Repository Public
1# État d'implémentation — module Quantity Survey (ex-Métré)23> Mis à jour le 2026-10-28 (soir). Déployé sur `https://www.uqo-eval.app/quantity-survey` (`/metre` redirigé) (M2U64, PM2 `uqo-eval`). Feature flag `METRE_ENABLED=1`.45## Phases67| Phase | État | Livrables |8|---|---|---|9| **A — Audit et baseline** | ✅ terminée | `OPENCONSTRUCTIONERP_AUDIT.md` (commit `93135eeb`), `UQO_EVAL_INTEGRATION_AUDIT.md`, baseline 69 tests / tsc / lint, journal des décisions de licence (`DATA_SOURCES_AND_LICENSES.md`) |10| **B — Fondations** | ✅ terminée | feature flag + entrée de navigation, schéma `metre.db` v1 (migrations forward-only), authentification par codes + sessions, rôles et isolation par projet, projets/membres/gabarits, préremplissage MAMH, registre des sources, pipeline d'ingestion (download → hash → parse → normalize → classify → validate → dedupe → publish) |11| **C — Estimation MVP** | ✅ terminée | registre de mesures manuelles, moteur de recettes (imbrication, pertes, productivité, cycles), moteur d'estimation en cents (ordre documenté, localisation, actualisation StatCan, TPS/TVQ), provenance par ligne (catalogue / recette / hypothèse), révisions immuables hachées, scénarios, sensibilité, rapport PDF **FR/EN**, CSV, XLSX |12| **D — Plan Studio** | ✅ terminée (v2, éditeur d'architecte) | **création sans fichier** : plan vierge à l'échelle (grille 1 m, calibration exacte), **galerie de 38 gabarits paramétriques** (`templates.ts` : 10 bungalows, 9 maisons à 2 étages/jumelées, 10 plex de 2 à 9 logements, 2 maisons en rangée, 2 chalets, maison mobile, copropriété, 3 garages — niveaux complets sous-sol/RDC/étage, pièces nommées, ouvertures, empreinte, fiche technique préremplie ; aperçu SVG `GET /api/metre/templates?key=`), **zone de dessin agrandie** (hauteur = écran − 230 px, plein écran, panneau repliable), **plan de site satellite géoréférencé** (Mapbox, échelle exacte Web Mercator, géocodage d'adresse / MAMH), niveaux (duplication d'étage) ; import PDF/PNG/JPG (calibration 2 points) et DXF ; **murs à épaisseur avec jonctions en onglet**, cloisons, **portes à battant et fenêtres insérées dans les murs**, pièces nommées avec surface, cotations automatiques et manuelles, textes, escaliers, colonnes, empreinte, lot ; saisie des longueurs au clavier, ortho 15°, aimant sommets/segments/grille, zoom à la molette, déplacement, glisser-déposer des sommets, annuler/rétablir, calques, raccourcis ; **export PDF/PNG/SVG avec cartouche** ; quantités en direct et « Mesurer tout → registre » |13| **E — Intelligence des données québécoises** | ✅ terminée (périmètre légalement accessible) | SEAO (OCDS, CC-BY) **ingéré en production** (totaux de contrats octroyés, UNSPSC) ; permis Montréal (CC-BY) **ingéré** : agrégats annuels de valeur déclarée des travaux par arrondissement et type (seule ressource portant une valeur) + résumé du détail (562 748 permis, sans valeur) ; DTNI-11A/11B et MTMD : **import manuel** (sites protégés HTTP 403, pas de jeu ouvert) avec classification MasterFormat assistée et revue ; indices StatCan (actualisation) et grilles APCHQ réutilisés ; classes d'évidence séparées ; facteurs régionaux = ceux de `cost_locations` (hypothèses documentées, **aucun facteur empirique calculé** faute d'observations unitaires comparables par région) ; tableau de bord QA, citations, comparaison historique côte à côte de deux révisions |14| **F — Évaluation et enseignement** | ✅ terminée (périmètre de base) | cas d'évaluation liés aux révisions (remplacement/reproduction, site, physique âge-vie ou %, fonctionnel curable/incurable avec garde anti-double déduction, externe, terrain), gabarits de projets, devoirs avec corrigé protégé, remises, notation, codes d'accès par cours ; lien vers l'atelier `/cout` pour la dépréciation par composante |15| **C bis — Méthode du relevé des quantités** | ✅ terminée | **fiche technique du bâtiment** (onglet Fiche : fondation, sous-sol, structure, isolation, revêtements, toiture, ouvertures, finitions, cuisine/salles de bain, mécanique, électricité, extérieur ; `projects.spec_json`, validée par `sanitizeSpec`) + **relevé automatique** `quantity-survey.ts` : depuis les plans calibrés de chaque niveau (murs ext./cloisons, ouvertures, pièces et usages, empreinte, périmètre) et la fiche → ≈ 40 lignes mappées sur les codes d'assemblage du catalogue (excavation, semelles, murs et dalle de fondation, planchers, murs 2×6/2×4, fermes et OSB, isolation murs/comble, revêtements, toiture selon pente, fenêtres/portes/portes-patio/placards, gypse murs/plafonds, peinture, planchers par usage de pièce, plinthes, cuisine, salles de bain, plomberie, chauffe-eau, chauffage selon fiche, VRC, entrée 200 A, filage, luminaires, perron) avec formule, entrées, origine (plan / fiche) et pages sources ; bouton **Relevé des quantités depuis les plans** (onglet Estimation) → mesures « QS · … » au registre + lignes d'estimation `origin: "qs"` regénérables sans doublon ; `POST /api/metre/projects/[id]/quantity-survey` |16| **G — Avancé** | 🟡 livrée pour l'essentiel | **Assistance IA révisable** (`src/lib/metre/ai.ts`, Claude via la clé serveur existante) : proposition d'assemblages (codes filtrés sur le catalogue), postes manquants, explication pédagogique, commentaire d'anomalies détectées par règles déterministes, classification MasterFormat des observations importées — chaque suggestion est étiquetée (modèle, version de prompt, empreinte, preuves), enregistrée en attente, acceptée/refusée par un humain, journalisée, plafonnée par budget quotidien ; **jamais de prix**. **Import DXF ASCII** (LINE, LWPOLYLINE, POLYLINE, CIRCLE ; calibration exacte depuis `$INSUNITS`). Non livré : IFC (aucun analyseur validé), reconnaissance d'images, collaboration temps réel, facteurs régionaux empiriques |1718## Définition de « terminé » — vérifiée en production (API et navigateur Chromium via Playwright)1920Un utilisateur peut, sans mot de passe : créer un projet → dessiner un plan d'architecte (ou le capturer depuis la carte satellite, ou téléverser et calibrer un plan) → mesurer un élément → choisir un prix d'assemblage vérifié (catalogue/recette) ou explicitement supposé → produire une estimation tracée → la lier à la méthode du coût → exporter un rapport professionnel bilingue — sans perturber le reste d'UQO Éval (pages existantes et 69 tests inchangés). Chaque chiffre a une origine reproductible (révision + instantané + registre), chaque estimation a une version, chaque jeu de données a ses droits documentés.2122## RSMeans Québec, relevé tarifé RSMeans et cas d'étude (2026-10-28, soir)2324- **Renommage** : le module s'appelle **Quantity Survey** (navigation, coquille, pages, fil d'Ariane ; routes `/quantity-survey/*`, anciennes routes `/metre/*` redirigées en 308 ; l'onglet du registre s'appelle « Relevé »). Les chemins d'API `/api/metre/*` et le code interne gardent le nom `metre`.25- **Données RSMeans (Gordian) 2026 T4** extraites de RSMeans Online (compte UQO) pour le Québec : 4 livres (commercial STD/OPN, rénovation STD/OPN, résidentiel RES, entretien FMR), moyenne nationale + 17 villes du Québec ; 79 044 lignes, 3 059 013 prix localisés extraits (tous livres pour Montréal/Québec/Gatineau/Hull, livres commercial et résidentiel pour les 13 autres villes), 22 071 facteurs de localisation par section validés à l'arrondi près (p90 < 0,1 %) ; base `data/rsmeans.db`, service, API, explorateur dans le Catalogue, sélecteur de ligne RSMeans dans l'estimation, base de prix `rsmeans` (coûts bare + majorations du module). Détails, licence et validation : `RSMEANS.md`.26- **Relevé des quantités tarifé RSMeans** : chaque famille du relevé correspond à une ou plusieurs lignes RSMeans (`rsmeans-qs-map.ts`, testée contre la base) ; choix de la tarification au moment de générer le relevé.27- **Cas d'étude** : `scripts/qs-seed-cases.mts` — 8 gabarits verrouillés « plan + relevé + détail des coûts RSMeans » dans 8 villes.2829## Téléchargements universels de la plateforme (2026-10-28)3031Tout élément généré par UQO Éval se télécharge **avec la mention UQO Éval** (en-tête, feuille de couverture, pied de page, enveloppe JSON) : `src/lib/export-generic.ts` (feuilles → CSV / XLSX / PDF / JSON), `POST|GET /api/export`, composant `DownloadMenu`. Branché sur : laboratoire d'économétrie (résultats du modèle : coefficients, diagnostics, validation croisée, indice temporel, effets géographiques…), estimation « le prix d'un… » (XLSX/CSV/JSON en plus des deux PDF), parc immobilier, méthode du coût (enregistrée ou non), tableau de bord des statistiques, « la valeur de l'immobilier québécois », « la mesure à l'épreuve du marché », pages de municipalité, atelier des comparables à vendre ; le Métré conserve ses exports par révision (PDF FR/EN, CSV, XLSX, JSON, plans PDF/PNG/SVG). Détails : `docs/EXPORTS.md`.3233## Limitations connues3435- **Prix** : les assemblages du catalogue combinent prix observés (détaillants, APCHQ) et prix de référence internes étiquetés « hypothèse » ; part observée affichée partout.36- **Facteurs régionaux** : hypothèses `cost_locations` (main-d'œuvre uniforme CCQ, surcoût de transport matériaux) ; non empiriques.37- **DTNI / MTMD** : import manuel seulement ; aucun barème n'a encore été importé en production (droits à confirmer par l'administrateur).38- **Permis Montréal** : le détail des permis ne publie **aucune valeur de travaux** ; seules les statistiques annuelles agrégées en portent une (ingérées). Le téléchargement exige un User-Agent de navigateur (403 sinon).39- **SEAO** : 2 semaines ingérées au déploiement ; relancer périodiquement depuis `/metre/admin` (≈ 19 Mo par semaine).40- **Plan Studio** : pas de reconnaissance automatique d'images ; DXF ASCII seulement (pas de DWG/DXF binaire ni IFC) ; polygones ≤ 500 points ; parcours complet couvert par un test Playwright (`e2e/metre.spec.ts`).41- **Accès** : plateforme OUVERTE (session anonyme automatique, projets visibles et modifiables par tous, verrou par projet, gabarits en lecture seule, codes facultatifs pour l'administration) — choix pédagogique assumé : pas de confidentialité entre utilisateurs.42- **IA** : suggestions textuelles seulement (pas d'annotation automatique de plans) ; coût suivi par appel, budget quotidien `METRE_AI_DAILY_BUDGET_USD` (5 $ US par défaut).43- **Performance** : SQLite ; adapté à un cours (voir mesures dans `VALIDATION_PLAN.md`).4445## Fichiers4647```48src/lib/metre/{types,money,units,geometry,measure,assemblies,estimate-engine,valuation}.ts modules purs49src/lib/metre/{db,auth,projects,plans,estimates,report,exports}.ts services50src/lib/metre/sources/{csv,seao,permits,schedule-import,ingest}.ts sources51src/lib/metre/{engine,services,examples,dxf,ai,scale,plan,qs}.test.ts tests (97) · e2e/{metre,exports}.spec.ts (Playwright, 4)52src/lib/metre/templates.ts · quantity-survey.ts 38 gabarits paramétriques · relevé des quantités53src/lib/export-generic.ts (+ .test.ts) · src/app/api/export/route.ts · src/components/DownloadMenu.tsx téléchargements universels54src/lib/metre/ai.ts · src/lib/metre/sources/dxf.ts · scripts/metre-backup.sh · scripts/metre-seed-examples.ts55src/app/api/metre/** 37 routes56src/lib/metre/plan-geometry.ts · plan-render.ts (murs, ouvertures, cotations, rendu SVG partagé client/serveur)57src/components/metre/{MetreShell,MapPicker}.tsx · metre.css (coquille ERP, carte satellite)58src/app/metre/{page,projets/[id]/page,catalogue/page,admin/page}.tsx pages59src/components/metre/{ui,MetreHome,ProjectWorkspace,PlanStudio,TakeoffLedger,EstimateEditor,ValuationPanel,AssemblyEditor,CatalogueView,AdminPanel}.tsx60public/metre/pdf.worker.min.mjs worker pdfjs61src/lib/metre/{rsmeans,rsmeans-qs-map}.ts (+ rsmeans.test, rsmeans-map.test) · src/app/api/metre/rsmeans · src/components/metre/RsmeansPanel.tsx RSMeans Québec62scripts/rsmeans-build.py · scripts/qs-seed-cases.mts base RSMeans · cas d'étude63docs/construction/*.md documentation (11)64```6566## Prochaines étapes recommandées67681. Importer le DTNI-11A/11B (juin 2026) et, le cas échéant, des bordereaux MTMD après vérification des droits ; relancer SEAO chaque semaine.692. Créer les codes étudiants IMM1033 ; les trois gabarits d'exemple sont déjà en place (`scripts/metre-seed-examples.ts`) ; rédiger les corrigés des devoirs.703. Facteurs régionaux empiriques lorsque des observations unitaires comparables par région existeront (bordereaux, soumissions).714. IFC/DWG seulement via un analyseur validé ; annotation de plans assistée par vision si un besoin pédagogique le justifie.72