Numéro d'ordre unique sur chaque reçu fiscal mécénat

Volunteer.mecenat_receipt_number (migration 0020, unique) : année du
paiement + rang sur 5 chiffres (202600001…), une seule numérotation pour
toutes les éditions, repartant à 1 chaque année. Attribué à la
confirmation du paiement, ou au premier export pour les bénévoles payés
avant (dans l'ordre des paiements), puis jamais réattribué — un reçu
regénéré garde son numéro. Attribution sérialisée par un verrou
pg_advisory_xact_lock (webhook et sondage peuvent confirmer deux
paiements à la fois). Imprimé centré dans la case « Numéro d'ordre du
reçu » en page 1 du cerfa.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

backend/app/mecenat/pdf.py

@@ -55,6 +55,10 @@ _COUNTRY = _Field(x=67, bottom=310.5, max_width=125, font_size=9)
 _AMOUNT = _Field(x=44, bottom=365.2, max_width=110, font_size=9)
 _AMOUNT_IN_WORDS = _Field(x=356, bottom=363.1, max_width=190, font_size=8)
 _PAYMENT_DATE = _Field(x=184, bottom=385, max_width=76, font_size=9)
+# Page 1 : case « Numéro d'ordre du reçu » (x 418,7 → 566,8, haut 111 → bas
+# 128,2), texte centré dedans (`x` = centre de la case).
+_RECEIPT_NUMBER = _Field(x=492.75, bottom=124.0, max_width=140, font_size=11, bold=True)
+_CERFA_DATE = _Field(x=320, bottom=640, max_width=76, font_size=9)
 
 
 @dataclass(frozen=True)
@@ -71,6 +75,7 @@ class MecenatReceipt:
     country: str
     amount: float
     payment_date: dt.date
+    number: str = ""
 
 
 def _fitted_font_size(text: str, max_width: float, font_size: float, bold: bool) -> float:
@@ -93,6 +98,31 @@ def _draw(c: canvas.Canvas, text: str, field: _Field) -> None:
     c.drawString(field.x, _PAGE_H - field.bottom + _NUDGE, text)
 
 
+def _draw_centered(c: canvas.Canvas, text: str, field: _Field) -> None:
+    """Comme `_draw`, mais `field.x` est le centre de la zone (case encadrée,
+    pas une ligne de pointillés : pas de `_NUDGE`)."""
+    if not text:
+        return
+    font_size = _fitted_font_size(text, field.max_width, field.font_size, field.bold)
+    c.setFont("Helvetica-Bold" if field.bold else "Helvetica", font_size)
+    c.setFillColor(black)
+    c.drawCentredString(field.x, _PAGE_H - field.bottom, text)
+
+
+def _finish(c: canvas.Canvas, buffer: io.BytesIO) -> PageObject:
+    c.showPage()
+    c.save()
+    buffer.seek(0)
+    return PdfReader(buffer).pages[0]
+
+
+def _organisation_overlay(receipt: MecenatReceipt) -> PageObject:
+    buffer = io.BytesIO()
+    c = canvas.Canvas(buffer, pagesize=(_PAGE_W, _PAGE_H))
+    _draw_centered(c, receipt.number, _RECEIPT_NUMBER)
+    return _finish(c, buffer)
+
+
 def _overlay_page(receipt: MecenatReceipt) -> PageObject:
     buffer = io.BytesIO()
     c = canvas.Canvas(buffer, pagesize=(_PAGE_W, _PAGE_H))
@@ -105,15 +135,14 @@ def _overlay_page(receipt: MecenatReceipt) -> PageObject:
     _draw(c, f"{receipt.amount:.2f}".replace(".", ","), _AMOUNT)
     _draw(c, amount_in_words(receipt.amount), _AMOUNT_IN_WORDS)
     _draw(c, receipt.payment_date.strftime("%d/%m/%Y"), _PAYMENT_DATE)
-    c.showPage()
-    c.save()
-    buffer.seek(0)
-    return PdfReader(buffer).pages[0]
+    _draw(c, receipt.payment_date.strftime("%d/%m/%Y"), _CERFA_DATE)
+    return _finish(c, buffer)
 
 
 def generate_mecenat_receipts_pdf(receipts: list[MecenatReceipt]) -> bytes:
-    """Un reçu = les 2 pages du cerfa officiel, page 2 complétée avec les
-    informations du donateur, du montant et de la date — voir le docstring
+    """Un reçu = les 2 pages du cerfa officiel, page 1 complétée avec le
+    numéro d'ordre, page 2 avec les informations du donateur, du montant et
+    de la date — voir le docstring
     du module. Retourne les octets du PDF concaténant tous les reçus, un
     bénévole après l'autre. Le modèle est relu à chaque itération : `merge_page`
     mutant la page en place, réutiliser le même objet d'un tour à l'autre
@@ -121,7 +150,8 @@ def generate_mecenat_receipts_pdf(receipts: list[MecenatReceipt]) -> bytes:
     writer = PdfWriter()
     for receipt in receipts:
         base = PdfReader(_TEMPLATE_PATH)
-        writer.add_page(base.pages[0])
+        organisation_page = writer.add_page(base.pages[0])
+        organisation_page.merge_page(_organisation_overlay(receipt))
         # `add_page` renvoie la page telle qu'attachée au writer — fusionner
         # l'overlay sur ce retour plutôt que sur `base.pages[1]` (page encore
         # détachée d'un writer, `merge_page` dépréciée dans ce cas).