Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VisionTorg12

Извлечение данных из бухгалтерской первички РФ (ТОРГ-12, УПД, счёт-фактура) в структурированный JSON и XLSX — через REST API.

Гибридный pipeline: быстрый regex-путь обрабатывает ~80% типовых документов бесплатно, а Vision-LLM подключается только там, где это действительно нужно. Результат — низкая себестоимость на потоке и предсказуемая точность.


Зачем это нужно

Ручной ввод накладных и УПД в учётную систему — дорогая, медленная и ошибкоёмкая операция. VisionTorg12 превращает PDF первички в готовую к загрузке структуру данных: реквизиты сторон, номер и дата документа, табличная часть с товарами, итоги — с валидацией арифметики.

Отдельно поставляется расширение для 1С:Предприятие 8.3 — данные попадают прямо в учётную базу, минуя перебивку руками.


Возможности

  • REST API на FastAPI — загрузка PDF, получение результата в JSON или XLSX.
  • Гибридный pipeline — regex fast-path (0 ₽) с fallback на Vision-LLM только при необходимости.
  • Два провайдера — Claude и OpenAI с автоматическим переключением.
  • Экспорт в XLSX и JSON с аккуратным форматированием.
  • API-ключи и rate-limit для публичного доступа к API.
  • SHA-256 кеш — один уникальный документ обрабатывается один раз.
  • Жёсткая валидация результата с автоматическим повтором на усиленной модели.
  • Prompt caching (Anthropic) — экономия на повторяющихся шаблонах документов.
  • Веб-интерфейс (vanilla JS + Tailwind, светлая тема) для загрузки и просмотра.
  • Расширение 1С (CFE) — интеграция извлечённых данных в учётную базу.

Архитектура

PDF → [ SHA-256 кеш ] → [ regex fast-path ] ──── покрыто? ──► JSON/XLSX
                                │ нет
                                ▼
                        [ Vision-LLM: Claude / OpenAI ]
                                │
                        [ валидация + повтор ] → JSON/XLSX
Слой Технологии
API FastAPI, Python 3.10+
Извлечение regex fast-path + Vision-LLM (Anthropic / OpenAI)
Хранилище SHA-256 кеш результатов, очередь обработки
Экспорт XLSX (форматированный), JSON
UI HTML5 + vanilla JS + Tailwind
Интеграция Расширение 1С:Предприятие 8.3 (CFE)

Подробности — в ARCHITECTURE.md и ARCHITECTURE.1C.md.


Быстрый старт

pip install -r requirements.txt
cp env.example .env          # укажите ключи провайдеров и параметры API
python -m api.app            # запуск REST API + веб-интерфейса

Загрузка документа через API:

curl -X POST http://localhost:8000/extract \
  -H "X-API-Key: <ваш-ключ>" \
  -F "file=@накладная.pdf"

В ответ — структурированный JSON; для XLSX добавьте ?format=xlsx.


Стоимость обработки

Fast-path (regex) — 0 ₽ на документ и покрывает большинство типовых накладных. LLM-путь подключается выборочно, а SHA-256 кеш и prompt caching дополнительно снижают расход на потоке дублей и однотипных шаблонов.


Статус

Рабочий MVP (V4): REST API, гибридный pipeline, экспорт, веб-UI и расширение 1С. Дорабатывается покрытие типов документов и точность табличной части.


Лицензия

Проприетарный проект. Все права защищены. По вопросам использования — свяжитесь с автором.

About

Извлечение данных из ТОРГ-12/УПД/счетов-фактур (PDF → JSON/XLSX) через REST API. Гибрид regex + Vision-LLM, интеграция с 1С.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages