Étape 22 : feuilles de poste (PDF), complément des badges

Une page par poste et par jour, listant les créneaux avec les bénévoles
affectés et leur téléphone — à imprimer et afficher sur place. Aucune
nouvelle entité : dérivé de Position/Shift/Assignment/Volunteer
existants (contrairement aux badges, pas de personnalisation à
configurer). Un créneau à besoin 0/0 sans affectation n'apparaît pas.

Backend : app/sheets/pdf.py (ReportLab, Platypus — SimpleDocTemplate/
Table plutôt que le canvas bas niveau des badges, plus adapté à un
rapport texte multi-pages), POST /editions/{id}/position-sheets/generate
(COORDINATION, {position_ids?} — absent = tous les postes).

Frontend : bouton « Feuilles de poste » dans la grille des besoins,
respecte le filtre de catégorie déjà actif à l'écran.

Vérifié : pytest (284 passés), ruff, alembic check, tsc --noEmit,
eslint, vite build, smoke (flux de bout en bout en mode démonstration)
— tous verts.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

backend/tests/test_position_sheets_api.py

@@ -0,0 +1,69 @@
+"""Feuilles de poste (PDF) — API."""
+
+from app.models import Assignment, Role
+from tests.factories import dt_at, make_position, make_shift, make_volunteer
+
+
+def _url(edition):
+    return f"/editions/{edition.id}/position-sheets/generate"
+
+
+def test_is_coordinator_only(edition, make_account, as_account):
+    lead = make_account(Role.LEAD, email="lead@e.fr")
+    client = as_account(lead)
+    resp = client.post(_url(edition), json={})
+    assert resp.status_code == 403
+
+
+def test_rejects_when_no_position_matches(client, edition):
+    resp = client.post(
+        _url(edition),
+        json={"position_ids": ["00000000-0000-0000-0000-000000000000"]},
+    )
+    assert resp.status_code == 422
+    assert resp.json()["detail"]["code"] == "position_sheets.no_positions"
+
+
+def test_rejects_when_no_real_need_to_print(client, edition, session):
+    # Créneaux générés à 0/0, jamais remplis : rien à imprimer.
+    make_position(session, edition, name="Bar central")
+    resp = client.post(_url(edition), json={})
+    assert resp.status_code == 422
+    assert resp.json()["detail"]["code"] == "position_sheets.no_shifts"
+
+
+def test_generates_a_pdf_with_assigned_volunteers(client, edition, session):
+    position = make_position(session, edition, name="Bar central")
+    shift = make_shift(
+        session, edition, position, start=dt_at(9, 19), end=dt_at(9, 22),
+        min_staff=1, ideal_staff=2,
+    )
+    volunteer = make_volunteer(session, edition, first_name="Alex", last_name="Martin")
+    session.add(
+        Assignment(edition_id=edition.id, volunteer_id=volunteer.id, shift_id=shift.id)
+    )
+    session.commit()
+
+    resp = client.post(_url(edition), json={})
+    assert resp.status_code == 200
+    assert resp.headers["content-type"] == "application/pdf"
+    assert resp.content.startswith(b"%PDF")
+
+
+def test_position_ids_filter_scopes_the_sheets(client, edition, session):
+    bar = make_position(session, edition, name="Bar central")
+    welcome = make_position(session, edition, name="Accueil")
+    make_shift(
+        session, edition, bar, start=dt_at(9, 19), end=dt_at(9, 22),
+        min_staff=1, ideal_staff=2,
+    )
+    make_shift(
+        session, edition, welcome, start=dt_at(9, 9), end=dt_at(9, 13),
+        min_staff=1, ideal_staff=2,
+    )
+
+    resp = client.post(_url(edition), json={"position_ids": [str(bar.id)]})
+    assert resp.status_code == 200
+
+    resp = client.post(_url(edition), json={"position_ids": [str(welcome.id)]})
+    assert resp.status_code == 200

backend/tests/test_position_sheets_pdf.py

@@ -0,0 +1,70 @@
+"""Génération des feuilles de poste (module pur, sans base)."""
+
+import datetime as dt
+
+from app.sheets.pdf import (
+    PositionDaySheet,
+    SheetShift,
+    SheetVolunteer,
+    generate_position_sheets_pdf,
+)
+
+
+def _sheet(volunteers=(), min_staff=1, ideal_staff=2) -> PositionDaySheet:
+    return PositionDaySheet(
+        position_name="Bar central",
+        position_location="Chapiteau",
+        date=dt.date(2026, 7, 10),
+        shifts=(
+            SheetShift(
+                starts_at=dt.datetime(2026, 7, 10, 19, 0),
+                ends_at=dt.datetime(2026, 7, 10, 22, 0),
+                min_staff=min_staff,
+                ideal_staff=ideal_staff,
+                volunteers=volunteers,
+            ),
+        ),
+    )
+
+
+def test_shift_is_understaffed_when_below_min_staff():
+    fully_staffed = _sheet(
+        volunteers=(SheetVolunteer(name="Alex Martin", phone="0600000000"),),
+        min_staff=1,
+    )
+    assert fully_staffed.shifts[0].understaffed is False
+
+    understaffed = _sheet(volunteers=(), min_staff=1)
+    assert understaffed.shifts[0].understaffed is True
+
+
+def test_generates_a_valid_pdf_with_volunteers():
+    sheet = _sheet(
+        volunteers=(
+            SheetVolunteer(name="Alex Martin", phone="0600000000"),
+            SheetVolunteer(name="Sam Nuit", phone=None),
+        )
+    )
+    pdf = generate_position_sheets_pdf([sheet])
+    assert pdf.startswith(b"%PDF")
+    assert pdf.rstrip().endswith(b"%%EOF")
+
+
+def test_generates_a_valid_pdf_with_no_volunteers_assigned():
+    pdf = generate_position_sheets_pdf([_sheet(volunteers=())])
+    assert pdf.startswith(b"%PDF")
+
+
+def test_generates_a_valid_pdf_with_no_shifts_that_day():
+    sheet = PositionDaySheet(
+        position_name="Bar central", position_location=None,
+        date=dt.date(2026, 7, 10), shifts=(),
+    )
+    pdf = generate_position_sheets_pdf([sheet])
+    assert pdf.startswith(b"%PDF")
+
+
+def test_multiple_sheets_produce_a_larger_pdf():
+    one = generate_position_sheets_pdf([_sheet()])
+    two = generate_position_sheets_pdf([_sheet(), _sheet()])
+    assert len(two) > len(one)