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

51 lines
3.1 KiB
Markdown

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
- [x] Quick start и курс явно называют `uv` и остальные обязательные
пререквизиты до первой команды, которая их требует.
- [x] Быстрый старт на чистом стенде подготавливает DDL до проверок генератора;
отсутствие таблиц не падает сырым `UNKNOWN_TABLE`.
- [x] После обновления репозитория Airflow получает новые зависимости и DAG-и
без ручных догадок: через пересборку, явную команду или ясно описанный шаг.
- [x] `generator_control` не висит навсегда, если зависимый `etl_pipeline`
стоит на паузе: оператор получает понятный отказ или инструкцию до запуска
долгого ожидания.
- [x] Решение по Airflow API, проверенное через Context7 для текущей версии,
зафиксировано в коде или документации кратко и рядом с местом выбора.
- [x] 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.