docx-parser

Лёгкий HTTP-микросервис для работы с документами Word в пайплайне таможенного брокера. Принимает DOCX-файлы с реквизитами клиентов, извлекает текст для дальнейшего парсинга ИИ, а также генерирует готовые договоры (PDF и DOCX) по шаблону с реквизитами компании.

Разворачивается в Docker, деплоится через Coolify — автоматически при пуше в main.

pip install -r requirements.txt
python app.py
# Сервис доступен на http://localhost:8082

docker build -t docx-parser .
docker run -d -p 8082:8082 --restart unless-stopped docx-parser

Принимает DOCX-файл, возвращает извлечённый текст.

curl -X POST -F "file=@card.docx" http://localhost:8082/extract

Или как raw body:

curl -X POST --data-binary @card.docx \
 -H "Content-Type: application/octet-stream" \
 http://localhost:8082/extract

Ответ:

{
 "text": "ООО «Омега»\nИНН 7718100830\nКПП 772001001\n...",
 "chars": 1234,
 "paragraphs": 25,
 "tables": 1
}

Рендерит договор на оказание услуг таможенного представителя по шаблону templates/contract.docx.

Запрос (JSON):

{
 "contract_number": "415",
 "contract_date": "26.06.2026",
 "client": {
 "company_name": "ООО «Омега»",
 "inn": "7718100830",
 "kpp": "772001001",
 "ogrn": "1157746208729",
 "address": "111123, Москва, ш. Энтузиастов, д. 31",
 "account": "40702810413000010925",
 "bank": "ПАО Сбербанк",
 "bik": "042007681",
 "cor_account": "30101810600000000681",
 "director_genitive": "Елютина Ивана Михайловича",
 "director_short": "Елютин И.М.",
 "intro_clause": ", в лице генерального директора Елютина Ивана Михайловича, действующего на основании Устава",
 "email": "client@example.com",
 "phone": "+7 903 030 99 94"
 }
}

Ответ: бинарный PDF (application/pdf) с именем Contract_415.pdf.

Эндпоинт /generate-contract-docx принимает тот же JSON, возвращает .docx.

Реквизиты Представителя задаются через переменные окружения в Coolify — не хардкодятся в образе:

1. Подключите репозиторий в Coolify → Build Pack: Dockerfile.
2. Укажите Port: 8082.
3. Заполните переменные окружения (реквизиты компании).
4. Нажмите Deploy — при каждом пуше в main Coolify пересобирает образ автоматически.

Проверка после деплоя:

curl https://parser.yourdomain.ru/health
# {"status": "ok"}

Python Flask Docker LibreOffice Coolify

• Flask 3.0 — HTTP-сервер
• python-docx — извлечение текста из DOCX
• docxtpl — рендеринг договора по Jinja2-шаблону
• LibreOffice headless — конвертация DOCX → PDF
• gunicorn — production WSGI-сервер (2 воркера ×ばつ 4 потока)

Сервис не имеет аутентификации — он живёт внутри закрытой Docker-сети Coolify и не выставлен напрямую в интернет. Если вы открываете порт наружу — закройте его Basic Auth на уровне reverse-proxy.

MIT