ddmitry/clickstream-ch-kafka-superset-demo

Files

T

ddadminandClaude Fable 5 85f076e205 docs(generator): проведён триаж бэклога фичи, задачи 01-06 закрыты

- Зачем:
  - 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>

2026-07-04 16:39:40 +03:00

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

Blocked by

Жёстких блокеров нет: штатный путь (make generated-history-analytics) уже существует, уроки можно вести через него.
Мягкая зависимость от 07-startup-history-portable-artifact-and-usage-docs.md: runbook из issue 07 изменит команды запуска и восстановления стенда, а уроки будут на него ссылаться. Делать эту задачу после него, иначе уроки придётся править дважды (номера уже отражают порядок: 07 -> 08, переставлены 2026-07-04).

5.2 KiB Raw Blame History Unescape Escape