docs(handbook): четыре главы переписаны живым русским
Зачем: владелец прочел главы и нашел неестественные фразы: дашборды «спрашивают», даги «двигают ось», заказ «ездит в слепках», Superset — «витрины глазами», объекты «приезжают из файлов». Читателю такие образы надо расшифровывать, а урок в них не прячется. Что: в четырех главах олицетворения заменены прямыми формулировками, «позиция мира» и «шаговый даг» раскрыты через world_position и имена дагов, паспорт мира описан по составу и назначению, окно слепка заказов объяснено словами, режимы генератора и правило импорта Superset сказаны прямо. Тире и стрелки оставлены: это домашний стиль. Проверка: проверки тикета #220 на битые ссылки и запретные слова пусты, строки прозы не длиннее 80 знаков, git diff --check чист. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
1 parent
ac21399fe4
commit
043d1c1382
4 files changed
+110
-93
No files matched your search
+24
-19
@@ -1,8 +1,8 @@
|
||||
# Генератор: откуда берутся данные
|
||||
|
||||
Генератор притворяется двумя системами магазина. Счетчик сайта шлет события в
|
||||
топик `hits`. Бэкенд раз в модельные сутки выгружает слепок заказов в топик
|
||||
`orders`.
|
||||
Генератор изображает две системы интернет-магазина. Первая — счетчик на сайте,
|
||||
он шлет события в топик `hits`. Вторая — бэкенд магазина, он раз в модельные
|
||||
сутки выгружает слепок заказов в топик `orders`.
|
||||
|
||||
## Что он производит
|
||||
|
||||
@@ -10,19 +10,23 @@
|
||||
три вида событий: просмотр страницы, корзину и покупку. Все колонки перечислены
|
||||
в [описании выгрузки](../formats/clickstream-event.md).
|
||||
|
||||
Заказ — вторая проекция той же покупки, с деньгами магазина. Заказ ездит в
|
||||
слепках, пока может измениться, — семь модельных дней. Устройство и форму слепка
|
||||
разбирает [отдельный справочник](../architecture/orders/snapshot.md).
|
||||
Заказ — та же покупка, но записанная бэкендом магазина, с суммами в деньгах.
|
||||
Семь модельных дней после оформления заказ еще может измениться, поэтому каждый
|
||||
дневной слепок несет заказы за последние семь дней в их текущем состоянии.
|
||||
Устройство и форма слепка разобраны в [отдельном
|
||||
справочнике](../architecture/orders/snapshot.md).
|
||||
|
||||
## Почему данные всегда одни и те же
|
||||
|
||||
Модельный день зависит от [зерна](../architecture/generator/seeds.md) — числа,
|
||||
из которого генератор разворачивает всю свою случайность, — и от номера дня.
|
||||
Одна и та же пара дает те же события, поэтому стартовый мир одинаков при каждом
|
||||
`make up`.
|
||||
Генератор не берет случайность извне. Все его случайные решения выводятся из
|
||||
[зерна](../architecture/generator/seeds.md) — одного числа в настройках — и из
|
||||
номера дня. То же зерно и тот же номер дня дают ровно те же события, поэтому
|
||||
стартовый мир одинаков при каждом `make up`.
|
||||
|
||||
Паспорт `data/world-inventory.json` отвечает на один вопрос: тот ли это мир. Он
|
||||
охватывает только восемь дней стартового мира.
|
||||
Рядом лежит паспорт мира, `data/world-inventory.json`: зерно, версия генератора
|
||||
и по строке на каждый день с числом событий и контрольной суммой. По нему
|
||||
проверяют, что генератор собрал тот же мир, что и раньше, и что в ODS все
|
||||
доехало без потерь. Паспорт описывает только восемь дней стартового мира.
|
||||
|
||||
## Кто его запускает
|
||||
|
||||
@@ -30,8 +34,9 @@
|
||||
времени](airflow-dags.md#даги-мира). Его можно запустить и напрямую. Команды
|
||||
собраны в [справочнике мира](../architecture/world.md#как-запустить-генератор).
|
||||
|
||||
У генератора два режима. Пакетный отправляет день пачкой. Живой проигрывает
|
||||
модельные сутки в ускоренном темпе.
|
||||
У генератора два режима. Пакетный отправляет весь день разом. Живой шлет
|
||||
события по ходу модельных суток; сутки идут ускоренно и занимают около двадцати
|
||||
четырех минут.
|
||||
|
||||
## Посмотрите сами
|
||||
|
||||
@@ -47,11 +52,11 @@ ORDER BY EventDate;
|
||||
|
||||
Сравните первые восемь дней с восемью строками в [паспорте
|
||||
мира](../../data/world-inventory.json): числа совпадут. Дни, сыгранные после
|
||||
стартового мира, в паспорте не записаны. Это ожидаемо.
|
||||
стартового мира, в паспорте не записаны. Так и задумано.
|
||||
|
||||
## Куда дальше
|
||||
|
||||
Глубже генератор разобран в [`generator/`](../../generator/README.md) и в
|
||||
[справочнике его устройства](../architecture/generator/README.md). Тропа
|
||||
путеводителя закончена: дальше идут справочники и [учебные
|
||||
задания](../labs/README.md).
|
||||
Подробнее генератор разобран в [README папки
|
||||
`generator/`](../../generator/README.md) и в [справочнике его
|
||||
устройства](../architecture/generator/README.md). На этом путеводитель
|
||||
заканчивается: дальше справочники и [учебные задания](../labs/README.md).
|
||||
Reference in new issue
Block a user