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

HISTORY/2026-07-31-session.md

@@ -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.`