Repository Public
1# RSMeans (Gordian) — données de coûts unitaires localisées pour le Québec23> 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`).45## 1. Source et licence67- **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).8- 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`).9- **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`).1011## 2. Méthode d'extraction (reproductible)1213Le 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/`).1415Deux passes :16171. **National Average + Montréal (C11), Québec (C12), Gatineau (C57), Hull (C77)** : tous les livres et types de MO, **en entier**.182. **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).1920**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.2122Colonnes 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).2324## 3. Localisation : prix extraits et facteurs validés2526RSMeans localise par **indices de coût de ville (CCI)** appliqués par section MasterFormat et par nature de coût. La plateforme :2728- sert **tel quel** le prix extrait pour la ville demandée (méthode `full`) ;29- 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.3031**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) :3233| Niveau du facteur | Erreur médiane | p90 | part > 5 % |34|---|---|---|---|35| division (2 chiffres) | 0,01–0,02 % | **19–25 %** (matériau), 4,6–11,4 % (MO) | 20–26 % (matériau) |36| **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 % |3738(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.3940## 4. Schéma `data/rsmeans.db`4142| Table | Contenu |43|---|---|44| `rsm_meta` | source, version, date d'extraction, effectifs, validation (JSON), licence |45| `rsm_books` | 12, 14, 3, 4 et leurs types de MO |46| `rsm_locations` | 18 localisations (id RSMeans, nom, code CCI, `full`, lat/lng) |47| `rsm_lines` | ≈ 79 000 lignes distinctes (numéro, MF95, division, descriptions, unité, équipe, production, heures, drapeaux, livres, références) |48| `rsm_prices` | prix par (ligne, localisation, MO) extraits en entier — 3 059 013 au total |49| `rsm_factors` | 22 071 facteurs par (localisation, MO, division ou section) : matériau, MO, équipement, n, écart-type, méthode |50| `rsm_fts` | index FTS5 (numéro + descriptions, diacritiques neutralisés) |5152## 5. Intégration dans le Quantity Survey5354- **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.55- **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.56- **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.57- **Provenance** : classe d'évidence `published_schedule`, nature `official`, confiance 85 (prix extrait) / 72 (par facteur), source « RSMeans 2026 T4 · ville · MO ».5859## 6. Cas d'étude (plans + détail des coûts)6061`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).6263## 7. Mise à jour6465Nouvelle 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`.66