docs: README ultra détaillé + visite guidée en 10 captures
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
12 changed files +83 −5
modified
README.md
+73 −5
@@ -56,11 +56,77 @@ Sous le capot : les **6 millésimes (2021-2026)** des rôles d'évaluation fonci | |||||
| 56 | | Modèle | hédonique LightGBM + comparables ajustés — **MdAPE 11,0 %**, ratio médian 0,995 | | 56 | | Modèle | hédonique LightGBM + comparables ajustés — **MdAPE 11,0 %**, ratio médian 0,995 | | ||
| 57 | | Millésime de la base | 2026 (dernier recalcul : 2026-08-08) | | 57 | | Millésime de la base | 2026 (dernier recalcul : 2026-08-08) | | ||
| 58 | 58 | ||||
| 59 | −## Visite guidée | 59 | +## Visite guidée — le site en 10 pages | ||
| 60 | 60 | ||||
| 61 | −*Captures du 2026-08-25 — refonte v2 « terminal éditorial » (mobile 390×844 · desktop 1440×900).* | 61 | +*Captures live du **2026-08-28** (production, www.vrai-prix.com — desktop). Chaque capture correspond à une page réelle du site ; le manifeste des URLs est dans [`docs/screenshots/`](docs/screenshots/).* | ||
| 62 | 62 | ||||
| 63 | −### Mobile | 63 | +### 1. Accueil — [`/`](https://www.vrai-prix.com/) | ||
| 64 | + | ||||
| 65 | +<img src="docs/screenshots/01-accueil.jpg" width="840" alt="Accueil de Vrai-Prix — hero encre, recherche d'adresse centrale, graphique marché multi-séries"> | ||||
| 66 | + | ||||
| 67 | +**L'estimateur, dès la première seconde.** Hero « terminal éditorial », recherche d'adresse centrale (FTS5, tolérante aux fautes) parmi les 3 747 008 unités d'évaluation, chiffres clés de la province et graphique marché multi-séries interactif. C'est le point d'entrée de 95 % des visites : on tape une adresse, on obtient un rapport de valeur. | ||||
| 68 | + | ||||
| 69 | +### 2. Répertoire des municipalités — [`/municipalites`](https://www.vrai-prix.com/municipalites) | ||||
| 70 | + | ||||
| 71 | +<img src="docs/screenshots/02-municipalites.jpg" width="840" alt="Répertoire des 1 097 municipalités du Québec — recherche, tri et agrégats"> | ||||
| 72 | + | ||||
| 73 | +**Les 1 097 municipalités du Québec, une par une.** Répertoire complet avec recherche et agrégats (valeur médiane, croissance, nombre d'unités) — la porte d'entrée du SEO programmatique (1 097 pages municipalités + ~5 900 pages municipalité × type de propriété). | ||||
| 74 | + | ||||
| 75 | +### 3. Vrai-Prix Maps — [`/carte`](https://www.vrai-prix.com/carte) | ||||
| 76 | + | ||||
| 77 | +<img src="docs/screenshots/03-carte.jpg" width="840" alt="Vrai-Prix Maps — carte 3D Mapbox GL avec grappes de valeurs estimées"> | ||||
| 78 | + | ||||
| 79 | +**La recherche par carte.** Carte 3D Mapbox GL (framework partagé `@groupe-ka/ka-maps`) : grappes de valeurs estimées pilotées par le viewport, pastilles de prix, clic → fiche d'estimation. Le compteur suit exactement les marqueurs affichés. | ||||
| 80 | + | ||||
| 81 | +### 4. Statistiques provinciales — [`/stats`](https://www.vrai-prix.com/stats) | ||||
| 82 | + | ||||
| 83 | +<img src="docs/screenshots/04-stats.jpg" width="840" alt="Tableau de bord des statistiques provinciales — valeur du parc, palmarès, flux de ventes"> | ||||
| 84 | + | ||||
| 85 | +**L'observatoire du marché québécois.** Tableau de bord v3 : valeur totale du parc (≈ 2,01 billions $ au millésime 2026), médianes, croissance 2021→2026, palmarès des 200 municipalités, flux de ventes « prix d'abord » — et rapports PDF personnalisés à la demande (catalogue de blocs, ReportBuilder). | ||||
| 86 | + | ||||
| 87 | +### 5. Ka · agent IA — [`/ka`](https://www.vrai-prix.com/ka) | ||||
| 88 | + | ||||
| 89 | +<img src="docs/screenshots/05-ka.jpg" width="840" alt="Agent conversationnel Ka — estimation et analyse immobilière en langage naturel"> | ||||
| 90 | + | ||||
| 91 | +**Poser ses questions en français.** Agent conversationnel (Claude, streaming SSE, widget ka-agent v4 plein écran) branché sur **12 outils serveur** : il évalue une propriété, sort les comparables détaillés, compare deux adresses, évalue un parc, cite les stats municipales et pointe vers les rapports PDF — sans jamais inventer de lien. | ||||
| 92 | + | ||||
| 93 | +### 6. Parc immobilier — [`/parc`](https://www.vrai-prix.com/parc) | ||||
| 94 | + | ||||
| 95 | +<img src="docs/screenshots/06-parc.jpg" width="840" alt="Évaluation de parc immobilier — jusqu'à 40 propriétés agrégées"> | ||||
| 96 | + | ||||
| 97 | +**Évaluer un portefeuille entier.** Jusqu'à 40 adresses évaluées d'un coup, valeur consolidée, répartition et rapport PDF de parc — pensé pour les propriétaires de plex et les petits investisseurs. | ||||
| 98 | + | ||||
| 99 | +### 7. Méthodologie — [`/methodologie`](https://www.vrai-prix.com/methodologie) | ||||
| 100 | + | ||||
| 101 | +<img src="docs/screenshots/07-methodologie.jpg" width="840" alt="Méthodologie complète publiée — modèle hédonique, comparables, normes IAAO"> | ||||
| 102 | + | ||||
| 103 | +**La transparence comme produit.** Les 7 sections de la méthodologie (normes **IAAO**) publiées intégralement : sources (rôles MAMH 2021-2026 + 745 119 ventes réelles), fusion spatiale, modèle hédonique LightGBM (MdAPE 11,0 %), comparables ajustés, fourchette P10–P90, indice de confiance A–D, limites connues. Aucune boîte noire. | ||||
| 104 | + | ||||
| 105 | +### 8. Conditions d'utilisation — [`/conditions`](https://www.vrai-prix.com/conditions) | ||||
| 106 | + | ||||
| 107 | +<img src="docs/screenshots/08-conditions.jpg" width="840" alt="Conditions d'utilisation de Vrai-Prix"> | ||||
| 108 | + | ||||
| 109 | +**Le cadre d'usage, écrit clairement.** Nature indicative des estimations (elles ne remplacent pas un évaluateur agréé OEAQ), usage loyal du service et des rapports, propriété des contenus. | ||||
| 110 | + | ||||
| 111 | +### 9. Politique de confidentialité — [`/confidentialite`](https://www.vrai-prix.com/confidentialite) | ||||
| 112 | + | ||||
| 113 | +<img src="docs/screenshots/09-confidentialite.jpg" width="840" alt="Politique de confidentialité — conformité Loi 25"> | ||||
| 114 | + | ||||
| 115 | +**Conformité Loi 25.** Aucun script publicitaire, analytics première partie seulement, SSO KA ID sans base d'utilisateurs locale — la politique détaille ce qui est collecté (presque rien) et pourquoi. | ||||
| 116 | + | ||||
| 117 | +### 10. Page municipalité — [`/municipalite/montreal`](https://www.vrai-prix.com/municipalite/montreal) | ||||
| 118 | + | ||||
| 119 | +<img src="docs/screenshots/10-municipalite-montreal.jpg" width="840" alt="Page municipalité de Montréal — agrégats, palmarès et propriétés locales"> | ||||
| 120 | + | ||||
| 121 | +**Le portrait local, ici Montréal.** Agrégats du rôle (valeur médiane, croissance, composition du parc), palmarès locaux et accès aux fiches d'estimation du territoire — le gabarit décliné sur les 1 097 municipalités. | ||||
| 122 | + | ||||
| 123 | +--- | ||||
| 124 | + | ||||
| 125 | +### Galerie v2 « terminal éditorial » (2026-08-25) | ||||
| 126 | + | ||||
| 127 | +*Captures de la refonte v2 (mobile 390×844 · desktop 1440×900).* | ||||
| 128 | + | ||||
| 129 | +#### Mobile | ||||
| 64 | 130 | ||||
| 65 | <table> | 131 | <table> | ||
| 66 | <tr> | 132 | <tr> | ||
@@ -75,7 +141,7 @@ Sous le capot : les **6 millésimes (2021-2026)** des rôles d'évaluation fonci | |||||
| 75 | </tr> | 141 | </tr> | ||
| 76 | </table> | 142 | </table> | ||
| 77 | 143 | ||||
| 78 | −### Desktop | 144 | +#### Desktop | ||
| 79 | 145 | ||||
| 80 | <table> | 146 | <table> | ||
| 81 | <tr> | 147 | <tr> | ||
@@ -202,7 +268,7 @@ Application Next.js 16 (App Router) — SQLite better-sqlite3 (units + FTS5 | |||||
| 202 | | `src/lib/` | moteur de comparables (`engine.ts`), accès DB, agrégats municipalités, agent Ka (`ka/`), SSO KA ID, générateurs PDF (`report*.ts`), SEO, i18n | | 268 | | `src/lib/` | moteur de comparables (`engine.ts`), accès DB, agrégats municipalités, agent Ka (`ka/`), SSO KA ID, générateurs PDF (`report*.ts`), SEO, i18n | | ||
| 203 | | `data/` | base SQLite `vraiprix.db` (non versionnée) | | 269 | | `data/` | base SQLite `vraiprix.db` (non versionnée) | | ||
| 204 | | `scripts/` | réentraînement hédonique, build des stats, ingestion (dont `ingest-jdm.mjs`), captures Playwright | | 270 | | `scripts/` | réentraînement hédonique, build des stats, ingestion (dont `ingest-jdm.mjs`), captures Playwright | | ||
| 205 | −| `docs/` | pipeline de données (`PIPELINE-DONNEES.md`), notes Ka Maps, captures d'écran | | 271 | +| `docs/` | pipeline de données (`PIPELINE-DONNEES.md`), notes Ka Maps, captures d'écran (`screenshots/` : visite guidée 10 pages + manifeste, galeries WebP mobile/desktop ; `archive/` : captures v1) | | ||
| 206 | | `public/` | assets statiques (favicons, OG, polices) + guide `/doc` (page, images, PDF) | | 272 | | `public/` | assets statiques (favicons, OG, polices) + guide `/doc` (page, images, PDF) | | ||
| 207 | | `ios/` | ressources de l'app compagnon iOS (SwiftUI) | | 273 | | `ios/` | ressources de l'app compagnon iOS (SwiftUI) | | ||
| 208 | | `assets/` | matériel graphique du projet | | 274 | | `assets/` | matériel graphique du projet | | ||
@@ -283,6 +349,8 @@ pm2 logs vrai-prix --lines 30 | |||||
| 283 | | 2026-08-19 | stats v2 (`/stats` ultra complet + 5 rapports PDF), KA Agent v2 plein écran, socle mobile | | 349 | | 2026-08-19 | stats v2 (`/stats` ultra complet + 5 rapports PDF), KA Agent v2 plein écran, socle mobile | | ||
| 284 | | 2026-08-22 | ré-estimation hédonique sur le nœud (terrain/autre + recalibrage P10/P90), connecteur « nouvelles ventes » JdM, upgrade apparence (contexte marché, fourchette visuelle) | | 350 | | 2026-08-22 | ré-estimation hédonique sur le nœud (terrain/autre + recalibrage P10/P90), connecteur « nouvelles ventes » JdM, upgrade apparence (contexte marché, fourchette visuelle) | | ||
| 285 | | 2026-08-23/24 | stats v3 (rapports PDF personnalisés), favoris « Mon univers Ka », page `/doc` + PDF, README v3 | | 351 | | 2026-08-23/24 | stats v3 (rapports PDF personnalisés), favoris « Mon univers Ka », page `/doc` + PDF, README v3 | | ||
| 352 | +| 2026-08-25 | refonte front-end v2 « terminal éditorial », KA Tabbar v1, widget ka-agent v4, galerie WebP mobile+desktop | | ||||
| 353 | +| 2026-08-28 | README v4 — visite guidée « le site en 10 pages » (captures live de production, `docs/screenshots/`) | | ||||
| 286 | 354 | ||||
| 287 | ## Écosystème Groupe KA | 355 | ## Écosystème Groupe KA | ||
| 288 | 356 | ||||
added
docs/screenshots/01-accueil.jpg
+0 −0
Binary file not shown.
added
docs/screenshots/02-municipalites.jpg
+0 −0
Binary file not shown.
added
docs/screenshots/03-carte.jpg
+0 −0
Binary file not shown.
added
docs/screenshots/04-stats.jpg
+0 −0
Binary file not shown.
added
docs/screenshots/05-ka.jpg
+0 −0
Binary file not shown.
added
docs/screenshots/06-parc.jpg
+0 −0
Binary file not shown.
added
docs/screenshots/07-methodologie.jpg
+0 −0
Binary file not shown.
added
docs/screenshots/08-conditions.jpg
+0 −0
Binary file not shown.
added
docs/screenshots/09-confidentialite.jpg
+0 −0
Binary file not shown.
added
docs/screenshots/10-municipalite-montreal.jpg
+0 −0
Binary file not shown.
added
docs/screenshots/manifest.txt
+10 −0
@@ -0,0 +1,10 @@ | |||||
| 1 | +01-accueil.jpg :: https://www.vrai-prix.com/ | ||||
| 2 | +02-municipalites.jpg :: https://www.vrai-prix.com/municipalites | ||||
| 3 | +03-carte.jpg :: https://www.vrai-prix.com/carte | ||||
| 4 | +04-stats.jpg :: https://www.vrai-prix.com/stats | ||||
| 5 | +05-ka.jpg :: https://www.vrai-prix.com/ka | ||||
| 6 | +06-parc.jpg :: https://www.vrai-prix.com/parc | ||||
| 7 | +07-methodologie.jpg :: https://www.vrai-prix.com/methodologie | ||||
| 8 | +08-conditions.jpg :: https://www.vrai-prix.com/conditions | ||||
| 9 | +09-confidentialite.jpg :: https://www.vrai-prix.com/confidentialite | ||||
| 10 | +10-municipalite-montreal.jpg :: https://www.vrai-prix.com/municipalite/montreal | ||||
| 11 | |||||