@open3cl/engine 1.9.1 → 1.10.0

package/4_ventilation.js

@@ -1,4 +1,10 @@
-import { tv, requestInputID, requestInput, bug_for_bug_compat } from './utils.js';
+import {
+  tv,
+  requestInputID,
+  requestInput,
+  bug_for_bug_compat,
+  compat_for_corpus_analysis
+} from './utils.js';
 import calc_pvent from './5_conso_ventilation.js';
 
 function tv_debits_ventilation(di, de, du) {
@@ -119,6 +125,11 @@ function tv_q4pa_conv(di, de, cg, mur_list, ph_list, porte_list, bv_list) {
        * Si la ligne saisie correspond à la période de construction du DPE, on la reprend en entier
        * (isolation et joints) pour reproduire le calcul du logiciel.
        *
+       * Cette reprise n'est faite qu'avec l'option `compat_for_corpus_analysis` (analyse du corpus
+       * ADEME). Par défaut, la ligne contradictoire est seulement signalée et q4pa_conv est
+       * recalculé selon la méthode : un contrôle de cohérence du DPE doit détecter l'erreur et un
+       * scénario de travaux ne doit pas la propager.
+       *
        * Sens unique : la reprise ne s'applique que si la ligne indique des surfaces isolées alors que
        * le recalcul les donne non isolées. Dans le sens inverse (ligne « non isolées », recalcul
        * « isolées »), le DPE a pu être modifié par l'appelant (scénario d'isolation des parois) :
