# 2026-07-06 — Архитектурный рефакторинг tf_provider

## Контекст

После анализа Claude Opus (`HISTORY/OPUS/2026-07-06_architectural_analysis.md`) выявлены архитектурные проблемы и выполнены исправления.

## Выполненные изменения

### 1. Реструктуризация проекта

```
Было:                          Стало:
devops/                        TOOLS/scripts/        (все .sh)
devops/profiles/               TOOLS/config/         (profile.env, services_list, timeouts)
devops/ARCHITECTURE.md         TOOLS/ARCHITECTURE.md
devops/config/                 УДАЛЕНО (дубликат profiles)
provider/resources_yaml/       УДАЛЕНО (сгенерированное → generated/)
provider/internal/resources_gen/ УДАЛЕНО (сгенерированное → generated/)
                               generated/{test,prod,dev}/  (вывод пайплайна)
```

### 2. Независимость генераторов

- `yaml-generator` — требует `NUBES_OUTPUT_DIR`, без default в `provider/`
- `resource-generator` — требует `NUBES_RESOURCES_DIR` + `NUBES_RESOURCES_GEN_DIR`
- `docs-generator` — требует `--resources`, `--docs`, `--version` флаги
- Удалён `detectVersion()` — больше не читает `provider/main.go`
- Удалён `detectRoot()`, `pickPath()` — нет хардкод-путей

### 3. Общая библиотека типов

Создан `TOOLS/lib/` — единый YAML-контракт. Модуль: `tf-tools/lib`.

Подключены:
- `yaml-generator` → type alias `ParamSpec = lib.ParamSpec` и др.
- `resource-generator` → type alias `OutputParam`, `OperationSpec`, `ParamSpec`

НЕ подключён:
- `docs-generator` — будет заменён на LLM-генератор, не трогаем

При добавлении поля в YAML — править `lib/types.go`, несогласованность ловится компилятором.

### 4. Синхронизация версий

- `provider/main.go`: 5.0.75 → 5.0.60 (соответствует последней сборке)
- `profile.env`: три переменные → одна `VERSION`
- `03_build`, `04_publish`: `${PROVIDER_VERSION:-${RELEASE_VERSION:-}}` → `${VERSION}`

### 5. Автосборка бинарников

`01_generate_yamls.sh`: если исходники новее бинарника — пересборка.

### 6. Удалённый мусор

- `devops/config/` — дубликат profiles
- `02_generate_resources_and_docs.sh` + `_template.sh` — legacy, заменены v2
- `cloud-dashboard/`, `tools/` (root), `internal/` (root), `universal_rebuild/`
- 18 одноразовых файлов (check_ops.py, s.sh, ...)

### 7. Слияние ops-generator → docs-generator

`--ops` флаг. Три генератора вместо четырёх.

### 8. Документация LLM

`docs/LLM_DOCS_GENERATION.md` — подход, промпт, тест на Postgres (gpt-oss-120b, 9/10).

## Текущее состояние

```
tf_provider/
├── TOOLS/            — всё для генерации (код + скрипты + настройки)
│   ├── yaml-generator/
│   ├── resource-generator/
│   ├── docs-generator/
│   ├── lib/          — общие YAML-типы
│   ├── scripts/
│   ├── config/{test,prod,dev}/
│   └── ARCHITECTURE.md
├── provider/         — только исходники
├── generated/        — вывод пайплайна (gitignored)
└── docs/             — документация
```

## Осталось

- [x] yaml-generator → lib
- [ ] resource-generator → lib
- [ ] docs-generator → lib