docs: README ultra détaillé + visite guidée en 10 captures

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Simon-Pierre Boucher committed 27 days ago (Aug 29, 2026) parent cb53ef4

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	56	\| Modèle \| hédonique LightGBM + comparables ajustés — MdAPE 11,0 %, ratio médian 0,995 \|
57	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	131	<table>
66	132	<tr>
		`@@ -75,7 +141,7 @@ Sous le capot : les 6 millésimes (2021-2026) des rôles d'évaluation fonci`
75	141	</tr>
76	142	</table>
77	143
78		−### Desktop
	144	+#### Desktop
79	145
80	146	<table>
81	147	<tr>
		`@@ -202,7 +268,7 @@ Application Next.js 16 (App Router) — SQLite better-sqlite3 (units + FTS5`
202	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	269	\| `data/` \| base SQLite `vraiprix.db` (non versionnée) \|
204	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	272	\| `public/` \| assets statiques (favicons, OG, polices) + guide `/doc` (page, images, PDF) \|
207	273	\| `ios/` \| ressources de l'app compagnon iOS (SwiftUI) \|
208	274	\| `assets/` \| matériel graphique du projet \|
		`@@ -283,6 +349,8 @@ pm2 logs vrai-prix --lines 30`
283	349	\| 2026-08-19 \| stats v2 (`/stats` ultra complet + 5 rapports PDF), KA Agent v2 plein écran, socle mobile \|
284	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	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	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