@@ -127,6 +138,7 @@ function tv_q4pa_conv(di, de, cg, mur_list, ph_list, porte_list, bv_list) {
        */
       if (rowQ4paConv.isolation_surfaces !== isolation_surfaces) {
         if (
+          compat_for_corpus_analysis &&
           isLigneQ4paSurfacesIsolees(rowQ4paConv, isolation_surfaces) &&
           isLigneQ4paMemePeriode(rowQ4paConv, cg)
         ) {
@@ -147,10 +159,14 @@ function tv_q4pa_conv(di, de, cg, mur_list, ph_list, porte_list, bv_list) {
        * Issue #294 : aucune menuiserie n'exporte `presence_joint`. Aucune donnée ne contredit alors
        * la ligne q4pa_conv retenue par le logiciel (ex. ligne 12 « avant 1948 avec joints », 2,5) :
        * on reprend sa valeur `presence_joints_menuiserie` au lieu de considérer les menuiseries
-       * sans joint.
+       * sans joint. Uniquement avec l'option `compat_for_corpus_analysis`.
        * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §4
        */
-      if (!ligneDpeReprise && presenceJointNonRenseignee(porte_list, bv_list)) {
+      if (
+        compat_for_corpus_analysis &&
+        !ligneDpeReprise &&
+        presenceJointNonRenseignee(porte_list, bv_list)
+      ) {
         pjt = rowQ4paConv.presence_joints_menuiserie === '1' ? '1' : '0';
       } else if (!ligneDpeReprise && rowQ4paConv.presence_joints_menuiserie !== pjt) {
         console.error(

package/4_ventilation.spec.js

@@ -4,7 +4,8 @@ import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
  * Dépendances mockées pour isoler le module de ventilation :
  * - `tv` : accès aux tables `debits_ventilation` / `q4pa_conv`, on contrôle les lignes ;
  * - `requestInput` / `requestInputID` : passe-plats vers les données d'entrée ;
- * - `bug_for_bug_compat` : désactivé pour isoler le comportement nominal ;
+ * - `bug_for_bug_compat` / `compat_for_corpus_analysis` : désactivés pour isoler le comportement
+ *   nominal ;
  * - `calc_pvent` (5_conso_ventilation.js) : espion, la conso de ventilation est testée ailleurs.
  */
 vi.mock('./utils.js', () => ({
@@ -12,7 +13,8 @@ vi.mock('./utils.js', () => ({
   tv: vi.fn(),
   requestInput: (de, du, field) => de[field],
   requestInputID: (de, du, field) => de[`enum_${field}_id`],
-  bug_for_bug_compat: false
+  bug_for_bug_compat: false,
+  compat_for_corpus_analysis: false
 }));
 
 vi.mock('./5_conso_ventilation.js', () => ({
@@ -301,10 +303,12 @@ describe('calc_ventilation - orchestration', () => {
  */
 describe('calc_ventilation - compatibilité bug_for_bug_compat activée', () => {
   /**
-   * Recharge le module avec `bug_for_bug_compat = true`. Le double de `tv` renvoie une ligne
-   * `q4pa_conv` distincte selon que le matcher cible l'identifiant déjà saisi ou le matcher complet.
+   * Recharge le module avec `bug_for_bug_compat = true` et `compat_for_corpus_analysis` (vrai par
+   * défaut : reprise de la ligne du DPE pour l'analyse de corpus). Le double de `tv` renvoie une
+   * ligne `q4pa_conv` distincte selon que le matcher cible l'identifiant déjà saisi ou le matcher
+   * complet.
    */
-  async function chargerAvecBug(rowParId) {
+  async function chargerAvecBug(rowParId, compat = true) {
     vi.resetModules();
     const tvBug = vi.fn((table, matcher) => {
       if (table === 'debits_ventilation') return { ...ROW_DEBITS };
@@ -318,7 +322,8 @@ describe('calc_ventilation - compatibilité bug_for_bug_compat activée', () =>
       tv: tvBug,
       requestInput: (de, du, field) => de[field],
       requestInputID: (de, du, field) => de[`enum_${field}_id`],
-      bug_for_bug_compat: true
+      bug_for_bug_compat: true,
+      compat_for_corpus_analysis: compat
     }));
     vi.doMock('./5_conso_ventilation.js', () => ({ default: vi.fn() }));
     const { default: calc_ventilation_bug } = await import('./4_ventilation.js');
@@ -625,6 +630,78 @@ describe('calc_ventilation - compatibilité bug_for_bug_compat activée', () =>
       errorSpy.mockRestore();
     });
   });
+
+  /**
+   * Sans l'option `compat_for_corpus_analysis` (comportement par défaut) : la ligne q4pa_conv du DPE
+   * n'est jamais reprise, q4pa_conv est recalculé selon la méthode. Les écarts sont seulement
+   * signalés (contrôle de cohérence d'un DPE, scénarios de travaux).
+   */
+  describe('sans compat_for_corpus_analysis : ligne du DPE jamais reprise', () => {
+    const murNonIsole = [
+      {
+        donnee_intermediaire: { b: 1 },
+        donnee_entree: { enum_type_isolation_id: '2', surface_paroi_opaque: 100 }
+      }
+    ];
+    const vtLigne = (id) => ({
+      donnee_entree: { enum_type_ventilation_id: '1', tv_q4pa_conv_id: id, description: 'v' }
+    });
+
+    test('ligne « surfaces isolées » de la même période (#312) : isolation et joints recalculés', async () => {
+      const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
+      const { calc_ventilation_bug, tvBug } = await chargerAvecBug(
+        {
+          q4pa_conv: '2',
+          tv_q4pa_conv_id: '11',
+          enum_periode_construction_id: '1',
+          isolation_surfaces: '1',
+          presence_joints_menuiserie: '1'
+        },
+        false
+      );
+      const baieSansJoint = [{ donnee_entree: { surface_totale_baie: 10, presence_joint: 0 } }];
+
+      calc_ventilation_bug(vtLigne(11), CG, 'th', 80, 100, murNonIsole, [], [], baieSansJoint);
+
+      expect(tvBug).toHaveBeenLastCalledWith(
+        'q4pa_conv',
+        expect.objectContaining({ isolation_surfaces: '0', presence_joints_menuiserie: '0' })
+      );
+      expect(errorSpy).toHaveBeenCalledWith(
+        expect.stringContaining('La valeur recalculée isolation_surfaces = 0 est utilisée')
+      );
+      expect(errorSpy).toHaveBeenCalledWith(
+        expect.stringContaining('La valeur recalculée presence_joints_menuiserie = 0 est utilisée')
+      );
+      expect(errorSpy).not.toHaveBeenCalledWith(expect.stringContaining('est conservée'));
+      errorSpy.mockRestore();
+    });
+
+    test('presence_joint non exporté (#294) : joints recalculés à « 0 » et écart signalé', async () => {
+      const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
+      const { calc_ventilation_bug, tvBug } = await chargerAvecBug(
+        {
+          q4pa_conv: '2.5',
+          tv_q4pa_conv_id: '12',
+          isolation_surfaces: '0',
+          presence_joints_menuiserie: '1'
+        },
+        false
+      );
+      const baies = [{ donnee_entree: { surface_totale_baie: 10 } }];
+
+      calc_ventilation_bug(vtLigne(12), CG, 'th', 80, 100, murNonIsole, [], [], baies);
+
+      expect(tvBug).toHaveBeenLastCalledWith(
+        'q4pa_conv',
+        expect.objectContaining({ isolation_surfaces: '0', presence_joints_menuiserie: '0' })
+      );
+      expect(errorSpy).toHaveBeenCalledWith(
+        expect.stringContaining('La valeur recalculée presence_joints_menuiserie = 0 est utilisée')
+      );
+      errorSpy.mockRestore();
+    });
+  });
 });
 
 describe('presenceJointNonRenseignee', () => {

package/README.md

@@ -251,11 +251,18 @@ const c = calcul_3cl(dpeData, { sanitize: false });
 // Depuis un XML ADEME
 const d = calcul_3cl_xml(xmlString);
 const e = calcul_3cl_xml(xmlString, { sanitize: false });
+
+// Analyse du corpus ADEME uniquement : reproduire les choix du logiciel de saisie
+const f = calcul_3cl(dpeData, { sanitize: true, compat_for_corpus_analysis: true });
 ```
 
-| Option     | Défaut | Effet                                                                                                  |
-| :--------- | :----- | :----------------------------------------------------------------------------------------------------- |
-| `sanitize` | `true` | Normalise et corrige les incohérences du DPE d'entrée avant calcul. Désactivez-le pour un calcul brut. |
+| Option                       | Défaut  | Effet                                                                                                                                                                                                                                                                                                                                        |
+| :--------------------------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `sanitize`                   | `true`  | Normalise et corrige les incohérences du DPE d'entrée avant calcul. Désactivez-le pour un calcul brut.                                                                                                                                                                                                                                       |
+| `compat_for_corpus_analysis` | `false` | Reprend la ligne `q4pa_conv` choisie par le logiciel de saisie même si elle contredit l'isolation des parois ou les joints déclarés, pour reproduire les DPE du corpus ADEME. À n'utiliser que pour l'analyse de corpus. Désactivé, le moteur recalcule `q4pa_conv` selon la méthode (contrôle de cohérence d'un DPE, scénarios de travaux). |
+
+> Dès qu'un objet `options` est passé, `sanitize` vaut `false` s'il n'est pas précisé : indiquez
+> `sanitize: true` avec `compat_for_corpus_analysis`.
 
 <details>
 <summary><strong>Exemple d'objet JSON d'entrée (partiel)</strong></summary>
@@ -376,28 +383,28 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <!-- CORPUS:START -->
 
-> **Version `1.8.67`** · branche `main` · généré le 2026-10-16
+> **Version `1.9.1`** · branche `main` · généré le 2026-10-26
 > Seuil de tolérance **5%**
 
 <table>
 <tr>
 <td align="center"><strong>9</strong><br/><sub>corpus</sub></td>
 <td align="center"><strong>88 475</strong><br/><sub>DPE analysés</sub></td>
-<td align="center"><strong>75 663</strong><br/><sub>DPE conformes</sub></td>
-<td align="center"><strong>85,52 %</strong><br/><sub>réussite globale</sub></td>
+<td align="center"><strong>75 700</strong><br/><sub>DPE conformes</sub></td>
+<td align="center"><strong>85,56 %</strong><br/><sub>réussite globale</sub></td>
 </tr>
 </table>
 
 |     | Corpus                                                                                                                  |    Réussite |                        |  DPE conformes |
 | :-: | :---------------------------------------------------------------------------------------------------------------------- | ----------: | :--------------------- | -------------: |
-| 🟢  | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **95,39 %** | `███████████████████░` |  9 437 / 9 893 |
-| 🟢  | **Appartement · chauffage collectif (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_collectif_2025.csv`</sub>   | **94,54 %** | `███████████████████░` |  9 384 / 9 926 |
-| 🟢  | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub>                                        | **93,29 %** | `███████████████████░` |  9 173 / 9 833 |
-| 🟢  | **Maison individuelle (2025)**<br/><sub>`dpe_maison_individuelle_2025.csv`</sub>                                        | **92,03 %** | `██████████████████░░` |  8 992 / 9 771 |
-| 🟢  | **Maison individuelle (2026)**<br/><sub>`dpe_maison_individuelle_2026.csv`</sub>                                        | **90,41 %** | `██████████████████░░` | 9 041 / 10 000 |
-| 🟢  | **Immeuble · chauffage collectif**<br/><sub>`dpe_immeuble_chauffage_collectif.csv`</sub>                                | **89,10 %** | `██████████████████░░` |  8 677 / 9 739 |
-| 🟢  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **86,00 %** | `█████████████████░░░` |  8 535 / 9 924 |
-| 🟡  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **70,48 %** | `██████████████░░░░░░` |  6 746 / 9 571 |
+| 🟢  | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **95,43 %** | `███████████████████░` |  9 441 / 9 893 |
+| 🟢  | **Appartement · chauffage collectif (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_collectif_2025.csv`</sub>   | **94,55 %** | `███████████████████░` |  9 385 / 9 926 |
+| 🟢  | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub>                                        | **93,36 %** | `███████████████████░` |  9 180 / 9 833 |
+| 🟢  | **Maison individuelle (2025)**<br/><sub>`dpe_maison_individuelle_2025.csv`</sub>                                        | **92,14 %** | `██████████████████░░` |  9 003 / 9 771 |
+| 🟢  | **Maison individuelle (2026)**<br/><sub>`dpe_maison_individuelle_2026.csv`</sub>                                        | **90,46 %** | `██████████████████░░` | 9 046 / 10 000 |
+| 🟢  | **Immeuble · chauffage collectif**<br/><sub>`dpe_immeuble_chauffage_collectif.csv`</sub>                                | **89,13 %** | `██████████████████░░` |  8 680 / 9 739 |
+| 🟢  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **86,04 %** | `█████████████████░░░` |  8 539 / 9 924 |
+| 🟡  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **70,50 %** | `██████████████░░░░░░` |  6 748 / 9 571 |
 | 🔴  | **Individuel généré depuis l'immeuble (2026)**<br/><sub>`dpe_individuel_a_partir_dpe_immeuble_2026.csv`</sub>           | **57,83 %** | `████████████░░░░░░░░` |  5 678 / 9 818 |
 
 <sub>🟢 ≥ 85 % · 🟡 ≥ 60 % · 🔴 < 60 %</sub>
@@ -409,24 +416,24 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <table>
 <tr>
-<td align="center"><strong>10,2 ms</strong><br/><sub>moyenne</sub></td>
-<td align="center"><strong>8,72 ms</strong><br/><sub>médiane</sub></td>
-<td align="center"><strong>0,18 ms</strong><br/><sub>min</sub></td>
-<td align="center"><strong>618,1 ms</strong><br/><sub>max</sub></td>
+<td align="center"><strong>6,66 ms</strong><br/><sub>moyenne</sub></td>
+<td align="center"><strong>5,79 ms</strong><br/><sub>médiane</sub></td>
+<td align="center"><strong>0,13 ms</strong><br/><sub>min</sub></td>
+<td align="center"><strong>911,0 ms</strong><br/><sub>max</sub></td>
 </tr>
 </table>
 
 | Corpus                                         | Moyenne | Médiane |     Min |      Max |     p95 |     p99 |
 | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
-| **Appartement · chauffage individuel (2025)**  | 6,87 ms | 6,25 ms | 1,73 ms |  79,3 ms | 12,0 ms | 17,0 ms |
-| **Appartement · chauffage collectif (2025)**   | 7,91 ms | 6,85 ms | 2,08 ms |  66,2 ms | 15,1 ms | 21,7 ms |
-| **Logement individuel (2025)**                 | 9,05 ms | 8,08 ms | 2,03 ms | 104,0 ms | 16,9 ms | 24,1 ms |
-| **Maison individuelle (2025)**                 | 11,2 ms | 9,96 ms | 2,50 ms | 109,6 ms | 20,2 ms | 30,4 ms |
-| **Maison individuelle (2026)**                 | 11,8 ms | 10,3 ms | 2,74 ms | 120,6 ms | 22,7 ms | 34,3 ms |
-| **Immeuble · chauffage collectif**             | 12,0 ms | 9,62 ms | 0,21 ms | 197,5 ms | 25,2 ms | 42,9 ms |
-| **Immeuble · chauffage individuel**            | 12,2 ms | 10,3 ms | 0,18 ms | 228,3 ms | 24,6 ms | 39,3 ms |
-| **Immeuble · chauffage mixte**                 | 9,68 ms | 7,89 ms | 0,35 ms | 618,1 ms | 20,2 ms | 33,5 ms |
-| **Individuel généré depuis l'immeuble (2026)** | 10,8 ms | 9,27 ms | 2,42 ms | 114,5 ms | 20,3 ms | 34,2 ms |
+| **Appartement · chauffage individuel (2025)**  | 5,04 ms | 4,55 ms | 1,68 ms |  58,6 ms | 8,75 ms | 11,6 ms |
+| **Appartement · chauffage collectif (2025)**   | 5,96 ms | 5,55 ms | 2,00 ms |  56,7 ms | 9,64 ms | 12,0 ms |
+| **Logement individuel (2025)**                 | 6,17 ms | 5,46 ms | 1,75 ms |  60,4 ms | 11,5 ms | 16,1 ms |
+| **Maison individuelle (2025)**                 | 6,97 ms | 6,28 ms | 2,02 ms |  59,3 ms | 12,3 ms | 16,7 ms |
+| **Maison individuelle (2026)**                 | 7,06 ms | 6,30 ms | 2,00 ms |  45,5 ms | 12,6 ms | 17,6 ms |
+| **Immeuble · chauffage collectif**             | 6,94 ms | 5,88 ms | 0,14 ms | 144,5 ms | 12,8 ms | 22,1 ms |
+| **Immeuble · chauffage individuel**            | 7,88 ms | 6,68 ms | 0,13 ms | 172,2 ms | 15,7 ms | 25,4 ms |
+| **Immeuble · chauffage mixte**                 | 6,74 ms | 5,47 ms | 0,22 ms | 911,0 ms | 14,1 ms | 22,5 ms |
+| **Individuel généré depuis l'immeuble (2026)** | 7,21 ms | 5,97 ms | 1,81 ms |  91,1 ms | 13,7 ms | 22,1 ms |
 
 <sub>La moyenne est tirée vers le haut par les DPE collectifs, dont le coût atteint plusieurs
 dizaines de fois la médiane : c’est la médiane qui décrit le cas courant, et p95/p99 le cas

package/engine.js

@@ -24,6 +24,7 @@ import {
   containsAnySubstring,
   isEffetJoule,
   set_bug_for_bug_compat,
+  set_compat_for_corpus_analysis,
   use_enum_as_string,
   useEnumAsString,
   xmlParser
@@ -35,7 +36,7 @@ import DpeSanitizerService from './dpe-sanitizer.service.js';
 import { reconstituerRdimDpeGenereImmeuble } from './17.2_rdim_dpe_genere_immeuble.js';
 import { reconstituerRdimEcsIndividuelleUnique } from './11_rdim_ecs_individuelle_unique.js';
 
-const LIB_VERSION = '1.9.1';
+const LIB_VERSION = '1.10.0';
 
 const dpeSanitizerService = new DpeSanitizerService();
 
@@ -58,7 +59,7 @@ export function getVersion() {
 /**
  * Run the engine with a full dpe xml content
  * @param dpeXmlContent {string} A full dpe xml content
- * @param options {{sanitize: boolean}?}
+ * @param options {{sanitize?: boolean, compat_for_corpus_analysis?: boolean}?} voir `calcul_3cl`
  * @return {FullDpe}
  */
 export function calcul_3cl_xml(dpeXmlContent, options) {
@@ -70,12 +71,18 @@ export function calcul_3cl_xml(dpeXmlContent, options) {
 /**
  * Run the engine with a javascript plain object dpe
  * @param inputDpe {FullDpe} A full plain object dpe
- * @param options {{sanitize: boolean}?}
+ * @param options {{sanitize?: boolean, compat_for_corpus_analysis?: boolean}?}
+ * - `sanitize` (défaut `true` si `options` est absent) : nettoyage du DPE d'entrée ;
+ * - `compat_for_corpus_analysis` (défaut `false`) : reprend les valeurs choisies par le logiciel de
+ *   saisie qui contredisent les données d'entrée (ligne q4pa_conv, issues #312 et #294), pour
+ *   reproduire les DPE du corpus ADEME. À réserver à l'analyse de corpus : jamais pour le contrôle
+ *   d'un DPE ni pour les scénarios de travaux.
  * @return {FullDpe}
  */
 export function calcul_3cl(inputDpe, options) {
   set_bug_for_bug_compat();
   if (!options) options = { sanitize: true };
+  set_compat_for_corpus_analysis(options.compat_for_corpus_analysis === true);
   let dpe;
   if (options.sanitize) {
     dpe = dpeSanitizerService.execute(inputDpe);

package/engine.spec.js

@@ -21,6 +21,7 @@ let useEnumAsStringFlag = false;
 
 vi.mock('./utils.js', () => ({
   set_bug_for_bug_compat: vi.fn(),
+  set_compat_for_corpus_analysis: vi.fn(),
   add_references: vi.fn(),
   get bug_for_bug_compat() {
     return bugForBugCompat;
@@ -104,6 +105,7 @@ const {
   collectionCanBeEmpty,
   containsAnySubstring,
   isEffetJoule,
+  set_compat_for_corpus_analysis,
   useEnumAsString,
   xmlParser
 } = await import('./utils.js');
@@ -365,6 +367,52 @@ describe('calcul_3cl - garde-fous précoces', () => {
   });
 });
 
+/**
+ * Option `compat_for_corpus_analysis` : reprise des valeurs du logiciel de saisie (ligne q4pa_conv)
+ * réservée à l'analyse du corpus ADEME. Désactivée par défaut et repositionnée à chaque appel.
+ */
+describe('calcul_3cl - option compat_for_corpus_analysis', () => {
+  const dpeNonSupporte = () => ({ administratif: { enum_modele_dpe_id: '99' } });
+
+  beforeEach(() => {
+    vi.spyOn(console, 'error').mockImplementation(() => {});
+  });
+
+  test('sans options : désactivée', () => {
+    calcul_3cl(dpeNonSupporte());
+    expect(set_compat_for_corpus_analysis).toHaveBeenCalledExactlyOnceWith(false);
+  });
+
+  test('options sans le champ : désactivée', () => {
+    calcul_3cl(dpeNonSupporte(), { sanitize: false });
+    expect(set_compat_for_corpus_analysis).toHaveBeenCalledExactlyOnceWith(false);
+  });
+
+  test('valeur non booléenne « truthy » : désactivée (seul true active la reprise)', () => {
+    calcul_3cl(dpeNonSupporte(), { sanitize: false, compat_for_corpus_analysis: 'true' });
+    expect(set_compat_for_corpus_analysis).toHaveBeenCalledExactlyOnceWith(false);
+  });
+
+  test('true : activée, sans changer la sanitisation demandée', () => {
+    const dpe = dpeNonSupporte();
+    calcul_3cl(dpe, { sanitize: true, compat_for_corpus_analysis: true });
+    expect(set_compat_for_corpus_analysis).toHaveBeenCalledExactlyOnceWith(true);
+    expect(sanitizeExecute).toHaveBeenCalledWith(dpe);
+  });
+
+  test('repositionnée à chaque appel : un appel par défaut après un appel activé la désactive', () => {
+    calcul_3cl(dpeNonSupporte(), { sanitize: false, compat_for_corpus_analysis: true });
+    calcul_3cl(dpeNonSupporte());
+    expect(vi.mocked(set_compat_for_corpus_analysis).mock.calls).toEqual([[true], [false]]);
+  });
+
+  test('calcul_3cl_xml transmet l’option', () => {
+    vi.mocked(xmlParser.parse).mockReturnValue({ dpe: dpeNonSupporte() });
+    calcul_3cl_xml('<dpe/>', { sanitize: false, compat_for_corpus_analysis: true });
+    expect(set_compat_for_corpus_analysis).toHaveBeenCalledExactlyOnceWith(true);
+  });
+});
+
 describe('calcul_3cl_xml - garde sur le modèle de DPE', () => {
   test('parse le XML puis retourne null pour un modèle non supporté', () => {
     const dpe = { administratif: { enum_modele_dpe_id: '99' } };

package/features/engine/domain/enveloppe/ventilation/deperdition-ventilation.service.js

@@ -1,7 +1,7 @@
 import { DeperditionService } from '../deperdition.service.js';
 
 import { logger } from '../../../../../core/util/logger/log-service.js';
-import { bug_for_bug_compat } from '../../../../../utils.js';
+import { bug_for_bug_compat, compat_for_corpus_analysis } from '../../../../../utils.js';
 import { TypeHabitation } from '../../../../dpe/domain/models/type-habitation.model.js';
 import { TypeVentilation } from '../../../../dpe/domain/models/type-ventilation.model.js';
 
@@ -100,12 +100,14 @@ export class DeperditionVentilationService extends DeperditionService {
           presenceJointsMenuiserie = '1';
         } else if (
           bug_for_bug_compat &&
+          compat_for_corpus_analysis &&
           presenceJointNonRenseignee &&
           this.tvStore.getQ4paConvById(ventilationDE.tv_q4pa_conv_id)
             ?.presence_joints_menuiserie === '1'
         ) {
           // Issue #294 : aucune menuiserie n'exporte presence_joint, rien ne contredit la ligne
-          // q4pa_conv « avant 1948 avec joints » retenue par le DPE => on la reprend.
+          // q4pa_conv « avant 1948 avec joints » retenue par le DPE => on la reprend, uniquement
+          // pour l'analyse du corpus ADEME (option compat_for_corpus_analysis).
           presenceJointsMenuiserie = '1';
         }
       }

package/features/engine/domain/enveloppe/ventilation/deperdition-ventilation.service.spec.js

@@ -1,11 +1,14 @@
 import { beforeEach, describe, expect, test, vi } from 'vitest';
 
-/** `bug_for_bug_compat` (utils.js) piloté par le test. */
-const state = vi.hoisted(() => ({ bug: false }));
+/** `bug_for_bug_compat` et `compat_for_corpus_analysis` (utils.js) pilotés par le test. */
+const state = vi.hoisted(() => ({ bug: false, compat: false }));
 vi.mock('../../../../../utils.js', async (importOriginal) => ({
   ...(await importOriginal()),
   get bug_for_bug_compat() {
     return state.bug;
+  },
+  get compat_for_corpus_analysis() {
+    return state.compat;
   }
 }));
 
@@ -32,6 +35,7 @@ describe('DeperditionVentilationService.q4paConv', () => {
     };
     service = new DeperditionVentilationService(tvStore);
     state.bug = false;
+    state.compat = false;
   });
 
   test('Q4Pa mesuré saisi : utilisé directement', () => {
@@ -52,6 +56,7 @@ describe('DeperditionVentilationService.q4paConv', () => {
   describe('presence_joint non exporté (issue #294)', () => {
     test('hors bug_for_bug_compat : la ligne du DPE est ignorée', () => {
       state.bug = false;
+      state.compat = true;
       tvStore.getQ4paConvById.mockReturnValue({ presence_joints_menuiserie: '1' });
 
       service.q4paConv({ tv_q4pa_conv_id: 12 }, ctx, 0, 100, 0, 10, true);
@@ -59,8 +64,20 @@ describe('DeperditionVentilationService.q4paConv', () => {
       expect(tvStore.getQ4paConv).toHaveBeenCalledWith('1', 'APPARTEMENT', '0', undefined);
     });
 
-    test('bug_for_bug_compat et ligne DPE « avec joints » : joints repris', () => {
+    test('par défaut (sans compat_for_corpus_analysis) : la ligne du DPE est ignorée', () => {
       state.bug = true;
+      state.compat = false;
+      tvStore.getQ4paConvById.mockReturnValue({ presence_joints_menuiserie: '1' });
+
+      service.q4paConv({ tv_q4pa_conv_id: 12 }, ctx, 0, 100, 0, 10, true);
+
+      expect(tvStore.getQ4paConvById).not.toHaveBeenCalled();
+      expect(tvStore.getQ4paConv).toHaveBeenCalledWith('1', 'APPARTEMENT', '0', undefined);
+    });
+
+    test('compat_for_corpus_analysis et ligne DPE « avec joints » : joints repris', () => {
+      state.bug = true;
+      state.compat = true;
       tvStore.getQ4paConvById.mockReturnValue({ presence_joints_menuiserie: '1' });
 
       service.q4paConv({ tv_q4pa_conv_id: 12 }, ctx, 0, 100, 0, 10, true);
@@ -69,8 +86,9 @@ describe('DeperditionVentilationService.q4paConv', () => {
       expect(tvStore.getQ4paConv).toHaveBeenCalledWith('1', 'APPARTEMENT', '0', '1');
     });
 
-    test('bug_for_bug_compat mais presence_joint renseigné : pas de reprise', () => {
+    test('compat_for_corpus_analysis mais presence_joint renseigné : pas de reprise', () => {
       state.bug = true;
+      state.compat = true;
       tvStore.getQ4paConvById.mockReturnValue({ presence_joints_menuiserie: '1' });
 
       service.q4paConv({ tv_q4pa_conv_id: 12 }, ctx, 0, 100, 0, 10, false);
@@ -78,8 +96,9 @@ describe('DeperditionVentilationService.q4paConv', () => {
       expect(tvStore.getQ4paConv).toHaveBeenCalledWith('1', 'APPARTEMENT', '0', undefined);
     });
 
-    test('bug_for_bug_compat et ligne DPE sans joints : pas de reprise', () => {
+    test('compat_for_corpus_analysis et ligne DPE sans joints : pas de reprise', () => {
       state.bug = true;
+      state.compat = true;
       tvStore.getQ4paConvById.mockReturnValue({ presence_joints_menuiserie: '' });
 
       service.q4paConv({ tv_q4pa_conv_id: 1 }, ctx, 0, 100, 0, 10, true);
@@ -89,6 +108,7 @@ describe('DeperditionVentilationService.q4paConv', () => {
 
     test('surfaces majoritairement isolées : le critère des joints ne s’applique pas', () => {
       state.bug = true;
+      state.compat = true;
       tvStore.getQ4paConvById.mockReturnValue({ presence_joints_menuiserie: '1' });
 
       service.q4paConv({ tv_q4pa_conv_id: 12 }, ctx, 100, 0, 0, 10, true);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open3cl/engine",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "description": "Open Source 3CL-DPE engine",
   "main": "index.js",
   "directories": {

package/utils.js

@@ -40,6 +40,29 @@ export function set_bug_for_bug_compat() {
   bug_for_bug_compat = true;
 }
 
+/**
+ * Compatibilité réservée à l'analyse du corpus ADEME.
+ *
+ * Activée, le moteur reprend certaines valeurs choisies par le logiciel de saisie même
+ * lorsqu'elles contredisent les données d'entrée (ex. ligne `tv_q4pa_conv_id` incohérente avec
+ * l'isolation des parois ou les joints des menuiseries, issues #312 et #294), dans le seul but de
+ * reproduire les résultats des DPE du corpus.
+ *
+ * Ne jamais l'activer pour contrôler la cohérence d'un DPE ni pour calculer des scénarios de
+ * travaux : l'erreur du logiciel de saisie serait alors masquée ou propagée.
+ *
+ * Positionnée à chaque appel de `calcul_3cl` à partir de l'option du même nom.
+ * @type {boolean}
+ */
+export let compat_for_corpus_analysis = false;
+
+/**
+ * @param value {boolean} `true` uniquement pour l'analyse du corpus ADEME
+ */
+export function set_compat_for_corpus_analysis(value = false) {
+  compat_for_corpus_analysis = value === true;
+}
+
 export function useEnumAsString(jsonObj) {
   for (const key in jsonObj) {
     if (jsonObj.hasOwnProperty(key)) {

package/utils.spec.js

@@ -35,6 +35,7 @@ vi.mock('./tv.js', () => ({
 const {
   xmlParser,
   set_bug_for_bug_compat,
+  set_compat_for_corpus_analysis,
   useEnumAsString,
   set_use_enum_as_string,
   set_tv_match_optimized_version,
@@ -171,6 +172,20 @@ describe('Utils unit tests', () => {
       expect(utils.bug_for_bug_compat).toBe(true);
     });
 
+    test('compat_for_corpus_analysis : désactivé par défaut, seul true l’active', () => {
+      expect(utils.compat_for_corpus_analysis).toBe(false);
+      set_compat_for_corpus_analysis(true);
+      expect(utils.compat_for_corpus_analysis).toBe(true);
+      set_compat_for_corpus_analysis();
+      expect(utils.compat_for_corpus_analysis).toBe(false);
+      set_compat_for_corpus_analysis(true);
+      set_compat_for_corpus_analysis('true');
+      expect(utils.compat_for_corpus_analysis).toBe(false);
+      set_compat_for_corpus_analysis(true);
+      set_compat_for_corpus_analysis(false);
+      expect(utils.compat_for_corpus_analysis).toBe(false);
+    });
+
     test('set_use_enum_as_string active le drapeau', () => {
       set_use_enum_as_string();
       expect(utils.use_enum_as_string).toBe(true);