docs(overview): ORCH-105 — слайды Lite-установки и использования через Plane #127

Merged
admin merged 8 commits from feature/ORCH-105- into main 2026-06-12 08:25:53 +03:00
Owner

ORCH-105 — Подготовка презентации по орку (docs-only)

Расширяет слайдо-источник витрины docs/overview/presentation.md (канон ORCH-011) тремя слайдами; дека 16 → 19, сквозная нумерация сохранена. Рантайм не затронут.

Что добавлено

  • Слайд «Запуск и ведение задачи через Plane» — вход через статус To Analyse; статусы Plane = индикация, не управление; наблюдение (доска + живая Telegram-карточка + комментарии со ссылками на ветку/PR).
  • Слайд «Что решает человек: гейты, авто-режим, отмена» — оба человеческих гейта Approved / Confirm Deploy; авто-лейблы autoApprove/autoDeploy (снимают только человеческие решения — ни одна техническая проверка не пропускается); лейбл Bug; отмена STOP.
  • Слайд «Lite-установка скриптами» — два контейнера платформы (оркестратор + watchdog) на инфре заказчика; развёртывание без правки кода (только конфиг); gen_secrets.py/onboard_project.py + docker compose up -d; runbook LITE_SETUP.md с проверкой каждого шага; одношаговый bootstrap — это смежный Bundled, не Lite (BR-5).

Факты сверены с golden sources: docs/deployment/LITE_SETUP.md, docs/overview/tech-pipeline.md, tech-integrations.md, CLAUDE.md.

Анти-дрейф

Новая функция test_presentation_covers_lite_and_plane_usage_bits в tests/test_system_docs.py фиксирует присутствие нового контента (Lite + Plane-usage маркеры) — бесследное удаление слайдов рвёт CI. Существующие проверки модуля — без послаблений.

Инварианты (self-hosting / AC-7)

  • src/** / STAGE_TRANSITIONS / QG_CHECKS / check_* / схема БД — байт-в-байт; новый QG не вводится.
  • python-pptx не добавлен в прод-образ; собранный .pptx в git не коммитится (build/ в .gitignore).

Проверки

  • pytest tests/ -q1874 passed.
  • tests/test_system_docs.py — 29 passed (вкл. новый анти-дрейф тест).
  • Ручная сборка .pptx (TC-07) в dev-venv: Собрано слайдов: 19 → build/orchestrator-overview.pptx, exit 0.

ADR: docs/work-items/ORCH-105/06-adr/ADR-001-presentation-lite-and-plane-usage-slides.md (канон витрины adr-0039 не меняется).

Refs: ORCH-105

🤖 Generated with Claude Code

## ORCH-105 — Подготовка презентации по орку (docs-only) Расширяет слайдо-источник витрины `docs/overview/presentation.md` (канон ORCH-011) тремя слайдами; дека **16 → 19**, сквозная нумерация сохранена. Рантайм не затронут. ### Что добавлено - **Слайд «Запуск и ведение задачи через Plane»** — вход через статус `To Analyse`; статусы Plane = индикация, не управление; наблюдение (доска + живая Telegram-карточка + комментарии со ссылками на ветку/PR). - **Слайд «Что решает человек: гейты, авто-режим, отмена»** — оба человеческих гейта `Approved` / `Confirm Deploy`; авто-лейблы `autoApprove`/`autoDeploy` (снимают только человеческие решения — **ни одна техническая проверка не пропускается**); лейбл `Bug`; отмена `STOP`. - **Слайд «Lite-установка скриптами»** — два контейнера платформы (оркестратор + watchdog) на инфре заказчика; развёртывание без правки кода (только конфиг); `gen_secrets.py`/`onboard_project.py` + `docker compose up -d`; runbook `LITE_SETUP.md` с проверкой каждого шага; одношаговый bootstrap — это смежный **Bundled**, не Lite (BR-5). Факты сверены с golden sources: `docs/deployment/LITE_SETUP.md`, `docs/overview/tech-pipeline.md`, `tech-integrations.md`, `CLAUDE.md`. ### Анти-дрейф Новая функция `test_presentation_covers_lite_and_plane_usage_bits` в `tests/test_system_docs.py` фиксирует присутствие нового контента (Lite + Plane-usage маркеры) — бесследное удаление слайдов рвёт CI. Существующие проверки модуля — без послаблений. ### Инварианты (self-hosting / AC-7) - `src/**` / `STAGE_TRANSITIONS` / `QG_CHECKS` / `check_*` / схема БД — **байт-в-байт**; новый QG не вводится. - `python-pptx` не добавлен в прод-образ; собранный `.pptx` в git не коммитится (`build/` в `.gitignore`). ### Проверки - `pytest tests/ -q` — **1874 passed**. - `tests/test_system_docs.py` — 29 passed (вкл. новый анти-дрейф тест). - Ручная сборка `.pptx` (TC-07) в dev-venv: `Собрано слайдов: 19 → build/orchestrator-overview.pptx`, exit 0. ADR: `docs/work-items/ORCH-105/06-adr/ADR-001-presentation-lite-and-plane-usage-slides.md` (канон витрины `adr-0039` не меняется). Refs: ORCH-105 🤖 Generated with [Claude Code](https://claude.com/claude-code)
admin added 7 commits 2026-06-12 08:19:37 +03:00
Расширяю слайдо-источник презентации docs/overview/presentation.md тремя
слайдами в каноне ORCH-011 (16 → 19, сквозная нумерация сохранена):

- Слайд «Запуск и ведение задачи через Plane» (вход «To Analyse»,
  статусы = индикация, наблюдение: доска + Telegram-карточка + комментарии).
- Слайд «Что решает человек: гейты, авто-режим, отмена» (Approved /
  Confirm Deploy; autoApprove/autoDeploy/Bug — без пропуска тех. проверок; STOP).
- Слайд «Lite-установка скриптами» (два контейнера платформы; только конфиг;
  gen_secrets.py/onboard_project.py + docker compose up -d; runbook LITE_SETUP.md;
  одношаговый bootstrap — это смежный Bundled, не Lite).

Факты сверены с golden sources (LITE_SETUP.md, tech-pipeline.md,
tech-integrations.md, CLAUDE.md). Анти-дрейф — новая функция
test_presentation_covers_lite_and_plane_usage_bits в tests/test_system_docs.py
(существующие проверки без послаблений). CHANGELOG обновлён.

Docs+tests only: src/**/STAGE_TRANSITIONS/QG_CHECKS/check_*/схема БД —
байт-в-байт; python-pptx не в прод-образе; .pptx в git не коммитится.
Ручная сборка .pptx (TC-07) проверена в dev-venv: «Собрано слайдов: 19», exit 0.

Refs: ORCH-105

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
tester(ET): auto-commit from tester run_id=650
All checks were successful
CI / test (push) Successful in 1m0s
CI / test (pull_request) Successful in 1m3s
c04dba0c0a
admin force-pushed feature/ORCH-105- from 1e50d94d56 to c04dba0c0a 2026-06-12 08:19:37 +03:00 Compare
admin merged commit adebb997e6 into main 2026-06-12 08:25:53 +03:00
Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: admin/orchestrator#127