ddmitry/clickstream-data-platform
1
0 Fork 0
Code Issues 5 Pull Requests Actions Packages Projects 1 Releases Wiki Activity

Учебные задания витрин DM и даг самопроверки #159

New Issue
Closed
opened 2026-08-25 15:01:12 +03:00 by ddmitry · 1 comment
ddmitry commented 2026-08-25 15:01:12 +03:00
Owner
Copy link
Copy source

Part of #6.

Цель

Домашки слоя DM: ТЗ витрин менти с образцом и ручной даг самопроверки с
обратной связью по каждой витрине. Учебный результат: менти строит
витрину сам — от DDL по правилу зерна до задачи в конвейере.

Что войдёт

  • Тексты ТЗ пяти витрин (dm.md, «Кто строит»): разминка —
    events_enriched_v (представление, зерно события), затем
    top_pages_daily, session_overview, dq_errors_daily, последней —
    utm_effectiveness (урок declared_*). Каждое ТЗ: цель; роль витрины и её
    обязательные элементы — из спеки §7 (полного состава колонок она не
    даёт: четыре витрины «переезжают без смены роли» из v1 — образец
    состава смотреть в стенде-предшественнике, ссылка в
    docs/agents/issue-tracker.md «Архив»; полный состав проектирует само
    ТЗ); форма по правилу зерна (dm.md); ключ шардирования — решение менти
    по правилу донора storage.md; финальный пункт — добавить задачу своей
    витрины в dm_transform. Разминка-представление в конвейер не встаёт
    (пересобирать нечего) — слово «каждого» в dm.md поправить тем же PR.
  • Дом ТЗ — новая подпапка docs/labs/, имена — слаги строчными
    латинскими буквами (как в docs/formats/): задание — не событие
    истории, а живой документ. Раздел «Структура» в AGENTS.md пополнить
    правилом тем же PR.
  • Спека §10 относит лабы к отдельной работе после стенда, а резолюция
    #135 забрала ТЗ витрин DM и даг самопроверки в этап 4 — снять
    противоречие правкой §10 тем же PR; остальной учебный путь остаётся
    отдельной работой. Решение владельца (25 августа 2026): здесь —
    содержание ТЗ (роль, состав, проверки); единый стиль и оформление
    блока домашек — работа этапа учебного пути, там ТЗ дооформляются, не
    здесь.
  • Даг самопроверки homework_check: без расписания, запуск рукой; задача
    на витрину; красная, пока витрины нет или счёт не сходится; сообщение
    говорит, что не так и куда смотреть; проверки — инварианты против
    DDS-источников, золотые константы не прибиваются; в dq_summary не
    пишет.

Границы

  • Сами витрины менти стенд не строит; конвейер о них не знает до
    финального пункта ТЗ.
  • Лабы-идеи #143, #145, #148, #149 — не здесь.
  • Дашборд этапа 8 на домашки не опирается.

Кому что

Тексты ТЗ — Opus целиком: чистая учебная проза. Codex — прогон
самопроверки по брифу: на свежем стенде и на черновых сборках домашек;
черновики после проверки снести — домашки остаются менти.

Сначала прочитать

  • docs/architecture/dm.md — «Кто строит», «Даг самопроверки», это спека
    тикета;
  • мастер-спека, раздел 7 — состав витрин;
  • docs/architecture/testing.md — за опытами прибираются.

Проверка

  • make lint; на стенде make smoke, make check-clickhouse и
    make check-services зелёные (конвейер домашек не ждёт).
  • homework_check на свежем стенде: все задачи красные, каждое
    сообщение называет отсутствующую витрину и её ТЗ.
  • Каждое ТЗ проверено черновой сборкой своей витрины: задача
    самопроверки зелёная, после сноса черновика — снова красная. ТЗ, по
    которому витрину не собрать, — брак ТЗ, не менти.
  • В dq_summary строк от самопроверки нет.
