SPB Git

Repository Public

ARCHITECTURE.md 8.7 KB

# Architecture du module « Métré estimatif / intelligence de la construction »

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

# 1. Vue d'ensemble

text
Navigateur (Plan Studio : pdfjs-dist → PNG par page, SVG de dessin, autosauvegarde)
   │ cookie de session HttpOnly (metre_session)
   ▼
src/app/api/metre/*  (route handlers Node ; requireUser → requireProject ; HttpError → JSON)
   │
   ├─ src/lib/metre/auth.ts        codes d'accès, sessions, rôles, droits par projet, audit
   ├─ src/lib/metre/projects.ts    projets, membres, préremplissage MAMH (vraiprix.db, lecture)
   ├─ src/lib/metre/plans.ts       fichiers (sharp), pages, calibrations révisionnées, objets, registre
   ├─ src/lib/metre/estimates.ts   contexte de prix (cost.db + recettes), lignes, calcul, révisions, scénarios, évaluation
   ├─ src/lib/metre/sources/*      SEAO (OCDS), permis Montréal, barèmes CSV, pipeline d'ingestion + QA
   ├─ src/lib/metre/report.ts, exports.ts   PDF FR/EN (pdfkit), CSV, XLSX (exceljs)
   ├─ src/lib/metre/ai.ts          assistance IA révisable (Claude via clé serveur) : mapping d'assemblages, postes manquants, explication, anomalies, classification
   ├─ src/lib/metre/sources/dxf.ts  lecteur DXF ASCII pur → page raster (sharp) + calibration exacte + objets
   │
   └─ modules PURS (testés sans base) : types.ts, money.ts, units.ts, geometry.ts, measure.ts,
      assemblies.ts, estimate-engine.ts, valuation.ts
   │
   ▼
data/metre.db (schéma v1)  ·  data/metre-files/<projet>/<fichier>/original.pdf + page-N.png  ·  data/metre-files/_sources/<clé>/<hash>.*
data/cost.db (LECTURE : articles, prix canoniques, assemblages, grilles APCHQ/CCQ, indices StatCan, localisations)

# 2. Écrans (src/app/metre, composants src/components/metre)

Écran Route Composant Contenu
Tableau de bord /metre MetreHome connexion, projets visibles, révisions récentes, fraîcheur du catalogue, devoirs, création de projet (préremplissage MAMH)
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)
Catalogue /metre/catalogue CatalogueView assemblages/articles avec prix du jour et provenance, grille de main-d'œuvre, observations par classe d'évidence
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

# 3. Flux principal (définition de « terminé »)

  1. Créer un projet (optionnellement prérempli depuis le rôle MAMH).
  2. Importer un plan → pages PNG → calibrer (2 points, révision n).
  3. Dessiner (pièce, dalle, mur, ouverture, toit, fondation, ligne) → Mesurer → ligne du registre (formule, entrées, valeur, unité, révision de calibration) → Vérifier.
  4. 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.
  5. 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.
  6. Cas d'évaluation (méthode du coût) lié à la révision → valeur indiquée.
  7. Rapport PDF FR/EN, CSV, XLSX régénérés depuis la révision.

# 4. Principes non négociables appliqués dans le code

  • 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.
  • 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.
  • 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).
  • Déterminisme : mêmes lignes + mêmes paramètres + même instantané = même résultat (test engine.test.ts).

# 4 bis. Plateforme ouverte (2026-10-28)

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

# 4 ter. Éditeur de plan d'architecte

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

# 5. Sécurité

  • 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.
  • 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.
  • 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.
  • Entrées : toutes bornées/validées (sanitize*), identifiants UUID, pas de SQL dynamique non paramétré.
  • Journal d'audit (metre_audit_events) : connexion, projets, plans, calibrations, mesures, estimations, révisions, évaluations, ingestion, QA, devoirs.
  • 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).
  • Sauvegardes : scripts/metre-backup.sh (quotidien via PM2) ; restauration documentée dans SCHEMA_AND_MIGRATIONS.md.

# 6. Choix d'implémentation

  • 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.
  • Rendu PDF client (pdfjs-dist, Apache-2.0) : aucun binaire serveur (poppler absent du nœud), l'original est conservé et haché.
  • Argent en cents entiers (money.ts), arrondi demi vers le haut, une fois par étape.
  • 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.
  • 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.
Files main
Menu

Theme