<!-- Название PR: «[ID] Что сделано», по-русски. Например: [2.11] Изоляция организаций --> **Задача:** #<!-- ID задачи в дорожной карте --> **Пункты:** <!-- 2.11.4, 2.11.6 --> ## Что сделано - ## Как проверить 1. ## Скриншоты <!-- Для изменений интерфейса. Иначе удалить раздел. --> ## Чек-лист - [ ] Коммиты и название PR по-русски, в каждом коммите есть `Refs:` - [ ] Ветка свежая: `git rebase origin/main`, конфликтов нет - [ ] Запросы к данным организации — с `tenant_id` и через `WithTenantTx` - [ ] Права проверяются на сервере (`access.Require` / `ScopesFor`), интерфейс только скрывает - [ ] Новая функция — за флагом из каталога функций - [ ] Миграции только новые, смерженные не изменены; контракты (`api/`, `proto/`, `migrations/`) — отдельным PR - [ ] Тесты добавлены или обновлены; для новой таблицы организации — тест изоляции - [ ] Секретов и персональных данных в коде, логах и документах нет - [ ] Документация обновлена: запись журнала, `docs/status/`, ADR при значимом решении - [ ] Ссылка на этот PR добавлена в «Ссылки» задачи в дорожной карте Reviewed-on: #5 Co-authored-by: BrowenSiz <top.timashevsky@gmail.com>
2.2 KiB
2.2 KiB
Документация «Штиль»
Начните с AGENTS.md (правила проекта), затем docs/ai/PROTOCOL.md (как работать с контекстом и документировать).
Порядок чтения для новой сессии
AGENTS.mddocs/ai/PROTOCOL.mddocs/status/shared.md+docs/status/<ваша зона>.md- Последние записи
docs/journal/ - Дорожная карта:
node tools/roadmap-context/roadmap-context.mjs
Карта
| Папка / файл | Зона | Что внутри |
|---|---|---|
ai/ |
shared | Протокол AI, сверка с дорожной картой, шаблоны |
status/ |
shared + зоны | Снимок текущего состояния: общее, Frontend, Backend |
journal/ |
все | История работы: одна запись на ветку/PR |
adr/ |
shared | Архитектурные решения NNNN-название.md |
architecture/ |
shared | ERD, правила БД, протокол агента, IPC Помощника |
ux/ |
shared | Информационная архитектура, макеты, сценарии |
testing/ |
shared | Тестовый стенд, сценарии доступа |
research/ |
shared | Интервью, исследования рынка |
frontend/ |
frontend | Внутренние правила Frontend: дизайн-система, компоненты, соглашения |
private/ |
только владелец | Личные заметки разработчика с AI. В .gitignore, в Gitea не попадает |
backend/ |
backend | Внутренние правила Backend: области сервера, агент, эксплуатация |
environment.md |
shared | Версии инструментов и установка окружения (#1.3) |
glossary.md |
shared | Словарь терминов (#2.1) |
features.md |
shared | Каталог функций и лимитов (#2.3) |
contributing.md |
shared | Ветки, коммиты, PR, версии (#1.2.9) |