import initial

2026-06-10 10:21:18 +02:00
commit 5a03f8a38d
59 changed files with 4777 additions and 0 deletions
@@ -0,0 +1,71 @@
+# Design : affichage de l'image originale sur la page solution
+
+**Date :** 2026-05-20
+
+## Contexte
+
+La page solution affiche actuellement la grille remplie (cellules noires). L'utilisateur souhaite voir également l'image d'origine dont la grille est issue, pour faciliter la vérification et enrichir le rendu visuel.
+
+## Mise en page choisie
+
+Page portrait A4. La page solution est divisée en **deux colonnes égales** :
+
+- **Colonne gauche** : grille solution (indices + cellules remplies) — identique à aujourd'hui mais réduite pour tenir dans la moitié de la largeur
+- **Colonne droite** : image originale redimensionnée à la même hauteur et largeur que la grille, centrée verticalement
+
+Espacement entre les deux colonnes : gouttière fixe de 10 mm.
+
+Si `image_bytes` est `None`, la page solution se comporte comme avant (grille seule, pleine largeur).
+
+## Changements requis
+
+### 1. `src/logimage/domain/entities/puzzle.py`
+
+Ajouter un champ `image_bytes: bytes | None = None` à `NonogramPuzzle` :
+
+```python
+@dataclass(frozen=True)
+class NonogramPuzzle:
+    grid: Grid
+    row_clues: tuple[Clue, ...]
+    col_clues: tuple[Clue, ...]
+    title: str
+    image_bytes: bytes | None = None
+```
+
+Étendre `from_grid()` pour accepter et transmettre ce paramètre :
+
+```python
+@classmethod
+def from_grid(cls, grid: Grid, title: str, image_bytes: bytes | None = None) -> "NonogramPuzzle":
+    ...
+    return cls(grid=grid, row_clues=row_clues, col_clues=col_clues, title=title, image_bytes=image_bytes)
+```
+
+### 2. `src/logimage/application/use_cases/generate_puzzles.py`
+
+Passer `image_data.content` lors de la construction du puzzle :
+
+```python
+puzzle = NonogramPuzzle.from_grid(grid, image_data.title, image_data.content)
+```
+
+### 3. `src/logimage/infrastructure/pdf/reportlab_exporter.py`
+
+Modifier `_draw_page()` pour la page solution (`filled=True`) :
+
+- Si `puzzle.image_bytes` est `None` : comportement actuel inchangé.
+- Si `puzzle.image_bytes` est présent : calculer la largeur disponible en divisant en deux colonnes (`(avail_w - gutter) / 2`). Réduire la grille à cette demi-largeur. Rendre l'image dans la colonne droite via `reportlab.lib.utils.ImageReader` avec `canvas.drawImage()`, aux mêmes dimensions que la grille (même x, y, width, height).
+
+## Ce qui ne change pas
+
+- La page puzzle (non solution) reste inchangée
+- Le port `PdfExporter` reste inchangé (signature de `export()` inchangée)
+- Le port `ImageSource` reste inchangé
+- Les tests existants restent valides (le champ `image_bytes` est optionnel)
+
+## Tests
+
+- `NonogramPuzzle.from_grid()` avec et sans `image_bytes`
+- `ReportLabPdfExporter` : vérifier que le PDF généré avec `with_solution=True` et des bytes image est plus grand (taille fichier) que sans image
+- Vérifier que `with_solution=True` sans `image_bytes` se comporte comme avant (rétrocompatibilité)