domovoy_bot/services/gis_pdf_pipeline/SPECKIT_CONSTITUTION.md

22 lines
1.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 📜 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).