Repository Public
1# Plan de validation et résultats mesurés23> Tous les chiffres ci-dessous ont été **mesurés** le 2026-10-28 sur le nœud de production M2U64 (Mac Studio M2 Ultra, 24 cœurs, 64 Go, SQLite WAL, Next.js 16 en mode production, requêtes `curl` locales sur `127.0.0.1:8150`). Aucun chiffre n'est estimé.45## 1. Tests automatisés (Vitest)67| Fichier | Tests | Couverture |8|---|---|---|9| `src/lib/metre/engine.test.ts` | 18 | unités (m²↔pi², yd³, po↔pi, refus inter-dimensions), géométrie (lacet, polyligne, auto-intersection, calibration et incertitude, pente de toit), mesures (aire, volume, toit, mur brut/net, déduction unique des ouvertures vérifiées, plafond, périmé), argent (demi vers le haut, somme de 1 000 cents, arrondis), recettes (direct = matériaux × (1 + pertes) + heures × taux + équipement + autres ÷ sortie ; installé ; imbrication sans double pertes ; cycle refusé), moteur (ordre des majorations, taxes non composées, facteur régional par composante, actualisation, arrondi au dollar, facteur d'ajustement, conversion d'unités, exclusions, hypothèses, déterminisme), méthode du coût (âge-vie, double déduction évitée, plafonds) |10| `src/lib/metre/services.test.ts` | 13 | authentification (codes env/générés, inconnu, épuisé, désactivé, sessions), isolation (404 pour un projet invisible, 403 pour droit insuffisant, membres, gabarits), téléversement (signature refusée), calibration révisionnée, mesures/vérification/périmé/recalcul, estimation (quantité relue du registre, hypothèse, révision hachée, immuabilité, scénarios, sensibilité, refus si périmé), évaluation liée, validations d'entrée, analyseurs SEAO/permis/barème, import idempotent + licence obligatoire + QA, journal d'audit |11| `src/lib/metre/examples.test.ts` | 5 | trois exemples résidentiels québécois à quantités vérifiées à la main (§4) |12| `src/lib/metre/dxf.test.ts` | 3 | lecteur DXF (entités, calques, $INSUNITS, entités ignorées, bornes), projection (Y inversé, marge, calibration exacte), SVG, fichiers sans unités / vides |13| `src/lib/metre/ai.test.ts` | 5 | assistance IA avec fournisseur simulé : filtrage des codes et cibles invalides, suggestion en attente et étiquetée, cache par empreinte, revue (accepter/refuser), postes manquants, explication, anomalies déterministes (z robuste, hypothèse sans note, facteur inhabituel) + commentaire, classification MasterFormat (divisions invalides filtrées, application seulement après acceptation), absence de clé API, audit ; import DXF de bout en bout (page, calibration exacte, objets, mesure 12 × 9 = 108 m²) |14| `src/lib/metre/scale.test.ts` | 1 | catalogue synthétique de **10 000 articles** : recherche, prix canoniques et contexte de devis chronométrés (§5) |15| `src/lib/metre/plan.test.ts` | 9 | géométrie d'architecte : décalage des murs (onglets, anneaux fermés), projection sur polyligne, insertion d'ouvertures, cotations, aimant, quantités d'un plan, pages sans fichier (vierge, gabarit, carte) |16| `src/lib/metre/qs.test.ts` | 43 | **38 gabarits générés** (un test par gabarit : niveaux attendus, ouvertures à < 1 cm de leur mur, pièces dans l'empreinte, ≥ 2 pièces et ≥ 3 ouvertures par niveau habitable, murs > 10 m) ; **relevé des quantités** pur (bungalow 12,2 × 9,1 m : 33 codes attendus, empreinte/périmètre/chambres/salles de bain, fenêtres depuis le plan, murs ext. > périmètre × 2,44 m, fondation = périmètre × hauteur ; fiche dalle/thermopompe/toit plat ; refus sans calibration) ; service (cottage → 3 niveaux → relevé → estimation chiffrée > 100 000 $, regénération sans doublon, duplication des plans) |17| `src/lib/metre/rsmeans.test.ts` | 7 | unités RSMeans → module (diviseurs M.S.F., C.L.F., Sq., S.Y.), prix extrait vs national × facteur (section puis division, repli entre types de MO), substitution de MO signalée, localisation d'un projet (municipalité → région → défaut), recherche FTS/numéro, devis d'une ligne « rsmeans » (coûts bare, provenance « barème publié »), moteur complet (m² → pi², majorations sur le bare) |18| `src/lib/metre/rsmeans-map.test.ts` | 4 | correspondance relevé → RSMeans : couverture de toutes les familles, numéros/facteurs/unités valides ; **contre la base installée** : chaque ligne existe, a un prix national et une unité compatible ; cottage à Gatineau tarifé RSMeans (> 40 lignes, 100 % chiffrées, total plausible, regénération sans doublon) |19| `src/lib/export-generic.test.ts` | 6 | exports universels de la plateforme : feuilles (résumé, tableaux, tableaux imbriqués hissés, libellés bilingues, exclusions), CSV (BOM, mention UQO Éval, échappement), XLSX (feuille de couverture UQO Éval), PDF valide, JSON enveloppé, **ligatures JetBrains Mono neutralisées** (« // », « .. », « -- » faisaient planter fontkit) |20| existants (`engine`, `cost/engine`, `cost/ai`, `cost/connectors`) | 69 | **régression : inchangés et verts** |21| **Total unitaires/intégration** | **183** | `npx vitest run` : 15 fichiers, 183 tests verts (2026-10-28 soir) ; `tsc --noEmit` propre ; ESLint 0 erreur |22| **Bout en bout (Playwright, Chromium)** `e2e/metre.spec.ts` + `e2e/exports.spec.ts` | 5 | (5) **RSMeans Québec** : explorateur du catalogue (lignes à 12 chiffres, recherche « asphalt shingles laminated » → section 07 31 13), cas d'étude Cas 1 tarifé RSMeans (lignes « RSMeans NNNNNNNNNNNN », paramètres ville/MO RSMeans, PDF FR de la révision figée > 30 Ko) ; (3) **exports serveur** : estimation, parc, stats, province, marché, municipalité en CSV/XLSX/JSON/PDF (type MIME, taille, mention UQO Éval, 400/404) ; (4) **export client** (POST d'un résultat calculé) + boutons visibles sur `/stats`, `/stats/marche`, `/municipalite/gatineau` + téléchargement réel d'un CSV (`uqo-eval_l-immobilier-a-gatineau_….csv`). `npx playwright test` : **4 passed (7,0 s)** le 2026-10-28. (1) régression : `/`, `/cout`, `/a-vendre`, `/stats`, `/methodologie`, `/hedonique` en 200 et lien « Métré » présent ; (2) **parcours complet dans un vrai navigateur** : connexion par code → projet → téléversement PNG → calibration par deux clics (400 px = 4 m) → tracé d'une pièce 4 × 3 m → mesure (12 m²) → vérification au registre → estimation (ligne liée + hypothèse 1 500 $) → révision figée → PDF téléchargé (`%PDF`, > 20 Ko) → suppression. `npx playwright test` : **2 passed (6,4 s)** le 2026-10-28 |2324## 2. Tests d'intégration bout en bout (API, production)2526Scénario exécuté après déploiement : connexion admin → projet → mesure manuelle (120 m²) → estimation (ligne catalogue `INT-DRYWALL-1/2-FINISHED` liée + ligne hypothèse 3 × 1 500 $ installée) → calcul (gypse 4 385,99 $ localisé, provenance `observed`, conversion m² → pi² journalisée ; plomberie 4 500 $ `assumption`) → révision figée → **PDF (60 Ko), CSV, XLSX** générés → accès anonyme au projet : **401** → pages existantes `/`, `/cout`, `/a-vendre`, `/stats`, `/methodologie` : 200 → `https://www.uqo-eval.app/metre` : 200.2728Pipeline catalogue : import CSV → QA → publication → observations vérifiées (test `services.test.ts`). **Ingestions réelles exécutées en production le 2026-10-28** : SEAO (2 semaines, 1 306 totaux de contrats « works » 2013-06 → 2026-10, 3 652 releases non-travaux et 648 sans octroi ignorées), permis Montréal (1 267 agrégats annuels de valeur déclarée 1990 → 2026 ; détail sans valeur résumé). Trois gabarits d'exemple créés par `scripts/metre-seed-examples.mts` (r1 : 78 334,34 $ ; 115 971,27 $ taxes incluses ; 844 001,58 $ + méthode du coût).2930## 3. Sécurité3132| Vérification | Résultat |33|---|---|34| Accès inter-projets (autre étudiant) | 404 (existence non révélée) — test automatisé |35| Séparation des rôles (étudiant → gabarit, recette partagée, codes, ingestion, corrigé) | 403 / corrigé jamais sélectionné — tests + revue de code |36| Téléversement malveillant (texte renommé .pdf, PNG forgé) | signature magique + ré-encodage sharp ; refus 415 — test automatisé |37| Injection SQL | requêtes paramétrées uniquement (better-sqlite3) |38| Exposition de données sensibles | corrigés, IP (masquées pour l'enseignant), fichiers hors `public/`, cookies HttpOnly |39| Force brute sur les codes | 10 tentatives / 10 min / IP ; codes à 8 caractères alphanumériques (≈ 2,8 × 10¹²) hachés |4041## 4. QA humaine — trois estimations résidentielles québécoises4243Hypothèses de prix **explicites et pédagogiques** (classe `user_assumption`) ; quantités calculées à la main puis vérifiées par `examples.test.ts`.4445| Exemple | Métré vérifié à la main | Résultat moteur |46|---|---|---|47| **1. Bungalow 1 étage, Gatineau** — plan 12,2 m × 9,1 m (calibration 100 px/m) | dalle 12,2 × 9,1 × 0,10 = **11,102 m³** ; plancher **111,02 m²** ; toit pente 4/12 : 111,02 × 1,0541 = **117,03 m²** ; murs bruts (12,2 + 9,1) × 2 × 2,44 = **103,94 m²** | direct 3 164,07 + 17 150,10 + 5 618,40 + 34 416,20 = **60 348,77 $** ; CG 8 % 4 827,90 ; FG 7 % 4 562,37 ; profit 8 % 5 579,13 ; contingence 5 % 3 017,44 ; **total ≈ 78 336 $** (100 % hypothèses, affiché) |48| **2. Cottage 2 étages + garage, Montréal (impérial)** — 40 × 28 pi par étage, garage 22 × 22 pi, calibration 10 px/pi | plancher **1 120 pi²**/étage (104,05 m²) ; dalle de garage 484 pi² × 0,125 m = **5,621 m³** | 2 240 pi² × 28 $ = **62 720 $** ; avec facteur 1,05 = 65 856 $ (avertissement « facteur ») ; taxes : 100 000 $ → TPS 5 000 + TVQ 9 975 = **114 975 $** |49| **3. Triplex 1965, Québec** — 320 m² × 2 150 $/m² (benchmark de classe, hypothèse) | direct **688 000 $** ; CG/FG/profit 6 % en cascade ; actualisation 3 % | coût à neuf (avant taxes) ≈ 843 909 $ ; base remplacement −5 % ; site +15 000 ; physique 35/70 = **50 %** ; cuisines (45 000, éliminées par le remplacement) **non déduites** ; stationnement −20 000 ; externe −10 000 ; terrain 210 000 → valeur indiquée calculée et vérifiée (test) |5051## 5. Performance (mesurée)5253| Charge | Latence mesurée |54|---|---|55| Estimation de **1 000 lignes** (catalogue, 8 assemblages) : `PATCH` avec recalcul complet, réponse 1,1 Mo | **25–61 ms** (3 essais) |56| `GET` estimation 1 000 lignes (recalcul) | 19–30 ms |57| Figer une révision (1 000 lignes, instantané de prix) | 32 ms |58| Rapport **PDF** 1 000 lignes (≈ 205 Ko) | **1,03 s** |59| Export CSV / XLSX 1 000 lignes | 8 ms / 121 ms |60| Recherche catalogue (99 assemblages chiffrés + 184 articles) | 12–14 ms |61| Scénarios + sensibilité (6 recalculs) | 144 ms |62| 20 requêtes `dashboard` concurrentes | 82 ms au total |63| Téléversement de **20 pages** 2 000 × 1 500 px (ré-encodage sharp) | 250 ms |64| Image de page (48 Ko) | 2,5 ms |65| Création de **300 objets** (300 requêtes séquentielles) | 2,86 s (≈ 9,5 ms/objet) |66| **300 mesures** (300 requêtes séquentielles) | 3,31 s (≈ 11 ms/mesure) |67| Recalcul de 300 mesures périmées après recalibration (une requête) | 198 ms |68| Lecture complète d'un projet (300 mesures) | 3–15 ms |6970| **Catalogue de 10 000 articles** (synthétique, `scale.test.ts`) : recherche `LIKE` | **3,9 ms** |71| Prix canoniques des 10 000 articles (`loadPrices`) | 19 ms |72| Contexte de devis complet sur 10 000 articles (`buildQuoteContext`) | 16 ms |73| Ingestion SEAO réelle : 2 fichiers hebdomadaires (≈ 19 Mo chacun, 8 490 releases) → 1 306 observations | ≈ 25 s au total (téléchargement compris) |74| Ingestion permis Montréal réelle : statistiques (1 673 lignes → 1 267 observations) + détail 187 Mo résumé (76 595 permis depuis 2023) | ≈ 70 s (téléchargement compris) |75| Appel IA réel (`explain`, claude-haiku-5-5, exemple 1) | 0,004 $ US, réponse en français structurée |76| Sauvegarde quotidienne (`metre-backup.sh`) : base 5,4 Mo + fichiers 213 Mo | < 5 s |7778Non mesuré : charge de 100+ utilisateurs simultanés (hors périmètre d'un cours).7980## 6. Qualité des données8182| Contrôle | Implémentation |83|---|---|84| Doublons de sources | `UNIQUE(source_key, content_hash)` documents, `UNIQUE(source_key, external_id)` observations, `INSERT OR IGNORE` |85| Unités contradictoires | `convertQuantity` refuse les dimensions différentes ; ligne non chiffrée + avertissement |86| Licence absente | import manuel refusé sans licence ; registre `metre_sources.license` |87| Indices périmés | actualisation impossible → avertissement explicite, aucune actualisation appliquée |88| Prix aberrants | hérité de `cost.db` (MAD, bornes) ; observations externes : `verification_status`, drapeaux `metre_quality_flags` |89| Estimations de modèle non vérifiées | aucun modèle de prix déployé ; classe `modeled` réservée et étiquetée |9091## 7. Limites connues9293- Le test Playwright couvre un parcours nominal ; les cas limites d'interaction (tactile, annuler/rétablir, calques) restent validés manuellement.94- Le rendu PDF côté client dépend du navigateur (pdfjs) ; les PDF chiffrés/protégés échouent avec un message.95- Les prix du catalogue reposent pour ≈ 39 % (part non observée dans l'estimation de 1 000 lignes mesurée ci-dessus : 61 % observé) sur des prix de référence internes étiquetés « hypothèse ».96