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` — без замечаний.