TypeScript 90.1%
JavaScript 3.2%
Python 3.2%
CSS 1.8%
HTML 1.8%
1<p align="center">2 <a href="https://www.uqo-eval.app"><img src="public/og.png" width="760" alt="UQO Éval — Laboratoire pédagogique d'évaluation immobilière"></a>3</p>45<h1 align="center">UQO Éval</h1>67<p align="center"><b>Laboratoire pédagogique d'évaluation immobilière</b><br>8<sub>Cours IMM1003 — Éléments d'évaluation immobilière · IMM1033 — Méthodes du coût en évaluation immobilière<br>9enseignés par Simon-Pierre Boucher — Université du Québec en Outaouais</sub></p>1011<div align="center">12131415161718192021222324</div>2526**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.2728Sous 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**.2930> ⚠️ **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).3132## Fonctionnalités3334- **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.35- **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).36- **Comparables expliqués** — carte radar + tableau : distance, date, prix, $/m², ajustements en dollars, poids.37- **UQO Éval Maps** — recherche par carte 3D (Mapbox GL), pastilles de valeurs estimées.38- **Éva · assistante pédagogique** — agent conversationnel (Claude, streaming SSE, 12 outils serveur) qui évalue et **explique** chaque calcul.39- **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.40- **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).41- **Statistiques provinciales**, pages municipalités (1 097), parc immobilier multi-adresses, bilingue FR/EN.4243## Identité visuelle4445Couleurs et logo **officiels de l'UQO** (Guide de normes graphiques, déc. 2025 — `assets/uqo/BRANDING.md`) :46bleu 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.4748## Architecture4950```51Rôles d'évaluation MAMH 2021-2026 (6 millésimes × ~3,7 M unités)52 │ fusion spatiale XY (EPSG:32198) — kNN k=25 ≤200 m53 ▼54745 119 transactions enrichies ──▶ modèle hédonique LightGBM (log-prix,55 18 variables + quantiles P10/P90)56 ▼57Application Next.js 16 (App Router) — SQLite better-sqlite3 (units + FTS558+ transactions + indice de marché) · moteur de comparables (src/lib/engine.ts)59· mode étudiant (src/components/StudentPanel.tsx) · Éva (Claude + 12 outils)60· rapports pdfkit (logo UQO + mention IMM1003/IMM1033) · SEO programmatique61```6263| Répertoire | Rôle |64|---|---|65| `src/app/` | pages App Router (accueil, `estimation/[id]`, `carte`, `assistant`, `parc`, `stats`, `methodologie`, municipalités) + routes `/api/*` |66| `src/components/` | SearchBox, ResultView (+ mode étudiant), StudentPanel, MetricViz, RadarMap, KaCarte, UqoFooter… |67| `src/lib/` | moteur (`engine.ts`), accès DB, agent Éva (`ka/`), générateurs PDF (`report*.ts`), SEO, i18n |68| `data/` | base SQLite `vraiprix.db` (2 Go, non versionnée) |69| `assets/uqo/` | logos et normes graphiques officiels UQO |70| `vendor/` | tarball `@groupe-ka/ka-maps` (framework de carte, vendorisé) |7172## Démarrage rapide7374```bash75npm install76npm run test # Vitest — moteur d'estimation77npm run lint78npm run dev # http://localhost:300079npm run build && npm start80```8182Variables (`.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é).8384## Provenance8586Projet 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.8788---8990© UQO Éval — laboratoire pédagogique. Estimations statistiques à titre indicatif ; elles ne remplacent pas une évaluation par un évaluateur agréé (OEAQ).91