Dmitry Dementiev
8046e543d0
- Зачем:
- спека «Боевой реализм стенда» исполняется в новом репозитории:
предшественник замораживается как стабильный учебный стенд,
v2 стартует пустым и переносит только нужное
- Что:
- README: что это, статус «строится по спеке», ссылки на спеку и на
репозиторий-предшественник
- AGENTS.md написан заново, а не скопирован: язык, uv, обязательная
проверка API через MCP Context7, контракт трекера Gitea (спека —
источник истины, корневой issue тонкий), метки триажа, новые доки в docs/
- .gitignore: Python и uv, .env, секреты, IDE, логи
- docs/specs/2026-07-30-stand-v2-realism.md перенесена из v1; содержание
не менялось, поправлены только ссылки: добавлена строка о переезде,
ссылка на generator-realism.md переведена на абсолютный URL v1
- docs/research/2026-07-26-yandex-clickstream-format.md перенесено:
источник истины по формату широкого события
- лицензии у предшественника нет, переносить нечего
- Проверка:
- git show --stat: 5 файлов
- относительные ссылки спеки ведут на существующие файлы репозитория
37 lines
2.4 KiB
Markdown
37 lines
2.4 KiB
Markdown
# Учебная дата-платформа кликстрима
|
|
|
|
Стенд для работы с кликстримом: Kafka, кластер ClickHouse (2 шарда и
|
|
clickhouse-keeper), Airflow, Superset. Преемник учебного стенда
|
|
[clickstream-ch-kafka-superset-demo](https://git.dementev.space/ddmitry/clickstream-ch-kafka-superset-demo).
|
|
|
|
## Статус
|
|
|
|
Репозиторий строится по спеке
|
|
[«Боевой реализм стенда (v2)»](docs/specs/2026-07-30-stand-v2-realism.md).
|
|
Работающего стенда пока нет: здесь только спека, исследование формата данных и
|
|
контракт работы ([AGENTS.md](AGENTS.md)). Быстрый старт появится вместе с
|
|
этапом «Каркас стенда».
|
|
|
|
## Что здесь будет
|
|
|
|
- одно широкое событие кликстрима по образцу выгрузки Яндекс Метрики вместо
|
|
четырёх топиков;
|
|
- второй источник — заказы бэкенда, ежедневным слепком в ту же Kafka;
|
|
- сверка клиентской покупки с заказом бэкенда: деньги считаем по бэкенду,
|
|
поведение и атрибуцию — по трекеру;
|
|
- анонимный кликстрим и склейка кука↔пользователь через покупки;
|
|
- ClickHouse кластером как единственным режимом.
|
|
|
|
## Чем отличается от предшественника
|
|
|
|
Предшественник остаётся стабильным учебным стендом и заморожен для новых фич:
|
|
там событие разрезано на четыре топика, есть только просмотры страниц,
|
|
посетители опознаны по email, ClickHouse — одна нода. Развитие идёт здесь.
|
|
|
|
## Документация
|
|
|
|
- [docs/specs/](docs/specs/) — спеки: источник истины о задуманном.
|
|
- [docs/research/](docs/research/) — исследования; сейчас это формат
|
|
кликстрима Яндекса, по которому строится модель события.
|
|
- [AGENTS.md](AGENTS.md) — контракт работы в репозитории.
|