SPB Git

Repository Public

OPENCONSTRUCTIONERP_AUDIT.md 15.0 KB

# Audit d'OpenConstructionERP (Phase 0)

Dépôt inspecté : https://github.com/datadrivenconstruction/OpenConstructionERP.git Commit épinglé : 93135eeb1243b7bc457b4c50c2714536fee2a0b6 (2026-10-28 02:01 +0100), cloné le 2026-10-28 dans un répertoire isolé (3,5 Go, 8 669 commits). Lecture seule : aucun code du dépôt n'a été exécuté. « Vérifié » = constaté dans les fichiers ; « déclaré » = affirmation du README non recoupée.

# 1. Verdict en quatre points

  1. Aucune donnée de prix québécoise. Les paquets packs/canada-ca et packs/batimatech-ca ne contiennent que de la configuration (manifeste, règles, locales fr-CA/en-CA, onboarding TPS/TVQ/RBQ/CCQ). Le pack de règles quebec_ccq.json déclare explicitement enables_rule_ids: [] (régime CCQ non modélisé). Aucune occurrence d'APCHQ, SEAO, MTQ/MTMD, Gatineau ou Statistique Canada.
  2. La seule donnée « canadienne » est un catalogue torontois reprisé depuis une base d'origine russe (GESN/FER/TER) dont la licence est marquée PENDING par le dépôt lui-même (data/catalog/README). Main-d'œuvre à ≈ 17 $/h sur des « grades » russes, devises EUR/CAD incohérentes (6 657 codes sur 6 670 ont des prix identiques dans le fichier « EUR » et le fichier « CAD »). À ne pas réutiliser.
  3. Le moteur d'estimation est sérieux et inspirant : Decimal partout, cascade de majorations ordonnée (base = direct ou cumulatif), actualisation = ratio d'indices, facteur de localisation = ratio, build-up de main-d'œuvre, pertes net→brut, garde anti-cycle des assemblages (profondeur ≤ 8), instantanés JSON et verrouillage atomique.
  4. Licence AGPL-3.0-or-later + marque CWICR restreinte : copier/adapter du code (même traduit en TypeScript) rendrait UQO Éval AGPL avec obligation de publication réseau (§13). Seules les idées, formules et conceptions de schéma sont reprises, réécrites de zéro (clean-room). Aucune donnée CWICR importée.

# 2. Pile et organisation (vérifié)

Aspect Constat
Backend FastAPI ≥ 0.121, SQLAlchemy 2 async, Pydantic 2, Alembic (444 révisions), Python 3.12+ — backend/pyproject.toml, backend/app/main.py
Modules 221 entrées sous backend/app/modules/, 218 avec manifest.py (le MODULES.md déclare 194) ; gabarit modules/oe-module-template/, SDK packages/oe-sdk/
Base PostgreSQL (asyncpg) en production ; SQLite toléré (backend/app/database.py:202) ; RLS PostgreSQL désactivée par défaut (core/rls.py)
Frontend React 18.3, TypeScript 5.9, Vite 6, react-router 7, zustand, TanStack Query, ag-grid 32, Tailwind 3, i18next (45 locales ; fr seulement, fr-CA uniquement dans le pack batimatech), pdfjs-dist 6, three.js, jspdf
Bureau Tauri 2 + sidecar PyInstaller (desktop/src-tauri/)
Tests ≈ 3 030 fichiers test_*.py / ≈ 37 800 fonctions (pytest, xdist) ; 1 276 fichiers Vitest ; 81 spécifications Playwright
CI / qualité 24 workflows GitHub (ci, codeql, secret-scan, sbom-and-licenses, scorecard…), pre-commit (ruff, gitleaks, licence check), SECURITY.md, 5 ADR, 11 RFC
Activité 3 460 commits depuis le 2026-09-01, dont 3 412 par un seul auteur (« DataDrivenConstruction ») — production très élevée, vraisemblablement assistée par IA

# 3. Matrice de fonctionnalités (vérifié, profondeur non évaluée module par module)

