Dmitry Dementiev
6c4e0f4d16
- Зачем: - после калибровки потока и state v2 генератор нужно принять как рабочий steady-stream источник, а не как исторически сломанный прототип. - Что: - добавлен сервисный тест multi-event визита с мок-публикацией во все четыре Kafka-топика. - compose позволяет переопределять демо-параметры генератора без правки файла, сохраняя внутренние контейнерные адреса. - README, OPERATIONS, KNOWN_ISSUES и карточка задачи синхронизированы с новой моделью и state v2. - Проверка: - uv run --with-requirements generator/requirements.txt pytest generator/tests -q. - git diff --check. - GEN_STATE_RESET=true GEN_POPULATION_MAX=123 docker compose config.
53 lines
3.6 KiB
Markdown
53 lines
3.6 KiB
Markdown
Status: ready-for-human
|
|
|
|
# Подключение к сервису и документации
|
|
|
|
## 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
|
|
|
|
- [x] Генератор в режиме steady-stream пишет связанные сообщения в
|
|
`browser_events`, `location_events`, `device_events`, `geo_events`.
|
|
- [x] Существующие команды запуска и остановки генератора остаются рабочими или
|
|
документация явно описывает замену.
|
|
- [x] Метрики Prometheus продолжают показывать успешные тики, ошибки публикации
|
|
и объём отправленных событий.
|
|
- [x] Интеграционный тест или проверка с мок-публикацией подтверждает, что
|
|
сервисный контур использует новую модель, а не старую плоскую генерацию.
|
|
- [x] `generator/README.md` описывает новые параметры и новую модель без старых
|
|
предупреждений о сломанном `click_id`.
|
|
- [x] `generator/KNOWN_ISSUES.md` обновлён: старый дефект закрыт или перенесён в
|
|
исторический раздел, не как актуальный блокер.
|
|
|
|
## Blocked by
|
|
|
|
- `.scratch/feature-data-generator/issues/06-state-v2-and-restart.md`
|
|
|
|
## Comments
|
|
|
|
- 2026-06-11: добавлена проверка сервисных тиков с мок-публикацией без Kafka:
|
|
steady-stream публикует несколько событий одного визита с общим `click_id`,
|
|
разными `event_id` и согласованными записями во всех четырёх топиках; история
|
|
тиков остаётся `success`.
|
|
- 2026-06-11: `docker-compose.yml` теперь пробрасывает переменные генератора
|
|
через `${VAR:-default}`, поэтому команды вида `GEN_STATE_RESET=true docker
|
|
compose up -d generator` реально меняют окружение контейнера. Внутренние
|
|
`KAFKA_BOOTSTRAP_SERVERS` и `GEN_DATA_DIR` оставлены безопасными значениями
|
|
для контейнера.
|
|
- 2026-06-11: `generator/README.md` и `generator/KNOWN_ISSUES.md` синхронизированы
|
|
с новой моделью, состоянием v2 и историческим статусом старого дефекта.
|
|
- Проверка: `uv run --with-requirements generator/requirements.txt pytest
|
|
generator/tests -q` — 113 passed; `git diff --check` — без замечаний.
|