SPB Git

Repository Public

UQO_EVAL_INTEGRATION_AUDIT.md 6.6 KB

# Audit d'intégration — UQO Éval (Phase 0)

État inspecté le 2026-10-28 sur le nœud de production M2U64 (~/apps/uqo-eval, commit 07063c1, PM2 uqo-eval :8150, https://www.uqo-eval.app), source de vérité remote-first (origin gitsrv:srv/git/uqo-eval.git).

# 1. Architecture existante

Aspect Constat
Framework Next.js 16.3 (App Router, React 19, React Compiler lint), TypeScript strict, Tailwind v4 ; serverExternalPackages: ["better-sqlite3", "pdfkit"]
Backend Route handlers Node sous src/app/api/* ; aucune couche serveur séparée, aucun ORM
Bases SQLite (better-sqlite3) : data/vraiprix.db (3,75 M unités MAMH + 745 k ventes, 2 Go), data/immoka.db (annonces, 2 Go), data/cost.db (catalogue de la méthode du coût : 184 articles, 99 assemblages, 4 827 prix observés, 3 404 taux APCHQ/CCQ, 1 084 points d'indices StatCan, 16 localisations, 12 sources)
Authentification Aucune : pas de comptes, pas de sessions ; seule une API admin protégée par COST_ADMIN_TOKEN (src/lib/cost/connectors/admin.ts) ; rate-limit mémoire (src/lib/cost/cache.ts)
Rôles inexistants ; « mode étudiant » purement client (masquer des résultats)
Module Coût existant src/lib/cost/* : types, unités (prix), taxonomie MasterFormat, moteur déterministe (engine.ts : assemblages → direct → indirects → FG → profit → contingence → RCN → dépréciation), géométrie paramétrique depuis des attributs de bâtiment (geometry.ts), service (estimate.ts, instantané de prix), connecteurs (APCHQ, CCQ, StatCan 18-10-0289, Canac, BMR, Patrick Morin, imports Altus/RSMeans), IA d'analyse d'annonces ; UI /cout (landing + atelier 9 sections), PDF report-cost.ts
UI design « terminal éditorial » UQO (tokens --accent, classes .kicker .klabel .btn .vp-card .src-table .kv-cell .stat-chip .pill), useLang() FR/EN, HeaderNav + MobileTabBar (6 onglets)
PDF pdfkit, polices assets/fonts, logo UQO, Lettre
Tests Vitest : 69 tests (4 fichiers) ; lint 0 erreur / 10 avertissements ; tsc --noEmit propre
Déploiement mld (passerelle M1M32) → M2U64 ; PM2 uqo-eval (npm start -- -H 0.0.0.0 -p 8150) + uqo-eval-cost-sync (cron) ; route MacLustr Tunnel sur BHS64

# 2. Ce qui manquait par rapport au cahier des charges

Exigence Existant Décision
Projets, plans, métré aucun nouveau module metre (base distincte data/metre.db)
Plan Studio (import PDF/image, calibration, dessin, registre) aucun implémenté (pdfjs-dist côté client, SVG, formules inspectables, révisions de calibration)
Assemblages éditables, imbrication, versions catalogue seedé en code (seed/assemblies.ts), non éditable recettes du module (metre_assemblies + versions) qui réutilisent les articles et assemblages de cost.db
Estimation versionnée, scénarios, sensibilité, taxes, actualisation cost_estimates (une passe, pas de révisions) metre_estimates (état de travail) + metre_estimate_versions (immuables, hachées)
Classes d'évidence de prix price_kind (observed/official/indexed/derived/reference/assumption) conservé + evidence_class pour les observations externes (barème, contrat octroyé, permis, …)
Sources québécoises (DTNI, MTMD, SEAO, permis) APCHQ, CCQ, StatCan, détaillants adaptateurs SEAO (OCDS) et permis Montréal ; DTNI/MTMD en import manuel (sites protégés)
Rôles et isolation aucun codes d'accès + sessions, rôles student/instructor/admin/professional, contrôle serveur par projet
Rapports bilingues PDF/CSV/XLSX PDF FR seulement (report-cost.ts) nouveau rapport FR/EN + CSV + XLSX depuis révision immuable
Méthode du coût atelier /cout complet (RCN, dépréciation, terrain) cas d'évaluation du module liés à une révision + lien vers /cout?property= pour le rôle MAMH

# 3. Stratégie d'intégration et de migration

  • Isolation : tout le module vit dans src/lib/metre, src/app/metre, src/app/api/metre, src/components/metre et une base séparée data/metre.db + fichiers data/metre-files/. Les bases existantes ne sont jamais écrites ; cost.db est lue via les fonctions existantes (buildContext, loadAssemblies, residentialIndexSeries…).
  • Feature flag : METRE_ENABLED (serveur : pages → 404, API → 404) et NEXT_PUBLIC_METRE_ENABLED (entrée « Métré » du HeaderNav). Désactiver = retirer le module sans redéploiement de données.
  • Migrations : metre_meta.schema_version (v1), migrations forward-only additives ; retour arrière = restauration de la copie de metre.db (voir SCHEMA_AND_MIGRATIONS.md).
  • Dépendances ajoutées : pdfjs-dist 6.4 (Apache-2.0, rendu client ; worker copié dans public/metre/), exceljs 4.4 (MIT). sharp (déjà présent via Next) re-encode les PNG téléversés.
  • Compatibilité : aucune route, table, composant ou page existants modifiés, sauf HeaderNav.tsx (une entrée de menu conditionnelle) et package.json. La barre mobile (6 onglets) n'est pas modifiée.

# 4. Baseline de tests et régression

Mesure Avant (2026-10-28 06:40) Après
Vitest 69 tests, 4 fichiers, verts 105 tests, 7 fichiers, verts (69 inchangés + 36 nouveaux)
tsc --noEmit propre propre
ESLint 0 erreur / 10 avertissements (code existant) 0 erreur (module : 0 avertissement)
Pages existantes /, /cout, /a-vendre, /stats, /methodologie 200 200 (vérifiées après redéploiement)

# 5. Contraintes et risques identifiés

  • Pas de comptes utilisateurs institutionnels : le mécanisme de codes d'accès est pragmatique (pas de courriel, pas de mot de passe) ; une intégration SSO UQO (si disponible un jour) remplacerait auth.ts sans toucher au reste.
  • SQLite et concurrence : better-sqlite3 synchrone, WAL, busy_timeout 5 s ; adapté à un cours (dizaines d'utilisateurs), pas à des milliers de sessions simultanées. Les mesures de performance réelles figurent dans VALIDATION_PLAN.md.
  • Rendu PDF côté client : évite d'installer poppler/pymupdf sur le nœud (absents) ; limite 60 pages / 4 000 px de côté ; les plans numérisés très lourds doivent être découpés.
  • Catalogue de prix : les assemblages du catalogue sont majoritairement appuyés sur des prix de référence (hypothèses) pour les articles sans observation détaillant ; la part observée est affichée partout et figure dans les rapports.
  • Sites municipaux/provinciaux protégés (HTTP 403 pour les accès automatisés depuis le LAN et depuis OVH le 2026-10-28) : DTNI/MTMD restent en import manuel documenté.
Files main
Menu

Theme