docs: ka-maps-vrai-prix.md — intégration Vrai-Prix Maps
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 changed file +39 −0
added
docs/ka-maps-vrai-prix.md
+39 −0
@@ -0,0 +1,39 @@ | ||
| 1 | +# Vrai-Prix Maps — intégration Ka Maps | |
| 2 | + | |
| 3 | +**Auteur : Simon-Pierre Boucher — contact@spboucher.ai — Groupe Ka / Ka Maps (intégration Vrai-Prix)** | |
| 4 | + | |
| 5 | +`/carte` est propulsée par le framework partagé `@groupe-ka/ka-maps`, | |
| 6 | +consommé en **tarball** (`file:../../ka-maps/groupe-ka-ka-maps-0.1.0.tgz` | |
| 7 | +— Turbopack ne résout pas les liens symboliques hors racine). Après une | |
| 8 | +évolution du framework : `npm run pack:tarball` dans ka-maps puis | |
| 9 | +`npm install` ici. Voir `~/Desktop/ka-maps/docs/ka-maps.md`. | |
| 10 | + | |
| 11 | +## Fichiers de l'intégration | |
| 12 | + | |
| 13 | +| Fichier | Rôle | | |
| 14 | +|---|---| | |
| 15 | +| `src/lib/kamaps.ts` | thème Vrai-Prix Maps + adaptateur `/api/nearby` (valeurs estimées, jamais des prix) | | |
| 16 | +| `src/components/KaCarte.tsx` | carte cliente (chargée `next/dynamic { ssr:false }`), bilingue FR/EN | | |
| 17 | +| `src/app/carte/CartePage.tsx` | page ; remplace l'ancienne carte Leaflet/OSM | | |
| 18 | +| `src/app/api/nearby/route.ts` | plafonds relevés (halfLat 0,08 / halfLng 0,12 / limit 1500) — additif | | |
| 19 | +| `src/app/globals.css` | styles `.vpm-*` + jetons `--ka-*` (bloc Leaflet supprimé) | | |
| 20 | + | |
| 21 | +## Sémantique valuation | |
| 22 | + | |
| 23 | +Les pastilles affichent la **valeur estimée 2026** (`kind: "valuation"`, | |
| 24 | +pastille encre à liseré rouge) — visuellement distincte d'un prix | |
| 25 | +demandé et jamais présentée comme tel. Aperçu : « Estimation 2026 » + | |
| 26 | +lien vers `/estimation/{id}`. | |
| 27 | + | |
| 28 | +## Contrat iOS | |
| 29 | + | |
| 30 | +`/api/nearby` est consommé par l'app iOS 1.1.0 (MapKit). Les changements | |
| 31 | +sont **additifs uniquement** : mêmes paramètres, mêmes défauts, même | |
| 32 | +forme de réponse — seuls les plafonds serveur ont été relevés (l'app iOS | |
| 33 | +y gagne la disparition de ses gouttières). | |
| 34 | + | |
| 35 | +## Temporel (architecturé) | |
| 36 | + | |
| 37 | +Les six millésimes (`est_2021…est_2026`) sont des colonnes de la même | |
| 38 | +ligne : un futur curseur temporel = élargir le SELECT de `unitsNear` + | |
| 39 | +un paramètre `year` additif — aucun changement de schéma. | |
| 40 | ||