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
This commit is contained in:
1 parent
86ad8afaf2
commit
59d8c83b17
54 files changed
+794
-776
No files matched your search
@@ -1,7 +1,7 @@
|
||||
"""Проверка описи мира: та ли она, что собирается из кода сегодня.
|
||||
"""Проверка паспорта мира: совпадает ли он с тем, что собирается из кода сегодня.
|
||||
|
||||
Опись собирается из кода, значит разойтись они могут только одним способом —
|
||||
код правили, опись не пересобрали. Ровно это здесь и сторожится, тем же
|
||||
Паспорт собирается из кода, значит разойтись они могут только одним способом —
|
||||
код правили, паспорт не пересобрали. Ровно это здесь и сторожится, тем же
|
||||
способом, что свежесть «описания выгрузки».
|
||||
|
||||
Проверка дорогая — она пересчитывает восемь модельных дней целиком, и это
|
||||
@@ -23,24 +23,24 @@ from clickstream_generator.seeds import CANONICAL_SEED
|
||||
|
||||
INVENTORY_PATH = Path(__file__).resolve().parents[2] / "data" / "world-inventory.json"
|
||||
|
||||
# Прогон, слепок которого сверяется с описью байт в байт. День любой из
|
||||
# Прогон, слепок которого сверяется с паспортом байт в байт. День любой из
|
||||
# отправляемых; этот дешевле прочих — его окно короче.
|
||||
RUN_DAY = 2
|
||||
|
||||
# День любой: хеш дня не зависит ни от соседей, ни от края описи.
|
||||
# День любой: хеш дня не зависит ни от соседей, ни от края паспорта.
|
||||
REPLAY_DAY = 4
|
||||
|
||||
|
||||
@pytest.fixture(scope="module")
|
||||
def inventory() -> dict:
|
||||
"""Опись, собранная из кода: мир пересчитывается один раз на весь модуль."""
|
||||
"""Паспорт, собранный из кода: мир пересчитывается один раз на весь модуль."""
|
||||
return build()
|
||||
|
||||
|
||||
def test_inventory_is_up_to_date(inventory: dict):
|
||||
stored = json.loads(INVENTORY_PATH.read_text(encoding="utf-8"))
|
||||
assert stored == inventory, (
|
||||
"опись мира отстала от кода — пересоберите: make inventory."
|
||||
"паспорт мира отстал от кода — пересоберите: make inventory."
|
||||
" Разошлись хеши дней и каталога — правили data/catalog/products.csv;"
|
||||
" разошлись только дни — правили генератор"
|
||||
)
|
||||
@@ -68,7 +68,7 @@ def test_the_inventory_holds_the_hash_of_every_sent_snapshot(inventory: dict, tm
|
||||
"""У каждого отправленного слепка — своя строка с хешем его байтов.
|
||||
|
||||
Байты слепка не покрыты хешами дней ни при каком раскладе подпотоков: это
|
||||
второй артефакт мира, и побайтовое обещание сторожит опись. Слепков на день
|
||||
второй артефакт мира, и побайтовое обещание сторожит паспорт. Слепков на день
|
||||
меньше, чем дней: прогон дня 0 не отправляет ничего.
|
||||
|
||||
Хеш сверяется с настоящей выгрузкой, а не с самим собой: в файл уезжают те
|
||||
@@ -86,7 +86,7 @@ def test_the_inventory_holds_the_hash_of_every_sent_snapshot(inventory: dict, tm
|
||||
|
||||
|
||||
def test_a_replayed_day_matches_its_inventory_hash(tmp_path):
|
||||
"""Опись сверяется с байтами, вышедшими из CLI, а не с собранной тут же:
|
||||
"""Паспорт сверяется с байтами, вышедшими из CLI, а не с собранной тут же:
|
||||
пересчет сравнивался бы сам с собой.
|
||||
"""
|
||||
stored = json.loads(INVENTORY_PATH.read_text(encoding="utf-8"))
|
||||
|
||||
Reference in new issue
Block a user