ddmitry/clickstream-ch-kafka-superset-demo

Files

T

ddadminandClaude Fable 5 c672ed0329 docs(issues): дооформлены задачи 12 и 14, обновлён граф бэклога генератора

- Зачем:
  - подготовить цепочку 12 -> 14 -> 09 -> 10 -> 08 к передаче в coordinator-loop:
    задаче 12 не хватало решений после 07 и 11, задача 14 родилась из обсуждения
    учебного UX (суточная волна вживую).
- Что:
  - issue 12 (DAG-пульт): решения 2026-07-04 — без Docker-доступа из Airflow,
    операции как Python-код генератора в тасках, генератор без автостарта,
    границы пульта, предпроверки чистоты (топики + STG), ожидание ETL перед
    check; учтены находки адверсарного ревью и ревью Codex.
  - issue 14 (новая): профиль daily-wave переводится на speed=60 при тике 1 с —
    модельный час за настенную минуту без изменения фактуры мира.
  - issue 08: мягкие зависимости от 14 и 09 (артефакт курса рождается после
    них), режим ревью; PRD: задача 14 в списке и графе, 12 помечена дооформленной.
- Проверка:
  - вычитка: статусы задач ready-for-agent, порядок в PRD и Blocked by
    согласованы; mermaid-граф рендерится.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-07-04 20:42:46 +03:00

6.5 KiB

Raw Blame History

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

Обновить курс и связанные материалы (тест-план) так, чтобы основной путь был:

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).

Рекомендуемый режим ревью по coordinator-loop: обычный (документы и уроки, кода генератора и state задача не трогает); человеческая приёмка — проход по урокам через пульт (HITL).

Blocked by

Жёстких блокеров нет: штатный путь (make generated-history-analytics) уже существует, уроки можно вести через него.
Мягкая зависимость от 07-startup-history-portable-artifact-and-usage-docs.md: runbook из issue 07 изменит команды запуска и восстановления стенда, а уроки будут на него ссылаться. Делать эту задачу после него, иначе уроки придётся править дважды.
Мягкая зависимость от 12-generator-control-dag.md (решение 2026-07-04): человеческая приёмка миграции — это проход по урокам 00–05, и вести её удобнее через DAG-пульт, а не через консоль. Поэтому эта задача идёт последней в очереди — после 12. Порядок всей очереди — в PRD, раздел «Задачи».
Мягкая зависимость от 14-fast-teaching-profile.md и 09-seam-browser-fixture-not-preserved.md (дополнено 2026-07-04): обе меняют мир — 14 переводит профиль daily-wave на быстрый темп, 09 меняет схему state. Артефакт стартовой истории для уроков должен родиться после них, иначе он протухнет по антисмешиванию и проход по урокам придётся повторять.

6.5 KiB Raw Blame History Unescape Escape