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
@@ -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#даги-модельного-времени).
|
||||
|
||||
## Состав и доступ
|
||||
|
||||
|
||||
Reference in new issue
Block a user