Files
clickstream-ch-kafka-supers…/.scratch/generator-model-time-startup-history/issues/16-fresh-stand-generator-control.md
T
ddadmin 9804d0beae docs(generator): закрыта задача 16 в трекере
- Зачем:
  - coordinator-loop отделяет рабочие изменения от статусов и журнала.
- Что:
  - задача 16 переведена в done с закрытыми критериями.
  - журнал дополнен ревью, стендовым gate и коммитами.
- Проверка:
  - staged-состав содержит только issue 16 и журнал.
2026-07-05 20:47:41 +03:00

3.1 KiB

Status: done

Свежий стенд и Airflow-пульт без догадок

Parent

.scratch/generator-model-time-startup-history/PRD.md

What to build

Сделать так, чтобы человек на свежем клоне мог пройти быстрый старт до generator_control без неявных шагов, сырых ошибок и зависаний Airflow.

Источник: .scratch/handoffs/20260705-0002-cross-review-generator-chain.md, разделы Issue 12/14 и Issue 08.

Связанные старые issue: 12-generator-control-dag.md, 14-fast-teaching-profile.md.

Acceptance criteria

  • Quick start и курс явно называют uv и остальные обязательные пререквизиты до первой команды, которая их требует.
  • Быстрый старт на чистом стенде подготавливает DDL до проверок генератора; отсутствие таблиц не падает сырым UNKNOWN_TABLE.
  • После обновления репозитория Airflow получает новые зависимости и DAG-и без ручных догадок: через пересборку, явную команду или ясно описанный шаг.
  • generator_control не висит навсегда, если зависимый etl_pipeline стоит на паузе: оператор получает понятный отказ или инструкцию до запуска долгого ожидания.
  • Решение по Airflow API, проверенное через Context7 для текущей версии, зафиксировано в коде или документации кратко и рядом с местом выбора.
  • Runbook предупреждает, что долгий простой daily-wave на скорости 60 создаёт большую дыру в модельном времени, и советует reset или повторный импорт стартовой истории.

Blocked by

  • .scratch/generator-model-time-startup-history/issues/15-world-boundary-after-cross-review.md

Notes

  • Рекомендуемый режим coordinator-loop: обычный issue, worker medium, ревью кода high. Если правка уйдёт в устройство DAG-зависимостей шире предпроверки паузы, эскалировать до гейта.
  • Формальная зависимость от 15 нужна из-за общего участка предпроверки чистого стенда: свежий стенд должен опираться на уже выбранный способ отказа и диагностики грязного мира.
  • Не включать сюда учебные тексты уроков 00/01/05, кроме пререквизитов и quick start: основной проход курса закрывает задача 18.