Repository Public
1# Architecture du module « Métré estimatif / intelligence de la construction »23> Module intégré à UQO Éval (Next.js 16, SQLite), activé par `METRE_ENABLED=1`. Inspiré, sans copie de code, d'OpenConstructionERP (voir `OPENCONSTRUCTIONERP_AUDIT.md`).45## 1. Vue d'ensemble67```8Navigateur (Plan Studio : pdfjs-dist → PNG par page, SVG de dessin, autosauvegarde)9 │ cookie de session HttpOnly (metre_session)10 ▼11src/app/api/metre/* (route handlers Node ; requireUser → requireProject ; HttpError → JSON)12 │13 ├─ src/lib/metre/auth.ts codes d'accès, sessions, rôles, droits par projet, audit14 ├─ src/lib/metre/projects.ts projets, membres, préremplissage MAMH (vraiprix.db, lecture)15 ├─ src/lib/metre/plans.ts fichiers (sharp), pages, calibrations révisionnées, objets, registre16 ├─ src/lib/metre/estimates.ts contexte de prix (cost.db + recettes), lignes, calcul, révisions, scénarios, évaluation17 ├─ src/lib/metre/sources/* SEAO (OCDS), permis Montréal, barèmes CSV, pipeline d'ingestion + QA18 ├─ src/lib/metre/report.ts, exports.ts PDF FR/EN (pdfkit), CSV, XLSX (exceljs)19 ├─ src/lib/metre/ai.ts assistance IA révisable (Claude via clé serveur) : mapping d'assemblages, postes manquants, explication, anomalies, classification20 ├─ src/lib/metre/sources/dxf.ts lecteur DXF ASCII pur → page raster (sharp) + calibration exacte + objets21 │22 └─ modules PURS (testés sans base) : types.ts, money.ts, units.ts, geometry.ts, measure.ts,23 assemblies.ts, estimate-engine.ts, valuation.ts24 │25 ▼26data/metre.db (schéma v1) · data/metre-files/<projet>/<fichier>/original.pdf + page-N.png · data/metre-files/_sources/<clé>/<hash>.*27data/cost.db (LECTURE : articles, prix canoniques, assemblages, grilles APCHQ/CCQ, indices StatCan, localisations)28```2930## 2. Écrans (`src/app/metre`, composants `src/components/metre`)3132| Écran | Route | Composant | Contenu |33|---|---|---|---|34| Tableau de bord | `/metre` | `MetreHome` | connexion, projets visibles, révisions récentes, fraîcheur du catalogue, devoirs, création de projet (préremplissage MAMH) |35| Projet | `/metre/projets/[id]` | `ProjectWorkspace` | onglets **Projet** (fiche, membres), **Plan Studio** (`PlanStudio`, PDF/PNG/JPG/DXF), **Métré** (`TakeoffLedger`), **Assemblages** (`AssemblyEditor`), **Estimation** (`EstimateEditor` + panneau d'assistance IA révisable), **Valeur** (`ValuationPanel`), **Rapports** (révisions, comparaison côte à côte de deux révisions, exports, remise de devoir, originaux) |36| Catalogue | `/metre/catalogue` | `CatalogueView` | assemblages/articles avec prix du jour et provenance, grille de main-d'œuvre, observations par classe d'évidence |37| Administration | `/metre/admin` | `AdminPanel` | sources et licences, ingestion SEAO/permis, import CSV, QA des documents, codes d'accès, devoirs (corrigé protégé), journal d'audit |3839## 3. Flux principal (définition de « terminé »)40411. Créer un projet (optionnellement prérempli depuis le rôle MAMH).422. Importer un plan → pages PNG → **calibrer** (2 points, révision n).433. Dessiner (pièce, dalle, mur, ouverture, toit, fondation, ligne) → **Mesurer** → ligne du registre (formule, entrées, valeur, unité, révision de calibration) → **Vérifier**.444. Estimation : lignes liées aux mesures (la quantité est toujours relue dans le registre) × facteur d'ajustement explicite ; assemblage du catalogue, recette du module ou **prix supposé** (avec justification) ; paramètres ordonnés ; recalcul déterministe à chaque modification.455. **Figer une révision** : instantané immuable (lignes, paramètres, résultat, prix utilisés, versions catalogue/formules, SHA-256) ; refusé si une mesure liée est périmée.466. Cas d'évaluation (méthode du coût) lié à la révision → valeur indiquée.477. Rapport PDF FR/EN, CSV, XLSX régénérés depuis la révision.4849## 4. Principes non négociables appliqués dans le code5051- **Aucun prix inventé** : un prix affiché est (a) un coût d'assemblage du catalogue dont chaque composant porte sa provenance (`observed` / `official` / `indexed` / `derived` / `reference`), (b) une **hypothèse explicite** de l'utilisateur (`basis = assumption`, note obligatoire pour une confiance > 25), ou (c) une observation externe avec sa **classe d'évidence**. Une ligne sans prix reste à 0 et est signalée (« ligne non chiffrée »), jamais remplie.52- **Un total de contrat SEAO ou une valeur de permis n'est jamais une quantité unitaire** : classes `awarded_contract_total` et `permit_declared_value` avec note d'incertitude ; l'interface ne les propose pas comme prix de ligne.53- **Traçabilité** : chaque nombre du rapport descend d'une ligne de révision, elle-même liée à une mesure (formule + entrées + objet + page + calibration) et à un devis unitaire (composants + sources + dates).54- **Déterminisme** : mêmes lignes + mêmes paramètres + même instantané = même résultat (test `engine.test.ts`).5556## 4 bis. Plateforme ouverte (2026-10-28)5758À la demande du propriétaire du projet, le module est **ouvert** : `POST /api/metre/auth/anonymous` crée une session (cookie) à la première visite ; `projectAccess` renvoie « write » à tout le monde sur un projet ordinaire, « owner » au créateur, au personnel et aux éditeurs explicites, « read » sur les gabarits et les projets verrouillés. Les codes ne servent qu'à élever une session au rôle enseignant/admin (`/api/metre/auth/login` sur une session existante). La coquille `MetreShell` (barre latérale, pleine largeur) remplace la mise en page éditoriale pour tout `/metre`.5960## 4 ter. Éditeur de plan d'architecte6162`plan-geometry.ts` (pur) : décalage de polylignes en murs à épaisseur (onglets limités), anneaux extérieur/intérieur des boucles fermées, projection d'un point sur un mur (pose des ouvertures), symboles porte (vantail + arc) et fenêtre, géométrie des cotations, centroïdes, aimant (sommets → segments → ortho 15° → grille), quantités (`planQuantities`). `plan-render.ts` (pur) : SVG partagé par l'éditeur (`dangerouslySetInnerHTML` du calque de rendu) et l'export serveur (`exportPage` : SVG → PNG via sharp → PDF Lettre paysage, cartouche). Pages sans fichier : `createBlankPage` (grille papier), `createTemplatePage`, `createMapPage` (Mapbox Static Images, m/px = 40 075 016,686 × cos φ / (512 × 2^z) ÷ 2), `duplicatePage` (niveaux).6364## 5. Sécurité6566- Sessions : jeton 256 bits stocké haché (SHA-256), cookie `HttpOnly; SameSite=Lax; Secure` (prod), 30 jours ; rate-limit par IP sur la connexion (10 / 10 min) et les actions sensibles.67- Autorisation serveur : `requireUser` (401 sans session — le client en crée une automatiquement), `requireProject` (404 projet inexistant, 403 droit insuffisant : suppression/verrou réservés au créateur et au personnel, gabarits et projets verrouillés en lecture seule) ; rôles vérifiés sur les routes d'administration ; corrigés de devoirs jamais sélectionnés pour un étudiant.68- Téléversements : signature magique vérifiée (PDF/PNG/JPEG), tailles bornées (60 Mo, 25 Mo/page, 60 pages, 8 000 px), PNG **ré-encodés par sharp**, stockage hors `public/`, téléchargement via route autorisée (`Content-Disposition: attachment`, `nosniff`), noms de fichiers assainis.69- Entrées : toutes bornées/validées (`sanitize*`), identifiants UUID, pas de SQL dynamique non paramétré.70- Journal d'audit (`metre_audit_events`) : connexion, projets, plans, calibrations, mesures, estimations, révisions, évaluations, ingestion, QA, devoirs.71- Secrets : codes d'amorçage en variables d'environnement ; aucune clé en navigateur ; l'assistance IA s'exécute côté serveur avec la clé existante, sous budget quotidien, et chaque sortie est stockée en attente de revue (`metre_ai_suggestions`, audit `ai.suggest` / `ai.accepted` / `ai.rejected`).72- Sauvegardes : `scripts/metre-backup.sh` (quotidien via PM2) ; restauration documentée dans `SCHEMA_AND_MIGRATIONS.md`.7374## 6. Choix d'implémentation7576- **Pas de PostGIS, pas de Postgres** : SQLite suffit au périmètre pédagogique ; les points sont stockés en JSON (pixels de page) et convertis par la calibration.77- **Rendu PDF client** (pdfjs-dist, Apache-2.0) : aucun binaire serveur (poppler absent du nœud), l'original est conservé et haché.78- **Argent en cents entiers** (`money.ts`), arrondi demi vers le haut, une fois par étape.79- **Unités** : SI en interne (m, m², m³) ; conversion vers l'unité de l'assemblage uniquement entre grandeurs de même dimension ; le catalogue (pi², pi lin.) est converti par `catalogueUnitToMeasure`.80- **Le catalogue `cost.db` n'est pas modifié** : les recettes du module le référencent ; la mise à jour des prix reste assurée par `scripts/cost-sync.ts`.81