Files
clickstream-ch-kafka-supers…/.scratch/generator-model-time-startup-history/issues/16-fresh-stand-generator-control.md
T
ddadmin 525bd8cabf docs(issues): оформлены задачи кросс-ревью генератора
- Зачем:
  - нужен готовый набор задач для закрытия находок кросс-линейного ревью.
- Что:
  - добавлены issue 15-18 по границе миров, свежему стенду, проверкам и курсу.
  - обновлены навигация PRD и блокировка будущей доливки истории.
  - уточнены риски fallback, Superset sync и простоя daily-wave.
- Проверка:
  - git diff --cached --check.
2026-07-05 01:00:39 +03:00

51 lines
3.1 KiB
Markdown

Status: ready-for-agent
# Свежий стенд и 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.