Files
clickstream-data-platform/docs/architecture/orders/inventory.md
T
ddadminandClaude Fable 5.1 59d8c83b17 docs(glossary): четыре термина переименованы, world.md и stand.md вычитаны
- Зачем:
  - справочники читает человек со стороны, а «пульт мира», «опись мира»,
    «работник» и «сырьё» звучали шуткой или калькой времён разработки
    (тикет #214, выбор владельца).
- Что:
  - CONTEXT.md: статьи «Паспорт мира», «Даги модельного времени»,
    «Шаговый даг», «Сырые данные», старые слова в строках «Избегать»;
    пометки в ADR 0005, 0008, 0009 без переписывания решений.
  - замены по README, справочникам, путеводителю, лабам, спекам,
    комментариям дагов и SQL, тегу дага и панели Grafana; имена в коде
    не тронуты.
  - world.md и stand.md: 35 находок вычитки внесены, регистр выровнен.
- Проверка:
  - make config-test; make lint в корне и в generator/; make test в
    generator/ (437 passed); скрипт ссылок из #212 пуст; grep старых
    слов вне ADR, research и CONTEXT.md пуст.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014QBCtU38qSHg5DvgtnKXcW
2026-09-02 16:46:50 +03:00

2.9 KiB

Что хранит паспорт мира

Резолюции развилок «Расхождения A–D и опоздания: механика, доли и что обещано» и «Места заказов в стартовом мире». Термины паспорта — «растяжка-хеш» и «опора-счётчик» — заданы разделом «Чем меряется генератор» в спеке генератора и статьёй «Паспорт мира» в CONTEXT.md.

Паспорт хранит только то, чего движение мира не меняет. Хеш кладём всегда, счётчик — только когда назван его читатель.

  • У каждого отправленного слепка — своя строка с хешем байтов. Байты слепка не покрыты хешами дней ни при каком раскладе подпотоков — это второй артефакт мира. Побайтовое обещание («слепок переснимается и даёт те же байты») паспорт начинает сторожить.
  • Счётчики классов расхождений — наблюдаемых, после приоритета, по итоговой судьбе заказов дня. В строке закрытого дня поле orders хранит число заказов каждого класса; пока окно открыто, поля нет. При N сыгранных днях закрыты N − 7 (день d закрывается слепком d + 6, а последний отправленный слепок несёт день N − 2). Их читатель — техническая проверка classes_vs_inventory из DQ-звена этапа 4.
  • Контрольные числа идентичности не заводятся вовсе: uniq известных пользователей и число двухкуковых пар растут, пока мир едет, — опоры из них не выходит; генератор сторожит хеш, транспорт — счёт событий.
  • Паспорт описывает мир, а не доставку. Работа генератора кончается на Kafka: дошли ли байты до ods.order — вопрос стенда и его проверок. Поэтому счёта строк у слепка в паспорте нет; понадобится проверка приёма заказов — число заведётся вместе с ней.