ddmitry/clickstream-ch-kafka-superset-demo
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

docs(generator): уточнена мат-спека по итогам ревью, handoff для передачи

Browse Source 
- Зачем:
  - повторное адверсариальное ревью нашло ошибку в формуле межсессионной
    паузы (двойной счёт кулдауна) и незакрытый контракт публикации
    device/geo; дизайн-этап завершён, работа передаётся исполнителю.
- Что:
  - исправлена формула паузы (баланс цикла, минус длительность визита);
    зафиксированы каденция device/geo «на каждое событие, как в сиде»,
    правило выбора возвращающегося, стартовое распределение страниц,
    калибровка по медиане и среднему, инвариант потолков конфигурации,
    компактное хранение профиля ссылкой на сид-сессию.
  - уточнены критерии приёмки (среднее паузы вместо медианы, счёт шага
    «товары», имена полей времени) в обеих спеках.
  - добавлен handoff .scratch/handoffs/2026-06-10-generator-spec-to-codex.md
    (передача на детальный план/реализацию), отработавший handoff от
    2026-06-09 удалён.
- Проверка:
  - цифры спеки сверены замерами по полным data/*.jsonl (стартовые страницы
    58/24/17, шаги воронки 98>=94>=56>=35>=25, device 1000 строк / 99
    уникальных); повторное ревью свежим агентом блокеров не оставило.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Dmitry Dementiev
2026-06-10 18:02:57 +03:00
co-authored by Claude Fable 5
parent 0b5fc64f6f
commit bcca8f5127
4 changed files with 123 additions and 81 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/specs/2026-06-09-generator-rework-hierarchical.md
+4 -3
View File
@@ -138,9 +138,10 @@
- `uniqExact(user_domain_id) < uniqExact(click_id) < count(event_id)` —
пирамида не вырождена (есть возвраты и мультисобытийные сессии).
- У `click_id` с несколькими событиями `event_ts` строго **возрастает**;
мультисобытийные визиты составляют заметную долю потока (одностраничные
визиты-отказы допустимы и правдоподобны).
- У `click_id` с несколькими событиями время строго **возрастает**
(`event_timestamp` в источнике, `event_ts` в DDS — проверять можно в любой
точке); мультисобытийные визиты составляют заметную долю потока
(одностраничные визиты-отказы допустимы и правдоподобны).
- Один `click_id` принадлежит ровно одному `user_domain_id`; у пользователя
бывает несколько `click_id`.
- Воронка по `page_url_path` затухает от шага к шагу; доля визитов, доходящих