From 6250ba224d3941feb3fc02b52d8ad6e425740daf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E2=80=9CNaeel=E2=80=9D?= <tazet@narod.ru>
Date: Fri, 31 Jul 2026 19:23:53 +0400
Subject: [PATCH] init: README + .gitignore (polygon v0.1.0)

---
 .gitignore | 23 +++++++++++++++++++++++
 README.md  | 41 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 64 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 README.md

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..7055915
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,23 @@
+# Bytecode
+__pycache__/
+*.pyc
+*.pyo
+
+# IDE
+.idea/
+.vscode/
+*.iml
+
+# OS
+.DS_Store
+Thumbs.db
+*.swp
+*.swo
+*~
+
+# Temp
+*.bak
+*.orig
+
+# Services (генерируются from_stands.py)
+services/*.yaml
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..22cd596
--- /dev/null
+++ b/README.md
@@ -0,0 +1,41 @@
+# polygon v0.1.0
+
+Mock-эмулятор Nubes API для интеграционных тестов app-autotest.
+
+Отдельный Flask-процесс (порт 5001), притворяющийся Nubes REST API.
+Data-driven: сервисы генерируются из STANDS YAML через `from_stands.py`.
+
+## Архитектура
+
+```
+polygon/
+├── server.py          # Flask-приложение, префикс /api/v1/svc
+├── state.py           # MockState — состояние в памяти
+├── config_loader.py   # загрузка YAML + достройка defaults
+├── defaults.py        # default_for(dataType)
+├── from_stands.py     # конвертер STANDS YAML → polygon/services/*.yaml
+└── services/          # сгенерированные конфиги (37 сервисов)
+```
+
+## Запуск
+
+```bash
+STANDS_DIR=../STANDS/test/resources_yaml python server.py
+```
+
+## Тесты
+
+```bash
+NUBES_API_ENDPOINT=http://localhost:5001/api/v1/svc pytest ../app-autotest/tests/ -v
+```
+
+## Сброс состояния
+
+```http
+POST /_mock/reset
+```
+
+## Связанные документы
+
+- [DOCS/polygon-plan.md](../DOCS/polygon-plan.md) — полный план реализации
+- [AGENT_BRIEFING.md](../AGENT_BRIEFING.md) — контекст проекта app-autotest