fix: guide - bouton telechargement icone seule, diagramme Architecture rendu en image dans le PDF, emoji couleur (Noto) (#105)

docs/features/guide-coverage-105.md

@@ -47,7 +47,8 @@ le viewer ne rend que les vues document, la modale est donc enrichie ici. Si le
 CDN Mermaid n'est pas prêt, le bloc reste du code lisible et le rendu est
 retenté à l'ouverture suivante (`data-mermaid-rendered` ne se pose qu'après
 succès). Le MD exporté embarque le diagramme en fenced block ` ```mermaid `
-(copiable, rendu par GitHub/VS Code/Obsidian) ; le PDF contient le même bloc.
+(copiable, rendu par GitHub/VS Code/Obsidian) ; le PDF affiche le PNG pré-rendu
+(section 4 — WeasyPrint n'exécute pas Mermaid).
 
 ## 4. Téléchargement (MD + PDF)
 
@@ -63,13 +64,26 @@ nu) — même stratégie que le bouton « PDF » des documents (#92).
 `index.html` et `fr.json`) pour éviter de re-générer à chaque requête.
 
 Endpoint `GET /api/guide/download?format=md|pdf&lang=fr|en`
-(`require_auth`, tag OpenAPI **« Guide »**), `Content-Disposition: attachment`.
-Côté UI : boutons « Markdown » / « PDF » dans l'en-tête de la modale
-(`#help-download-md`/`#help-download-pdf`), handler `downloadGuide()` dans
+(`require_auth`, tag OpenAPI « Guide »), `Content-Disposition: attachment`.
+Côté UI : boutons **icônes seules** 📄/⬇ dans l'en-tête de la modale
+(`#help-download-md`/`#help-download-pdf`, tooltip i18n), handler `downloadGuide()` dans
 `frontend/js/config.js` — fetch avec `AuthManager.getAuthHeaders()` +
 credentials (identique à `viewer.downloadExport()`), blob → lien
 téléchargeable, toasts i18n réutilisés (`viewer.export_*`).
 
+Diagramme d'architecture dans le PDF : WeasyPrint n'exécute pas Mermaid → le code
+Mermaid est **pré-rendu en PNG** (`scripts/build_guide_diagrams.py` +
+`scripts/render_guide_diagram.mjs`, Chromium + mermaid v11 CDN, scale 2) et le PNG
+est **commité** dans `backend/assets/guide_diagrams/<sha1>.png` ; `diagram_png_for()`
+(hash sha1[:16] du code normalisé, même algorithme des deux côtés) remplace le
+bloc par `<img src="file:///…">` dans le HTML d'export. Après modification du
+diagramme dans `guide_content.py` + réinsertion : relancer
+`python scripts/build_guide_diagrams.py` et committer le nouveau PNG.
+Emoji : l'image Docker installe `fonts-noto-color-emoji` et la pile de polices
+PDF finit par `"Noto Color Emoji"` — sans cela les emoji pleine chasse des titres
+de section s'affichent en rectangles (la TOC n'était pas touchée car elle passe
+par DejaVu/Sans).
+
 ## 5. Guide desktop élargi
 
 `frontend/js/desktop.js::initDesktopIntegration()` ajoute `body.desktop-mode`
@@ -106,14 +120,15 @@ même layout est accordé aux viewports ≥1400 px web via media-query (contenu
 
 ## 7. Tests & vérifications
 
-- `tests/test_guide.py` (11) : ancre TOC→sections (garde-fou BUG-067),
+- `tests/test_guide.py` (13) : ancre TOC→sections (garde-fou BUG-067),
   sections #105 présentes, parité/présence des clés `guide105.*` FR=EN,
   Markdown FR/EN (titres, mermaid, absence de balises résiduelles), PDF
-  (`%PDF`, taille), metadata `get_guide_document`, endpoint MD/PDF/400 via
-  TestClient, OpenAPI (path + tag « Guide »).
-- Suite backend pytest : 1216 passed · ruff/mypy 0 erreur ·
+  (`%PDF`, taille), **diagramme Architecture rendu en `<img>` PNG dans le HTML
+  d'export**, MD garde le fenced mermaid, metadata `get_guide_document`,
+  endpoint MD/PDF/400 via TestClient, OpenAPI (path + tag « Guide »).
+- Suite backend pytest : 1218 passed · ruff/mypy 0 erreur ·
   `validate-imports` 38 modules · `unit.test.mjs` 10/10 · E2E complet CI.
-- SW cache busting : `SW_VERSION` v21→v22.
+- SW cache busting : `SW_VERSION` v21→v23 (guides + boutons icônes).
 
 ## 8. Limites assumées