tf_provider/HISTORY/README.md

HISTORY — журнал изменений провайдера, стендов и инфраструктуры

Здесь лежат записи о том, что и почему менялось: разборы багов, релизы, эксперименты, диалоги с LLM-ревьюерами. Назначение — чтобы по документации можно было восстановить всю историю изменений, включая собственные ошибки.

⛔ Приказ владельца: документировать АБСОЛЮТНО ВСЁ — включая свои ошибки. Запись делается в файл в этом каталоге, а не в память ассистента.

Структура

Папка	О чём	Файлов
10_reviews/	Ревью кода и разборы от LLM-ревьюеров	2
20_releases/	Заливки версий в реестр, чистки реестра, нумерация версий	8
30_provider/	Ядро провайдера: архитектура, модификаторы, UUID, nested-атрибуты	6
40_generator/	Генератор YAML/спеки, формат MAN, dev-генератор	3
50_docs/	Документация: пайплайн сборки, навигация, ссылки, публикация, хостинг	10
60_stands/	Стенды и примеры: CRUD, FullPipe, Штурвал, TEST_STAND	8
70_infra/	Инфраструктура: реестр, API Gateway, DDoS-Guard, VPN/213, зеркала	4
90_llm/	Диалоги и промпты с LLM, не привязанные к одной теме	36
Итого		77

Соглашения

• Имя файла записи: YYYY-MM-DD_<краткая_тема>.md (латиница, змеиный регистр). Для старых диалогов с LLM, которые шли без даты (3006_*, 0107.md), исторические имена не переименовывались — чтобы не рвать ссылки в уже написанных документах.
• Нумерация папок — как в ../NOTES/: 10_, 20_, … Шаг 10 оставлен для вставки новых тем между существующими.
• Куда писать новую запись: в папку своей темы. Если темы нет — завести новую папку со следующим свободным номером и дописать её в таблицу выше и в раздел ниже.
• Диалоги/брифинги для LLM — в 90_llm/<модель>/: пары «бриф → ответ» держим вместе, поэтому авторские подпапки не растворяются по темам.
• Файл = один эпизод. Ссылки на смежные записи — в разделе «Связанные документы» внизу файла.

---

10_reviews — ревью кода

Файл	Тема
10-code-review-sonnet.md	Code Review (Sonnet) + список исправлений, структура проекта
2026-08-31_opus_code_review.md	Code Review провайдера от Opus

20_releases — релизы и реестр

Файл	Тема
2026-09-03_reversion_cleanup.md	Чистка реестра + новая нумерация версий + баг dev
2026-09-30_dev_registry_prune_versions.md	Очистка dev-реестра: удалены версии провайдера старше 2.0.21
2026-09-30_dev_release_2_0_1.md	Релиз dev-провайдера 2.0.1
2026-09-30_release_1_0_0_2_0_0_3_0_0_all_stands.md	Первая перезаливка всех трёх стендов под версии 1.0.0 / 2.0.0 / 3.0.0
2026-10-01_release_keep_on_destroy_subresources.md	Заливка во все стенды с фичей keep_on_destroy у подресурсов
2026-10-01_release_subresource_password_output.md	Заливка с выходом password у подресурсов
2026-10-01_release_password_unknown_fix.md	Перезаливка после фикса unknown password
2026-10-01_release_x_0_0_all_stands.md	Перезаливка 1.0.0 / 2.0.0 / 3.0.0 (актуальные номера)

30_provider — ядро провайдера

Файл	Тема
2026-07-06_architectural_refactoring.md	Архитектурный рефакторинг tf_provider
2026-07-16_nested_provider_test_success.md	Успешный тест nested-провайдера (5.1.2)
2026-07-16_subparams_nested_terraform_attributes.md	SubParams: переход map-fixed → nested Terraform-атрибуты
2026-09-21_fullpipe_vdc_nsxt_and_refsvc_fixes.md	Серия фиксов генератора и провайдера по FullPipe (vDC + Edge)
2026-09-30_core_and_modifiers_remediation.md	Правки ядра и модификаторов по итогам анализа
2026-09-30_uuid_case_normalization_on_create.md	Регистр UUID: нормализация на отправке в API (create/modify/read/delete)

