15 lines
1.3 KiB
Markdown
15 lines
1.3 KiB
Markdown
# 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).
|