Part of #6. ## Цель Домашки слоя DM: ТЗ витрин менти с образцом и ручной даг самопроверки с обратной связью по каждой витрине. Учебный результат: менти строит витрину сам — от DDL по правилу зерна до задачи в конвейере. ## Что войдёт - Тексты ТЗ пяти витрин (dm.md, «Кто строит»): разминка — `events_enriched_v` (представление, зерно события), затем `top_pages_daily`, `session_overview`, `dq_errors_daily`, последней — `utm_effectiveness` (урок `declared_*`). Каждое ТЗ: цель; роль витрины и её обязательные элементы — из спеки §7 (полного состава колонок она не даёт: четыре витрины «переезжают без смены роли» из v1 — образец состава смотреть в стенде-предшественнике, ссылка в docs/agents/issue-tracker.md «Архив»; полный состав проектирует само ТЗ); форма по правилу зерна (dm.md); ключ шардирования — решение менти по правилу донора storage.md; финальный пункт — добавить задачу своей витрины в `dm_transform`. Разминка-представление в конвейер не встаёт (пересобирать нечего) — слово «каждого» в dm.md поправить тем же PR. - Дом ТЗ — новая подпапка `docs/labs/`, имена — слаги строчными латинскими буквами (как в `docs/formats/`): задание — не событие истории, а живой документ. Раздел «Структура» в AGENTS.md пополнить правилом тем же PR. - Спека §10 относит лабы к отдельной работе после стенда, а резолюция #135 забрала ТЗ витрин DM и даг самопроверки в этап 4 — снять противоречие правкой §10 тем же PR; остальной учебный путь остаётся отдельной работой. Решение владельца (25 августа 2026): здесь — содержание ТЗ (роль, состав, проверки); единый стиль и оформление блока домашек — работа этапа учебного пути, там ТЗ дооформляются, не здесь. - Даг самопроверки `homework_check`: без расписания, запуск рукой; задача на витрину; красная, пока витрины нет или счёт не сходится; сообщение говорит, что не так и куда смотреть; проверки — инварианты против DDS-источников, золотые константы не прибиваются; в `dq_summary` не пишет. ## Границы - Сами витрины менти стенд не строит; конвейер о них не знает до финального пункта ТЗ. - Лабы-идеи #143, #145, #148, #149 — не здесь. - Дашборд этапа 8 на домашки не опирается. ## Кому что Тексты ТЗ — Opus целиком: чистая учебная проза. Codex — прогон самопроверки по брифу: на свежем стенде и на черновых сборках домашек; черновики после проверки снести — домашки остаются менти. ## Сначала прочитать - docs/architecture/dm.md — «Кто строит», «Даг самопроверки», это спека тикета; - мастер-спека, раздел 7 — состав витрин; - docs/architecture/testing.md — за опытами прибираются. ## Проверка - [x] `make lint`; на стенде `make smoke`, `make check-clickhouse` и `make check-services` зелёные (конвейер домашек не ждёт). - [x] `homework_check` на свежем стенде: все задачи красные, каждое сообщение называет отсутствующую витрину и её ТЗ. - [x] Каждое ТЗ проверено черновой сборкой своей витрины: задача самопроверки зелёная, после сноса черновика — снова красная. ТЗ, по которому витрину не собрать, — брак ТЗ, не менти. - [x] В `dq_summary` строк от самопроверки нет.
ddmitry commented 2026-08-28 10:02:05 +03:00
Author
Owner
Copy link
Copy source

Влито PR #174 (ветка 159-dm-labs, merge в main). Чекбоксы приёмки тикнуты: make lint зелёный, ТЗ пяти витрин в docs/labs/, даг homework_check на месте.

Влито PR #174 (ветка 159-dm-labs, merge в main). Чекбоксы приёмки тикнуты: make lint зелёный, ТЗ пяти витрин в docs/labs/, даг homework_check на месте.
Sign in to join this conversation.
No Branch/Tag Specified
Labels
Clear labels
needs-info
needs-triage
ready-for-agent
ready-for-human
wayfinder:grilling
wayfinder:map
wayfinder:prototype
wayfinder:research
wayfinder:task
wontfix
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
ddmitry (Dmitry Dementiev)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Depends on
#154 Витрины стенда: даг dm_transform, revenue_daily и daily_traffic
ddmitry/clickstream-data-platform
Reference: ddmitry/clickstream-data-platform#159