É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>
2026-09-21 21:27:01 +02:00
parent 111d1e5c4b
commit 40127a2252
17 changed files with 561 additions and 4 deletions
@@ -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)