- Зачем: - coordinator-loop отделяет рабочие изменения от статусов и журнала. - Что: - задача 16 переведена в done с закрытыми критериями. - журнал дополнен ревью, стендовым gate и коммитами. - Проверка: - staged-состав содержит только issue 16 и журнал.
51 lines
3.1 KiB
Markdown
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.
|