SPB Git

Repository Public

COST_FORMULAS.md 8.0 KB

# Formules de coût — module Métré

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.

# 1. Argent (money.ts)

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

# 2. Coût unitaire d'une recette (assemblies.ts)

text
DirectCost = Σ_matériaux( Qty_i × (1 + Waste_i) × Price_i )
           + Σ_mo( Hours_j × Rate_j )                [Rate = coût employeur APCHQ/CCQ ; repli 85 $/h signalé]
           + Σ_équipement( EqHours_k × EqRate_k + Qty_k × Price_k si l'article est de classe équipement )
           + Subcontract + Transport
AssemblyUnitCost = DirectCost / OutputQuantity

Rè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.

Les 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 = Σ $.

# 3. Estimation (estimate-engine.ts) — ordre d'application

# Étape Formule Base
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)
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
3 Localisation Localisé = M×F_mat + L×F_mo + E×F_éq + O (facteurs cost_locations par composante ; O non localisé)
4 Conditions générales CG = Localisé × cg% direct
5 Frais généraux FG = (Localisé + CG) × fg% cumulatif
6 Profit P = (Localisé + CG + FG) × p% cumulatif
7 Contingence C = Localisé × c% direct (ne majore pas le profit)
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)
9 Taxes S2 = S1 + Esc ; TPS = S2 × 5 % ; TVQ = S2 × 9,975 % (non composées, régime 2013+)
10 Total Total = arrondi(S2 + TPS + TVQ)

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

Valeurs par défaut (hypothèses pédagogiques, modifiables) : CG 8 %, FG 7 %, profit 8 %, contingence 5 %, sans taxes.

# 4. Métré (measure.ts)

text
polygon_area      = aire du lacet (px²) ÷ (px/m)²
polyline_length   = Σ |segments| (px) ÷ (px/m)
wall_gross_area   = longueur × hauteur
wall_net_area     = wall_gross_area − Σ ouvertures VÉRIFIÉES avec deductFrom = ce mur (chaque ouverture une fois ; plafonné au brut)
slab_volume       = aire × épaisseur
roof_surface_area = aire projetée × √(1 + (pente/12)²)
opening_area      = largeur × hauteur × nombre
count             = nombre

Calibration : 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.

# 5. Méthode du coût (valuation.ts)

text
CoûtNeufUtilisé   = CoûtRévision × (1 + ajustement_base %)      [reproduction ↔ remplacement]
CoûtNeufTotal     = CoûtNeufUtilisé + améliorations du site admissibles
D_physique        = CoûtNeufTotal × min(âge_effectif / vie_économique, 90 %)   ou  × % saisi
D_fonctionnelle   = Σ curables (coût de correction) + Σ incurables (perte de valeur)
                    — une déficience « éliminée par la conception de remplacement » n'est PAS déduite en base remplacement
D_externe         = montant saisi
AméliorationsDép. = max(0, CoûtNeufTotal − D_phys − D_fonct − D_ext)
ValeurIndiquée    = Terrain + AméliorationsDép.

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

# 6. Ce que le moteur refuse

  • Prix unitaire manquant sur une hypothèse → ligne non chiffrée, signalée.
  • Unités incompatibles (m² vs m) → ligne non chiffrée, signalée.
  • Mesure périmée → révision refusée.
  • Assemblage inconnu/circulaire → ligne non chiffrée / erreur.
  • 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.

# 7. Détection déterministe d'anomalies (ai.ts detectAnomalies)

Avant 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 ».

# 8. Relevé des quantités depuis les plans (quantity-survey.ts)

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

Famille Quantité Formule
Excavation (sous-sol) m³ (A_e + bande 1 m) × (h_f + 0,3)
Semelles m P (niveau le plus bas)
Murs de fondation m² P × h_f
Dalle (sous-sol ou sur sol) m² A_e
Planchers (solives) m² Σ aires des niveaux hors sol au-dessus d'un vide ou sous-sol
Murs extérieurs 2×6 m² Σ L_ext × h (brut)
Cloisons 2×4 m² Σ L_int × h
Fermes de toit + OSB m² A_e(toit) × facteur de pente √(1 + (pente/12)²)
Isolation murs / comble m² murs ext. nets ; A_e(toit)
Revêtements extérieurs m² murs ext. nets × part de chaque revêtement (fiche)
Toiture m² aire de toit × facteur de pente (membrane : facteur 1)
Fenêtres / portes ext. / portes-patio / placards unité comptées sur les plans (openingKind, exterior)
Gypse murs m² 2 × cloisons + murs ext. nets ; plafonds : Σ aires des pièces
Peinture m² gypse murs + plafonds
Planchers m² aire des pièces par usage (céramique : cuisine, salle de bain, entrée ; bois : séjour, chambres ; etc.)
Plinthes m Σ périmètres des pièces − portes
Cuisine / salles de bain unité comptées par usage des pièces
Mécanique / électricité unité, m² entrée 200 A, filage et luminaires sur l'aire habitable ; chauffage et VRC selon la fiche

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

Files main
Menu

Theme