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
+12
-12
@@ -37,13 +37,13 @@ world_next_day ─────> источники без ETL
|
||||
- **Живой день.** `world_live_day` дёргает конвейер с ожиданием — последним
|
||||
шагом, после установки позиции. Порядок несёт смысл: день сыгран — факт,
|
||||
упавшая трансформация его не отменяет, поэтому позиция ставится раньше; но
|
||||
зеленеть, не узнав, разложился ли день, работник не должен
|
||||
([ADR 0003](../adr/0003-dag-run-state.md)).
|
||||
Такой отказ чинится перезапуском `etl_pipeline` рукой — перезапуску ничего
|
||||
не нужно помнить, см. «Объём прогона».
|
||||
- **Разгон пачкой.** `world_next_day` конвейер не дёргает: пульт управляет
|
||||
генератором и только им. После разгона менти запускает конвейер сам —
|
||||
и видит, как слои догоняют уехавший вперёд мир.
|
||||
зеленеть, не узнав, разложился ли день, шаговый даг не должен ([ADR
|
||||
0003](../adr/0003-dag-run-state.md)). Такой отказ чинится перезапуском
|
||||
`etl_pipeline` рукой — перезапуску ничего не нужно помнить, см. «Объём
|
||||
прогона».
|
||||
- **Разгон пачкой.** `world_next_day` конвейер не дёргает: даги модельного
|
||||
времени управляют генератором и только им. После разгона менти запускает
|
||||
конвейер сам — и видит, как слои догоняют уехавший вперёд мир.
|
||||
- **Рождение мира.** `world_initialize` дёргает конвейер последним шагом:
|
||||
`make up` отдаёт стенд с собранными слоями, а не пустые витрины. Уроки
|
||||
ручного запуска начинаются со следующих дней.
|
||||
@@ -145,9 +145,9 @@ ODS и ещё не собранный в DDS, затем при необходи
|
||||
|
||||
## Отклонённые варианты
|
||||
|
||||
- **Задачи трансформаций прямо в работниках пульта.** Один зелёный прогон —
|
||||
весь день, но пульт — про ось времени: работников два, шаги дублировались
|
||||
бы, а этапу 5 пришлось бы выдирать их обратно.
|
||||
- **Задачи трансформаций прямо в шаговых дагах.** Один зелёный прогон —
|
||||
весь день, но даги времени отвечают за ось времени: шаговых дагов два, шаги
|
||||
дублировались бы, а этапу 5 пришлось бы выдирать их обратно.
|
||||
- **Make-цель или SQL рукой при приёмке.** Второй оркестратор рядом с
|
||||
Airflow — против [ADR 0013](../adr/0013-world-lifecycle.md), — а в живом
|
||||
режиме слои копили бы отставание молча.
|
||||
@@ -163,8 +163,8 @@ ODS и ещё не собранный в DDS, затем при необходи
|
||||
|
||||
- [ADR 0003](../adr/0003-dag-run-state.md) — зелёный конец графа не
|
||||
переживает отказ выше: отсюда ожидания в триггерах.
|
||||
- [ADR 0009](../adr/0009-world-control.md) — пульт мира: его работник
|
||||
живого дня и дёргает конвейер.
|
||||
- [ADR 0009](../adr/0009-world-control.md) — даги модельного времени: их шаговый
|
||||
даг живого дня и дёргает конвейер.
|
||||
- [ADR 0013](../adr/0013-world-lifecycle.md) — жизненный цикл мира: почему
|
||||
прикладным процессом владеет Airflow и почему `world_initialize` кончается
|
||||
собранными слоями.
|
||||
|
||||
Reference in new issue
Block a user