feat(report): Phase 21C — dispatch Documents + Crosses (cer-doc + quality-cer + pareto + marginal-cost)

Troisième commit Phase 21 : déplace les charts cross-dimensionnels et
doc-centriques depuis view_analyses.html vers leurs vues XerOCR
sémantiques. view_analyses.html ne contient plus que view_results_html
(Phase 23) et la corr-matrix interactive JS (Commit 21D pour
suppression).

Déplacés vers documents.html :
- chart-cer-doc — CER par document, tous moteurs (doc-centric)

Déplacés vers crosses.html :
- chart-quality-cer — qualité image × CER (cross-dimensional)
- pareto-chart — front Pareto interactif avec 3 toggles
(cost/speed/co2), liste d'hypothèses, note
pédagogique. Le wrapper passe de
`<div class="chart-card pareto-card">` à
`<section class="card xer-chart-card pareto-card">`
— convention XerOCR. `.pareto-card` (border
vert) et `.pareto-toolbar/.pareto-toggle`
inchangés en CSS, pas de régression visuelle.
- marginal_cost_html — coût marginal d'une erreur évitée entre
paires de moteurs (cost × quality cross-dim).

Commentaire d'en-tête de view_analyses.html mis à jour pour refléter
l'état post-21C : reliquat documenté (view_results pour Phase 23, JS
corr-matrix pour 21D).

