Versioning

Версионирование

Проект использует Semantic Versioning: MAJOR.MINOR.PATCH.

Текущая версия хранится в VERSION.

Правила

Тип	Когда повышать
MAJOR	несовместимые изменения URL, схемы данных, migrations или deploy-процесса
MINOR	новые возможности без поломки существующих ссылок и пользовательских сценариев
PATCH	исправления, тексты, документация, низкорисковые улучшения

Публичный Контракт

Считать публичным контрактом:

• /sub/{vpn_id};
• /wl-filtered/{vpn_id};
• /wl/{vpn_id};
• /connection;
• формат plans.json;
• .env.example;
• Alembic migrations;
• user-facing Telegram navigation.

Каждый Релиз Обновляет

• VERSION;
• CHANGELOG.md;
• Git tag vX.Y.Z;
• GitHub Release notes;
• wiki-source в docs/wiki, если менялись процессы или поведение.

Пример

printf "1.1.1\n" > VERSION
git add VERSION CHANGELOG.md docs/wiki
git commit -m "chore: release v1.1.1"
git tag -a v1.1.1 -m "v1.1.1"
git push origin main --tags