Repinoid
f7fffb9ed7
- NOTES/: 10_plans, 20_prompts, 30_analysis, 40_chat_summaries, 60_reference + README в каждой папке - HOW_TO/: все общие инструкции (сборка/заливка, DevOps-ранбук, добавление сервиса, миграция, генерация доков) + индекс «что нужно -> какой файл» - новый README.md: карта проекта, пайплайн, стенды, реестр, запреты/грабли - HOWTO-UPLOAD.md: исправлена легаси-схема версий (prod=1.*, dev=2.*, test=3.*) - DEVOPS_BUILD_PIPELINE.md: пути скриптов -> TOOLS/scripts, universal_rebuild/main.go -> provider/main.go - howitwasdone.md / MIGRATION_PLAN_FOR_AGENT.md: пометки о соответствии старых путей - внутри перенесённых файлов обновлены ссылки на новые пути
68 lines
6.1 KiB
Markdown
68 lines
6.1 KiB
Markdown
# NOTES — рабочие материалы по провайдеру Nubes
|
||
|
||
Здесь лежат **рабочие материалы**: планы, промпты для LLM, анализы, выжимки из чатов, процессные
|
||
и справочные заметки. Это НЕ публикуемая документация пользователя (та — в `docs/`, собирается mkdocs).
|
||
|
||
> **Главное правило:** файлы с баннером ⛔ в первой строке — **отменённый («ложный») путь**.
|
||
> Читать можно, опираться нельзя.
|
||
|
||
---
|
||
|
||
## Карта папок
|
||
|
||
| Папка | Что внутри | Когда идти туда |
|
||
|---|---|---|
|
||
| [`10_plans/`](10_plans/README.md) | Планы работ: актуальные, перекрытые и отменённые | Понять текущие задачи и их статус |
|
||
| [`20_prompts/`](20_prompts/README.md) | Промпты для LLM (Opus/Sol/Sonnet/DeepSeek/Codex) | Понять, что и у кого спрашивали; переиспользовать формулировки |
|
||
| [`30_analysis/`](30_analysis/README.md) | Анализы, форензика, отчёты, ответы LLM-ревью, разборы багов | Найти факты и обоснования решений |
|
||
| [`40_chat_summaries/`](40_chat_summaries/README.md) | Выжимки-хендоверы из чатов (`CHAT_RESUME_*`) | Быстро войти в контекст прошлых сессий |
|
||
| [`60_reference/`](60_reference/README.md) | Справочники: состояния, стадии, API, архитектурный обзор | Уточнить терминологию и внешние факты |
|
||
|
||
> ❗ **Инструкции (сборка/заливка, добавление сервиса, процессы) вынесены из NOTES в корневую папку
|
||
> [`HOW_TO/`](../HOW_TO/README.md)** — там индекс «что нужно → какой файл».
|
||
|
||
---
|
||
|
||
## Что осталось в корне и в других местах (НЕ переносилось)
|
||
|
||
| Путь | Что это | Почему оставлено |
|
||
|---|---|---|
|
||
| `docs/` | Документация + налоговая структура `00_overview … 90_finance`, `curated/`, `TODO/`, `help/`, `ops/` | Завязана на mkdocs (`mkdocs.yml`, `exclude_docs`) — перенос ломает сборку сайта |
|
||
| `HISTORY/` | Архив: записи по датам, `HISTORY/OPUS/`, `HISTORY/SONNET/` | Это канонический архив истории; отменённый заход помечен баннерами внутри |
|
||
| `HAR/` | Сырые HAR-дампы (live-запросы к API стенда) | Исходные данные для анализа, менять нельзя |
|
||
| `generated/` | Выхлоп генераторов (`resources_yaml`, `go`, `docs`, `provider_build`) | Машинный вывод, не заметки |
|
||
| `TOOLS/`, `provider/`, `scripts/`, `gateway/`, `apps/`, `charts/`, `tf_examples/`, `secrets/` | Код и артефакты проекта | Не заметки |
|
||
| `! /` | **Прецедент Cloud Director** (`vmware_org.tf`, `vdc.tf`, `network.tf.tmpl`) — чужой tf-код на официальном vcd-провайдере | Оставлено на месте (папка названа «!» специально, чтобы быть на виду) |
|
||
| `README.md`, `VERSIONS.md`, `mkdocs.yml` | Точки входа | `README.md` — карта всего проекта; `VERSIONS.md` — источник правды по залитым версиям |
|
||
| `TMP/`, `test_push.md`, `demo.jpg` | Временное/непонятное | Не трогал (статус не определён) |
|
||
|
||
---
|
||
|
||
## Актуальное состояние (2026-09-24)
|
||
|
||
Если нужен контекст по задаче «IaC + модификаторы (modify)», читать в таком порядке:
|
||
|
||
1. [`40_chat_summaries/CHAT_RESUME_IAC_2026-09-24.md`](40_chat_summaries/CHAT_RESUME_IAC_2026-09-24.md) — **начинать отсюда**: полный хендовер (задача, факты, позиции участников, развилка, исправленные ошибки).
|
||
2. [`30_analysis/SHTURVAL_IAC_MODIFY_ANALYSIS_2026-09-23.md`](30_analysis/SHTURVAL_IAC_MODIFY_ANALYSIS_2026-09-23.md) — анализ проблемы и варианты.
|
||
3. [`30_analysis/OPUS_ANSWER_IAC_SHTURVAL_MODIFY_2026-09-23.md`](30_analysis/OPUS_ANSWER_IAC_SHTURVAL_MODIFY_2026-09-23.md) — ответ Opus **с поправками** (часть его «блокеров» ложная).
|
||
4. [`30_analysis/ORG_IP_MODIFIER_TEST_2026-09-22.md`](30_analysis/ORG_IP_MODIFIER_TEST_2026-09-22.md) — единственные проверенные на стенде факты.
|
||
5. [`20_prompts/prompt_for_opus_iac_shturval_modify.md`](20_prompts/prompt_for_opus_iac_shturval_modify.md) — актуальный промпт.
|
||
|
||
---
|
||
|
||
## Статусы файлов (что можно использовать)
|
||
|
||
- ✅ **Актуально** — можно опираться.
|
||
- ⚠️ **Перекрыто / частично** — использовать осторожно, есть более новый документ.
|
||
- ⛔ **Отменённый путь** — только как история (баннер в файле).
|
||
|
||
Точные статусы по каждому файлу — в README соответствующей папки.
|
||
|
||
---
|
||
|
||
## ⚠️ Известная проблема: устаревшие ссылки
|
||
|
||
Файлы переносились из корня и `docs/`, поэтому **внутри исторических документов могли остаться
|
||
старые пути** (например `docs/prompts/...` или `docs/CHAT_RESUME_...`). В актуальных документах
|
||
ссылки обновлены; в архивных — могли не обновляться: ищите файл по имени, а не по пути.
|