SPB Git

Repository Public

RSMEANS.md 8.9 KB

# RSMeans (Gordian) — données de coûts unitaires localisées pour le Québec

Mis à jour le 2026-10-28. Base data/rsmeans.db (lecture seule) construite par scripts/rsmeans-build.py ; service src/lib/metre/rsmeans.ts ; API GET /api/metre/rsmeans ; interface : Catalogue → bloc « RSMeans — coûts unitaires localisés pour le Québec », sélecteur de ligne dans l'estimation (base « rsmeans »), relevé des quantités tarifé RSMeans (rsmeans-qs-map.ts).

# 1. Source et licence

  • RSMeans Online (Gordian, https://www.rsmeansonline.com), abonnement de l'UQO (compte du professeur), version de données 2026 trimestre 4 (ReleaseId 98), format MasterFormat 2018, unités US Standard (la plateforme convertit en métrique), type Unit cost (l'abonnement ne comprend pas les assemblages UniFormat).
  • Livres extraits : 12 Commercial New Construction (main-d'œuvre STD syndiquée et OPN non syndiquée), 14 Facilities and Commercial Renovation (STD/OPN), 3 Residential New Construction (RES), 4 Facilities Maintenance and Repair (FMR).
  • Licence : données sous licence RSMeans/Gordian ; usage pédagogique interne (IMM1003/IMM1033) ; aucune redistribution brute (pas d'export de la base, pas d'API publique de masse : la recherche est limitée à 200 lignes par requête et à 600 requêtes/min/session). Le module affiche la mention de source sur chaque prix. La convention d'utilisateur RSMeans Online s'applique (Content/RSMeansOnlineUserAgreement.pdf).

# 2. Méthode d'extraction (reproductible)

Le site n'offre pas d'API publique ni d'export en masse : l'extraction reproduit, depuis une session Safari ouverte sur SearchData, les appels internes de la grille (POST /SearchData/LoadGridWithCriteria, jeton anti-CSRF ValidationToken lu dans la page, 2 000 lignes par page, 400 ms entre requêtes). Outils (hors dépôt, laptop) : worker.js (tourne dans la page) + poller.py (AppleScript do JavaScript, récupère chaque page par tranches, vérifie le JSON, écrit raw/<VILLE>_<LIVRE>_<MO>_<DIV>_p<N>.json, se reconnecte si la session expire). Volume : ≈ 2 300 requêtes, ≈ 1 Go de JSON brut (conservé sur M2U64 ~/rsmeans-raw/).

Deux passes :

  1. National Average + Montréal (C11), Québec (C12), Gatineau (C57), Hull (C77) : tous les livres et types de MO, en entier.
  2. 13 autres villes du Québec de RSMeans (Cap-de-la-Madeleine, Charlesbourg, Chicoutimi, Granby, Joliette, Laval, Rimouski, Rouyn-Noranda, Saint-Hyacinthe, Sherbrooke, Sorel, Saint-Jérôme, Trois-Rivières) : livres 12 (STD, OPN) et 3 (RES) en entier ; les livres 14 et 4 y sont tarifés par facteurs (§3).

Résultat final (build du 2026-10-28 18 h 42) : 3 002 fichiers bruts (1,8 Go), 79 044 lignes distinctes, 3 059 013 prix localisés (18 localisations), 22 071 facteurs (ville × MO × division/section), 0 conflit de prix entre livres, base de 433 Mo.

Colonnes conservées par ligne : numéro MF2018 et MF1995, description courte et longue, unité, équipe, production journalière, heures de MO, coûts bare matériau / MO / équipement / total, coûts avec O&P (matériau, installation, total), total « in-house », coûts horaires et locations d'équipement, drapeaux (en-tête, ligne %, vert), références (R-fiches).

# 3. Localisation : prix extraits et facteurs validés

RSMeans localise par indices de coût de ville (CCI) appliqués par section MasterFormat et par nature de coût. La plateforme :

  • sert tel quel le prix extrait pour la ville demandée (méthode full) ;
  • sinon calcule national × facteur (méthode factor), le facteur étant la médiane des ratios ville / national des lignes extraites (valeurs ≥ 1 $ pour éviter le bruit d'arrondi) par section à 4 chiffres (si ≥ 5 lignes), sinon par division à 2 chiffres, sinon par un autre type de MO, sinon la moyenne de la ville ; le prix est alors étiqueté « ƒ national × facteur » avec les facteurs et l'effectif.

Validation (rsm_meta.validation_json, recalculée à chaque build) : pour les 4 villes extraites en entier, les prix prédits par facteurs sont confrontés ligne à ligne aux prix réels (≈ 123 000 lignes matériau, 119 000 MO, 23 000 équipement par ville) :

Niveau du facteur Erreur médiane p90 part > 5 %
division (2 chiffres) 0,01–0,02 % 19–25 % (matériau), 4,6–11,4 % (MO) 20–26 % (matériau)
section (4 chiffres) 0,00–0,01 % 0,05 % (matériau), 0,08–0,09 % (MO), 0,11–0,13 % (équipement) 1,4–1,5 %

(Validation effectuée sur les 17 villes extraites : ≈ 121 000 lignes matériau et 115 000 lignes MO par ville, mêmes résultats partout ; Trois-Rivières a le pire niveau division, p90 33,6 %.) Conclusion : au niveau de la section, la localisation par facteur reproduit les prix RSMeans à l'arrondi près ; le niveau division seul est insuffisant (d'où l'abandon de l'échantillonnage initial au profit de l'extraction complète des livres 12 et 3 pour toutes les villes). En pratique, seuls les livres 14 (rénovation) et 4 (entretien) des 13 villes de la passe 2 sont tarifés par facteurs de section.

# 4. Schéma data/rsmeans.db

Table Contenu
rsm_meta source, version, date d'extraction, effectifs, validation (JSON), licence
rsm_books 12, 14, 3, 4 et leurs types de MO
rsm_locations 18 localisations (id RSMeans, nom, code CCI, full, lat/lng)
rsm_lines ≈ 79 000 lignes distinctes (numéro, MF95, division, descriptions, unité, équipe, production, heures, drapeaux, livres, références)
rsm_prices prix par (ligne, localisation, MO) extraits en entier — 3 059 013 au total
rsm_factors 22 071 facteurs par (localisation, MO, division ou section) : matériau, MO, équipement, n, écart-type, méthode
rsm_fts index FTS5 (numéro + descriptions, diacritiques neutralisés)

# 5. Intégration dans le Quantity Survey

  • Base de prix « rsmeans » d'une ligne d'estimation (EstimateLineInput.basis = "rsmeans", rsmeansLine) : le devis unitaire prend les coûts bare (matériau, MO, équipement) de la ligne pour la ville RSMeans de l'estimation (params.rsmeansLocationId, sinon déduite de la municipalité/région du projet, sinon Montréal) et le type de MO (params.rsmeansLabor, STD par défaut ; substitution signalée si la ligne n'existe pas pour ce type). Les majorations du module (conditions générales, frais généraux, profit, contingence, actualisation, taxes) s'appliquent ensuite — le Total O&P RSMeans (qui inclut déjà l'O&P de l'installateur) est fourni en note, jamais additionné aux majorations.
  • Unités : rsmUnit() convertit l'unité RSMeans en unité du module et un diviseur ramène les unités groupées (M.S.F. = 1 000 pi², C.L.F. = 100 pi lin., Sq. = 100 pi², S.Y. = 9 pi²…) ; le moteur convertit ensuite m ↔ pi, m² ↔ pi², m³ ↔ vg³. Unités de comptage (Ea., Opng., Flight, Ton…) → « unité » avec note. Lignes % et en-têtes : non chiffrables.
  • Relevé des quantités tarifé RSMeans (rsmeans-qs-map.ts) : chaque famille du relevé (≈ 55 codes) correspond à une ou plusieurs lignes RSMeans ; lorsque l'unité RSMeans n'a pas la dimension de la quantité relevée (m² de mur → m d'ossature, m² chauffés → tonnes de conduits, unité de cuisine → armoires/comptoir/évier), la ligne est créée dans l'unité RSMeans avec un facteur documenté (qtyFactor) et la formule d'origine en note ; sinon elle reste liée à la mesure du registre. Familles sans équivalent (drainage/évents forfaitaires, VRC résidentiel, branchements) restent sur le catalogue UQO Éval et sont signalées. Test rsmeans-map.test.ts : chaque ligne existe, a un prix national et une unité compatible.
  • Provenance : classe d'évidence published_schedule, nature official, confiance 85 (prix extrait) / 72 (par facteur), source « RSMeans 2026 T4 · ville · MO ».

# 6. Cas d'étude (plans + détail des coûts)

scripts/qs-seed-cases.mts crée huit gabarits verrouillés « Cas 1 … Cas 8 » (bungalow Gatineau 222 762 $, cottage + garage Montréal 375 237 $, triplex Québec 580 634 $, duplex Laval 406 582 $, sixplex Sherbrooke 858 624 $, chalet sur pieux Rimouski 109 344 $, garage détaché Trois-Rivières 123 317 $, bungalow sous-sol fini Saguenay 291 319 $ — totaux avec majorations, hors taxes, RSMeans 2026 T4) : plans multi-niveaux générés, fiche technique, relevé automatique tarifé RSMeans pour la ville du cas, révision figée « Révision de référence (RSMeans 2026 T4) ». Chaque cas se duplique en un clic pour être modifié (plans, fiche, prix).

# 7. Mise à jour

Nouvelle version trimestrielle : changer release dans spec.json, relancer les deux passes (≈ 1 h), python3 scripts/rsmeans-build.py ~/rsmeans-raw data/rsmeans.db ~/rsmeans-raw/spec-build.json, pm2 restart uqo-eval, puis npx vitest run src/lib/metre/rsmeans*.test.ts et npx tsx scripts/qs-seed-cases.mts.

Files main
Menu

Theme