domovoy_bot/services/gis_pdf_pipeline/SPECKIT_CONSTITUTION.md

1.9 KiB
Raw Permalink Blame History

📜 SPECKIT_CONSTITUTION: GIS PDF Pipeline

1. Стек технологий

  • Язык: Python 3.12+
  • Обработка изображений: Pillow (PIL)
  • Создание и склейка PDF: reportlab (для генерации страниц с тегами), PyPDF2 или pypdf (для слияния).
  • Распознавание текста (OCR): Интеграция с Gemini Vision API (или локальный Tesseract на M4) для анализа скриншотов evidence.png и извлечения дат/номеров.
  • Взаимодействие с Google Drive: google-api-python-client (использование domovoy_google_creds.json).

2. Стандарты кода

  • Строгая модульность (отдельно OCR, конвертер, склейка, загрузчик).
  • Изолированная обработка ошибок: поврежденный файл в одном ZIP не должен останавливать весь конвейер.
  • Логирование каждого этапа для прозрачности.

3. Взаимодействие (Lead <-> Worker)

  • Lead Agent: Проектирует архитектуру (SDD), пишет код интеграции, управляет загрузкой в GDrive.

4. DATA SEPARATION (Критическое правило)

  • ЗАПРЕЩЕНО использовать папку /volume1/video/youtube/ или любые медиа-пути для хранения юридических данных.
  • ВСЕ GIS-данные должны храниться строго в /volume1/web/legal/gis/.
  • ФИНАЛЬНЫЙ PDF сохраняется в корне юридического архива ГИС.
  • Нарушение этого правила считается критическим сбоем логики (eblanAI-mode).