chore: release v1.0.0 — каркас FastAPI, ingress Grafana, интеграции, документация

Made-with: Cursor

docs/VERSIONING.md

@@ -0,0 +1,43 @@
+# Версии и откат
+
+## Соглашение
+
+| Что | Как |
+|-----|-----|
+| Версия в коде | `pyproject.toml` → `[project] version`, `onguard24/__init__.py` → `__version__` |
+| Git-теги | Аннотированные: `v1.0.0`, `v1.1.0` (`git tag -a v1.0.0 -m "..."`) |
+| Ветка по умолчанию | `main` |
+
+Семвер ориентир:
+
+- **MAJOR** — несовместимые изменения API или схемы БД.
+- **MINOR** — новые фичи, обратная совместимость.
+- **PATCH** — исправления без смены контракта.
+
+## Откат к предыдущей версии
+
+```bash
+git fetch --tags
+git checkout v1.0.0   # или нужный тег
+# отладка / hotfix от тега
+```
+
+Новая ветка от старого тега:
+
+```bash
+git checkout -b hotfix/v1.0.1 v1.0.0
+```
+
+Сравнение версий:
+
+```bash
+git log v1.0.0..main --oneline
+git diff v1.0.0..main
+```
+
+## Выпуск новой версии (чеклист)
+
+1. Обновить `CHANGELOG.md`, `pyproject.toml`, `onguard24/__init__.py`.
+2. `git commit -m "chore: release vX.Y.Z"`.
+3. `git tag -a vX.Y.Z -m "Release vX.Y.Z"`.
+4. `git push origin main --tags`.