SPB Git forge

spb/uqo-eval

Public
55commits 2branches 0releases
134.4 MBsize
maindefault branch
52 min agolast push
TypeScript 90.1% JavaScript 3.2% Python 3.2% CSS 1.8% HTML 1.8%
ZIP tar.gz
NameLast commitUpdated
assets UQO Éval : refonte complète depuis Vrai-Prix — identité UQO officielle... 1 mo ago
docs adopt: état déployé sur M2U64 adopté comme source de vérité... 1 h ago
prompts adopt: état déployé sur M2U64 adopté comme source de vérité... 1 h ago
public adopt: état déployé sur M2U64 adopté comme source de vérité... 1 h ago
scripts adopt: état déployé sur M2U64 adopté comme source de vérité... 1 h ago
src adopt: état déployé sur M2U64 adopté comme source de vérité... 1 h ago
tmp adopt: état déployé sur M2U64 adopté comme source de vérité... 1 h ago
vendor UQO Éval : refonte complète depuis Vrai-Prix — identité UQO officielle... 1 mo ago
.gitignore Recherche par carte — /carte (Leaflet+OSM) + API /api/nearby 1 mo ago
AGENTS.md Initial commit from Create Next App 1 mo ago
CLAUDE.md Initial commit from Create Next App 1 mo ago
eslint.config.mjs Initial commit from Create Next App 1 mo ago
next.config.ts Vrai-Prix Maps — recherche par carte propulsée par Ka Maps (framework... 1 mo ago
package-lock.json adopt: état déployé sur M2U64 adopté comme source de vérité... 1 h ago
package.json adopt: état déployé sur M2U64 adopté comme source de vérité... 1 h ago
postcss.config.mjs Initial commit from Create Next App 1 mo ago
README.md UQO Éval : refonte complète depuis Vrai-Prix — identité UQO officielle... 1 mo ago
tsconfig.json Initial commit from Create Next App 1 mo ago
vitest.config.ts feat: Vrai-Prix — moteur d'évaluation immobilière transparent pour le... 1 mo ago
README.md source

UQO Éval — Laboratoire pédagogique d'évaluation immobilière

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

Site UQO Next.js React TypeScript Tailwind SQLite Mapbox Claude MdAPE

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 — jamais redessinés ni déformés.

# Architecture

text
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).