docs(generator): путеводитель по генератору и живой проход make demo #179

Merged
ddmitry merged 2 commits from 48-generator-guide into main 2026-08-28 15:03:37 +03:00
Owner

Closes #48. Набор docs/architecture/generator/ по ADR 0011: индекс с mermaid-схемой цепочки и шесть поддокументов (дерево зерен, ленивость мира, паспорт куки, целочисленная случайность, шов торговли, время счетчика); make demo показывает канонический D0 на одном экране, тест-сторож без прибитых чисел; README генератора сжат до прихожей. Проверка: make lint/typecheck/test (430)/demo из generator/; два слепых ревью + перепроверка. Единственный непроверенный локально пункт — рендер mermaid в Gitea: откройте docs/architecture/generator/README.md в файлах ветки и гляньте схему до мерджа.

Closes #48. Набор docs/architecture/generator/ по ADR 0011: индекс с mermaid-схемой цепочки и шесть поддокументов (дерево зерен, ленивость мира, паспорт куки, целочисленная случайность, шов торговли, время счетчика); make demo показывает канонический D0 на одном экране, тест-сторож без прибитых чисел; README генератора сжат до прихожей. Проверка: make lint/typecheck/test (430)/demo из generator/; два слепых ревью + перепроверка. Единственный непроверенный локально пункт — рендер mermaid в Gitea: откройте docs/architecture/generator/README.md в файлах ветки и гляньте схему до мерджа.
ddmitry added 1 commit 2026-08-28 13:00:53 +03:00
- Зачем:
  - спека отвечает «почему», а жанра «как пройти устройство по коду»
    не было (#48); черновик в generator/README.md ждал выверки.
- Что:
  - новый набор docs/architecture/generator/: индекс с целевой картиной
    и mermaid-схемой плюс шесть поддокументов по темам тикета.
  - демо-модуль и цель make demo: канонический D0, все стадии цепочки
    на одном экране; тест-сторож проверяет стадии без прибитых чисел.
  - раздел «Как это работает» в generator/README.md сжат до ссылки
    на путеводитель, черновая врезка снята.
- Проверка:
  - из generator/: make lint, make typecheck, make test (430 passed),
    make demo; два слепых ревью и узкая перепроверка — находки закрыты.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
ddmitry added 1 commit 2026-08-28 13:06:26 +03:00
ddmitry merged commit 9cc3e5ae3b into main 2026-08-28 15:03:37 +03:00
ddmitry deleted branch 48-generator-guide 2026-08-28 15:03:38 +03:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: ddmitry/clickstream-data-platform#179