Bounded contexts

Бэкенд разрезан на bounded contexts в platform/app/contexts/. Каждый контекст владеет своими таблицами, логикой, схемами и роутером; изоляцию принуждает import-linter в CI. Эта страница — карта.

Производство контента

Контекст	Владеет
research	Накапливающаяся база знаний контракта (исследовательские факты и смежные таблицы): обогащение, свежесть, гигиена, разрешение конфликтов. Фундамент retrieval-grounded генерации.
retrieval	Универсальный векторный примитив: чанкинг, эмбеддинги, поиск по близости и rerank поверх pgvector. Используется research, publish и quality.
publish	Публикационный конвейер: сборка payload, реестр опубликованных URL, клиент хаба, дедупликация тем и батчей, grounding-гейт, карантин, тематический фидбек.
quality	Пост-публикационный скоринг статей: верификация, проверка утверждений по источникам, сигналы бренд-безопасности, языковая консистентность, детект устаревших публикаций.
competitors	Жизненный цикл списков конкурентов контракта: майнинг кандидатов, реестр, безопасное применение в декларации бренд-защиты.

Исполнение и эксплуатация

Контекст	Владеет
runs	Трекинг и оркестрация исполнений пайплайнов: каталог версий, события прогонов и проекции, метеринг, автоскейлинг, staging и реконсиляция.
integrations	Единственный канал к внешним сервисам (LLM, веб-поиск, генерация картинок, хранилище, DNS): декларативный реестр коннекшенов, подключаемые секрет-бэкенды, типизированные capability-адаптеры и монитор здоровья.
ops	Живой операционный снапшот для дашборда и статус-чтений агентов.
analytics	Поисковые и трафиковые данные (недельные ряды search console по инстансам) и производная аналитика: скоринг, тематическая отдача, планирование.
cockpit	Read-only агрегатор для дашборда контракта.

Знание и процесс

Контекст	Владеет
tickets	Трекер инцидентов / дефектов / предложений (доска, в которую пишут агенты).
tasks	Назначаемые рабочие задачи со статусами и заметками.
chatlog	Поисковый архив рабочего чата команды.
specs	Реестр, связывающий фичи с их SPEC-документами (трассируемость).

Общие слои вне контекстов

Часть фундаментальных слоёв старше разреза на контексты и живёт плоско в platform/app/:

• auth/ — выпуск JWT, скоупы и грант-модель агентов (см. Аутентификацию).
• lifecycle/ — движок стейт-машин сущностей, унаследованный от метамодели платформы (см. Модель данных).
• db/models/ — ORM-слой.
• api/v1/ — REST-роутеры (около 28, сгруппированы по способностям).
• native/ — сами директории неизменяемых версий пайплайнов.

Правило взаимодействия

Контекст обращается к другому только через его публичный contracts.py или событие — никогда импортом внутренностей, никогда касанием чужих таблиц. Примеры живых швов: publish-гейт читает вердикты качества через контракт quality; дедупликация получает эмбеддинги через контракт retrieval; любой LLM-вызов где угодно идёт через адаптер integrations. Если трассируешь поведение через модули — начинай с contracts.py целевого контекста: это его полная публичная поверхность.