Repository Public
1# Formules de coût — module Métré23> Référence des formules implémentées (versions `metre-estimate-1.0`, `metre-valuation-1.0`, `metre-formulas-1.0`). Toute modification doit incrémenter la version correspondante ; les révisions figées conservent la version utilisée.45## 1. Argent (`money.ts`)67Toutes les sommes sont accumulées en **cents entiers** ; chaque étape est arrondie une seule fois, demi vers le haut (symétrique pour les négatifs). `quantité × prix unitaire` est arrondi une fois au cent. Le total peut être arrondi au cent, au dollar ou à 100 $ (`roundingCents`).89## 2. Coût unitaire d'une recette (`assemblies.ts`)1011```12DirectCost = Σ_matériaux( Qty_i × (1 + Waste_i) × Price_i )13 + Σ_mo( Hours_j × Rate_j ) [Rate = coût employeur APCHQ/CCQ ; repli 85 $/h signalé]14 + Σ_équipement( EqHours_k × EqRate_k + Qty_k × Price_k si l'article est de classe équipement )15 + Subcontract + Transport16AssemblyUnitCost = DirectCost / OutputQuantity17```1819Règles : un composant **installé** (prix tout compris) n'ajoute ni pertes ni main-d'œuvre (avertissement si saisis) ; un **assemblage imbriqué** est chiffré par sa propre recette — ses pertes et heures ne sont jamais réappliquées ; profondeur ≤ 8 ; **cycle refusé** (`AssemblyCycleError`). Part observée = coût matériau appuyé sur des prix `observed`/`official`/`indexed` ÷ coût matériau.2021Les assemblages du **catalogue** (`cost.db`) sont chiffrés par le moteur existant (`src/lib/cost/engine.ts assemblyUnitCost`) : `matériau = Σ qté × (1 + pertes) × prix`, `MO = Σ heures × taux`, `équipement = Σ $`.2223## 3. Estimation (`estimate-engine.ts`) — ordre d'application2425| # | Étape | Formule | Base |26|---|---|---|---|27| 1 | Quantité d'assemblage | `Q = Q_métré × f` (f = facteur d'ajustement explicite, défaut 1 ; conversion d'unités **seulement** entre grandeurs de même dimension, sinon ligne non chiffrée) | |28| 2 | Direct de ligne | `M = Q × u_mat ; L = Q × u_mo ; E = Q × u_éq ; O = Q × u_autres` ; ligne « hypothèse installée » → `O = Q × prix` | |29| 3 | Localisation | `Localisé = M×F_mat + L×F_mo + E×F_éq + O` (facteurs `cost_locations` par composante ; O non localisé) | |30| 4 | Conditions générales | `CG = Localisé × cg%` | direct |31| 5 | Frais généraux | `FG = (Localisé + CG) × fg%` | cumulatif |32| 6 | Profit | `P = (Localisé + CG + FG) × p%` | cumulatif |33| 7 | Contingence | `C = Localisé × c%` | direct (ne majore pas le profit) |34| 8 | Actualisation | `Esc = S1 × (k − 1)`, `S1 = Localisé + CG + FG + P + C`, `k = I(date cible) / I(date des prix)` (StatCan 18-10-0289, résolu **avant** le calcul ; si l'indice manque : aucune actualisation + avertissement) | |35| 9 | Taxes | `S2 = S1 + Esc ; TPS = S2 × 5 % ; TVQ = S2 × 9,975 %` (non composées, régime 2013+) | |36| 10 | Total | `Total = arrondi(S2 + TPS + TVQ)` | |3738Les lignes **exclues** restent visibles (exclusions de portée) mais ne comptent pas. Couverture : lignes chiffrées / actives, part observée pondérée, part d'hypothèses.3940Valeurs par défaut (hypothèses pédagogiques, modifiables) : CG 8 %, FG 7 %, profit 8 %, contingence 5 %, sans taxes.4142## 4. Métré (`measure.ts`)4344```45polygon_area = aire du lacet (px²) ÷ (px/m)²46polyline_length = Σ |segments| (px) ÷ (px/m)47wall_gross_area = longueur × hauteur48wall_net_area = wall_gross_area − Σ ouvertures VÉRIFIÉES avec deductFrom = ce mur (chaque ouverture une fois ; plafonné au brut)49slab_volume = aire × épaisseur50roof_surface_area = aire projetée × √(1 + (pente/12)²)51opening_area = largeur × hauteur × nombre52count = nombre53```5455Calibration : `px/m = |p1p2| / longueur_réelle_en_m` ; incertitude relative `= √(2) × 1,5 px / |p1p2|` combinée à l'incertitude de la longueur saisie. Chaque calibration crée une **révision** ; les mesures calculées sous une autre révision deviennent `stale`.5657## 5. Méthode du coût (`valuation.ts`)5859```60CoûtNeufUtilisé = CoûtRévision × (1 + ajustement_base %) [reproduction ↔ remplacement]61CoûtNeufTotal = CoûtNeufUtilisé + améliorations du site admissibles62D_physique = CoûtNeufTotal × min(âge_effectif / vie_économique, 90 %) ou × % saisi63D_fonctionnelle = Σ curables (coût de correction) + Σ incurables (perte de valeur)64 — une déficience « éliminée par la conception de remplacement » n'est PAS déduite en base remplacement65D_externe = montant saisi66AméliorationsDép. = max(0, CoûtNeufTotal − D_phys − D_fonct − D_ext)67ValeurIndiquée = Terrain + AméliorationsDép.68```6970Le coût à neuf retenu depuis une révision est le **sous-total avant taxes** (les taxes de vente ne font pas partie du coût de remplacement dans l'approche pédagogique retenue ; documenter si l'enseignant choisit autrement).7172## 6. Ce que le moteur refuse7374- Prix unitaire manquant sur une hypothèse → ligne non chiffrée, signalée.75- Unités incompatibles (m² vs m) → ligne non chiffrée, signalée.76- Mesure périmée → révision refusée.77- Assemblage inconnu/circulaire → ligne non chiffrée / erreur.78- Intervalle de confiance : **jamais calculé** faute de dispersion observée ; seules la part observée, la part d'hypothèses et les notes d'incertitude des sources sont affichées.7980## 7. Détection déterministe d'anomalies (`ai.ts detectAnomalies`)8182Avant tout commentaire par l'IA : (a) ligne non chiffrée ; (b) coût unitaire direct dont l'écart robuste à la médiane des autres lignes de même unité dépasse 3 (`z = (x − médiane) / (1,4826 × MAD)`, ≥ 4 lignes comparables) ; (c) hypothèse sans justification notée ; (d) facteur d'ajustement hors [0,5 ; 1,5]. Les règles ne modifient rien ; elles alimentent la liste et la suggestion « anomalies ».8384## 8. Relevé des quantités depuis les plans (`quantity-survey.ts`)8586Entrées : pour chaque niveau calibré, `planQuantities` (murs extérieurs L_ext et cloisons L_int en m, ouvertures comptées par type et dimensions, pièces avec usage et aire, empreinte A_e et périmètre P en m, hauteur d'étage h) + la fiche `BuildingSpecQS` (fondation, sous-sol, hauteur de mur de fondation h_f, structure, isolation, revêtements et parts, toiture et pente, chauffage, finitions…). Chaque ligne porte `formula`, `inputs`, `origin` (`plan` ou `spec`) et `pageIds`.8788| Famille | Quantité | Formule |89|---|---|---|90| Excavation (sous-sol) | m³ | (A_e + bande 1 m) × (h_f + 0,3) |91| Semelles | m | P (niveau le plus bas) |92| Murs de fondation | m² | P × h_f |93| Dalle (sous-sol ou sur sol) | m² | A_e |94| Planchers (solives) | m² | Σ aires des niveaux hors sol au-dessus d'un vide ou sous-sol |95| Murs extérieurs 2×6 | m² | Σ L_ext × h (brut) |96| Cloisons 2×4 | m² | Σ L_int × h |97| Fermes de toit + OSB | m² | A_e(toit) × facteur de pente √(1 + (pente/12)²) |98| Isolation murs / comble | m² | murs ext. nets ; A_e(toit) |99| Revêtements extérieurs | m² | murs ext. nets × part de chaque revêtement (fiche) |100| Toiture | m² | aire de toit × facteur de pente (membrane : facteur 1) |101| Fenêtres / portes ext. / portes-patio / placards | unité | comptées sur les plans (`openingKind`, `exterior`) |102| Gypse murs | m² | 2 × cloisons + murs ext. nets ; plafonds : Σ aires des pièces |103| Peinture | m² | gypse murs + plafonds |104| Planchers | m² | aire des pièces par usage (céramique : cuisine, salle de bain, entrée ; bois : séjour, chambres ; etc.) |105| Plinthes | m | Σ périmètres des pièces − portes |106| Cuisine / salles de bain | unité | comptées par usage des pièces |107| Mécanique / électricité | unité, m² | entrée 200 A, filage et luminaires sur l'aire habitable ; chauffage et VRC selon la fiche |108109Les codes d'assemblage absents du catalogue sont ignorés et **signalés** (`warnings`) ; aucun niveau calibré → relevé vide et avertissement explicite. Le relevé alimente le registre (mesures « QS · … », `measure_kind = "count"`/`"area"`/…) et l'estimation (lignes `origin: "qs"`), puis suit l'ordre d'application de la section 3.110111