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,6 +1,6 @@
|
||||
-- STG: чтецы топиков hits и orders, таблицы сырья обоих источников.
|
||||
-- STG: чтецы топиков hits и orders, таблицы STG обоих источников.
|
||||
--
|
||||
-- Слой сырья ничего не интерпретирует: сообщение ложится строкой, как пришло,
|
||||
-- Сырой слой ничего не интерпретирует: сообщение ложится строкой, как пришло,
|
||||
-- рядом с метаданными доставки. Довод целиком — ADR 0005, конвенции колонок и
|
||||
-- сроков — docs/architecture/storage.md.
|
||||
|
||||
@@ -30,9 +30,9 @@ SETTINGS
|
||||
kafka_group_name = 'clickstream_hits',
|
||||
kafka_format = 'RawBLOB';
|
||||
|
||||
-- Локальная таблица сырья.
|
||||
-- Локальная таблица STG.
|
||||
--
|
||||
-- Движок именно ReplicatedMergeTree, не Replacing: повтор доставки в сырье
|
||||
-- Движок именно ReplicatedMergeTree, не Replacing: повтор доставки в STG
|
||||
-- обязан быть виден — ради этого слой и заведён.
|
||||
--
|
||||
-- Служебные колонки не повторяют имён виртуальных (_topic, _partition,
|
||||
@@ -45,7 +45,7 @@ SETTINGS
|
||||
-- колонки _timestamp_ms, а не из _timestamp. Измерено на стенде 5 августа
|
||||
-- 2026 года: _timestamp — Nullable(DateTime), то есть секунды; _timestamp_ms —
|
||||
-- Nullable(DateTime64(3)). Взяты миллисекунды: у брокера метка миллисекундная,
|
||||
-- _load_ts рядом тоже миллисекундная, а слой сырья хранит то, что приехало, и
|
||||
-- _load_ts рядом тоже миллисекундная, а сырой слой хранит то, что приехало, и
|
||||
-- округлять ему нечего. Обнуляемость обязательна: метку брокер заполняет не
|
||||
-- всегда, а необнуляемый тип дал бы либо падение приёма, либо тихий 1970 год.
|
||||
--
|
||||
@@ -115,8 +115,8 @@ SETTINGS
|
||||
kafka_format = 'RawBLOB',
|
||||
kafka_commit_on_select = 1;
|
||||
|
||||
-- Локальная таблица сырья заказов. Колонки, типы, ключ, нарезка и срок жизни —
|
||||
-- те же, что у сырья событий, и по тем же доводам: docs/architecture/storage.md.
|
||||
-- Локальная таблица STG заказов. Колонки, типы, ключ, нарезка и срок жизни —
|
||||
-- те же, что у STG событий, и по тем же доводам: docs/architecture/storage.md.
|
||||
--
|
||||
-- Своя колонка здесь одна — _load_id, идентификатор пачки загрузки: он равен
|
||||
-- run_id прогона Airflow, который забрал порцию, и по нему разбор в ODS читает
|
||||
|
||||
Reference in new issue
Block a user