scan4llm/.ai/DEVELOPMENT.md

Правила разработки

Цель проекта

Проект предназначен для полностью офлайн-подготовки документов к OCR.

Главный приоритет — сохранить максимальное качество исходного изображения.

Любое преобразование изображения должно либо улучшать OCR, либо не изменять качество изображения.

---

Принципы

Приоритеты разработки:

1. Простота.
2. Предсказуемость.
3. Читаемость.
4. Качество изображения.
5. Производительность.

Не реализовывать функциональность “на будущее”.

Реализовывать только то, что требуется текущим техническим заданием.

---

Поведение

Если требования неоднозначны:

• не делать предположений;
• не придумывать функциональность самостоятельно;
• предложить варианты и дождаться решения пользователя.

Не изменять существующее поведение без необходимости.

Новые возможности добавлять как отдельные независимые этапы обработки.

---

Зависимости

Каждая новая библиотека должна иметь явное обоснование.

Предпочитать стандартную библиотеку Python.

Не добавлять тяжёлые зависимости без необходимости.