# Доменные пакеты документации

## Назначение

`docs/domains/**` хранит самодостаточные пакеты по доменам платформы. Такой пакет должен быть достаточно независимым, чтобы позже его можно было перенести в отдельный репозиторий или отдельный пакет документации без переписывания всей навигации.

## Правила доменного пакета

- В корне домена всегда есть `README.md`.
- Документы домена не дублируют сквозную платформенную канонику из `docs/platform/**`.
- Если домену нужны продуктовые, архитектурные, delivery или ops документы, они создаются внутри домена.
- Карта Issue домена живёт в `docs/delivery/issue-map/domains/<domain>.md`.
- Волновая карта живёт в `docs/delivery/issue-map/waves/<wave>.md`.

## Первый набор доменов

| Домен | Назначение |
|---|---|
| `access-and-accounts/` | Доступ, организации, группы, пользователи, allowlist, внешние аккаунты как субъекты политики и аудит решений доступа. |
| `projects-and-repositories/` | Проекты, репозитории, проектная документация, правила веток, релизные политики и релизные линии. |
| `provider-native-work-items/` | `Issue`, `PR/MR`, комментарии, mentions, relationships, поля провайдера и platform watermarks. |
| `package-platform/` | Плагины, пакеты руководящей документации, клиент магазина пакетов, установка, версии и каталоги. |
| `agent-orchestration/` | `agent-manager`, flow, этапы, роли, шаблоны промптов и правила автоматизации. |
| `runtime-and-fleet/` | Слоты, platform jobs, подготовка workspace, prewarm/reuse/cleanup, серверы, Kubernetes-кластеры и placement scope. |
| `interaction-hub/` | UI, голос, уведомления, внешняя обратная связь и расширяемые каналы взаимодействия. |
| `console-and-operations-ux/` | Командный центр, рабочие представления, операционные статусы и диагностические экраны. |
| `risk-and-release-governance/` | Риски, Human gate, релизные линии, правила веток и релизная автоматизация. |
| `billing-and-cost-accounting/` | Затраты, распределение расходов, счета и коммерческий контур. |
| `knowledge-lifecycle/` | Руководящая и проектная документация, проектные правила, самоулучшение и жизненный цикл знаний. |

## Сервисные пакеты без доменного владения

Некоторые внутренние сервисы имеют самостоятельную документацию поставки и контрактов, но не являются доменами-владельцами из архитектурной карты. Для них допускается отдельный пакет внутри `docs/domains/**` с явной пометкой о границе.

| Пакет | Назначение |
|---|---|
| `platform-mcp-server/` | MCP-поверхность инструментов, проверка источника, policy boundary и маршрутизация MCP-вызовов к сервисам-владельцам без владения бизнес-состоянием. |
| `codex-hook-ingress/` | Входной контур нормализованных Codex hook events от hook emitter или локального sidecar без MCP transport и без владения бизнес-состоянием. |
| `integration-gateway/` | HTTP-вход для внешних webhook и callback событий, проверка источника, подписи, лимитов, размера payload и маршрутизация в сервисы-владельцы без владения бизнес-состоянием. |