Tests :
- 19 nouveaux tests dans test_phase21_dispatch.py (4 classes : Documents,
Crosses/Quality, Crosses/Pareto, Crosses/MarginalCost).
- Anti-theater validé par 3 sabotages distincts (canvas rename, toggle
removal, conditional wiring rename).
- test_english_locale_full_render (test_docs_case_studies.py) mis à jour
pour le nouveau wrapper Pareto (`pareto-card` au lieu de
`chart-card pareto-card` — l'ancien sélecteur exact serait cassé).
- test_report_contains_pareto_card (test_pareto_pricing.py) idem.

Lint propre, 5764 tests, 0 failed.

https://claude.ai/code/session_01WYDbfkhKPeBZ15BTP4e9Ye

picarones/reports/html/templates/view_analyses.html

@@ -1,94 +1,30 @@
 
-<!-- ════ Vue 5 : Analyses (charts Chart.js non encore portés en SVG) ═══
-     Conteneur des charts Chart.js qui n'ont pas (encore) d'équivalent
-     SVG côté serveur dans les 4 vues XerOCR principales.  Migrations
-     déjà effectuées et retirées :
-       - chart-cer-hist     → engines.cer_distribution (SVG)
-       - chart-radar        → engines.radar (SVG)
-       - chart-gini-cer     → crosses CER × Gini (SVG)
-       - chart-ratio-anchor → crosses Ancrage × Longueur (SVG)
-       - venn-container     → crosses.venn (SVG)
-       - wilcoxon-table     → engines.wilcoxon (HTML)
-       - corr-matrix        → engines.correlation (HTML)
-     Charts ENCORE en Chart.js dans cette vue : cer-doc, duration,
-     quality-cer, taxonomy, reliability, bootstrap-ci, pareto-chart,
-     error-clusters.  Tant que ces 8 charts persistent ici, le vendor
-     Chart.js inliné dans base.html.j2 reste justifié.  Migration
-     incrémentale vers SVG = chantier non bloquant. -->
+<!-- ════ Vue 5 : Analyses (reliquat post-Phase 21) ═══════════════════
+     Quasi-vide après le dispatch Phase 21 (A/B/C).  Contenu restant :
+       - view_results_html       — Phase 23 : intégration en <details>
+                                   dans la vue XerOCR la plus pertinente.
+       - corr-matrix interactif  — Commit 21D : suppression (la version
+                                   Python `engines_correlation_matrix_html`
+                                   couvre déjà le besoin dans
+                                   engines_diagnostics.html, sans selector
+                                   JS mais avec sélection serveur).
+     L'onglet Analyses lui-même sera retiré en Phase 22 une fois ces
+     deux derniers items traités.  Le wrapper `<div id="view-analyses">`
+     reste pour ne pas casser les deeplinks `#analyses` legacy entre
+     Phase 21 et Phase 22. -->
 <div id="view-analyses" class="view">
   <div class="charts-grid">
 
-    <div class="chart-card">
-      <h3 data-i18n="h_cer_doc">CER par document (tous moteurs)</h3>
-      <div class="chart-canvas-wrap">
-        <canvas id="chart-cer-doc" role="img" aria-label="CER par document" data-a11y-label="CER par document"></canvas>
-      </div>
-    </div>
-
-    <div class="chart-card">
-      <h3 data-i18n="h_quality_cer">Qualité image ↔ CER (scatter plot)</h3>
-      <div class="chart-canvas-wrap">
-        <canvas id="chart-quality-cer" role="img" aria-label="Corrélation qualité d'image / CER" data-a11y-label="Corrélation qualité d'image / CER"></canvas>
-      </div>
-      <div style="font-size:.72rem;color:var(--text-muted);margin-top:.4rem" data-i18n="quality_cer_note">
-        Chaque point = un document. Axe X = score qualité image [0–1]. Axe Y = CER. Corrélation négative attendue.
-      </div>
-    </div>
-
-    <div class="chart-card pareto-card" style="grid-column:1/-1">
-      <h3 data-i18n="h_pareto">Compromis qualité / coût</h3>
-      <div class="pareto-toolbar" role="group" aria-label="Axe d'analyse Pareto">
-        <button type="button" class="pareto-toggle active" data-axis="cost"
-                onclick="setParetoAxis('cost')"
-                aria-pressed="true"
-                data-i18n="pareto_axis_cost">Coût € / 1000 pages</button>
-        <button type="button" class="pareto-toggle" data-axis="speed"
-                onclick="setParetoAxis('speed')"
-                aria-pressed="false"
-                data-i18n="pareto_axis_speed">Vitesse (s / page)</button>
-        <button type="button" class="pareto-toggle pareto-experimental" data-axis="co2"
-                onclick="setParetoAxis('co2')"
-                aria-pressed="false"
-                data-i18n="pareto_axis_co2"
-                title="Estimation expérimentale">Carbone (g CO₂)</button>
-      </div>
-      <div class="chart-canvas-wrap"><canvas id="pareto-chart" role="img" aria-label="Front Pareto coût/qualité" data-a11y-label="Front Pareto coût/qualité"></canvas></div>
-      <div id="pareto-method-note" class="pareto-note" data-i18n="pareto_note">
-        Les moteurs sur la frontière de Pareto (en évidence) sont ceux pour
-        lesquels aucun autre moteur n'offre simultanément un meilleur CER ET
-        un meilleur coût. Prix indicatifs (table interne, datée). Le mode
-        carbone est expérimental.
-      </div>
-      <details class="pareto-assumptions">
-        <summary data-i18n="pareto_assumptions_summary">Hypothèses détaillées par moteur</summary>
-        <ul id="pareto-assumptions-list"></ul>
-      </details>
-    </div>
-
-    {# Sections déplacées vers les vues XerOCR (S13 cleanup) :
-       - calibration_summary_html, reliability_diagrams_html → Engines/Diagnostics
-       - ner_summary_html, ner_per_category_html → Engines/Diagnostics
-       - philological_profile_html → Engines/Diagnostics
-       - searchability_html, numerical_sequences_html → Engines/Diagnostics
-       - specialization_html → Crosses (passthrough)
-       - divergence_matrix_html, oracle_gap_html → Crosses (passthrough)
-       Doubler le rendu HTML coûtait ~120 lignes inutiles dans chaque rapport.
-       Les renderers eux-mêmes sont toujours invoqués côté générateur ;
-       seul le ``{% include %}`` legacy a été retiré. #}
-
-    {# Phase B6 — view_results (par EvaluationView) — pas encore migrée
-       vers les vues XerOCR.  Conservée le temps de la migration. #}
+    {# Phase B6 — view_results (par EvaluationView) — destinée à
+       Phase 23 : intégration en <details> dans la vue XerOCR
+       la plus pertinente (option α conservatrice). #}
     {% if view_results_html %}
     {{ view_results_html | safe }}
     {% endif %}
 
-    {% if marginal_cost_html %}
-    <div class="chart-card" style="grid-column:1/-1">
-      {{ marginal_cost_html | safe }}
-    </div>
-    {% endif %}
-
-    <!-- Sprint 7 — Matrice de corrélation -->
+    {# Matrice de corrélation interactive (JS) — sera supprimée en
+       Commit 21D.  La version Python statique vit déjà dans
+       engines_diagnostics.html via engines_correlation_matrix_html. #}
     <div class="chart-card technical" style="grid-column:1/-1">
       <h3 data-i18n="h_correlation">Matrice de corrélation entre métriques</h3>
       <div style="margin-bottom:.5rem">

picarones/reports/html/templates/views/crosses.html

@@ -35,4 +35,63 @@
     {{ crosses_venn_html | safe }}
   </section>
   {% endif %}
+
+  {# Phase 21C dispatch — depuis view_analyses.html :
+     - chart-quality-cer : scatter qualité image × CER (cross-dimensional)
+     - pareto-chart : front Pareto coût/vitesse/CO₂ × CER, interactif
+     - marginal_cost_html : coût marginal par erreur évitée entre paires
+  #}
+  <section class="card xer-chart-card" aria-labelledby="crosses-quality-cer-title"
+           style="margin-top:1.25rem">
+    <h3 id="crosses-quality-cer-title" data-i18n="h_quality_cer">Qualité image ↔ CER (scatter plot)</h3>
+    <p data-i18n="quality_cer_note">
+      Chaque point = un document. Axe X = score qualité image [0–1]. Axe Y = CER. Corrélation négative attendue.
+    </p>
+    <div class="chart-canvas-wrap">
+      <canvas id="chart-quality-cer" role="img"
+              aria-label="Corrélation qualité d'image / CER"
+              data-a11y-label="Corrélation qualité d'image / CER"></canvas>
+    </div>
+  </section>
+
+  <section class="card xer-chart-card pareto-card" aria-labelledby="crosses-pareto-title"
+           style="margin-top:1.25rem">
+    <h3 id="crosses-pareto-title" data-i18n="h_pareto">Compromis qualité / coût</h3>
+    <div class="pareto-toolbar" role="group" aria-label="Axe d'analyse Pareto">
+      <button type="button" class="pareto-toggle active" data-axis="cost"
+              onclick="setParetoAxis('cost')"
+              aria-pressed="true"
+              data-i18n="pareto_axis_cost">Coût € / 1000 pages</button>
+      <button type="button" class="pareto-toggle" data-axis="speed"
+              onclick="setParetoAxis('speed')"
+              aria-pressed="false"
+              data-i18n="pareto_axis_speed">Vitesse (s / page)</button>
+      <button type="button" class="pareto-toggle pareto-experimental" data-axis="co2"
+              onclick="setParetoAxis('co2')"
+              aria-pressed="false"
+              data-i18n="pareto_axis_co2"
+              title="Estimation expérimentale">Carbone (g CO₂)</button>
+    </div>
+    <div class="chart-canvas-wrap">
+      <canvas id="pareto-chart" role="img"
+              aria-label="Front Pareto coût/qualité"
+              data-a11y-label="Front Pareto coût/qualité"></canvas>
+    </div>
+    <div id="pareto-method-note" class="pareto-note" data-i18n="pareto_note">
+      Les moteurs sur la frontière de Pareto (en évidence) sont ceux pour
+      lesquels aucun autre moteur n'offre simultanément un meilleur CER ET
+      un meilleur coût. Prix indicatifs (table interne, datée). Le mode
+      carbone est expérimental.
+    </div>
+    <details class="pareto-assumptions">
+      <summary data-i18n="pareto_assumptions_summary">Hypothèses détaillées par moteur</summary>
+      <ul id="pareto-assumptions-list"></ul>
+    </details>
+  </section>
+
+  {% if marginal_cost_html %}
+  <section class="card xer-chart-card" style="margin-top:1.25rem">
+    {{ marginal_cost_html | safe }}
+  </section>
+  {% endif %}
 </section>

picarones/reports/html/templates/views/documents.html

@@ -61,4 +61,17 @@
       {{ documents_worst_lines_html | safe }}
     </div>
   {% endif %}
+
+  {# Phase 21C dispatch — CER par document : chart doc-centric depuis
+     view_analyses.html.  Construit par buildCharts() (lazy au premier
+     passage sur l'onglet Documents). #}
+  <section class="card xer-chart-card" aria-labelledby="documents-cer-doc-title"
+           style="margin-top:1.25rem">
+    <h3 id="documents-cer-doc-title" data-i18n="h_cer_doc">CER par document (tous moteurs)</h3>
+    <div class="chart-canvas-wrap">
+      <canvas id="chart-cer-doc" role="img"
+              aria-label="CER par document"
+              data-a11y-label="CER par document"></canvas>
+    </div>
+  </section>
 </section>

tests/evaluation/metrics/test_pareto_pricing.py

@@ -271,7 +271,11 @@ class TestReportIntegration:
         out = tmp_path / "report.html"
         ReportGenerator(benchmark_result).generate(out)
         html = out.read_text(encoding="utf-8")
-        assert 'class="chart-card pareto-card"' in html
+        # Phase 21C : Pareto migré vers crosses.html sous convention XerOCR.
+        # Le wrapper est passé de <div class="chart-card pareto-card"> à
+        # <section class="card xer-chart-card pareto-card">.  La classe
+        # ``pareto-card`` (border-left vert via CSS) est préservée.
+        assert "pareto-card" in html
         assert 'id="pareto-chart"' in html
         assert 'setParetoAxis(\'cost\')' in html
         assert 'setParetoAxis(\'speed\')' in html

tests/reports/test_docs_case_studies.py

@@ -168,7 +168,11 @@ class TestEndToEnd:
         for marker in [
             'class="synth-card"',           # Sprint 19 narrative
             'class="cdd-card"',             # Sprint 18 CDD
-            'class="chart-card pareto-card"', # Sprint 20 Pareto
+            # Phase 21C : Pareto migré dans Crosses sous convention XerOCR.
+            # Wrapper passé de <div class="chart-card pareto-card"> à
+            # <section class="card xer-chart-card pareto-card">.
+            'pareto-card',                  # Sprint 20 Pareto (post-21C)
+            'id="pareto-chart"',            # Canvas Pareto présent
             'id="glossary-panel"',          # Sprint 21 glossaire
             'id="customize-panel"',         # Sprint 21 personnalisation
             'btn-customize',

tests/reports/test_phase21_dispatch.py

@@ -0,0 +1,175 @@
+"""Tests Phase 21C — dispatch Documents + Crosses (chart-cer-doc, chart-quality-cer, pareto, marginal_cost).
+
+Vérifie que les charts cross-dimensionnels et doc-centriques sont
+correctement déplacés depuis view_analyses.html vers leur destination
+XerOCR sémantique :
+
+- chart-cer-doc       → documents.html  (doc-centric line chart)
+- chart-quality-cer   → crosses.html    (cross-dim image quality × CER)
+- pareto-chart        → crosses.html    (cross-dim cost/quality interactif)
+- marginal_cost_html  → crosses.html    (cost marginal par erreur évitée)
+
+Anti-theater : chaque test échoue par sabotage ciblé (ID rename,
+template miss, etc.) — preuve documentée dans les docstrings de classe.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import pytest
+
+REPO_ROOT = Path(__file__).resolve().parents[2]
+TEMPLATES = REPO_ROOT / "picarones" / "reports" / "html" / "templates"
+DOCS_VIEW = TEMPLATES / "views" / "documents.html"
+CROSSES_VIEW = TEMPLATES / "views" / "crosses.html"
+ANALYSES_VIEW = TEMPLATES / "view_analyses.html"
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 1. Documents — chart-cer-doc
+# ─────────────────────────────────────────────────────────────────────────────
+
+
+class TestChartCerDocInDocuments:
+    """``chart-cer-doc`` (CER par document, tous moteurs) doit vivre
+    dans documents.html — chart doc-centric va avec la galerie.
+
+    Anti-theater : retirer/renommer le canvas → ces tests échouent.
+    """
+
+    @pytest.fixture(scope="class")
+    def docs_src(self) -> str:
+        return DOCS_VIEW.read_text(encoding="utf-8")
+
+    @pytest.fixture(scope="class")
+    def analyses_src(self) -> str:
+        return ANALYSES_VIEW.read_text(encoding="utf-8")
+
+    def test_canvas_in_documents(self, docs_src: str) -> None:
+        assert 'id="chart-cer-doc"' in docs_src
+
+    def test_section_heading_present(self, docs_src: str) -> None:
+        assert 'id="documents-cer-doc-title"' in docs_src
+        assert 'data-i18n="h_cer_doc"' in docs_src
+
+    def test_aria_label_preserved(self, docs_src: str) -> None:
+        assert 'aria-label="CER par document"' in docs_src
+        assert 'data-a11y-label="CER par document"' in docs_src
+
+    def test_not_in_analyses(self, analyses_src: str) -> None:
+        assert 'id="chart-cer-doc"' not in analyses_src, (
+            "chart-cer-doc doit être retiré de view_analyses.html (Phase 21C)"
+        )
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 2. Crosses — chart-quality-cer
+# ─────────────────────────────────────────────────────────────────────────────
+
+
+class TestChartQualityCerInCrosses:
+    """``chart-quality-cer`` (qualité image × CER) est un scatter
+    cross-dimensionnel — vit dans crosses.html.
+
+    Anti-theater : double-vérification (présent dans crosses + absent
+    dans analyses).  Renommer l'ID dans un seul des 2 fichiers fait
+    immédiatement échouer un test.
+    """
+
+    @pytest.fixture(scope="class")
+    def crosses_src(self) -> str:
+        return CROSSES_VIEW.read_text(encoding="utf-8")
+
+    @pytest.fixture(scope="class")
+    def analyses_src(self) -> str:
+        return ANALYSES_VIEW.read_text(encoding="utf-8")
+
+    def test_canvas_in_crosses(self, crosses_src: str) -> None:
+        assert 'id="chart-quality-cer"' in crosses_src
+
+    def test_section_heading_present(self, crosses_src: str) -> None:
+        assert 'id="crosses-quality-cer-title"' in crosses_src
+        assert 'data-i18n="h_quality_cer"' in crosses_src
+
+    def test_note_present(self, crosses_src: str) -> None:
+        assert 'data-i18n="quality_cer_note"' in crosses_src
+
+    def test_not_in_analyses(self, analyses_src: str) -> None:
+        assert 'id="chart-quality-cer"' not in analyses_src
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 3. Crosses — pareto-chart (canvas + toolbar + assumptions)
+# ─────────────────────────────────────────────────────────────────────────────
+
+
+class TestParetoChartInCrosses:
+    """Le Pareto avec toolbar 3 axes (cost/speed/co2) + détails
+    hypothèses est entièrement dans crosses.html.
+
+    Anti-theater : retirer un toggle, retirer la liste d'hypothèses,
+    ou laisser une copie dans analyses → tests échouent.
+    """
+
+    @pytest.fixture(scope="class")
+    def crosses_src(self) -> str:
+        return CROSSES_VIEW.read_text(encoding="utf-8")
+
+    @pytest.fixture(scope="class")
+    def analyses_src(self) -> str:
+        return ANALYSES_VIEW.read_text(encoding="utf-8")
+
+    def test_canvas_in_crosses(self, crosses_src: str) -> None:
+        assert 'id="pareto-chart"' in crosses_src
+
+    def test_toolbar_present(self, crosses_src: str) -> None:
+        assert 'class="pareto-toolbar"' in crosses_src
+        assert 'role="group"' in crosses_src
+
+    @pytest.mark.parametrize("axis", ["cost", "speed", "co2"])
+    def test_each_axis_toggle_present(self, crosses_src: str, axis: str) -> None:
+        assert f'data-axis="{axis}"' in crosses_src
+        assert f"setParetoAxis('{axis}')" in crosses_src
+
+    def test_assumptions_list_container(self, crosses_src: str) -> None:
+        assert 'id="pareto-assumptions-list"' in crosses_src
+        assert 'class="pareto-assumptions"' in crosses_src
+
+    def test_method_note_present(self, crosses_src: str) -> None:
+        assert 'id="pareto-method-note"' in crosses_src
+        assert 'data-i18n="pareto_note"' in crosses_src
+
+    def test_not_in_analyses(self, analyses_src: str) -> None:
+        assert 'id="pareto-chart"' not in analyses_src
+        assert 'id="pareto-assumptions-list"' not in analyses_src
+        assert 'class="pareto-toolbar"' not in analyses_src
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 4. Crosses — marginal_cost_html
+# ─────────────────────────────────────────────────────────────────────────────
+
+
+class TestMarginalCostInCrosses:
+    """``marginal_cost_html`` mesure le coût marginal d'une erreur évitée
+    entre paires de moteurs — cross-dimensionnel cost × quality.
+
+    Anti-theater : déplacer ailleurs ou oublier le wiring → tests échouent.
+    """
+
+    def test_wired_in_crosses(self) -> None:
+        crosses_src = CROSSES_VIEW.read_text(encoding="utf-8")
+        assert "{% if marginal_cost_html %}" in crosses_src, (
+            "marginal_cost_html doit être câblé conditionnellement dans crosses.html"
+        )
+
+    def test_not_in_analyses(self) -> None:
+        analyses_src = ANALYSES_VIEW.read_text(encoding="utf-8")
+        assert "{% if marginal_cost_html %}" not in analyses_src
+
+    def test_not_in_engines_diagnostics(self) -> None:
+        """Anti-confusion : marginal_cost n'est PAS dans diagnostics —
+        il appartient à Crosses (cross-dimensional), pas à 'où ça plante'."""
+        diag_src = (TEMPLATES / "views" / "engines_diagnostics.html").read_text(encoding="utf-8")
+        assert "{% if marginal_cost_html %}" not in diag_src