SPB Git

Repository Public

IMPLEMENTATION_STATUS.md 13.0 KB

# État d'implémentation — module Quantity Survey (ex-Métré)

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.

# Phases

Phase État Livrables
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)
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)
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
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 »
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
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
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
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

# Définition de « terminé » — vérifiée en production (API et navigateur Chromium via Playwright)

Un 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.

# RSMeans Québec, relevé tarifé RSMeans et cas d'étude (2026-10-28, soir)

  • 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.
  • 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.
  • 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é.
  • Cas d'étude : scripts/qs-seed-cases.mts — 8 gabarits verrouillés « plan + relevé + détail des coûts RSMeans » dans 8 villes.

# Téléchargements universels de la plateforme (2026-10-28)

Tout é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.

# Limitations connues

  • 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.
  • Facteurs régionaux : hypothèses cost_locations (main-d'œuvre uniforme CCQ, surcoût de transport matériaux) ; non empiriques.
  • DTNI / MTMD : import manuel seulement ; aucun barème n'a encore été importé en production (droits à confirmer par l'administrateur).
  • 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).
  • SEAO : 2 semaines ingérées au déploiement ; relancer périodiquement depuis /metre/admin (≈ 19 Mo par semaine).
  • 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).
  • 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.
  • 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).
  • Performance : SQLite ; adapté à un cours (voir mesures dans VALIDATION_PLAN.md).

# Fichiers

text
src/lib/metre/{types,money,units,geometry,measure,assemblies,estimate-engine,valuation}.ts   modules purs
src/lib/metre/{db,auth,projects,plans,estimates,report,exports}.ts                            services
src/lib/metre/sources/{csv,seao,permits,schedule-import,ingest}.ts                            sources
src/lib/metre/{engine,services,examples,dxf,ai,scale,plan,qs}.test.ts                         tests (97) · e2e/{metre,exports}.spec.ts (Playwright, 4)
src/lib/metre/templates.ts · quantity-survey.ts                                               38 gabarits paramétriques · relevé des quantités
src/lib/export-generic.ts (+ .test.ts) · src/app/api/export/route.ts · src/components/DownloadMenu.tsx   téléchargements universels
src/lib/metre/ai.ts · src/lib/metre/sources/dxf.ts · scripts/metre-backup.sh · scripts/metre-seed-examples.ts
src/app/api/metre/**                                                                          37 routes
src/lib/metre/plan-geometry.ts · plan-render.ts (murs, ouvertures, cotations, rendu SVG partagé client/serveur)
src/components/metre/{MetreShell,MapPicker}.tsx · metre.css (coquille ERP, carte satellite)
src/app/metre/{page,projets/[id]/page,catalogue/page,admin/page}.tsx                          pages
src/components/metre/{ui,MetreHome,ProjectWorkspace,PlanStudio,TakeoffLedger,EstimateEditor,ValuationPanel,AssemblyEditor,CatalogueView,AdminPanel}.tsx
public/metre/pdf.worker.min.mjs                                                               worker pdfjs
src/lib/metre/{rsmeans,rsmeans-qs-map}.ts (+ rsmeans.test, rsmeans-map.test) · src/app/api/metre/rsmeans · src/components/metre/RsmeansPanel.tsx   RSMeans Québec
scripts/rsmeans-build.py · scripts/qs-seed-cases.mts                                            base RSMeans · cas d'étude
docs/construction/*.md                                                                        documentation (11)

# Prochaines étapes recommandées

  1. 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.
  2. 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.
  3. Facteurs régionaux empiriques lorsque des observations unitaires comparables par région existeront (bordereaux, soumissions).
  4. IFC/DWG seulement via un analyseur validé ; annotation de plans assistée par vision si un besoin pédagogique le justifie.
Files main
Menu

Theme