104 lines
5.9 KiB
Markdown
104 lines
5.9 KiB
Markdown
# DOCS — Архив документации
|
|
|
|
## Архитектура
|
|
|
|
| Файл | Описание |
|
|
|------|----------|
|
|
| `ARCHITECTURE.md` | Актуальная архитектура: эндпоинты, схема БД, безопасность (§8 с фиксами аудита) |
|
|
| `ARCHITECTURE-FULL.md` | Развёрнутая архитектура: полный список файлов, все роуты, зависимости |
|
|
| `ARCHITECTURE.legacy.md` | Архитектура v1.0.x (до рефакторинга) |
|
|
| `architecture-final.md` | Финальная архитектура после всех рефакторингов и аудитов |
|
|
| `architecture-next.md` | Черновик архитектуры vNext — идеи на будущее |
|
|
| `architecture-questions-for-sonnet.md` | Вопросы к Sonnet по архитектуре (перед ревью) |
|
|
| `architecture-review-sonnet.md` | Ревью архитектуры от Sonnet |
|
|
| `architecture-round2.md` | Второй раунд архитектурных решений |
|
|
|
|
## Как делать (How-to)
|
|
|
|
| Файл | Описание |
|
|
|------|----------|
|
|
| `howto-flask-nubes.md` | **ВАЖНО.** Как писать Flask-приложение под Nubes: структура `site/`, порт 5000, `app.run()`, запреты |
|
|
|
|
## API Nubes
|
|
|
|
| Файл | Описание |
|
|
|------|----------|
|
|
| `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 (тестовый стенд) |
|