docs(history): этап 2 — удаление мёртвого легаси (что удалено, что оставлено)

- раздел «Этап 2» с таблицей удалённых файлов и обоснованием;
- зафиксировано, что НЕ удалено и почему (index.cfm-совместимость,
  справочная копия DOCS_PIPELINE/publish-docs.sh, исторические документы);
- результаты проверок после удаления (bash -n, smoke-прогон 01 dev).
This commit is contained in:
Repinoid
2026-09-30 09:53:57 +03:00
parent c822ae2f2a
commit 5e1a6f06bc
+39 -3
View File
@@ -124,8 +124,44 @@ staging = generated/<stand>/resources_yaml.staging.<pid>
- прогон dev/test/prod — 0 failures, stale отсутствует, staging не остаётся;
- бэкапы создаются: `generated/dev/resources_yaml.bak-20260930T063152Z` и т.д.
## Этап 2 — удаление мёртвого (по команде «удаляй всё старое, аккуратно»)
**Удалено (`1e796c8`)** — 100% мёртвый код/данные, ничего их не вызывает:
| Файл | Почему удалён |
|---|---|
| `TOOLS/scripts/10_yaml_stability_run.sh` | зовёт `01` без `--profile` (exit 2), ищет `*.token` в корне |
| `TOOLS/scripts/11_yaml_stability_run_latest.sh` | цепочка на `10`, та же поломка |
| `TOOLS/scripts/12_generate_yamls_latest.sh` | зовёт `01` без `--profile`, ищет `*.token` в корне |
| `TOOLS/scripts/13_generate_yamls_clean.sh` | цепочка на `12` + делал `rm -f provider/resources_yaml/*.yaml` |
| `TOOLS/scripts/02_generate_resources_and_docs_template_v2.sh` | легаси-дубль канонического `02_generate_resources_and_docs_v2.sh` |
| `TOOLS/config/services_list.txt` (общий) | код его не читает; как «объединение» устарел: активный `27` (в test/prod — «нет в UI»), нет `87/88/97/153`, которые есть в dev |
Проверка «ничего не вызывает»: `grep` по всему репо находил ссылки только в
исторических `HISTORY/`, `NOTES/`, `docs/` (не исполняются).
**Правки ссылок (`c822ae2`)**: `README.md`, `HOW_TO/README.md`,
`HOW_TO/DEVOPS_BUILD_PIPELINE.md`, `HOW_TO/HOWTO_ADD_NEW_SERVICE.md` (включая
переписанный блок «Быстрый старт» с `devops/` на `./TOOLS/scripts/*`),
`DOCS_PIPELINE/README.md`, `scripts/publish-doc-page.sh`, `.gitignore`.
**Проверка после удаления**: `bash -n` для всех `TOOLS/scripts/*.sh` и
`scripts/publish-doc-page.sh` — OK; smoke-прогон `01 --profile TOOLS/config/dev` —
40 YAML, замена атомарная, бэкап создан.
**Не удалено (осознанно):**
- поддержка легаси-прокси `index.cfm` в `01` и `yaml-generator` — это совместимость
с работающими пользователями старого API (провайдер v5.0.75, `secrets/stands.md`);
- `DOCS_PIPELINE/publish-docs.sh` — сам файл помечен «справочная копия, не подменяет пайплайн»;
- `HISTORY/`, `NOTES/`, `docs/` — исторические документы (в них `devops/` и легаси-скрипты
упоминаются как история, это нормально);
- `scripts/*.py` и `s3_notification_example.sh` — ручные утилиты, вызываются вручную.
## Открытые вопросы (на решение владельца)
1. Удалять ли отключённые легаси-скрипты (`10/11/12/13`, `02_..._template_v2`) физически?
2. `TOOLS/config/services_list.txt` (общий, «объединение») не используется ни одним профилем — удалять?
3. Нужна ли поддержка легаси-прокси `index.cfm` в `01` и `yaml-generator` (сейчас сохранена как совместимость)?
1. Поддержка легаси-прокси `index.cfm`: оставляем или выпиливаем (README уже помечает
закрытые API как «не использовать»)?
2. Прочие `.gitignore`-паттерны мёртвых каталогов (`universal_rebuild/*`, `provider/generated/`)
— чистить?