# Lou-Ka Maps — intégration Ka Maps

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

Lou-Ka consomme le framework partagé `@groupe-ka/ka-maps`
(`file:../../ka-maps`, moteur Mapbox GL, style Standard 3D). Voir
`~/Desktop/ka-maps/docs/ka-maps.md` pour l'architecture du framework.

## Fichiers de l'intégration

| Fichier | Rôle |
|---|---|
| `frontend/src/kamaps/theme.ts` | thème Lou-Ka Maps (encre/lime/vert ; pastilles encre-blanc, sélection lime) |
| `frontend/src/kamaps/adapter.ts` | `/api/listings.geojson?bbox=…` → `MapProperty` (kind `listing`, type `rent`) |
| `frontend/src/kamaps/config.ts` | jeton public Mapbox (surcharge `VITE_MAPBOX_TOKEN`) |
| `frontend/src/components/MapView.tsx` | montage : sync liste↔carte, URL caméra, aperçu React, 3D/2D |
| `frontend/src/pages/Home.tsx` | sélection/survol des cartes de liste + recherche debouncée |
| `louka/web.py` | `/api/listings.geojson` : `bbox`, `limit`, `totalGeocoded`, `totalMatching` |
| `louka/db.py` | index `idx_listings_geo(lat,lng)` (+ `PRAGMA optimize` à l'ingestion) |

## Spécificités Lou-Ka

- `cluster={{ maxZoom: 15, valueClamp: [250, 8000] }}` : géocodage par
  immeuble (les logements d'une adresse se superposent) et loyers
  aberrants (maisons à vendre publiées en location) bornés.
- Compat : sans `bbox`, l'endpoint GeoJSON garde son ancien comportement.
- « N hors carte » = annonces filtrées sans coordonnées ou hors zone
  (`totalMatching`) — ~40 % des annonces actives ne sont pas géocodées.
- L'app iOS (MapKit) est hors périmètre Ka Maps : elle partage seulement
  les API.

## Vérifier

`npm run build` (typecheck+bundle) ; `python run.py serve 8095` puis
`/?view=carte` : grappes → zoom → pastilles → clic → aperçu → pan →
« Rechercher dans cette zone » → filtre → compteur.