40_generator — генератор YAML/спеки

Файл	Тема
2026-08-10_man_format_fix.md	Фикс формата MAN
2026-09-03_dev_generator_nested_schema_plan.md	Баг dev-генератора: рассинхрон nested-параметра
2026-09-30_yaml_pipeline_hardening.md	Ужесточение пайплайна генерации YAML (безопасная замена вместо удаления)

50_docs — документация и её публикация

Файл	Тема
2026-08-31_registry_getting_started_url_fix.md	Фикс URL в Getting Started реестра
2026-09-02_full_docs_pipeline_analysis.md	Анализ полного pipeline документации и публикации
2026-09-03_cross_stand_links_fix.md	Фикс публикации кросс-стендовых ссылок
2026-09-03_cross_stand_links_on_indexes.md	Кросс-стендовые ссылки на индексных страницах
2026-09-03_current-stand-in-index.md	Текущий стенд на индексной странице документации
2026-09-03_docs_hardcodes_removed_and_dev_published.md	Устранение хардкодов документации + публикация DEV
2026-09-03_docs_upload_pipeline_verified.md	Проверенный pipeline публикации документации
2026-09-03_test_prod_docs_published.md	Публикация документации TEST и PROD
2026-10-02_s3_static_website_docs_hosting.md	Хостинг документации: S3 static website на RGW — находки и версии развития (V0→V1→V2)
2026-10-02_crud_docs_page_and_manual_pages_pipeline.md	Страница CRUD-стенда на сайте: правки README стенда, переписанная docs/curated/crud/three_apps.md, разбор «какие ручные страницы попадают на сайт и как добавить остальные» (04:157-173, mkdocs.yml:52)

60_stands — стенды и примеры

Файл	Тема
2026-07-21_crud_stand_three_apps.md	CRUD-стенд: три приложения (Lucee, Flask, Node.js) + PostgreSQL
2026-08-31_terraform_stands_configuration.md	Настройка Terraform под разные стенды (dev/test/prod)
2026-09-24_shturval_dev00_adopt_and_freeze_design.md	Штурвал dev-00: диагностика, adopt, дизайн «freeze on destroy»
2026-09-25_fullpipe_example_shturval_and_docs.md	Штурвал в примере fullpipe_chain + страница документации
2026-09-30_shturval_dev1_delete_npe.md	shturval-dev1: повторное удаление через API не проходит
2026-10-01_test_crud_pg_create_failure.md	TEST_STAND/CRUD: сбои создания nubes_postgres.main_pg
2026-10-01_test_stand_fpipegmail.md	TEST_STAND/FPipeGmail: копия dev-примера, адаптированная под тест
2026-10-02_crud_repo_paths_terraform_org.md	Пути к репозиториям приложений CRUD: организация terraform вместо Nail (перепроверка всех git-путей через git ls-remote; tf_examples и IOT — в Nail)

70_infra — инфраструктура и окружение

Файл	Тема
2026-07-01_ddos_guard_403_and_registry_fix.md	DDoS-Guard 403 + фикс реестра
2026-07-02_api_gateway_migration.md	Миграция с deck-api на API Gateway (lk-api-gateway)
2026-09-28_vpn-transit-213-vultr.md	VPN-транзит через ВМ 213 и Vultr
2026-10-01_sync_tf_to_213_mirror.md	Полное зеркалирование локального ~/TF на сервер 213

90_llm — диалоги и промпты с LLM

90_llm/gemini/

Файл	Тема
prompt_for_gemini_iot_diagram.md	Промпт для Gemini: диаграмма пайплайна IoT Demo
prompt_for_gemini_iot_diagram_FINAL.md	Финальная правка того же промпта

90_llm/OPUS/

