Repository Public
1# Audit d'intégration — UQO Éval (Phase 0)23> É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`).45## 1. Architecture existante67| Aspect | Constat |8|---|---|9| Framework | Next.js 16.3 (App Router, React 19, React Compiler lint), TypeScript strict, Tailwind v4 ; `serverExternalPackages: ["better-sqlite3", "pdfkit"]` |10| Backend | Route handlers Node sous `src/app/api/*` ; aucune couche serveur séparée, aucun ORM |11| 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) |12| 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`) |13| Rôles | inexistants ; « mode étudiant » purement client (masquer des résultats) |14| 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` |15| 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) |16| PDF | pdfkit, polices `assets/fonts`, logo UQO, Lettre |17| Tests | Vitest : 69 tests (4 fichiers) ; lint 0 erreur / 10 avertissements ; `tsc --noEmit` propre |18| 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 |1920## 2. Ce qui manquait par rapport au cahier des charges2122| Exigence | Existant | Décision |23|---|---|---|24| Projets, plans, métré | aucun | nouveau module `metre` (base distincte `data/metre.db`) |25| Plan Studio (import PDF/image, calibration, dessin, registre) | aucun | implémenté (pdfjs-dist côté client, SVG, formules inspectables, révisions de calibration) |26| 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` |27| 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) |28| 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, …) |29| 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) |30| Rôles et isolation | aucun | codes d'accès + sessions, rôles student/instructor/admin/professional, contrôle serveur par projet |31| Rapports bilingues PDF/CSV/XLSX | PDF FR seulement (`report-cost.ts`) | nouveau rapport FR/EN + CSV + XLSX depuis révision immuable |32| 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 |3334## 3. Stratégie d'intégration et de migration3536- **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`…).37- **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.38- **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`).39- **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.40- **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.4142## 4. Baseline de tests et régression4344| Mesure | Avant (2026-10-28 06:40) | Après |45|---|---|---|46| Vitest | 69 tests, 4 fichiers, verts | **105 tests, 7 fichiers**, verts (69 inchangés + 36 nouveaux) |47| `tsc --noEmit` | propre | propre |48| ESLint | 0 erreur / 10 avertissements (code existant) | 0 erreur (module : 0 avertissement) |49| Pages existantes `/`, `/cout`, `/a-vendre`, `/stats`, `/methodologie` | 200 | 200 (vérifiées après redéploiement) |5051## 5. Contraintes et risques identifiés5253- **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.54- **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`.55- **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.56- **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.57- **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é.58