ddadminandClaude Fable 5
85f076e205
- Зачем:
- follow-up задачи после ревью 2026-06-14 лежали без триажа; решения по
артефакту, громкому отказу и интерфейсу приняты 2026-07-04 и должны
попасть в задачи до передачи исполнителю.
- Что:
- задачи 07 (миграция курса) и 08 (артефакт) поменяны местами — номера
отражают порядок; ссылки обновлены.
- 07 (артефакт + runbook) дооформлен: импорт строго через Kafka (напрямую
в ClickHouse не пишет), громкий отказ при несовместимом state с правкой
спеки, граница runbook «использование, не устройство»; ready-for-agent.
- 08 дооформлен: устройство генератора вне пути менти, реальный объём
(make data во всех уроках 00-05), демо вне скоупа; ready-for-agent.
- новые задачи: 11 глаголы/длительность/профили (после 07, до 12),
12 Airflow-DAG как пульт (приоритет поднят), 13 доливка (после 09).
- задачи 01-06 переведены в done (стояли ошибочные ready-for-human);
PRD фичи дополнен списком задач 7-13 с порядком и зависимостями.
- Проверка:
- head -1 .scratch/generator-model-time-startup-history/issues/*.md;
grep по старым именам файлов ничего не находит вне handoff.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
79 lines
5.2 KiB
Markdown
79 lines
5.2 KiB
Markdown
Status: ready-for-agent
|
||
|
||
# Миграция учебных материалов с архивного сида на генерацию
|
||
|
||
## Parent
|
||
|
||
`.scratch/generator-model-time-startup-history/PRD.md`
|
||
|
||
## Why
|
||
|
||
После перевода штатного аналитического контура на стартовую историю генератора
|
||
часть учебных материалов всё ещё описывает `data/*.jsonl` как основной источник
|
||
данных стенда. Это нельзя править внутри issue 06: потребуется пройти уроки и
|
||
сохранить понятный учебный путь.
|
||
|
||
Развилка «отдельный урок про генератор vs скрытая инфраструктура» закрыта
|
||
(2026-07-04, `docs/course/PRD.md` §7): **отдельного урока не будет, генератор —
|
||
скрытая инфраструктура**. Устройство генератора — это разработка бэкенда и
|
||
математика, не инженерия данных; в цели курса не попадает. Уроки адаптируем,
|
||
не вводя марковские цепи и сложный Python в путь менти.
|
||
|
||
## What to build
|
||
|
||
Обновить курс и связанные материалы (тест-план) так, чтобы основной путь был:
|
||
|
||
```text
|
||
startup-history/backfill -> Kafka -> STG -> ODS -> DDS -> DM -> Superset
|
||
```
|
||
|
||
Архивный `data/*.jsonl` оставить только как временную фактуру генератора.
|
||
Генератор в уроках подаётся как готовый источник данных стенда («откуда берутся
|
||
данные»), без погружения в его устройство.
|
||
|
||
## Acceptance criteria
|
||
|
||
- [ ] `docs/course/` больше не ведёт ученика через `make data` или `kafka_load`
|
||
как основной путь получения аналитических данных.
|
||
- [ ] Уроки явно объясняют, что `data/*.jsonl` пока остаётся кладовкой значений
|
||
для генератора, а не источником аналитического контура.
|
||
- [ ] Уроки не вводят устройство генератора (марковская модель, внутренний
|
||
Python) в путь менти: генератор упоминается только как готовый источник данных.
|
||
- [ ] Тест-план согласован с новым штатным путём запуска.
|
||
- [ ] Если для уроков нужны новые скриншоты или ручная оценка dashboard, это
|
||
вынесено в HITL-приёмку.
|
||
|
||
## Notes
|
||
|
||
Реальный объём больше, чем кажется: `make data` вплетён во **все** уроки 00–05,
|
||
а не только в урок 06 (проверка 2026-07-04, `grep -rn "make data" docs/course/`):
|
||
|
||
- `docs/course/README.md` — быстрый старт через `LIMIT=50 make data`;
|
||
- `lessons/00_kafka_intro.md` — `make data` играет роль трекера, на нём построен
|
||
весь разбор партиций и offset'ов;
|
||
- `lessons/01–05` — `LIMIT=50 make data` в запуске, «полном сбросе» и таблицах
|
||
проверок;
|
||
- `docs/TEST_PLAN.md` — сценарии на старом пути.
|
||
|
||
Тонкое место — урок 00: там ручная заливка используется как учебный приём
|
||
(наглядно видно сообщения в топике). Решить при миграции, чем её заменить, не
|
||
потеряв наглядность; критерий приёмки запрещает `make data` как **основной путь
|
||
аналитики**, а не как локальный демонстрационный приём внутри урока.
|
||
|
||
Схема потока в `docs/course/PRD.md` §1 уже обновлена (поправка 2026-07-04) — PRD
|
||
дополнительно править не нужно.
|
||
|
||
Демо-материалов в скоупе нет: демо-употребление стенда устарело (демо выросло в
|
||
отдельный проект), шпаргалки удалены из репозитория 2026-07-04 (см. поправку в
|
||
шапке `docs/course/PRD.md`).
|
||
|
||
## Blocked by
|
||
|
||
- Жёстких блокеров нет: штатный путь (`make generated-history-analytics`) уже
|
||
существует, уроки можно вести через него.
|
||
- Мягкая зависимость от
|
||
`07-startup-history-portable-artifact-and-usage-docs.md`: runbook из issue 07
|
||
изменит команды запуска и восстановления стенда, а уроки будут на него
|
||
ссылаться. Делать эту задачу после него, иначе уроки придётся править дважды
|
||
(номера уже отражают порядок: 07 -> 08, переставлены 2026-07-04).
|