SPB Git

Repository Public

OPENCONSTRUCTIONERP_AUDIT.md 15.0 KB 102 lines markdown

1# Audit d'OpenConstructionERP (Phase 0)23> Dépôt inspecté : `https://github.com/datadrivenconstruction/OpenConstructionERP.git`4> 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é.5> « Vérifié » = constaté dans les fichiers ; « déclaré » = affirmation du README non recoupée.67## 1. Verdict en quatre points891. **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.102. **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.**113. **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.124. **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.1314## 2. Pile et organisation (vérifié)1516| Aspect | Constat |17|---|---|18| Backend | FastAPI ≥ 0.121, SQLAlchemy 2 async, Pydantic 2, Alembic (444 révisions), Python 3.12+ — `backend/pyproject.toml`, `backend/app/main.py` |19| 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/` |20| Base | PostgreSQL (asyncpg) en production ; SQLite toléré (`backend/app/database.py:202`) ; RLS PostgreSQL **désactivée par défaut** (`core/rls.py`) |21| 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 |22| Bureau | Tauri 2 + sidecar PyInstaller (`desktop/src-tauri/`) |23| Tests | ≈ 3 030 fichiers `test_*.py` / ≈ 37 800 fonctions (pytest, xdist) ; 1 276 fichiers Vitest ; 81 spécifications Playwright |24| 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 |25| 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 |2627## 3. Matrice de fonctionnalités (vérifié, profondeur non évaluée module par module)2829| Domaine | Modules (backend `app/modules/…`) | Notes |30|---|---|---|31| Projets | `projects/` (WBS, jalons, `classification_standard` défaut `din276`, devise, `fx_rates`) | |32| 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 |33| Catalogue de coûts | `costs/` (CostItem, CostCatalog, RegionalIndex, ResourcePrice, matcher, Qdrant, importeurs de listes de prix), `catalog/`, `supplier_catalogs/` | |34| 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 |35| 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`) | |36| 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 |37| BIM/CAO | `bim_hub/` (IFC, GLB, COBie), `cad/`, `clash*`, `bcf/`, `drawing_compare/` ; ADR 002 « no-ifcopenshell » | |38| Rapports | `reporting/`, `bi_dashboards/` ; exports Excel/CSV/PDF/GAEB/BC3 | |39| Appels d'offres | `procurement/`, `tendering/` (GAEB X83/X84), `rfq_bidding/`, `bid_management/` | |40| IA | `ai/` (Anthropic, OpenAI, Gemini, Ollama, Mistral…), `ai_estimator/`, `erp_chat/`, `mcp/` | |41| Permissions | `core/permissions.py:33–79` (admin > manager > editor > viewer + rôles de champ), `core/tenant_scope.py`, OIDC | |42| Audit | `core/audit.py` (`oe_core_audit_log`), `core/audit_log.py`, `boq/models.py:436 BOQActivityLog` | |43| Unités | `boq/units.py` (normalisation d'orthographe seulement), `core/unit_conversion.py` (affichage métrique→impérial ; **aucune conversion dimensionnelle dans le chiffrage**) | |4445## 4. Carte du schéma (tables `oe_*`, vérifié)4647- `oe_boq_boq` : `project_id`, `status`, `estimate_type`, `is_locked`, `base_date` (texte libre), `tax_date`, `branch_of_id`.48- `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).49- `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`.50- `oe_boq_snapshot` (`:510`), `oe_boq_branch`, `oe_boq_quantity_link`, `oe_boq_exchange_report`.51- `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`.52- `oe_assemblies_assembly` / `_component` (`cost_item_id`, `catalog_resource_id`, `quantity`, `quantity_formula`, `unit_cost`, `total`) / `_template`.53- `oe_price_index_series` / `_point` (`period` AAAA-MM, `factor`), `_location_factor`, `_resource_index` (`is_sample`), `_overhead_norm` (`is_sample`).54- `oe_labor_rates_template` / `_oncost` (`kind` percentage | fixed) / `_crew_member` ; `oe_waste_factors_factor`.55- 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.**5657## 5. Algorithmes d'estimation (vérifié)5859- **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`).60- **Ligne** : `total = quantity × unit_rate` (`_compute_total`, :492) ; lignes à ressources : `unit_rate = Σ(qté × taux)` convertis en devise de base (`:862`, `costs/buildup.py`).61- **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`.62- **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.63- **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`).64- **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`).65- **Pertes** : `brut = net × facteur`, 4 décimales (`waste_factors/waste_math.py:52`).66- **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).6768## 6. Données et paquets (vérifié)6970| Élément | Constat |71|---|---|72| `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.** |73| `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.** |74| 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). |75| `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 ». |76| 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`. |77| Gabarits | `data/templates/` : `masterformat-sample.csv`, `cost_database_template.csv`, `cost_database_with_assemblies.json`, `nrm-sample.csv`, BC3 espagnol. |7879**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`.8081## 7. Classifications8283Registre `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.8485## 8. Import / export8687BOQ : 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`.8889## 9. Licence et provenance9091- `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.92- Marques (`docs/legal/TRADEMARK.md`) : OpenConstructionERP, OCERP, OpenEstimate, DataDrivenConstruction, DDC, **CWICR** — référence factuelle seulement.93- 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).9495**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.9697## 10. Idées reprises (réécrites) et écarts d'intégration9899Reprises (→ 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).100101É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.102
Files main
Menu

Theme