docs: AI documentation protocol and roadmap context tool

Протокол работы AI-ассистентов, зоны frontend/backend/shared, статусы, журнал, шаблоны и скрипт сводки дорожной карты.

Refs: 1.2.3

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
This commit is contained in:
TMSHandDevin committed 2026-11-08 17:14:44 +03:00
1 parent 699e6bbd57
commit a1ce4bdb8a
15 files changed
+804

No files matched your search

+15
View File
@@ -0,0 +1,15 @@
# Backend: документы зоны
Зона `backend` (`docs/ai/PROTOCOL.md`, раздел 2): сервер `shtil-server`, агент `shtil-agent`, БД, окружение, сборка.
Здесь — внутренние правила Backend, которые не нужны Frontend. Всё, что влияет на API, протокол, права, функции, конфиг, — в `shared`.
## Документы
| Файл | О чём | Появится в |
|---|---|---|
| `conventions.md` | Структура `internal/server/<область>`, слои, ошибки, логи, тесты, транзакции | #2.10 |
| `areas/<область>.md` | Область сервера (`access`, `sites`, `audit`…): таблицы, сервисные функции, права, события NATS | по мере появления |
| `agent.md` | Устройство агента: транспорт, сборщики, очередь, исполнитель, платформенные части | шаг 4–5 |
| `operations.md` | Запуск, конфиг, переменные окружения, миграции, диагностика | #2.8 |
Шаблон для областей и модулей — `docs/ai/templates/module.md`. Общая архитектура, ERD, правила БД, IPC — `docs/architecture/` (shared).