Dmitry Dementiev
640050e409
- Зачем: - генератор должен переживать рестарт без потери популяции пользователей и коротко прерванных активных визитов. - Что: - добавлен компактный state v2 для популяции, активных визитов и остатка бюджета рождений. - сервис генератора переведён на единый тиковый поток с сохранением и восстановлением состояния. - добавлена безопасная деградация для старого state v1 и битого state v2. - покрыты короткий и долгий простой, reset состояния и валидация вложенного state. - Проверка: - uv run --with-requirements generator/requirements.txt pytest generator/tests -q. - git diff --check.
56 lines
4.3 KiB
Markdown
56 lines
4.3 KiB
Markdown
Status: ready-for-human
|
|
|
|
# Состояние версии 2 и рестарт
|
|
|
|
## What to build
|
|
|
|
Расширить состояние генератора до версии 2: кроме тика и состояния генератора
|
|
случайных чисел сохранять популяцию пользователей и активные визиты. После
|
|
рестарта генератор должен продолжать коротко прерванные визиты и закрывать
|
|
сильно просроченные, не теряя популяцию пользователей.
|
|
|
|
Задача проверяет поведение состояния через публичные методы сохранения и
|
|
восстановления, без реального Kafka-брокера там, где достаточно сериализации.
|
|
|
|
Источник решений: `docs/specs/2026-06-10-generator-math-model.md`, раздел
|
|
«Персистентность через рестарты».
|
|
|
|
## Acceptance criteria
|
|
|
|
- [x] Состояние версии 2 сериализуется в JSON и восстанавливает тик, ГПСЧ,
|
|
популяцию пользователей и активные визиты.
|
|
- [x] Старое состояние версии 1 или битое состояние не валит генератор:
|
|
фиксируется предупреждение, генератор начинает с чистого листа.
|
|
- [x] После простоя не больше 30 минут активный визит продолжается, а созревшие
|
|
события досылаются со своими исходными запланированными метками времени.
|
|
- [x] После долгого простоя просроченный активный визит закрывается без досылки
|
|
остатка.
|
|
- [x] Популяция пользователей переживает простой любой длины.
|
|
- [x] `GEN_STATE_RESET=true` явно сбрасывает состояние, как и раньше.
|
|
|
|
## Blocked by
|
|
|
|
- `.scratch/feature-data-generator/issues/05-intensity-and-flow-calibration.md`
|
|
|
|
## Comments
|
|
|
|
2026-06-11: задачу нельзя считать самостоятельной к реализации, пока не закрыты
|
|
предыдущие срезы генератора: 02 (путь визита и монотонное время), 03 (тики и
|
|
активные визиты), 04 (популяция и возвраты), 05 (интенсивность и калибровка).
|
|
Преждевременный кодовый задел state v2 был откатан, чтобы он не попал в коммиты
|
|
следующих задач. Возвращаться к этой задаче нужно после реализации зависимостей
|
|
и заново проверять все acceptance criteria на актуальной модели генератора.
|
|
|
|
2026-06-11: реализовано состояние версии 2 для `TickStreamGenerator`: в снимок
|
|
попадают тик, ГПСЧ, компактная популяция пользователей, компактные активные
|
|
визиты и остаток бюджета рождений визитов. `GeneratorService` теперь владеет
|
|
одним тиковым потоком, сохраняет его снимок и восстанавливает его при старте.
|
|
Короткий простой продолжает активные визиты и досылает созревшие события с
|
|
исходными метками времени; долгий простой закрывает просроченные визиты без
|
|
досылки остатка; популяция сохраняется.
|
|
|
|
Старое state v1 и битое v2-state деградируют в чистый старт с предупреждением;
|
|
`GEN_STATE_RESET=true` по-прежнему пропускает загрузку состояния. Проверка:
|
|
`uv run --with-requirements generator/requirements.txt pytest generator/tests -q`
|
|
— 112 passed.
|