doc: README для DOCS/HISTORY, polygon-docs/, +.venv в gitignore

2026-07-31 20:39:48 +04:00
parent 633537a775
commit 6978d13d0e
7 changed files with 850 additions and 0 deletions
@@ -504,3 +504,50 @@ convert_all(stands_dir) → dict[int, config]

 Конвертер помечает такие операции: `{svcOperationId, operation, subresource, action}`.
 Один универсальный `apply_effect`, без сервис-специфичного кода.
+
+---
+
+## Полигон — отдельная репа (2026-07-31)
+
+### Решение: отдельный managed-сервис
+
+Полигон выносится из `app-autotest/polygon/` в отдельный репозиторий
+`https://gitea.services.ngcloud.ru/forcloud/polygon.git`.
+
+Это НЕ часть app-autotest, а самостоятельный сервис:
+`polygon.pythonk8s.dev.nubes.ru/` — эмулятор Nubes API.
+
+### Структура (Nubes-совместимая, по howto-flask-nubes.md)
+
+```
+polygon/
+├── requirements.txt
+├── README.md
+├── .gitignore
+└── site/
+    ├── app.py            # точка входа, порт 5000
+    ├── state.py          # MockState
+    ├── config_loader.py  # загрузка YAML + defaults
+    ├── defaults.py       # default_for(dataType)
+    ├── from_stands.py    # конвертер STANDS YAML → polygon/services/*.yaml
+    └── services/         # генерится конвертером
+```
+
+### Поправки к плану Опуса
+
+| Было | Стало |
+|------|-------|
+| `polygon/server.py` на 5001 | `site/app.py` на 5000 |
+| Папка внутри app-autotest | Отдельная репа |
+| `NUBES_API_ENDPOINT=http://localhost:5001` | `http://localhost:5000` (или URL сервиса) |
+| Только локально/CI | Можно задеплоить на Nubes |
+
+### Ключевые правила
+
+- `polygon/` репа = **только код**, никакой документации
+- Документация полигона → `HISTORY/2026-07-31-session.md` (этот файл)
+- `polygon/` добавлен в `.gitignore` основного репо
+- Версионирование своё: polygon v0.1.0
+- YAML не руками — через `from_stands.py` из STANDS (37 сервисов)
+- `site/__init__.py` ⛔ нельзя
+- Импорты без префикса `site.`
@@ -0,0 +1,27 @@
+# HISTORY — Хронология сессий
+
+| Файл | Дата | Содержание |
+|------|------|------------|
+| `2026-07-23-session-1.md` | 23.07.2026 | Сессия 1 |
+| `2026-07-23-session-2.md` | 23.07.2026 | Сессия 2 |
+| `2026-07-23-session-3.md` | 23.07.2026 | Сессия 3 |
+| `2026-07-23-session-4.md` | 23.07.2026 | Сессия 4 |
+| `2026-07-24-all-failures.md` | 24.07.2026 | Все ошибки/падения |
+| `2026-07-24-har-analysis.md` | 24.07.2026 | Анализ HAR-файлов |
+| `2026-07-24-session-1.md` | 24.07.2026 | Сессия 1 |
+| `2026-07-24-session-2.md` | 24.07.2026 | Сессия 2 |
+| `2026-07-24-session-3.md` | 24.07.2026 | Сессия 3 |
+| `2026-07-24-session-4.md` | 24.07.2026 | Сессия 4 |
+| `2026-07-24-session-5.md` | 24.07.2026 | Сессия 5 |
+| `2026-07-24-session-6.md` | 24.07.2026 | Сессия 6 |
+| `2026-07-29-session.md` | 29.07.2026 | Сессия: CMDB delete, переписка с Георгием |
+| `2026-07-30-session.md` | 30.07.2026 | Сессия |
+| `2026-07-31-session.md` | 31.07.2026 | **Текущая.** Аудит Codex (3 раунда), полигон (план + отдельная репа), v1.2.16→v1.2.23 |
+
+## Формат
+
+Каждая сессия содержит:
+- Контекст (что обсуждалось)
+- Принятые решения
+- Реализованные изменения (версии)
+- Ошибки и как исправлены