Feuilles de poste : ajouter la programmation du jour (horaires artistes)

Sous le référent, la liste des artistes qui jouent ce jour-là (heure de
passage + nom), tous postes confondus — repère utile même hors de la
régie (affluence prévisible au bar, sécurité...). Triée par horaire,
omise si aucun artiste ne joue ce jour-là.

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

backend/app/api/position_sheets.py

@@ -17,9 +17,10 @@ from app.api.deps import get_edition
 from app.api.schemas import PositionSheetsRequest
 from app.auth.deps import require_coordinator
 from app.db import get_session
-from app.models import Account, Assignment, Edition, Position, Shift, Volunteer
+from app.models import Account, Artist, Assignment, Edition, Position, Shift, Volunteer
 from app.sheets.pdf import (
     PositionDaySheet,
+    SheetArtist,
     SheetShift,
     SheetVolunteer,
     generate_position_sheets_pdf,
@@ -89,6 +90,15 @@ def generate_position_sheets(
         pid: referent for pid, referent in referent_rows if referent is not None
     }
 
+    # Programmation du jour, tous postes confondus — voir `SheetArtist`.
+    artists_by_date: dict[dt.date, list[Artist]] = defaultdict(list)
+    for artist in session.exec(
+        select(Artist)
+        .where(Artist.edition_id == edition.id)
+        .order_by(Artist.start_time)
+    ):
+        artists_by_date[artist.performance_date].append(artist)
+
     positions_by_id = {p.id: p for p in positions}
 
     def _sheet(position_id: uuid.UUID, date: dt.date, day_shifts: list[Shift]) -> PositionDaySheet:
@@ -99,6 +109,10 @@ def generate_position_sheets(
             date=date,
             referent_name=f"{referent.first_name} {referent.last_name}" if referent else None,
             referent_phone=referent.phone if referent else None,
+            artists=tuple(
+                SheetArtist(name=a.name, start_time=a.start_time, end_time=a.end_time)
+                for a in artists_by_date.get(date, [])
+            ),
             shifts=tuple(
                 SheetShift(
                     starts_at=s.starts_at,

backend/app/sheets/pdf.py

@@ -48,6 +48,13 @@ class SheetVolunteer:
     photo: bytes | None = None
 
 
+@dataclass(frozen=True)
+class SheetArtist:
+    name: str
+    start_time: dt.time
+    end_time: dt.time
+
+
 @dataclass(frozen=True)
 class SheetShift:
     starts_at: dt.datetime
@@ -73,6 +80,10 @@ class PositionDaySheet:
     # (`Position.lead_account_id`).
     referent_name: str | None = None
     referent_phone: str | None = None
+    # Programmation du jour (tous postes confondus, pas seulement les
+    # artistes que les bénévoles affectés souhaitent voir) — repère utile sur
+    # place (affluence au bar, sécurité...), triée par heure de passage.
+    artists: tuple[SheetArtist, ...] = ()
 
 
 def _styles() -> dict[str, ParagraphStyle]:
@@ -87,7 +98,11 @@ def _styles() -> dict[str, ParagraphStyle]:
         ),
         "referent": ParagraphStyle(
             "SheetReferent", parent=base["Normal"],
-            fontSize=11.5, fontName="Helvetica-Bold", spaceAfter=16,
+            fontSize=11.5, fontName="Helvetica-Bold", spaceAfter=6,
+        ),
+        "artists": ParagraphStyle(
+            "SheetArtists", parent=base["Normal"],
+            fontSize=9.5, textColor=colors.HexColor("#4a4a4a"), spaceAfter=16,
         ),
         "shiftHeader": ParagraphStyle(
             "ShiftHeader", parent=base["Heading3"], fontSize=13, spaceBefore=12, spaceAfter=4
@@ -155,6 +170,12 @@ def generate_position_sheets_pdf(sheets: list[PositionDaySheet]) -> bytes:
         else:
             story.append(Paragraph("Référent : à désigner", styles["referent"]))
 
+        if sheet.artists:
+            programme = " · ".join(
+                f"{a.start_time:%H:%M}–{a.end_time:%H:%M} {a.name}" for a in sheet.artists
+            )
+            story.append(Paragraph(f"Programmation : {programme}", styles["artists"]))
+
         if not sheet.shifts:
             story.append(Paragraph("Aucun créneau ce jour-là.", styles["normal"]))
             continue

backend/tests/test_position_sheets_api.py

@@ -1,9 +1,10 @@
 """Feuilles de poste (PDF) — API."""
 
 import base64
+import datetime as dt
 
 from app.models import Assignment, Role
-from tests.factories import dt_at, make_position, make_shift, make_volunteer
+from tests.factories import dt_at, make_artist, make_position, make_shift, make_volunteer
 
 # PNG 1×1 valide (transparent), le plus petit possible.
 _PNG = base64.b64decode(
@@ -101,6 +102,36 @@ def test_includes_a_volunteer_photo_when_present(client, edition, session):
     assert resp.content.startswith(b"%PDF")
 
 
+def test_includes_the_day_lineup_across_all_positions(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,
+    )
+    # Passage le 9 (jour des deux créneaux) : doit apparaître sur les deux
+    # feuilles, pas seulement celle du poste « Régie ».
+    make_artist(
+        session, edition, name="Chilla",
+        performance_date=dt.date(2026, 7, 9),
+        start_time=dt.time(20, 0), end_time=dt.time(21, 0),
+    )
+    # Passage un autre jour : ne doit apparaître sur aucune des deux.
+    make_artist(
+        session, edition, name="Hors sujet",
+        performance_date=dt.date(2026, 7, 11),
+        start_time=dt.time(20, 0), end_time=dt.time(21, 0),
+    )
+
+    resp = client.post(_url(edition), json={})
+    assert resp.status_code == 200
+    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")

backend/tests/test_position_sheets_pdf.py

@@ -5,6 +5,7 @@ import datetime as dt
 
 from app.sheets.pdf import (
     PositionDaySheet,
+    SheetArtist,
     SheetShift,
     SheetVolunteer,
     generate_position_sheets_pdf,
@@ -118,3 +119,26 @@ def test_a_volunteer_photo_makes_the_pdf_larger():
         [_sheet(volunteers=(SheetVolunteer(name="Alex Martin", phone=None, photo=_PNG),))]
     )
     assert len(with_photo) > len(without_photo)
+
+
+def test_generates_a_valid_pdf_with_the_day_lineup():
+    sheet = PositionDaySheet(
+        position_name="Bar central", position_location="Chapiteau",
+        date=dt.date(2026, 7, 10), shifts=(),
+        artists=(
+            SheetArtist(name="Chilla", start_time=dt.time(20, 0), end_time=dt.time(21, 0)),
+            SheetArtist(name="XYZ", start_time=dt.time(21, 30), end_time=dt.time(23, 0)),
+        ),
+    )
+    pdf = generate_position_sheets_pdf([sheet])
+    assert pdf.startswith(b"%PDF")
+
+
+def test_generates_a_valid_pdf_without_a_lineup():
+    sheet = PositionDaySheet(
+        position_name="Bar central", position_location="Chapiteau",
+        date=dt.date(2026, 7, 10), shifts=(),
+    )
+    assert sheet.artists == ()
+    pdf = generate_position_sheets_pdf([sheet])
+    assert pdf.startswith(b"%PDF")