docs(generator): добавлена мат-спека модели и исправлен профиль сида
- Зачем:
- закрыть Open questions спеки формы доработки перед передачей на
реализацию; адверсариальное ревью показало, что прежние ориентиры
(популяция/паузы/интенсивность) взаимно несовместимы, а документы
опираются на неверный факт о сиде («1..7 событий на визит»).
- Что:
- добавлена docs/specs/2026-06-10-generator-math-model.md: марковская
цепочка по страницам, формула связи «популяция-интенсивность-пауза»
(λ по умолчанию 30/мин), кулдаун возврата, правило 30 минут на рестарт,
критерии приёмки.
- в CONTEXT.md добавлен профиль сид-датасета (полный замер: длины визитов
1..27, медиана 10, конверсия 25%, петли и события после /confirmation)
и исправлено ложное «разброс времени внутри click_id <= 1 мин».
- исправлен факт «1..7 событий» в KNOWN_ISSUES.md и ADR-0004; критерии
Validation спеки формы доработки приведены к фактам сида.
- Проверка:
- перекрёстные ссылки между спеками/ADR/CONTEXT.md открываются; цифры
профиля сида воспроизводятся скриптом подсчёта по полным data/*.jsonl.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Fable 5
parent
bce1ded9c4
commit
6efa031023
+24
-2
@@ -22,8 +22,11 @@
|
||||
`domain_sessionid`). Поэтому в этой модели **сессия ≡ визит ≡ `click_id`** —
|
||||
группа событий под одним идентификатором, а не окно активности по тайм-ауту.
|
||||
Если в будущем понадобится «настоящая» сессия по 30-минутному окну неактивности —
|
||||
это отдельная производная над `user_domain_id` + `event_ts`; на текущих данных
|
||||
она дала бы те же группы (разброс времени внутри `click_id` ≤ 1 мин).
|
||||
это отдельная производная над `user_domain_id` + `event_ts`, и на сиде она дала
|
||||
бы **другие** группы: в полном сиде 11 внутрисессионных пауз превышают 30 минут,
|
||||
а разброс времени внутри `click_id` доходит до 49 минут (см. профиль
|
||||
сид-датасета ниже; ранее здесь ошибочно значилось «разброс ≤ 1 мин» — это был
|
||||
замер по малому срезу файла).
|
||||
|
||||
«Сессию» и «визит» используем как синонимы; в UI предпочитаем «визит», когда важно
|
||||
подчеркнуть, что это не сессия-по-тайм-ауту.
|
||||
@@ -81,6 +84,25 @@ user_domain_id (пользователь, постоянный)
|
||||
усугубляет: он штампует свежий `click_id` на каждое событие, и `click_id`
|
||||
вырождается в «событие». См. `generator/KNOWN_ISSUES.md` на той ветке.
|
||||
|
||||
## Профиль сид-датасета (измерено 2026-06-10, полные файлы)
|
||||
|
||||
Опорные цифры о статическом сиде (`data/*.jsonl`) — для калибровки генератора
|
||||
и проверки гипотез. Измерено по **полным** файлам (1000 событий); внимание:
|
||||
ранние оценки «1..7 событий на визит» делались по малому срезу и неверны.
|
||||
|
||||
- **Объём:** 1000 событий, 99 визитов (`click_id`), 99 пользователей (1:1).
|
||||
- **Длина визита:** 1..27 событий, медиана 10, среднее 10.1.
|
||||
- **Паузы между событиями визита:** медиана ~20 с, p95 ≈ 17 мин,
|
||||
максимум ≈ 40 мин; пауз длиннее 30 минут — 11 штук. Разброс времени внутри
|
||||
одного `click_id` — до 49 минут.
|
||||
- **Воронка:** 25% визитов достигают `/confirmation`. Пути — с петлями:
|
||||
возвраты на `/home`, просмотр обоих товаров; у 21 из 25 «купивших» визитов
|
||||
есть события **после** `/confirmation`, у 9 — `/confirmation` встречается
|
||||
дважды. То есть `/confirmation` — последний *шаг воронки*, но не обязательно
|
||||
последнее *событие визита*.
|
||||
- **Страницы (по событиям):** `/home` 426, `/product_a` 236, `/product_b` 157,
|
||||
`/cart` 93, `/payment` 53, `/confirmation` 35. `event_type` — 100% `pageview`.
|
||||
|
||||
## Слои данных
|
||||
|
||||
`STG → ODS → DDS → DM` — см. [`docs/ARCHITECTURE.md`](./docs/ARCHITECTURE.md).
|
||||
|
||||
Reference in New Issue
Block a user