# Vrai-Prix Maps — intégration Ka Maps

**Auteur : Simon-Pierre Boucher — contact@spboucher.ai — Groupe Ka / Ka Maps (intégration Vrai-Prix)**

`/carte` est propulsée par le framework partagé `@groupe-ka/ka-maps`,
consommé en **tarball** (`file:../../ka-maps/groupe-ka-ka-maps-0.1.0.tgz`
— Turbopack ne résout pas les liens symboliques hors racine). Après une
évolution du framework : `npm run pack:tarball` dans ka-maps puis
`npm install` ici. Voir `~/Desktop/ka-maps/docs/ka-maps.md`.

## Fichiers de l'intégration

| Fichier | Rôle |
|---|---|
| `src/lib/kamaps.ts` | thème Vrai-Prix Maps + adaptateur `/api/nearby` (valeurs estimées, jamais des prix) |
| `src/components/KaCarte.tsx` | carte cliente (chargée `next/dynamic { ssr:false }`), bilingue FR/EN |
| `src/app/carte/CartePage.tsx` | page ; remplace l'ancienne carte Leaflet/OSM |
| `src/app/api/nearby/route.ts` | plafonds relevés (halfLat 0,08 / halfLng 0,12 / limit 1500) — additif |
| `src/app/globals.css` | styles `.vpm-*` + jetons `--ka-*` (bloc Leaflet supprimé) |

## Sémantique valuation

Les pastilles affichent la **valeur estimée 2026** (`kind: "valuation"`,
pastille encre à liseré rouge) — visuellement distincte d'un prix
demandé et jamais présentée comme tel. Aperçu : « Estimation 2026 » +
lien vers `/estimation/{id}`.

## Contrat iOS

`/api/nearby` est consommé par l'app iOS 1.1.0 (MapKit). Les changements
sont **additifs uniquement** : mêmes paramètres, mêmes défauts, même
forme de réponse — seuls les plafonds serveur ont été relevés (l'app iOS
y gagne la disparition de ses gouttières).

## Temporel (architecturé)

Les six millésimes (`est_2021…est_2026`) sont des colonnes de la même
ligne : un futur curseur temporel = élargir le SELECT de `unitsNear` +
un paramètre `year` additif — aucun changement de schéma.