Changelog¶
What changed between deployed versions of the Cifras backend.
Versioning is semver (MAJOR.MINOR.PATCH):
- MAJOR — backwards-incompatible GraphQL schema or DB migration that requires frontend / integration changes.
- MINOR — new features that don't break existing clients.
- PATCH — fixes, internal refactors, and additive fields the frontend can ignore.
The version exposed to clients lives in app/version.py. FastAPI surfaces it at GET /openapi.json under info.version. Bump it with:
uv run python scripts/bump_version.py 1.0.2
# or, to also scaffold a changelog page and wire it into nav:
uv run python scripts/bump_version.py 1.0.2 --changelog-stub
That script updates app/version.py and the version = "..." line in pyproject.toml together — keep them in lock-step so the OpenAPI doc never lies about what's deployed.