Files
clickstream-ch-kafka-supers…/.scratch/feature-data-generator/issues/07-service-integration-and-docs.md
T
Dmitry Dementiev f0370cdb90 docs(generator): добавлены задачи реализации и handoff
- Зачем:
  - переработку steady-stream генератора нужно передать агентам как набор
    проверяемых вертикальных задач, а не как один крупный rewrite.
- Что:
  - создан локальный набор из семи ready-for-agent задач для реализации новой
    иерархической модели генератора.
  - добавлен handoff с текущим состоянием обсуждения, рекомендуемым следующим
    шагом через TDD и примером команды /goal для запуска задачи 01.
- Проверка:
  - git diff HEAD~1 --stat.
2026-06-11 10:48:37 +03:00

40 lines
2.3 KiB
Markdown

Status: ready-for-agent
# Подключение к сервису и документации
## What to build
Подключить новое генеративное ядро к рабочему steady-stream сервису. Генератор
должен запускаться прежними командами, писать сообщения в прежние Kafka-топики,
сохранять полезные метрики Prometheus и больше не документироваться как
концептуально сломанный источник.
На этом шаге нужно синхронизировать пользовательскую документацию и заметку об
известных проблемах с новой моделью.
Источник решений: `docs/specs/2026-06-09-generator-rework-hierarchical.md`,
`docs/specs/2026-06-10-generator-math-model.md`, `generator/README.md`,
`generator/KNOWN_ISSUES.md`.
## Acceptance criteria
- [ ] Генератор в режиме steady-stream пишет связанные сообщения в
`browser_events`, `location_events`, `device_events`, `geo_events`.
- [ ] Существующие команды запуска и остановки генератора остаются рабочими или
документация явно описывает замену.
- [ ] Метрики Prometheus продолжают показывать успешные тики, ошибки публикации
и объём отправленных событий.
- [ ] Интеграционный тест или проверка с мок-публикацией подтверждает, что
сервисный контур использует новую модель, а не старую плоскую генерацию.
- [ ] `generator/README.md` описывает новые параметры и новую модель без старых
предупреждений о сломанном `click_id`.
- [ ] `generator/KNOWN_ISSUES.md` обновлён: старый дефект закрыт или перенесён в
исторический раздел, не как актуальный блокер.
## Blocked by
- `.scratch/feature-data-generator/issues/06-state-v2-and-restart.md`
## Comments