docs: record full docs pipeline analysis

HISTORY/2026-09-02_full_docs_pipeline_analysis.md

@@ -0,0 +1,29 @@
+# Анализ полного pipeline документации и публикации
+
+Дата: 2026-09-02
+
+Проверен полный маршрут `tf_provider`:
+
+```text
+Nubes API
+  -> TOOLS/scripts/01_generate_yamls.sh
+  -> generated/<stand>/resources_yaml/*.yaml
+  -> TOOLS/scripts/02_generate_resources_and_docs_v2.sh
+       -> generated/<stand>/go/*.go
+       -> generated/<stand>/docs/*.md + _nav_fragment.yml
+  -> TOOLS/scripts/05_generate_docs_llm.py (опционально)
+  -> TOOLS/scripts/04_build_and_publish_docs.sh
+       -> .mkdocs.tmp.yml
+       -> site/
+       -> S3 terraform-registry/docs/<namespace>/<name>/<version>/
+```
+
+Параллельно релиз провайдера идёт через `03_build_and_upload_provider.sh` и `build-provider.sh`: временная копия provider собирается под linux/windows/darwin, подписывается GPG и загружается в `nubes-terraform-registry/<host>/<namespace>/<name>/<version>/`.
+
+Ключевые реализации: `TOOLS/yaml-generator/main.go`, `TOOLS/resource-generator/main.go`, `TOOLS/docs-generator/main.go`, их `internal/**`, `mkdocs.yml`, профильные конфиги `TOOLS/config/<stand>/*`, `.github/workflows/publish-docs.yml` и серверные файлы `/home/naeel/TF/tf_registry/server/{main.go,handlers.go,router_versions.go,proxy.go}`.
+
+Обнаружен фактический разрыв: `TOOLS/scripts/04_build_and_publish_docs.sh` и CI вызывают `./scripts/publish-docs.sh`, но такого файла в `tf_provider/scripts/` нет. Справочная рабочая копия находится в `DOCS_PIPELINE/publish-docs.sh`. Поэтому генерация `site/` возможна, а штатная финальная загрузка из текущего репозитория завершается ошибкой отсутствующего файла.
+
+Подробный пользовательский отчёт сохранён в:
+
+`/home/naeel/TF/TMP/tf_provider_full_docs_pipeline_2026-09-02.md`