{% extends 'workflows/base_shell.html' %}
{% load static i18n %}

{% block title %}{% trans "Release Checklist" %}{% endblock %}



{% block extra_css %}
<link rel="stylesheet" href="{% static 'workflows/css/release_checklist.css' %}" />
{% endblock %}

{% block shell_body %}
      {% include 'workflows/includes/app_header.html' with header_show_home=1 header_inside_shell=1 %}
    <div class="page-stack">
    <section class="hero">
      <div class="eyebrow">{% trans "Release" %}</div>
      <div class="top">
        <h1>{% trans "Release Checklist" %}</h1>
        <a class="btn btn-secondary" href="/admin-tools/handbook/">{% trans "Back to Handbook" %}</a>
      </div>
      <p class="sub">{% 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." %}</p>
    </section>

    <div class="grid">
      <section class="panel">
        <h2>{% trans "1. Pre-release checks" %}</h2>
        <ul class="checklist">
          <li>{% trans "Confirm git working tree is clean or intentionally scoped." %}</li>
          <li>{% trans "Read the latest Project Wiki and Developer Handbook updates for architecture changes." %}</li>
          <li>{% trans "Check environment changes in .env.example and deployment secrets if integrations changed." %}</li>
          <li>{% trans "If dependencies changed, rebuild web and worker images before validation." %}</li>
        </ul>
        <pre><code>git status --short
docker compose up -d --build web worker</code></pre>
      </section>

      <section class="panel">
        <h2>{% trans "2. Validation commands" %}</h2>
        <ul class="checklist">
          <li>{% trans "Run Django system checks." %}</li>
          <li>{% trans "Run tests or a targeted verification command for the changed area." %}</li>
          <li>{% trans "Compile translations after UI/content changes." %}</li>
          <li>{% trans "If dependencies changed, verify imports do not emit warnings." %}</li>
          <li>{% trans "Verify the latest backup bundle before release if operational tooling, storage, or restore behavior changed." %}</li>
          <li>{% trans "Prefer the single local release gate command so local validation matches CI." %}</li>
        </ul>
        <pre><code>make release-validate

# individual commands if needed:
docker compose exec -T web python manage.py check
docker compose exec -T web python manage.py test
docker compose exec -T web python manage.py verify_latest_backup --create-if-missing
make i18n-compile
docker compose exec -T web python -c "import requests"</code></pre>
      </section>

      <section class="panel">
        <h2>{% trans "3. Data and asset steps" %}</h2>
        <ul class="checklist">
          <li>{% trans "Create and apply migrations if models changed." %}</li>
          <li>{% trans "Run collectstatic if UI assets changed." %}</li>
          <li>{% trans "Generate fresh PDFs if PDF templates or document logic changed." %}</li>
          <li>{% trans "Confirm file outputs appear under backend/media/pdfs/." %}</li>
        </ul>
        <pre><code>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</code></pre>
      </section>

      <section class="panel">
        <h2>{% trans "4. Integration checks" %}</h2>
        <ul class="checklist">
          <li>{% trans "Verify the health endpoint returns status ok." %}</li>
          <li>{% trans "Verify MailHog in test mode or SMTP in production mode." %}</li>
          <li>{% trans "Verify Nextcloud upload if synchronization behavior changed." %}</li>
          <li>{% trans "Verify welcome-email scheduling or notification rules if email routing changed." %}</li>
        </ul>
        <pre><code>curl --max-time 8 http://127.0.0.1:8088/healthz/
docker compose exec -T web python manage.py run_staging_e2e_check</code></pre>
      </section>

      <section class="panel">
        <h2>{% trans "5. Release evidence" %}</h2>
        <ul class="checklist">
          <li>{% trans "Record which checks were run and their result." %}</li>
          <li>{% trans "Take a snapshot commit before moving to the next change phase." %}</li>
          <li>{% trans "If a release introduces new operations or engineering behavior, update both handbooks." %}</li>
          <li>{% trans "Keep at least one successful onboarding and one offboarding smoke example during major workflow changes." %}</li>
        </ul>
      </section>

      <section class="panel">
        <h2>{% trans "6. Rollback basics" %}</h2>
        <ul class="checklist">
          <li>{% trans "If rollout fails after code-only changes, redeploy the previous snapshot commit." %}</li>
          <li>{% trans "If rollout includes schema changes, verify backward compatibility before rollback." %}</li>
          <li>{% trans "If integrations fail, switch email mode/test settings conservatively before wider retry." %}</li>
          <li>{% trans "Use logs from web and worker containers to isolate whether the issue is request, task, or integration related." %}</li>
        </ul>
        <pre><code>docker compose logs --no-color --tail=200 web
docker compose logs --no-color --tail=200 worker</code></pre>
      </section>
    </div>

    <div class="note">{% 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." %}</div>
    </div>
  
{% endblock %}