SPB Git

Repository Public

TAKEOFF_SPECIFICATION.md 7.0 KB

# Spécification du métré (Plan Studio et registre)

# 1. Import des plans

  • Formats : PDF (vectoriel ou numérisé), PNG, JPEG, DXF ASCII (lecteur maison sources/dxf.ts : LINE, LWPOLYLINE, POLYLINE/VERTEX, CIRCLE ; ARC/SPLINE/INSERT/HATCH/TEXT comptés et signalés ; ≤ 20 000 entités ; page raster générée par sharp ; calibration exacte (incertitude 0) dérivée de $INSUNITS — sinon calibration manuelle ; une polyligne fermée devient un objet « aire », une ligne un objet « ligne », par calque). DWG, DXF binaire et IFC : non pris en charge (aucun analyseur validé).
  • Rendu : dans le navigateur (pdfjs-dist, worker /metre/pdf.worker.min.mjs), ≤ 60 pages, ≤ 4 000 px de côté (échelle ≤ 3×), fond blanc. Images : redimensionnées ≤ 4 000 px.
  • Serveur : signature magique vérifiée, PNG ré-encodés par sharp, original conservé (sha256, taille, MIME, nombre de pages), une entrée metre_plan_pages par page (width_px, height_px, image_path).
  • Les images de page et les originaux ne sont servis qu'aux utilisateurs ayant accès au projet.

# 2. Calibration

  • Outil Calibrer (C) : deux clics sur des points dont la distance réelle est connue (cote, mur, règle graphique), longueur + unité (m, pi, mm, cm, po).
  • Résultat : px_per_meter, uncertainty_pct (clic ± 1,5 px par point ; une base trop courte fait monter l'incertitude, affichée), révision n (jamais écrasée ; historique consultable).
  • Effet : toutes les mesures de la page calculées sous une autre révision passent stale ; la grille d'aimantation se cale sur 0,5 m (ou 1 pi).

# 2 bis. Pages créées dans l'application

Source Création Calibration Usage
blank largeur × hauteur (m), échelle 10–200 px/m, niveau exacte (incertitude 0) plan d'architecte dessiné de zéro
template 38 gabarits paramétriques (templates.ts : bungalows, 2 étages, jumelés, plex 2–9 log., rangée, chalets, mobile, condo, garages) — crée tous les niveaux + la fiche technique exacte point de départ complet (murs, pièces nommées, ouvertures, empreinte) ; aperçu SVG GET /api/metre/templates?key=&level=
map adresse ou MAMH → vue satellite Mapbox (zoom 14–20), image 2 560 × 1 920 px exacte depuis la projection Web Mercator (incertitude notée 0,1 %) lot, empreinte, aménagements extérieurs
copie « dupliquer en nouveau niveau » copiée étage depuis le rez-de-chaussée

# 3. Objets

Outil (touche) Type Fermé Propriétés Formule par défaut
Pièce (R), Aire (A) room, area oui — polygon_area
Dalle (D) slab oui épaisseur (m) slab_volume
Fondation (F) foundation oui épaisseur (m) slab_volume
Toit (T) roof oui pente (po/12) roof_surface_area
Mur (W) wall non hauteur (m) wall_net_area
Porte (D) · Fenêtre (N) opening point projeté sur le mur cliqué type (porte/fenêtre/baie), largeur, hauteur (m), nombre, battement (±1 côté, ±2 charnière), mur à déduire opening_area (+ count)
Cloison (I) wall non épaisseur 0,12 m, hauteur wall_net_area, wall_gross_area, polyline_length
Rectangle (X) room oui deux clics ou longueur tapée polygon_area, périmètre
Cote (M) · Texte (T) dimension, text — décalage ; texte, taille non mesurés
Escalier (S) · Colonne (C) stairs, column oui / point — ; côté (m) polygon_area ; count
Empreinte (F) · Lot (L) footprint, lot oui — polygon_area
Ligne (L) line non — polyline_length

Interactions : clic = sommet ; clic sur le premier sommet / Entrée / clic droit = fermer ; Échap annule ; Suppr retire le dernier sommet ou l'objet sélectionné ; Ctrl+Z / Ctrl+Shift+Z / Ctrl+Y annuler/rétablir (50 niveaux) ; Ctrl+D dupliquer ; +/− zoom (25 % → 600 %) ; S aimant (sommets existants puis grille), G grille ; calques nommés, masquables ; contrôles tactiles (zoom et défilement natifs, touch-action: pan-x pan-y, cibles ≥ 44 px). Autosauvegarde : chaque création/modification est persistée immédiatement (POST/PATCH /api/metre/objects). Les points sont bornés à la page. Les objets sont supprimés logiquement (deleted_at).

Références conservées : page source, objet, calque, horodatages ; un polygone auto-intersectant est signalé (aire non fiable).

# 4. Registre de mesures

Une mesure = { objet, page, formule, texte de formule, entrées (dict), valeur, unité SI, révision de calibration, stale, confiance (measured | estimated | assumed), vérifiée par/le, lignage, version des formules, horodatage }.

  • Mesurer (par objet ou « Mesurer tout ») crée/recalcule l'entrée (une par objet et formule).
  • Saisie manuelle : valeur + unité + confiance estimated (relevé) ou assumed ; jamais measured.
  • Vérification : manuelle, refusée si stale ; retirée automatiquement au recalcul.
  • Recalcul : « Recalculer n mesure(s) périmée(s) » recalcule tout avec la calibration courante.
  • Garde-fous : pas de valeur sans calibration (sauf comptes), déduction d'ouverture unique et vérifiée, plafond au brut, unités de même dimension seulement dans l'estimation, lien d'estimation relu à chaque calcul, révision refusée si périmé.

# 5. Lien avec l'estimation

assembly_quantity = takeoff_quantity × adjustment_factor (facteur explicite, visible, par défaut 1 ; ex. 1,05 = +5 % de pertes de pose au-delà des pertes de la recette). Si l'unité de l'assemblage diffère (ex. catalogue en pi²), la conversion est journalisée dans les avertissements de la ligne.

# 6. Reconnaissance assistée par IA

Pas de reconnaissance d'images. L'assistance IA (onglet Estimation) propose des rattachements mesure → assemblage (codes existants seulement), des postes manquants et des commentaires d'anomalies ; chaque suggestion est revue, étiquetée (modèle/version/empreinte), acceptée ou refusée explicitement, et n'entre dans l'estimation que par l'action « Appliquer » de l'utilisateur. Le registre de mesures n'est jamais modifié par l'IA.

# 7. Rendu architectural et export

Murs : polygone de contour (décalage ± épaisseur/2, jonctions en onglet limitées à 4 × demi-épaisseur) rempli en noir ; boucle fermée rendue en anneau (fill-rule: evenodd). Ouvertures : découpe blanche à l'épaisseur du mur + vantail et arc de battement (porte) ou triple trait (fenêtre), orientés selon le segment de mur. Pièces : surface teintée, nom et aire au centroïde. Cotes : automatiques par segment de mur (côté extérieur) et manuelles (lignes d'attache, ligne de cote, repères, texte orienté lisible). Export GET /api/metre/pages/{id}/export?format=svg|png|pdf : SVG complet avec cartouche (projet, niveau, échelle approximative, date, auteur, mention « plan pédagogique, non scellé »), échelle graphique et flèche du nord ; PNG rasterisé à 144 dpi ; PDF Lettre paysage.

Files main
Menu

Theme