architect(ET): auto-commit from architect run_id=633

This commit is contained in:
2026-06-11 09:03:56 +03:00
committed by orchestrator-deployer
parent 47479a9b75
commit c455931ae7
4 changed files with 544 additions and 0 deletions

View File

@@ -245,6 +245,27 @@ Type B). Анти-дрейф — `tests/test_bundle_compose.py` / `test_bundled_
[adr-0038](adr/adr-0038-bundled-replication-canon.md), детально —
`docs/work-items/ORCH-103/06-adr/ADR-001-bundled-stack-compose-and-bootstrap.md`.
## Витрина системы `docs/overview/` (ORCH-011 — design)
Единая точка входа «бизнес + тех» для трёх аудиторий (заказчик / менеджер / разработчик) —
новый docs-раздел **`docs/overview/`** (семантика разделов: `overview/` — «что это за система
и как устроена», `architecture/` — инженерный справочник, `deployment/` — «как развернуть у
себя», `operations/` — «как эксплуатировать наш прод»). Состав — плоский каталог, 10 файлов:
индекс `README.md` (маршруты 3 аудиторий + норматив сопровождения), `business.md`
(бизнес-уровень без жаргона), 7 × `tech-*.md` (= 7 блоков: архитектура / конвейер / агенты /
модель объектов / интеграции / качество-безопасность / наблюдаемость), `presentation.md`
(слайдо-источник). **Link-first:** витрина ссылается на golden sources (этот README, internals,
стандарты, ADR), не форкает их; разрешённый дубль — только машинно-сверяемый тестом факт
(стадии/гейты/агенты — derive-тестами из `STAGE_TRANSITIONS`/`QG_CHECKS`/glob промптов).
**Канон презентации:** `.pptx` (тёмный дизайн) собирается из `presentation.md` dev-скриптом
`scripts/build_presentation.py` (python-pptx, запуск только вне рантайма; зависимость в
прод-образ не попадает — машинный гард); **собранный бинарь в git не коммитится**. **Норматив
сопровождения (кросс-каттинг):** «изменил функциональность → обнови витрину в том же PR»;
reviewer-ось обзорных доков (ORCH-079) расширена на витрину (finding ≥ P1). Анти-дрейф —
структурный `tests/test_system_docs.py` (паттерн `test_lite_setup_doc.py`); новый QG не
вводится, рантайм байт-в-байт. Подробнее: [adr-0039](adr/adr-0039-system-overview-docs-canon.md),
детально — `docs/work-items/ORCH-011/06-adr/ADR-001-system-overview-canon.md`.
## Конвейер и Quality Gates
```