doc: 54 устаревших файла -> LEGACY.*, README обновлён

Актуальные (4): ARCHITECTURE.md, howto-flask-nubes.md, polygon-plan.md, sonnet-app-autotest-review-v1.2.39.md
Всё остальное — исторические артефакты v1.0.x/v1.1.x, старые ревью, промпты.
This commit is contained in:
2026-08-04 08:28:06 +04:00
parent 8d111a05e1
commit 4e899b8d36
54 changed files with 30 additions and 95 deletions
+20
View File
@@ -0,0 +1,20 @@
Сергей Мищук, [22.07.2026 17:20]
у меня просьба подумать, как сделать автотесты на выбранные операции выбранных сервисов. Может быть, конфигурить через файл. Может быть, сделать веб интерфейс со списком сервисов-операций и статусами тестирования... Может сделать там же конфигурирование тестов. Запускать наверно захочется прямо на платформе
Владимир Крупский, [22.07.2026 17:36]
операции - create modify redeploy и тд ?
Владимир Крупский, [22.07.2026 17:37]
можно ... по всем сервисам есть yaml с полным перечнем всего что в сервисах есть.
Владимир Крупский, [22.07.2026 17:38]
сделаю во фласке или нодеjs
Владимир Крупский, [22.07.2026 17:39]
пока со своим токеном ... токенами по соотв. стендам
Сергей Мищук, [22.07.2026 18:07]
только не по всем можно все, поэтому нужна настройка. Это будет гоняться на проде. Например, организацию создавать нельзя, объекты надо делать и удалять в специальной тестовой организации. Кроме того, для многих сервисов действует удаление с передержкой. Поэтому для них можно 1 раз сделать создание и не делать удаление
Сергей Мищук, [22.07.2026 18:07]
это все надо конфигурить, а не кодировать
+10 -95
View File
@@ -1,103 +1,18 @@
# DOCS — Архив документации # DOCS — Архив документации
## Архитектура ## Актуальное
| Файл | Описание | | Файл | Описание |
|------|----------| |------|----------|
| `ARCHITECTURE.md` | Актуальная архитектура: эндпоинты, схема БД, безопасность (§8 с фиксами аудита) | | `ARCHITECTURE.md` | **Главный документ.** Полная архитектура v1.2.43: режимы, БД, роуты, безопасность, тесты |
| `ARCHITECTURE-FULL.md` | Развёрнутая архитектура: полный список файлов, все роуты, зависимости | | `howto-flask-nubes.md` | Как писать Flask-приложение под Nubes: структура `site/`, порт, `app.run()` |
| `ARCHITECTURE.legacy.md` | Архитектура v1.0.x (до рефакторинга) | | `polygon-plan.md` | План мок-полигона: 3 фазы, 12 шагов, YAML-спецификация |
| `architecture-final.md` | Финальная архитектура после всех рефакторингов и аудитов | | `sonnet-app-autotest-review-v1.2.39.md` | Код-ревью Соннета 4.6 (2026-08-03): 10 находок |
| `architecture-next.md` | Черновик архитектуры vNext — идеи на будущее |
| `architecture-questions-for-sonnet.md` | Вопросы к Sonnet по архитектуре (перед ревью) |
| `architecture-review-sonnet.md` | Ревью архитектуры от Sonnet |
| `architecture-round2.md` | Второй раунд архитектурных решений |
## Как делать (How-to) ## LEGACY (исторические)
| Файл | Описание | Все остальные файлы (54 шт.) переименованы с префиксом `LEGACY.` — это история
|------|----------| разработки: старые архитектуры, ревью v1.0.x/v1.1.x, промпты для Sonnet/Opus/Sol,
| `howto-flask-nubes.md` | **ВАЖНО.** Как писать Flask-приложение под Nubes: структура `site/`, порт 5000, `app.run()`, запреты | аудиты, планы, обсуждения.
## API Nubes Актуальная архитектура — только в `ARCHITECTURE.md` (v1.2.43).
| Файл | Описание |
|------|----------|
| `api-access.md` | Как получить доступ к Nubes API: токены, clientId, стенды |
| `api-create-flow.md` | Полный flow создания инстанса: instances → instanceOperations → params → run → poll |
| `api-operation-stages.md` | Стадии выполнения операций (plan, apply, etc.) |
| `terraform-operations-full-logic.md` | Логика Terraform-операций: validate-cfs, refSvc, нормализация параметров |
## Планы
| Файл | Описание |
|------|----------|
| `polygon-plan.md` | **ВАЖНО.** План мок-полигона: 3 фазы, 12 шагов, YAML-спецификация |
| `opus-plan-2026-07-31.md` | План Опуса: унификация executor, гибкие ссылки, 4 фазы 13 шагов |
| `test-results-history-plan.md` | План истории результатов тестов |
| `gpt56-sol-plan.md` | План Sol по GPT-5.6 |
## Промпты для агентов
| Файл | Описание |
|------|----------|
| `agent-analysis-request.md` | Запрос на анализ проекта (архитектура, риски, рекомендации) |
| `opus-architecture-prompt.md` | Промпт Опусу: полное описание проекта + вопросы по архитектуре |
| `opus-frontend-prompt.md` | Промпт Опусу: вопросы по фронтенду (instance dropdown) |
| `gpt56-sol-prompt.md` | Промпт GPT-5.6: описание проекта для Sol |
| `sonnet-review-prompt.md` | Промпт Sonnet для code review |
## Ревью и аудиты — Sonnet
| Файл | Описание |
|------|----------|
| `sonnet-full-code-review.md` | Полный code review всех файлов |
| `sonnet-full-response.md` | Полный ответ Sonnet на review |
| `sonnet-full-review.md` | Сводка review |
| `sonnet-architecture-review-v1.0.89.md` | Архитектурное ревью v1.0.89 |
| `sonnet-architecture-review-v1.0.89-r2.md` | Второй раунд архитектурного ревью |
| `sonnet-review-v1.1.11.md` | Ревью v1.1.11 |
| `sonnet-review-answers.md` | Ответы на замечания Sonnet |
| `sonnet-review-round2.md` | Второй раунд ревью |
| `sonnet-review-round3.md` | Третий раунд ревью |
| `sonnet-final-audit.md` | Финальный аудит |
| `sonnet-final-review.md` | Финальное ревью |
| `sonnet-missed-bugs.md` | Пропущенные баги (что Sonnet не нашёл) |
| `sonnet-params-and-audit.md` | Параметры + аудит |
| `sonnet-response-params-audit.md` | Ответ: параметры и аудит |
| `sonnet-response-final.md` | Финальный ответ |
| `sonnet-response-round2.md` | Ответ второго раунда |
| `sonnet-response-v1.1.11.md` | Ответ на ревью v1.1.11 |
| `sonnet-response-serviceInstanceUid.md` | Ответ про serviceInstanceUid |
| `sonnet-response-state-out.md` | Ответ про state.out |
| `sonnet-state-out-valuelist.md` | stateOut + valueList |
| `sonnet-terraform-diff.md` | Разбор Terraform diff |
| `sonnet-new-chat.md` | Новый чат с Sonnet |
| `sonnet-question-tracker.md` | Трекер вопросов к Sonnet |
## Ревью — Опус
| Файл | Описание |
|------|----------|
| `opus-questions-2026-07-31.md` | 19 уточняющих вопросов Опуса по архитектуре |
| `opus-instance-dropdown-questions.md` | Вопросы Опуса про instance dropdown |
| `opus-review-v1.2.0.md` | Ревью v1.2.0 от Опуса |
## Вопросы-ответы
| Файл | Описание |
|------|----------|
| `questions-to-sol.md` | Вопросы к Sol |
| `sol-answers.md` | Ответы Sol |
| `sol-scenario-editor.md` | Sol про редактор сценариев |
## Прочее
| Файл | Описание |
|------|----------|
| `HISTORY.md` | Краткая хронология версий (v1.0.x → v1.2.x) |
| `dialogues.md` | Диалоги/дискуссии в процессе разработки |
| `service-categories.md` | Категории сервисов Nubes (37 сервисов, их типы) |
| `review-comparison-sonnet-opus.md` | Сравнение ревью Sonnet vs Opus |
| `step-by-step-audit-v1.0.50.md` | Пошаговый аудит v1.0.50 |
| `vm-213.md` | Заметки о VM-213 (тестовый стенд) |