# 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.