IPWhiteList/.github/copilot-instructions.md

IPWhiteList Copilot Instructions

Главное правило

НЕ ПЕРЕУСЛОЖНЯТЬ. Это CRUD-сервис на 3 таблицы. Минимум абстракций, минимум папок, минимум зависимостей.

Коммуникация

• Продвигаемся вместе шаг за шагом
• ВСЕГДА спрашивать если что-то неясно — не додумывать, не фантазировать
• НЕ ВРАТЬ. Если не знаешь — скажи «не знаю»
• Пользователь объяснит устройство личного кабинета облака, Keycloak и т.д. — не придумывать

Стек (согласован)

• Python 3.11+ / FastAPI
• PostgreSQL
• Jinja2 + простые HTML-формы (без SPA, без тяжёлого JS)
• Минимум зависимостей

Принципы разработки

• Не плодить слои (services/, repositories/, routers/ отдельно) без реальной необходимости
• Сначала ядро (валидация, CRUD), потом UI, потом Keycloak
• Никаких ORM без явного запроса пользователя
• Никакого async без реальной необходимости
• Любое изменение кода — только после явного «делай» от пользователя

Процесс

• Сначала уточнить непонятное → предложить простой шаг → сделать → повторить
• Не пытаться сделать всё сразу