docs(generator): заморожена спека этапа 2, решения — в ADR 0015-0017
- Зачем:
- спека разрослась до 1058 строк, а журнал решений в разделе 9 читался
только целиком; агентам и людям нужен дешевый адресный заход к
основаниям решений генератора.
- Что:
- заведены ADR 0015 (пояс счетчика), 0016 (паспорт куки) и 0017 (номер
заказа); четыре адресные ссылки на «раздел 9» перешиты на них.
- раздел 9 пересобран в 11 тематических подразделов с датами и тикетами
у каждого решения и закрыт пометкой о заморозке; устаревшие
промежуточные замеры свернуты до указателей на актуальные.
- строка статуса в шапке отмечает закрытие спеки как документа этапа 2.
- Проверка:
- wc -l docs/specs/2026-08-01-generator.md (951, было 1058);
rg -n 'раздел[а-яё]* 9|разделы 8 и 9' docs -g '*.md' — 18 попаданий,
все классифицированы; разделы 1-8 нетронуты (сверка хешем).
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
1 parent
74061aa499
commit
6f18e9989c
9 files changed
+522
-526
No files matched your search
@@ -50,6 +50,10 @@ make demo
|
||||
Устройство генератора и основания решений записаны в [спеке этапа
|
||||
2](../../specs/2026-08-01-generator.md), а границы двух источников и склейки —
|
||||
в [мастер-спеке стенда](../../specs/2026-07-30-stand-v2-realism.md).
|
||||
Основания трех решений записаны в
|
||||
[ADR 0015](../../adr/0015-counter-timezone.md),
|
||||
[ADR 0016](../../adr/0016-cookie-passport.md) и
|
||||
[ADR 0017](../../adr/0017-order-numbering.md), а спека этапа 2 закрыта.
|
||||
Путеводитель появился по тикету
|
||||
[#48](https://git.dementev.space/ddmitry/clickstream-data-platform/issues/48):
|
||||
он отвечает на другой вопрос — как пройти принятое устройство по коду.
|
||||
@@ -23,7 +23,7 @@
|
||||
сохраняет его на всю жизнь.
|
||||
|
||||
Броски паспорта стоят после прежнего состава когорты. Правило такого
|
||||
продолжения подпотока описано в [дереве зерен](seeds.md), а основания выбора
|
||||
самого паспорта — в [спеке генератора](../../specs/2026-08-01-generator.md),
|
||||
раздел 9. Зачем стенду нужна двухкуковая пара одного человека, фиксирует
|
||||
продолжения подпотока описано в [дереве зерен](seeds.md), а выбор
|
||||
паспорта объясняет [ADR 0016](../../adr/0016-cookie-passport.md). Зачем стенду
|
||||
нужна двухкуковая пара одного человека, фиксирует
|
||||
[мастер-спека](../../specs/2026-07-30-stand-v2-realism.md), раздел 5.
|
||||
@@ -36,5 +36,5 @@
|
||||
Как часовой пояс меняет представление времени в ClickHouse, описано в разделе
|
||||
«Часовые пояса» [документа о хранилище](../storage.md). Типы и публичный смысл
|
||||
полей записаны в [описании события](../../formats/clickstream-event.md).
|
||||
Основание модели времени записано в [спеке
|
||||
генератора](../../specs/2026-08-01-generator.md), раздел 9.
|
||||
Выбор модели времени объясняет
|
||||
[ADR 0015](../../adr/0015-counter-timezone.md).
|
||||
@@ -18,9 +18,10 @@
|
||||
в трекере — не отдельная порода, а класс B, и делает его событийная сторона
|
||||
выбрасыванием события после присвоения номера
|
||||
([классы расхождений](fate.md));
|
||||
- номер заказа общий у обеих проекций: `order_id` = клиентский `purchaseID`,
|
||||
читаемый номер «день и порядковый номер покупки» ([спека
|
||||
генератора](../../specs/2026-08-01-generator.md), раздел 9); нумеруются все
|
||||
- обе проекции используют один номер заказа: `order_id` = клиентский
|
||||
`purchaseID`;
|
||||
читаемый номер «день и порядковый номер покупки» описан в
|
||||
[ADR 0017](../../adr/0017-order-numbering.md); нумеруются все
|
||||
покупки, дошедшие до потока дня, — до всяких потерь;
|
||||
- скидка заказа выводится из промокода события по таблице «код → скидка» —
|
||||
числу мира, которое этап 3 берёт готовым (спека генератора, разделы 8 и 9).
|
||||
|
||||
@@ -296,7 +296,7 @@ UTC+4), и пересчёт идёт один раз при наполнении
|
||||
**День берётся из `EventDate`.** Дата в поясе счётчика уже посчитана
|
||||
генератором и лежит колонкой, так что суточные срезы группируются по ней и
|
||||
пояса не упоминают вовсе. Почему у ночных событий `toDate(UTCEventTime)` с ней
|
||||
расходится — [спека генератора](../specs/2026-08-01-generator.md), раздел 9.
|
||||
расходится, объясняет [ADR 0015](../adr/0015-counter-timezone.md).
|
||||
|
||||
## Путь реплицированных таблиц в keeper
|
||||
|
||||
|
||||
Reference in new issue
Block a user