onGuard24/docs/VERSIONING.md

Версии и откат

Соглашение

Что	Как
Версия в коде	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 — исправления без смены контракта.

Откат к предыдущей версии

git fetch --tags
git checkout v1.0.0   # или нужный тег
# отладка / hotfix от тега

Новая ветка от старого тега:

git checkout -b hotfix/v1.0.1 v1.0.0

Сравнение версий:

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.