{% trans "Release" %}

{% trans "Release Checklist" %}

{% trans "Single runbook for preparing, validating, and evidencing a safe application release. Use it for both local production-like rollouts and future CI/CD handoffs." %}

{% trans "1. Pre-release checks" %}

{% trans "Confirm git working tree is clean or intentionally scoped." %}
{% trans "Read the latest Project Wiki and Developer Handbook updates for architecture changes." %}
{% trans "Check environment changes in .env.example and deployment secrets if integrations changed." %}
{% trans "If dependencies changed, rebuild web and worker images before validation." %}

git status --short
docker compose up -d --build web worker

{% trans "2. Validation commands" %}

{% trans "Run Django system checks." %}
{% trans "Run tests or a targeted verification command for the changed area." %}
{% trans "Compile translations after UI/content changes." %}
{% trans "If dependencies changed, verify imports do not emit warnings." %}

docker compose exec -T web python manage.py check
docker compose exec -T web python manage.py test
make i18n-compile
docker compose exec -T web python -c "import requests"

{% trans "3. Data and asset steps" %}

{% trans "Create and apply migrations if models changed." %}
{% trans "Run collectstatic if UI assets changed." %}
{% trans "Generate fresh PDFs if PDF templates or document logic changed." %}
{% trans "Confirm file outputs appear under backend/media/pdfs/." %}

docker compose exec -T web python manage.py makemigrations
docker compose exec -T web python manage.py migrate
docker compose exec -T web python manage.py collectstatic --noinput

{% trans "4. Integration checks" %}

{% trans "Verify the health endpoint returns status ok." %}
{% trans "Verify MailHog in test mode or SMTP in production mode." %}
{% trans "Verify Nextcloud upload if synchronization behavior changed." %}
{% trans "Verify welcome-email scheduling or notification rules if email routing changed." %}

curl --max-time 8 http://127.0.0.1:8088/healthz/
docker compose exec -T web python manage.py run_staging_e2e_check

{% trans "5. Release evidence" %}

{% trans "Record which checks were run and their result." %}
{% trans "Take a snapshot commit before moving to the next change phase." %}
{% trans "If a release introduces new operations or engineering behavior, update both handbooks." %}
{% trans "Keep at least one successful onboarding and one offboarding smoke example during major workflow changes." %}

{% trans "6. Rollback basics" %}

{% trans "If rollout fails after code-only changes, redeploy the previous snapshot commit." %}
{% trans "If rollout includes schema changes, verify backward compatibility before rollback." %}
{% trans "If integrations fail, switch email mode/test settings conservatively before wider retry." %}
{% trans "Use logs from web and worker containers to isolate whether the issue is request, task, or integration related." %}

docker compose logs --no-color --tail=200 web
docker compose logs --no-color --tail=200 worker

{% trans "Project rule: German remains the primary/fallback language. English is secondary. If a release adds new dynamic text, add the German source first and then the English value." %}