Audit d'intégration — UQO Éval (Phase 0)
État inspecté le 2026-10-28 sur le nœud de production M2U64 (
~/apps/uqo-eval, commit07063c1, PM2uqo-eval:8150,https://www.uqo-eval.app), source de vérité remote-first (origingitsrv: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) |
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/metreet une base séparéedata/metre.db+ fichiersdata/metre-files/. Les bases existantes ne sont jamais écrites ;cost.dbest lue via les fonctions existantes (buildContext,loadAssemblies,residentialIndexSeries…). - Feature flag :
METRE_ENABLED(serveur : pages → 404, API → 404) etNEXT_PUBLIC_METRE_ENABLED(entrée « Métré » duHeaderNav). 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 demetre.db(voirSCHEMA_AND_MIGRATIONS.md). - Dépendances ajoutées :
pdfjs-dist6.4 (Apache-2.0, rendu client ; worker copié danspublic/metre/),exceljs4.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) etpackage.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.tssans toucher au reste. - SQLite et concurrence : better-sqlite3 synchrone, WAL,
busy_timeout5 s ; adapté à un cours (dizaines d'utilisateurs), pas à des milliers de sessions simultanées. Les mesures de performance réelles figurent dansVALIDATION_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é.