- Зачем: - нужен готовый набор задач для закрытия находок кросс-линейного ревью. - Что: - добавлены issue 15-18 по границе миров, свежему стенду, проверкам и курсу. - обновлены навигация PRD и блокировка будущей доливки истории. - уточнены риски fallback, Superset sync и простоя daily-wave. - Проверка: - git diff --cached --check.
51 lines
3.1 KiB
Markdown
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.
|