# Архитектура платформы

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

Раздел хранит сквозную архитектуру всей платформы. Доменная архитектура размещается в `docs/domains/<domain>/architecture/`.

Архитектурный пакет задаёт целевую рамку для кодовой реализации: сервисные границы, владение данными, контракты, интеграцию с провайдерами и платформенный MCP-контур.

## Активная каноника

| Документ | Назначение |
|---|---|
| `c4_context.md` | Контекст платформы: участники, внешние системы и границы ответственности. |
| `c4_container.md` | Контейнерная карта: пограничный слой, доменные сервисы, исполнители, хранилища и внешние зависимости. |
| `domain_map.md` | Архитектурная карта доменов и сервисов-владельцев. |
| `service_boundaries.md` | Правила владения сервисов, пограничных компонентов и исполнителей. |
| `data_model.md` | Сквозная модель данных, владение состоянием и межсервисная синхронизация. |
| `provider_integration_model.md` | Модель интеграции с GitHub/GitLab и другими провайдерами. |
| `mcp_and_interaction_model.md` | Платформенный MCP, взаимодействия с человеком, уведомления и внешние каналы. |
| `secret_resolution.md` | Общий контракт безопасного получения секретов по ссылке без раскрытия значений в API, БД, событиях и логах. |
| `codex_hooks_and_skills.md` | Варианты использования Codex hooks и skills в платформе. |
| `repository_onboarding.md` | Варианты bootstrap/adoption репозитория, модели `services.yaml`, внешней документации и пакетов. |

## Правила развития

- Сквозные решения, которые затрагивают несколько доменов, фиксируются здесь.
- Детали конкретного домена выносятся в `docs/domains/<domain>/architecture/**`.
- Документы этого раздела не должны ссылаться в теле на временные PR, review threads или номера рабочих задач.
- Если меняется граница сервиса-владельца, нужно синхронно обновить `domain_map.md`, `service_boundaries.md` и `data_model.md`.
- Если меняется контур интеграции с провайдерами, нужно синхронно обновить `provider_integration_model.md` и контракты домена `provider-native-work-items`.

## Шаблоны

| Тип документа | Шаблон |
|---|---|
| C4-контекст | `docs/templates/c4_context.md` |
| C4-контейнеры | `docs/templates/c4_container.md` |
| Модель данных | `docs/templates/data_model.md` |
| API и контракты | `docs/templates/api_contract.md` |
| Проектное решение | `docs/templates/design_doc.md` |
| ADR | `docs/templates/adr.md` |
| Альтернативы | `docs/templates/alternatives.md` |
