UQO Éval
Laboratoire pédagogique d'évaluation immobilière
Cours IMM1003 — Éléments d'évaluation immobilière · IMM1033 — Méthodes du coût en évaluation immobilière
enseignés par Simon-Pierre Boucher — Université du Québec en Outaouais
**UQO Éval** est une plateforme universitaire qui permet aux étudiantes et étudiants de **comprendre comment une propriété est évaluée** — pas seulement d'obtenir un prix. Chaque estimation montre son calcul en entier : comparables retenus (et pourquoi), ajustements en dollars, pondération modèle/comparables, intervalle de confiance P10-P90, indice de confiance A-D — plus un **mode étudiant** qui décompose les formules du moteur.
Sous le capot : les **6 millésimes (2021-2026)** des rôles d'évaluation foncière géoréférencés du Québec (**MAMH**, données ouvertes) — **3 747 008 propriétés**, 22,15 M d'observations — fusionnés spatialement avec **745 119 transactions réelles**, alimentant un **modèle hédonique LightGBM** (MdAPE 11,0 %, ratio médian 0,995) et un **moteur de comparables ajustés**. Validation selon les normes **IAAO**.
> ⚠️ **Disclaimer** — Plateforme à vocation **pédagogique, universitaire et expérimentale**. Les estimations sont statistiques et ne constituent pas une évaluation immobilière professionnelle certifiée (OEAQ).
## Fonctionnalités
- **Analyser une propriété** — recherche plein-texte (FTS5) parmi 3,7 M d'unités ; estimation hybride 65 % modèle hédonique + 35 % comparables ajustés, fourchette P10-P90, indice A-D.
- **Mode étudiant 🎓** — sur chaque fiche : pourquoi ces comparables, formule de pondération (3 gaussiennes), les 3 ajustements expliqués, combinaison 65/35 avec les vrais chiffres, décomposition du score de confiance, concepts (valeur marchande vs prix demandé vs prix de transaction vs rôle).
- **Comparables expliqués** — carte radar + tableau : distance, date, prix, $/m², ajustements en dollars, poids.
- **UQO Éval Maps** — recherche par carte 3D (Mapbox GL), pastilles de valeurs estimées.
- **Éva · assistante pédagogique** — agent conversationnel (Claude, streaming SSE, 12 outils serveur) qui évalue et **explique** chaque calcul.
- **Rapports PDF vectoriels** — standard (3 p.), professionnel (6 p., structure de rapport d'évaluation), parc, statistiques — tous avec **logo officiel UQO** et mention des cours IMM1003 · IMM1033.
- **Méthodologie publique** (9 sections) — données, fusion spatiale, modèle, validation IAAO, moteur, **guide pédagogique des méthodes d'évaluation** (comparables, hédonique, coût, AVM, biais et limites).
- **Statistiques provinciales**, pages municipalités (1 097), parc immobilier multi-adresses, bilingue FR/EN.
## Identité visuelle
Couleurs et logo **officiels de l'UQO** (Guide de normes graphiques, déc. 2025 — `assets/uqo/BRANDING.md`) :
bleu institutionnel **PMS 7469 `#006085`**, turquoise web `#2BCCAE`, corail `#EA6047`. Logos officiels (EPS/SVG/PNG, versions couleur/blanc/noir) téléchargés depuis [uqo.ca/medias/logos](https://uqo.ca/medias/logos) — jamais redessinés ni déformés.
## Architecture
```
Rôles d'évaluation MAMH 2021-2026 (6 millésimes × ~3,7 M unités)
│ fusion spatiale XY (EPSG:32198) — kNN k=25 ≤200 m
▼
745 119 transactions enrichies ──▶ modèle hédonique LightGBM (log-prix,
18 variables + quantiles P10/P90)
▼
Application Next.js 16 (App Router) — SQLite better-sqlite3 (units + FTS5
+ transactions + indice de marché) · moteur de comparables (src/lib/engine.ts)
· mode étudiant (src/components/StudentPanel.tsx) · Éva (Claude + 12 outils)
· rapports pdfkit (logo UQO + mention IMM1003/IMM1033) · SEO programmatique
```
| Répertoire | Rôle |
|---|---|
| `src/app/` | pages App Router (accueil, `estimation/[id]`, `carte`, `assistant`, `parc`, `stats`, `methodologie`, municipalités) + routes `/api/*` |
| `src/components/` | SearchBox, ResultView (+ mode étudiant), StudentPanel, MetricViz, RadarMap, KaCarte, UqoFooter… |
| `src/lib/` | moteur (`engine.ts`), accès DB, agent Éva (`ka/`), générateurs PDF (`report*.ts`), SEO, i18n |
| `data/` | base SQLite `vraiprix.db` (2 Go, non versionnée) |
| `assets/uqo/` | logos et normes graphiques officiels UQO |
| `vendor/` | tarball `@groupe-ka/ka-maps` (framework de carte, vendorisé) |
## Démarrage rapide
```bash
npm install
npm run test # Vitest — moteur d'estimation
npm run lint
npm run dev # http://localhost:3000
npm run build && npm start
```
Variables (`.env.local`) : `NEXT_PUBLIC_SITE_URL`, `VRAIPRIX_DB` (chemin de la base), `ANTHROPIC_API_KEY` (assistante Éva), `NEXT_PUBLIC_MAPBOX_TOKEN` (facultatif, défaut embarqué).
## Provenance
Projet dérivé du moteur d'estimation **Vrai-Prix** (même socle de données et de modèles), entièrement ré-orienté et re-marqué en plateforme pédagogique universitaire indépendante. La production Vrai-Prix n'est ni modifiée ni partagée : base de données, environnement, domaine, nœud et processus sont distincts.
---
© UQO Éval — laboratoire pédagogique. Estimations statistiques à titre indicatif ; elles ne remplacent pas une évaluation par un évaluateur agréé (OEAQ).