Domaine Modules (backend app/modules/…) Notes
Projets projects/ (WBS, jalons, classification_standard défaut din276, devise, fx_rates)
Estimation (BOQ) boq/ (positions hiérarchiques, majorations, instantanés, branches/variantes, verrouillage/approbation, liens de quantités, import/export, GAEB, copilote, cost_risk_engine.py) ; estimate_rollup/, rom_estimate/, cost_plan/, costmodel/, methodology/ (2ᵉ cascade, arrondis à chaque étape) Deux moteurs de majorations qui s'écartent sciemment de quelques cents
Catalogue de coûts costs/ (CostItem, CostCatalog, RegionalIndex, ResourcePrice, matcher, Qdrant, importeurs de listes de prix), catalog/, supplier_catalogs/
Assemblages assemblies/ (composants, imbrication, formules paramétriques, formula_engine.py, gabarits) MAX_ASSEMBLY_DEPTH = 8, AssemblyCycleError (assemblies/service.py:76–101), boucles paramétriques par Kahn
Main-d'œuvre / pertes / indices labor_rates/ (rate_math.py:201 build_up, crew_rate), waste_factors/ (waste_math.py:52), price_index/ (index_math.py:128 resolve_factor, :166 location_multiplier)
Métré takeoff/ (55 points d'accès : upload PDF, detect-scale, page-scales, reconnaissance, lecture IA, mesures liées aux lignes), markups/models.py:96 ScaleConfig (pixels_per_unit, calibration_points, real_distance), measurement/formula.py (évaluateur AST sécurisé), dwg_takeoff/ (ezdxf) ; frontend features/takeoff/components/CalibrationDialog.tsx, ScaleAutoDetect.tsx, MeasurementLedger.tsx, WallAreaPanel.tsx Calibration humaine toujours requise
BIM/CAO bim_hub/ (IFC, GLB, COBie), cad/, clash*, bcf/, drawing_compare/ ; ADR 002 « no-ifcopenshell »
Rapports reporting/, bi_dashboards/ ; exports Excel/CSV/PDF/GAEB/BC3
Appels d'offres procurement/, tendering/ (GAEB X83/X84), rfq_bidding/, bid_management/
IA ai/ (Anthropic, OpenAI, Gemini, Ollama, Mistral…), ai_estimator/, erp_chat/, mcp/
Permissions core/permissions.py:33–79 (admin > manager > editor > viewer + rôles de champ), core/tenant_scope.py, OIDC
Audit core/audit.py (oe_core_audit_log), core/audit_log.py, boq/models.py:436 BOQActivityLog
Unités boq/units.py (normalisation d'orthographe seulement), core/unit_conversion.py (affichage métrique→impérial ; aucune conversion dimensionnelle dans le chiffrage)

# 4. Carte du schéma (tables oe_*, vérifié)

  • oe_boq_boq : project_id, status, estimate_type, is_locked, base_date (texte libre), tax_date, branch_of_id.
  • oe_boq_position (boq/models.py:128) : arbre (parent_id, ordinal) ; quantity, unit_rate, total, net_cost_rate, target_rate, sale_rate en String(50) dans l'ORM, convertis en NUMERIC(18,2)/( ,6) par la migration 7f3ab0f2d4e1 sur PostgreSQL seulement ; classification JSON, source, confidence, price_basis, version (verrou optimiste) ; ressources dans metadata.resources (JSON).
  • oe_boq_markup (:328) : markup_type (percentage | fixed | banded | escalation | per_unit), apply_to (direct_cost | cumulative | subtotal), sort_order, scope_position_id, overrides_id.
  • oe_boq_snapshot (:510), oe_boq_branch, oe_boq_quantity_link, oe_boq_exchange_report.
  • oe_costs_item (costs/models.py:39) : code, descriptions i18n, unit, rate, currency, source, classification, components JSON, region, price_as_of, catalog_id ; oe_regional_indices (factor Numeric(8,4), effective_date) ; oe_cost_item_usage (unit_rate_at_use, currency_at_use) ; oe_resource_price.
  • oe_assemblies_assembly / _component (cost_item_id, catalog_resource_id, quantity, quantity_formula, unit_cost, total) / _template.
  • oe_price_index_series / _point (period AAAA-MM, factor), _location_factor, _resource_index (is_sample), _overhead_norm (is_sample).
  • oe_labor_rates_template / _oncost (kind percentage | fixed) / _crew_member ; oe_waste_factors_factor.
  • Versions : is_locked par UPDATE compare-and-swap (boq/router.py:1694–1703), 409 en écriture (boq/service.py:2277), instantanés JSON ; chaque position estampille le prix utilisé (_stamp_variant_snapshot, CostItemUsage). Aucun journal de versions chaîné par hachage.

# 5. Algorithmes d'estimation (vérifié)

  • Argent : Decimal ; lignes quantifiées à 4 décimales ROUND_HALF_EVEN (boq/service.py:420–435), agrégats arrondis à 2 décimales ROUND_HALF_UP à la lecture (:446–470).
  • Ligne : total = quantity × unit_rate (_compute_total, :492) ; lignes à ressources : unit_rate = Σ(qté × taux) convertis en devise de base (:862, costs/buildup.py).
  • Majorations (_calculate_markup_amounts, :1654–1760) : direct = Σ feuilles non-sections ; application dans l'ordre sort_order ; base = direct ou cumulatif (direct + majorations précédentes) ; types pourcentage / fixe / par paliers (cautionnements) / actualisation = base × (facteur − 1) ; précision complète puis un seul arrondi final. Surcharges par section (_calculate_markup_amounts_scoped, :1861) avec garde seen.
  • Gabarit Canada (boq/markup_templates.py:1211–1290) : exigences générales 8 %, frais de siège 7 %, profit 5 %, assurances 1 % (sur direct), cautionnements CCDC 1 % (cumulatif), contingence conception 5 % et construction 3 % (sur direct) — « working defaults », sans ligne de taxes. Le gabarit methodology/templates.py:826 « canada » : FG 10 / profit 10 / TVA 5.
  • Actualisation : index(target) / index(base), erreur si période manquante (price_index/index_math.py:128) ; localisation : region(target) / region(base), 1 si absente (:166).
  • Main-d'œuvre : salaire de base + charges en % (sur la base) + ajouts fixes/h, chaque étape arrondie au cent (labor_rates/rate_math.py:201) ; crew_rate = Σ count × all_in (:284).
  • Pertes : brut = net × facteur, 4 décimales (waste_factors/waste_math.py:52).
  • Productivité : heuristiques (classe de béton, taux d'armature, coffrage) dans assemblies/formula_engine.py:932–946 ; dimensions lues dans la description (parse_dimensions, :775).

# 6. Données et paquets (vérifié)

Élément Constat
packs/canada-ca (72 Ko) README, manifest.py (cwicr_regions=["cwicr-eng-toronto"], default_currency="CAD", default_tax_template=None, Montréal « planned »), 12 JSON de règles (masterformat_2020, nbc_2020, ccdc_2/5a/14, csa_a23_1/a23_3/s16, ontario_obc, quebec_ccq vide, bc_bcbc, alberta_abc). Aucun fichier de prix.
packs/batimatech-ca (124 Ko) 9 règles, locales fr-CA/en-CA, onboarding.yaml 9 étapes (TPS/TVQ/HST, RBQ/CCQ/WSIB), logo (marque « batimatech » sous accord de partenariat). Aucun prix.
Contenu Québec core/demo_packs/office-montreal.py (démo ≈ 46 M$, taux codés en dur sans source), i18n_foundation/seed_data/tax_configurations.json (QST_QC 9,975 %, stacks_on_federal, 2013-01-01).
data/catalog/ (77 Mo) cwicr_resources_full.csv 7 024 lignes (devise « EUR ») ; ENG_TORONTO_catalog.csv 7 184 lignes (devise « EUR ») ; regions/DDC_CWICR_ENG_TORONTO_Catalog.csv 7 187 lignes (devise « CAD ») — 6 657 codes identiques aux mêmes prix ; 27 fichiers de régions (Dubaï, Berlin, Paris, Mumbai, São Paulo…). Provenance : « base globale traduite et reprisée par marché », structure GESN/FER/TER (CEI), licence PENDING. Main-d'œuvre Toronto « Grade 4 worker 17.12 CAD/hrs ».
Indices price_index/seed.py:32–49 (indice démo 2019 = 1,0 → 2026 = 1,40 ; NATIONAL_AVG 1,0 / HIGH_COST_METRO 1,15 / LOW_COST_RURAL 0,90), échantillons russes is_sample=True.
Gabarits data/templates/ : masterformat-sample.csv, cost_database_template.csv, cost_database_with_assemblies.json, nrm-sample.csv, BC3 espagnol.

Conclusion données : rien de réutilisable pour le Québec. Les sources retenues pour UQO Éval sont documentées dans DATA_SOURCES_AND_LICENSES.md.

# 7. Classifications

Registre core/classification_registry.py:69–113 (30 systèmes, défaut DIN 276). Listes livrées core/code_lists/data/*.json : MasterFormat 55 entrées (titres paraphrasés), UniFormat 8, NRM 34, DIN 276 83. Les niveaux profonds des normes sous licence ne sont pas livrés (core/code_lists/__init__.py:21–22). Pas de table de passage MasterFormat ↔ UniFormat. UQO Éval conserve ses 19 divisions MasterFormat de haut niveau (src/lib/cost/taxonomy.ts) + UNSPSC pour les contrats SEAO.

# 8. Import / export

BOQ : import Excel/GAEB/BC3/XPWE/« smart », export Excel/CSV/PDF/GAEB/BC3 (boq/router.py, boq/importers/). Listes de prix : CSV/XLSX, XML stream, XPWE, SIX, listes régionales italiennes (costs/pricelists/). Métré : PDF (pdfjs côté client + pdf_extract_worker.py), DXF/DWG. BIM : IFC, COBie. API : OpenAPI servie en direct, docs/api/ ne contient que README.md et mcp.md.

# 9. Licence et provenance

  • LICENSE : GNU AGPL v3 ; COPYRIGHT : © 2024-2026 Artem Boiko / DataDrivenConstruction.io, SPDX AGPL-3.0-or-later ; CLA obligatoire avec droit de double licence (docs/legal/CLA.md) ; licence commerciale proposée (docs/legal/COMMERCIAL-LICENSE.md) ; NOTICE (1 087 lignes) : aucune dépendance AGPL en amont depuis 18.7.0.
  • Marques (docs/legal/TRADEMARK.md) : OpenConstructionERP, OCERP, OpenEstimate, DataDrivenConstruction, DDC, CWICR — référence factuelle seulement.
  • Données : le README du catalogue précise que la licence AGPL couvre le code d'extraction, « ne remplace pas les conditions des publications sources » et « ne s'applique pas aux bases dont la base juridique est PENDING » (base globale, Toronto inclus).

Décision UQO Éval : (a) aucune ligne de code copiée ni traduite ; (b) idées réimplémentées en TypeScript dans src/lib/metre/* ; (c) aucune donnée CWICR/Toronto importée ; (d) mention de cette inspiration dans ARCHITECTURE.md sans utilisation des marques au-delà de la référence factuelle.

# 10. Idées reprises (réécrites) et écarts d'intégration

Reprises (→ fichier UQO Éval) : cascade de majorations ordonnée avec base direct/cumulatif et arrondi unique par étape (→ estimate-engine.ts) ; contingence sur le direct, cautionnements/profit sur le cumulatif (→ COST_FORMULAS.md) ; cents entiers + arrondi explicite (→ money.ts) ; actualisation = ratio d'indice résolu avant calcul, erreur/avertissement si période manquante (→ estimates.ts escalationFactor) ; facteur régional par composante (→ cost_locations existant) ; is_sample/source sur chaque taux (→ price_kind, Provenance, badge « hypothèse ») ; build-up de main-d'œuvre (→ grilles APCHQ coût employeur déjà présentes) ; pertes net→brut une seule fois (→ assemblies.ts) ; imbrication plafonnée + détection de cycle (→ assemblies.ts detectCycle, MAX_NESTING_DEPTH = 8) ; formule conservée avec la quantité (→ measure.ts, registre) ; calibration 2 points + px/unité par page confirmée par l'humain (→ geometry.ts makeCalibration, révisions) ; prix estampillé à l'usage (→ metre_estimate_versions.pricing_snapshot_json) ; verrouillage + instantanés comparables (→ révisions immuables hachées) ; taxes comme données datées non composées (→ TPS/TVQ dans le moteur) ; listes de classification de haut niveau seulement (→ MasterFormat 19 divisions).

Écarts : pas de données québécoises ni d'indices StatCan, pas de méthode du coût (dépréciation, obsolescence, terrain), pas de conversion dimensionnelle dans le chiffrage, fr-CA absent du cœur, architecture (218 modules, Postgres, Qdrant) non transférable à Next.js/SQLite.

Files main
Menu

Theme