Файл	Тема
3006_0_analysis.md	Анализ Terraform-провайдера для Nubes Cloud (legacy + universal)
3006_0_full_backup.md	Тот же анализ, полная версия (с трассой чтения и ответами)
3006_0_trace.md	Трассировка чтения файлов Opus'ом
3006_0_answers.md	Ответы на 8 дополнительных вопросов (сессия 2)
3006_1_questions.md	Дополнительные вопросы к Opus 4.8 (расхождение версий и др.)
3006_2_scripts_questions.md	Вопросы по аудиту генерационных скриптов
3006_2_scripts_analysis.md	Анализ генерационных скриптов (сессия 2)
2026-07-06_architectural_analysis.md	Архитектурный анализ tf_provider
2026-07-07_opus_answers_duplicate_fix.md	Стратегия фикса duplicate/exist
2026-07-07_skip_missing_on_delete_bugs.md	Разбор багов skip_missing_on_delete и связанных
2026-07-07_subresource_duplicate_exist_bug.md	Duplicate/exist при adopt подресурсов
2026-07-07_v5_0_64_fix_plan.md	План фикса идемпотентности delete + duplicate adopt
2026-09-22_modifier_architecture_project.md	⛔ Архитектура модификаторов (полный проект) — ложный путь, отменено 2026-09-24
2026-09-22_modifier_null_reset_bug.md	⛔ Modify-модификатор сбрасывает create-поля в дефолты — ложный путь
2026-09-22_modifier_plan_review.md	⛔ Ревью плана редизайна модификаторов — ложный путь
2026-09-22_modifiers_code_review.md	⛔ Код-ревью модификаторов — ложный путь
2026-09-30_provider_architecture_modifiers_dialog.md	Диалог Opus 4.8: архитектура провайдера и ресурсов-модификаторов

⛔ Четыре файла от 2026-09-22 помечены «ложный путь» — подход к модификаторам отменён 2026-09-24. Они оставлены как история: чтобы не повторять ошибочный дизайн.

90_llm/SONNET/

Файл	Тема
0107.md	Разбор перехода к JSON/200 OK + анализ и план
2026-07-08_find_instance_by_display_name_bug.md	FindInstanceByDisplayName: анализ и дебаг
2026-08-10_docs_ux_analysis.md	Анализ UX документации Nubes Terraform Provider
2026-08-10_nav_merge_answer.md	Как смержить nav (статический + динамический)
docs_improvement_briefing.md	Бриф: анализ и улучшение документации
docs_improvement_answer.md	Ответ по улучшению документации
docs_improvement_final.md	Полный диалог по документации и финальный план
docs_prompt_answer.md	Готовый SYSTEM_PROMPT + механизм MAN→группы (ответ)
docs_prompt_full_response.md	То же, полный ответ
docs_p1_final.md	Финальный план P1 — 05_generate_docs_llm.py
docs_p1_approved.md	Утверждённый план P1
stages_output_briefing.md	Бриф: вывод этапов (stages) в провайдере
stages_output_plan_final.md	Финальный план реализации вывода stages
stages_testing_question.md	Тестирование stages без реальных инстансов
stages_testing_answer.md	Ответы по тестированию stages
stages_testing_answer_v2.md	Второй ответ (после исправленного брифа)
stages_testing_answer_deepseek.md	DeepSeek Flash: ответы по тестированию stages

---

Известные особенности

• HISTORY/90_llm/OPUS/3006_1.md и 3006_0.md — упоминаются в старых транскриптах как предполагавшиеся имена файлов, реально не создавались. Ссылки оставлены как есть (историчность важнее «красоты»).
• HISTORY/HOWTO-UPLOAD.md — в 20_releases/2026-09-03_reversion_cleanup.md осталась ссылка на старый внешний репозиторий (tf_registry/HISTORY/HOWTO-UPLOAD.md). Актуальный документ — ../HOW_TO/HOWTO-UPLOAD.md.
• Диалоги с LLM не редактируются по фактам, кроме пометок и обновления путей: это стенограммы. Итоги и решения из них переносятся в тематические записи (30_provider/, 50_docs/, …).

Реорганизация

• 2026-10-02 — 75 файлов разложены по тематическим папкам (до этого 41 файл лежал в корне HISTORY/, а 34 — в авторских OPUS/ и SONNET/). Все переносы выполнены через git mv (история файлов сохранена), перекрёстные ссылки в репозитории обновлены. Резервная копия до переноса: TMP/backup_2026-10-02/HISTORY_before_restructure.tar.gz.