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:
ddadminandClaude Fable 5.1 committed 2026-09-02 16:46:50 +03:00
1 parent 86ad8afaf2
commit 59d8c83b17
54 files changed
+794 -776

No files matched your search

+20 -19
View File
@@ -35,12 +35,12 @@ Prometheus, Grafana, экспортёр метрик Kafka и общая баз
пользователя Windows; после правки нужен `wsl --shutdown`. Если своей машины не
хватает, стенд одинаково хорошо живёт на недорогом VPS.
Проверкам на поднятом стенде также нужны `curl`, `jq`, `awk`,
`grep`, `sed`, `tail`, `sleep` и `timeout`. `jq` нужен и самому `make up`: им
читается опись мира, по которой он ждёт заливки. По умолчанию должны быть свободны
порты `23000`, `28080`, `28088`, `28123`, `28124`, `29000`, `29001`, `29090`
и `29092`. Проверкам без стенда — `make config-test` и `make lint` в корне,
всем целям генератора в `generator/` — нужен `uv`.
Проверкам на поднятом стенде также нужны `curl`, `jq`, `awk`, `grep`, `sed`,
`tail`, `sleep` и `timeout`. `jq` нужен и самому `make up`: им читается паспорт
мира, по которому он ждёт заливки. По умолчанию должны быть свободны порты
`23000`, `28080`, `28088`, `28123`, `28124`, `29000`, `29001`, `29090` и
`29092`. Проверкам без стенда — `make config-test` и `make lint` в корне, всем
целям генератора в `generator/` — нужен `uv`.
Сначала скопируйте настройки стенда:
@@ -61,7 +61,8 @@ make check-services
экземпляра, внешние порты, учебные учётные данные и ключи. Одно значение образца
верно не везде — `DOCKER_GID`: у группы `docker` на каждой машине свой номер, и
свой подскажет `getent group docker`. Пока он не сойдётся, стенд работает весь,
кроме [пульта мира](docs/architecture/world.md#пульт-мира). `compose.yaml` не
кроме [дагов модельного
времени](docs/architecture/world.md#даги-модельного-времени). `compose.yaml` не
дублирует их умолчаниями: если значения нет в `.env`, Compose сразу предложит
скопировать образец. Внутренние адреса, имена топиков и версии образов описывают
сам стенд, поэтому записаны литералами в `compose.yaml` и Dockerfile.
@@ -79,28 +80,28 @@ make check-services
поднятый стенд, сколько стоит прогон и куда класть новую — в
[карте проверок](docs/architecture/testing.md).
Остановить контейнеры без удаления данных можно командой `make down`. Если
нужно вернуть прикладной мир к началу, `make rebuild-storage` запустит в
Airflow его явную пересборку: удалит прикладные базы ClickHouse, топики и
позиции потребителей Kafka, затем создаст схему и данные заново. Службы и их
тома останутся на месте. `make clean` удаляет весь стенд вместе с именованными
томами и для обычной разработки не нужен. Перед пересборкой поставьте
`world_live` на паузу и дайте уже начатому работнику закончить день.
Остановить контейнеры без удаления данных можно командой `make down`. Если нужно
вернуть прикладной мир к началу, `make rebuild-storage` запустит в Airflow его
явную пересборку: удалит прикладные базы ClickHouse, топики и позиции
потребителей Kafka, затем создаст схему и данные заново. Службы и их тома
останутся на месте. `make clean` удаляет весь стенд вместе с именованными томами
и для обычной разработки не нужен. Перед пересборкой поставьте `world_live` на
паузу и дайте уже начатому шаговому дагу закончить день.
## Стартовый мир
Стартовый мир и его опись описаны в
[справочнике мира](docs/architecture/world.md).
Стартовый мир и его паспорт описаны в [справочнике
мира](docs/architecture/world.md).
## Как позвать генератор
Режимы и команды запуска генератора описаны в
[справочнике мира](docs/architecture/world.md#как-запустить-генератор).
### Пульт мира
### Даги модельного времени
Даги пульта, позиция мира и форма запуска описаны в
[справочнике мира](docs/architecture/world.md#пульт-мира).
Даги времени, позиция мира и форма запуска описаны в [справочнике
мира](docs/architecture/world.md#даги-модельного-времени).
## Состав и доступ