# Анализ полного 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`