Planches de badges centrées, verso aligné sur le recto

Espace libre réparti à parts égales (mêmes écarts à gauche, entre les
badges et à droite ; en haut, entre les rangées et en bas) : grille
symétrique, le verso imprimé en miroir tombe exactement derrière le recto
au lieu d'être décalé de l'espace restant.

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

backend/app/badges/pdf.py

@@ -29,6 +29,9 @@ from reportlab.pdfgen import canvas
 
 DEFAULT_BADGE_WIDTH_MM = 85.6
 DEFAULT_BADGE_HEIGHT_MM = 54.0
+# Minimums pour compter combien de badges tiennent sur la page (marge
+# d'impression, écart entre deux badges) ; l'espace effectivement laissé est
+# ensuite réparti à parts égales — voir `_spacing`.
 _MARGIN_MM = 10.0
 _GUTTER_MM = 4.0
 _LINE_HEIGHT_FACTOR = 1.25
@@ -129,6 +132,23 @@ def _grid_size(badge_width_mm: float, badge_height_mm: float) -> tuple[int, int]
     return cols, rows
 
 
+def _spacing(count: int, page_mm: float, size_mm: float) -> tuple[float, float]:
+    """`(marge extérieure, écart entre badges)` sur un axe, en mm : l'espace
+    libre est réparti **à parts égales** — même écart à gauche, entre chaque
+    badge et à droite (resp. en haut, entre les rangées et en bas) — pour une
+    grille centrée et symétrique. Si cet écart passait sous la marge
+    d'impression (`_MARGIN_MM`), la marge est gardée de chaque côté et le
+    reste réparti entre les badges : toujours symétrique. Avant, la grille
+    partait du coin haut-gauche et tout l'espace restant tombait à droite et
+    en bas ; une fois la feuille retournée, le verso se décalait d'autant par
+    rapport au recto (bug corrigé une fois)."""
+    free = page_mm - count * size_mm
+    even = free / (count + 1)
+    if even >= _MARGIN_MM or count == 1:
+        return (even, even) if count > 1 else (free / 2, 0.0)
+    return _MARGIN_MM, (free - 2 * _MARGIN_MM) / (count - 1)
+
+
 def _cell_origin(
     index: int,
     cols: int,
@@ -146,8 +166,11 @@ def _cell_origin(
     col, row = index % cols, index // cols
     if mirrored:
         col = cols - 1 - col
-    x0 = _MARGIN_MM + col * (badge_width_mm + _GUTTER_MM)
-    y0 = _PAGE_HEIGHT_MM - _MARGIN_MM - (row + 1) * badge_height_mm - row * _GUTTER_MM
+    rows = _grid_size(badge_width_mm, badge_height_mm)[1]
+    outer_x, gap_x = _spacing(cols, _PAGE_WIDTH_MM, badge_width_mm)
+    outer_y, gap_y = _spacing(rows, _PAGE_HEIGHT_MM, badge_height_mm)
+    x0 = outer_x + col * (badge_width_mm + gap_x)
+    y0 = _PAGE_HEIGHT_MM - outer_y - (row + 1) * badge_height_mm - row * gap_y
     return x0, y0
 
 

backend/tests/test_badges_pdf.py

@@ -2,6 +2,7 @@
 
 import io
 
+import pytest
 from PIL import Image
 from reportlab.lib.units import mm
 from reportlab.pdfbase.pdfmetrics import stringWidth
@@ -18,6 +19,7 @@ from app.badges.pdf import (
     _column_widths,
     _fit_photo,
     _grid_size,
+    _spacing,
     generate_badge_sheets_pdf,
     image_size_mm,
     wrap_text,
@@ -396,3 +398,39 @@ def test_oval_photo_and_missing_oval_photo_generate_a_valid_pdf():
         )
         pdf = generate_badge_sheets_pdf([badge], None, None)
         assert pdf.startswith(b"%PDF")
+
+
+@pytest.mark.parametrize(
+    "size", [(DEFAULT_BADGE_WIDTH_MM, DEFAULT_BADGE_HEIGHT_MM), (54, 85.6), (50, 50), (74, 105)]
+)
+def test_grid_is_centred_with_equal_gaps_and_back_falls_behind_front(size):
+    from app.badges.pdf import _PAGE_HEIGHT_MM, _PAGE_WIDTH_MM
+
+    w, h = size
+    cols, rows = _grid_size(w, h)
+    xs = sorted({_cell_origin(i, cols, w, h)[0] for i in range(cols * rows)})
+    ys = sorted({_cell_origin(i, cols, w, h)[1] for i in range(cols * rows)})
+    left, right = xs[0], _PAGE_WIDTH_MM - (xs[-1] + w)
+    bottom, top = ys[0], _PAGE_HEIGHT_MM - (ys[-1] + h)
+    # Symétrique : même marge à gauche et à droite, en haut et en bas.
+    assert left == pytest.approx(right)
+    assert top == pytest.approx(bottom)
+    # Écarts entre badges tous égaux, et égaux aux marges quand c'est possible.
+    gaps_x = {round(b - a - w, 6) for a, b in zip(xs, xs[1:], strict=False)}
+    gaps_y = {round(b - a - h, 6) for a, b in zip(ys, ys[1:], strict=False)}
+    assert len(gaps_x) <= 1 and len(gaps_y) <= 1
+    _, gap_x = _spacing(cols, _PAGE_WIDTH_MM, w)
+    if gap_x >= 10 and cols > 1:
+        assert left == pytest.approx(gap_x)
+    # Verso : exactement derrière le recto une fois la feuille retournée
+    # sur son bord long (miroir horizontal).
+    for i in range(cols * rows):
+        fx, fy = _cell_origin(i, cols, w, h)
+        bx, by = _cell_origin(i, cols, w, h, mirrored=True)
+        assert bx == pytest.approx(_PAGE_WIDTH_MM - fx - w)
+        assert by == pytest.approx(fy)
+
+
+def test_cr80_gaps_are_even():
+    # 2 × 85,6 mm sur 210 mm : 12,9 mm à gauche, entre les deux, à droite.
+    assert _spacing(2, 210, 85.6) == pytest.approx((12.9333, 12.9333), abs=1e-3)