architect(ET): auto-commit from architect run_id=633
This commit is contained in:
@@ -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
|
||||
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user