feat(generator): заказы дня — проекция покупок с деньгами магазина

- Зачем:
  - тикет #90: второй источник должен смотреть на торговую половину дня
    глазами бэкенда — заказ есть проекция покупки, а не второе порождение;
    учебный результат — два источника согласованы по построению, а не
    сверкой.
- Что:
  - `commerce` отдаёт вторым выходом покупки дня: номер заказа, корзину,
    выручку клиента, промокод и человека за кукой; новых бросков в
    подпоток `COMMERCE` не добавилось, события дня не сдвинулись.
  - заведена заказная сторона: подпоток `ORDERS` на позиции 2 дерева зерна
    (прежнее мёртвое имя `DISCREPANCIES`), ветвление — по дню рождения
    заказа; `LATECOMERS` не тронут, его наполнит этап 6.
  - новый модуль `orders.py`: деньги заказа целыми копейками —
    `items_total` из корзины, `discount` по таблице «код → скидка»
    (округление вниз), `delivery` броском по таблице весов на полную длину
    дня, `total` = `items_total` − `discount` + `delivery`.
  - план состава завёл `person_id` — последним броском когорты, после
    паспортов: вторая кука пары повторяет ID своего человека, заказ
    показывает его как `user_id`, в событие Метрики он не попадает.
  - `world`: окно изменяемости `ORDER_WINDOW_DAYS` = 7 рядом с D0 и поясом,
    черновая таблица стоимости доставки.
  - слепок дня в тестах сторожит обе половины: заказы сравниваются наравне
    с потоком событий.
  - доки: имя подпотока заказной стороны и состав денег заказа записаны в
    `docs/architecture/orders`, README генератора знает про новый модуль.
- Проверка:
  - из `generator/`: make lint, make typecheck, make test (417 тестов);
    в корне — make lint.
  - опись мира не покраснела: байты восьми дней те же, заказная сторона
    события не сдвинула.

Closes #90

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-18 12:30:13 +03:00
co-authored by Claude Opus 5
parent 716eafe865
commit b2fcc7e593
14 changed files with 650 additions and 52 deletions
+29
View File
@@ -43,6 +43,7 @@ def same_cohort(left: plan.Cohort, right: plan.Cohort) -> bool:
and np.array_equal(left.pair_order_days, right.pair_order_days)
and np.array_equal(left.device, right.device)
and np.array_equal(left.city, right.city)
and np.array_equal(left.person_id, right.person_id)
)
@@ -175,6 +176,33 @@ def test_the_passport_of_a_pair_is_one_person_with_two_devices():
assert np.all(phone[cohort.device[first]] != phone[cohort.device[second]])
def test_two_cookies_of_a_pair_are_one_person():
"""Мост к склейке: у пары один `person_id`, у остальных — свой.
Значение непрозрачное и живёт ниже 2^53, как `ClientID`: выше JSON
округляет при разборе, а заказ повезёт его числом.
"""
cohort = plan.cohort(CANONICAL_SEED, 0)
first, second = cohort.pair_cookies[:, 0], cohort.pair_cookies[:, 1]
assert cohort.pairs > 0
assert np.array_equal(cohort.person_id[first], cohort.person_id[second])
# Люди когорты — это первые куки: у них личность своя у каждого, а всего
# разных личностей в когорте ровно столько, сколько людей.
people = cohort.person_id[: cohort.people]
assert len(set(people.tolist())) == cohort.people
assert len(set(cohort.person_id.tolist())) == cohort.people
assert cohort.person_id.min() > 0
assert cohort.person_id.max() < 2**53
def test_the_day_audience_knows_the_person_behind_a_cookie():
"""День спрашивает личность у плана — больше её знать неоткуда."""
audience = plan.audience(CANONICAL_SEED, 5)
assert audience.person_id.size == audience.client_id.size
assert np.all(audience.person_id > 0)
def test_the_passport_points_into_the_directories():
cohort = plan.cohort(CANONICAL_SEED, 0)
for passport, table in (
@@ -278,5 +306,6 @@ def test_plan_arrays_are_whole_numbers():
cohort.active_day,
cohort.pair_cookies,
cohort.pair_order_days,
cohort.person_id,
):
assert np.issubdtype(array.dtype, np.integer)