docs(architecture): операторские разделы README переехали в справочники #213

Merged
ddmitry merged 2 commits from 212-operator-sections-move into main 2026-09-01 23:27:07 +03:00
Owner

Переезд операторских разделов README в справочники docs/architecture/ по раскладке из резолюции #211.

  • Новые docs/architecture/stand.md (службы, пользователи и роли ClickHouse, применение настроек, ледгер сверки) и docs/architecture/world.md (стартовый мир, опись, вызов генератора, пульт).
  • Доводы смоука и описания целей make слиты в testing.md; два дубля умерли (фраза о check_containers_survived, абзац про config-test).
  • README: на месте каждого раздела — абзац со ссылкой, заголовки сохранены ради якорей, адреса и пароли на месте. Пересборка README — следующим тикетом.
  • Путеводитель и generator/README.md ссылаются на world.md.

Проверка: скрипт ссылок из тикета пуст, make config-test зелёный, подиффовая сверка переехавших диапазонов без расхождений.

Closes #212

🤖 Generated with Claude Code

https://claude.ai/code/session_014QBCtU38qSHg5DvgtnKXcW

Переезд операторских разделов README в справочники `docs/architecture/` по раскладке из резолюции #211. - Новые `docs/architecture/stand.md` (службы, пользователи и роли ClickHouse, применение настроек, ледгер сверки) и `docs/architecture/world.md` (стартовый мир, опись, вызов генератора, пульт). - Доводы смоука и описания целей `make` слиты в `testing.md`; два дубля умерли (фраза о `check_containers_survived`, абзац про `config-test`). - README: на месте каждого раздела — абзац со ссылкой, заголовки сохранены ради якорей, адреса и пароли на месте. Пересборка README — следующим тикетом. - Путеводитель и `generator/README.md` ссылаются на `world.md`. Проверка: скрипт ссылок из тикета пуст, `make config-test` зелёный, подиффовая сверка переехавших диапазонов без расхождений. Closes #212 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_014QBCtU38qSHg5DvgtnKXcW
ddmitry added 1 commit 2026-09-01 22:49:27 +03:00
Зачем: README служил складом для двух зон без своих справочников —
«службы и доступ» и «мир и его пульт». Раскладка принята резолюцией
#211: README остается лицом, устройство живет в docs/architecture/.

Что: новые docs/architecture/stand.md («Стенд: службы, доступ,
настройка», доводы — ADR 0001 и 0007) и docs/architecture/world.md
(«Мир и его пульт», доводы — ADR 0009 и 0013). Доводы смоука и
описания целей make слиты в testing.md без повторов: фраза о
check_containers_survived и абзац про config-test умерли как дубли.
На месте каждого переехавшего раздела README — абзац со ссылкой,
адреса и пароли интерфейсов остались. Путеводитель и README
генератора ссылаются на world.md вместо якорей README. Переехавший
текст не правился, только относительные ссылки.

Проверка: скрипт ссылок из тикета — пустой вывод; make config-test —
ЗЕЛЁНО; подиффовая сверка переехавших диапазонов с README@2588515 —
без расхождений (слепое ревью); в новой прозе нет «ё».

Closes #212

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014QBCtU38qSHg5DvgtnKXcW
ddmitry added 1 commit 2026-09-01 23:04:51 +03:00
Зачем: ревью владельца по PR #213. Сверка конфигурации в stand.md
приехала из README одним абзацем на двадцать строк, а Superset был
приклеен к Airflow без пустой строки. Три места в world.md читались
калькой с английского.

Что: ледгер «Что проверено» разбит на записи по темам — ClickHouse,
Kafka, метрики и Grafana, Airflow, Superset. В world.md заголовок
«Как позвать генератор» стал «Как запустить генератор» (якоря в README
и generator/README.md обновлены), переписаны абзацы про значения по
умолчанию и про сокет Docker. Смысл не менялся. Словарь проекта
(«пульт мира», «опись мира», «работник», «сырье») не трогался: это
термины CONTEXT.md и ADR, их пересмотр — отдельная развилка.

Проверка: скрипт ссылок из тикета — пустой вывод; make config-test —
ЗЕЛЁНО; старый якорь «как-позвать-генератор» в репозитории не встречается.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014QBCtU38qSHg5DvgtnKXcW
ddmitry merged commit 86ad8afaf2 into main 2026-09-01 23:27:07 +03:00
ddmitry deleted branch 212-operator-sections-move 2026-09-01 23:27:08 +03:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: ddmitry/clickstream-data-platform#213