spb/vrai-prix

- lib/hubfav.ts : client HMAC du hub (transposé de food-ka) — aucun stockage
  local, toggle synchrone, lecture GET signée avec cache mémoire 30 s
  invalidé à chaque toggle
- /api/favorites (GET, 401 sans session) + /api/favorites/toggle (POST,
  bascule add/remove selon la liste du hub, action explicite acceptée)
- FavButton ♥ : fiche estimation (panneau prix) + cartes du parc ;
  déconnecté → départ SSO KA ID ; état initial partagé (une requête/page)
- page /favoris : liste (titre, ville, estimation, lien fiche, retrait) ;
  lien « Mes favoris » sur /compte
- Testé bout en bout contre le hub (add → list → remove, rien laissé)

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

- Fiche estimation : barre de fourchette P10-P90 (marqueurs estimation + rôle),
  faits rapides ($/m², type, année, superficies), section « Le marché autour de
  cette propriété » (courbe d'indice base 100 + tendances 12 mois/2021, ventes
  réelles du secteur avec rayon adaptatif, position percentile dans la
  municipalité), comparables enrichis ($/m², superficie, année)
- Moteur : MarketContext (estimator) — stats secteur depuis les candidats déjà
  chargés, percentile municipal (db), aussi servi par /api/estimate (manuel)
- Accueil : pouls du marché (indice par type + variations), dernières ventes
  réelles captées (lien vers l'estimation), bande « comment ça marche »,
  compteur ventes/30 j — page en ISR 1 h
- DB : index idx_tx_date sur transactions(date)
- MetricViz : RangeBar, MarketIndexChart, PercentileBar, IndexSpark

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

- Dashboard v2 (agrégats réels du rôle + corpus de ventes, stats-v2.json via
  scripts/build-stats-v2.mjs) : 10 KPI (deltas honnêtes millésime/12 mois +
  sparklines), 4 jauges de couverture, 5 séries (millésimes, ventes/mois,
  volume, prix médian), 2 multi-courbes (indice marché, $/m² par type),
  ventes empilées par type, 3 répartitions, 2 distributions, géo, calendrier
  des ventes, 6 tableaux, 10 records.
- /api/stats/report : 5 modes (complet, synthese, tendances, repartitions,
  donnees ; inconnu → complet), filename(mode), moteur pdfkit v2 100 %
  vectoriel (sommaire paginé, courbes/aires/barres, multi-courbes à motifs,
  empilées, anneau, jauges, heatmap, tableaux zébrés paginés, records).
- /stats : hero conservé + StatsDashboard (kit kacharts v2, ordre SPEC §1),
  PdfButton menu 5 rapports, fraîcheur + rafraîchir.

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

- layout.tsx : export viewport (device-width, initial-scale 1, viewport-fit=cover) pour les encoches iOS ; extension tactile ::after -8px sur le logo Vrai-Prix du header (cible >= 44 px)
- CookieConsent.tsx : padding bas du bandeau avec env(safe-area-inset-bottom) ; verrou du scroll d arriere-plan quand le panneau de preferences est ouvert (useEffect + cleanup) + fermeture a Escape
- src/ka/tokens.css : nouvelle section SOCLE MOBILE OBLIGATOIRE (z-index unifies, --vh100 dvh, .ka-bottombar, verrou ka-scroll-lock, filet anti-zoom iOS 16 px, extension tactile gk-badge)
- public/ka-agent.js : agent corrige (safe-area bulle/panneau, textarea 16 px, plein ecran auto <= 640 px + verrou scroll kaa-lock)

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

- Nouveau GET /api/stats/dashboard : KPI, série des millésimes 2021-2026,
  répartition par type, top municipalités, top 20 en table, records —
  period accepté mais non applicable (instantané du rôle 2026), cache mémoire.
- report-stats.ts porté au gabarit Groupe-KA (A4) : couverture kicker
  GROUPE KA · RAPPORT STATISTIQUE + wordmark boîte encre/accent #ff5148 +
  bande « par Groupe KA — groupe-ka.com », sommaire, en-tête/pied normalisés,
  page de fin (3 courriels + rôles, avertissement d agrégateur d ecosystem.json).
  Contenu riche conservé (chiffre-choc, millésimes, types, palmarès 200) +
  records ; mode synthese = couverture + sommaire exécutif.
- GET /api/stats/report?mode=complet|synthese (alias /api/report/stats),
  fichier groupe-ka_vrai-prix_stats_instantane_<date>.pdf.
- /stats : barre en tête (mention de fraîcheur + Télécharger le rapport PDF +
  Synthèse) ; correction du débordement 360 px des stat-chips du bloc encre.
- Kit commun src/ka/stats (SPEC.md, kapdf.py, kacharts.tsx) versionné.

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

- ka-assets/ → public/ : image de partage og.png (1200×630), favicon.svg,
  apple-touch-icon.png ; retrait du favicon.ico par défaut de Next.
- layout.tsx : icons + og:image/twitter:image (summary_large_image).
- page.tsx : titre d'accueil suffixé « · Un service Groupe KA ».
- HeaderNav : la nav pilule n'entre pas à 768 px (~852 px requis) —
  bascule desktop/mobile déplacée de md: à lg: (cause racine du
  débordement horizontal de +84 px en tablette).

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

- ka-ui vendoré (src/ka/) : tokens.css importé dans layer(base) via globals.css
  (bat le preflight Tailwind, reste sous les utilitaires et le design local),
  bloc compat pour les titres, accent rouge canonique (--accent/--accent-soft/
  --accent-deep/--on-accent) avec alias historiques --lime/--lime-soft
- Header : badge « Un service Groupe KA » à côté du logo (desktop xl+) et dans
  le pied du menu mobile, cliquable vers groupe-ka.com
- Footer : KaFooter commun (bloc encre, contacts et sites centralisés
  d ecosystem.json) précédé de la rangée locale FooterNav restylée papier
- Nouvelle page /contact : courriels centralisés, avertissement d agrégateur,
  lien hub + création de compte KA ID, liste des sites de l écosystème
- SEO : titre par défaut « Vrai-Prix — Un service Groupe KA » (layout + OG/X)

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

- Fondations : metadataBase, gabarit de titres, og/twitter, canonical par
  page, JSON-LD Organization+WebSite (layout), title/description uniques
  sur toutes les pages statiques (pages clientes scindées en wrapper
  serveur + *Client.tsx).
- /estimation/[id] : generateMetadata (adresse, estimation, fourchette),
  JSON-LD SingleFamilyResidence/Residence/Place + BreadcrumbList,
  estimation dédupliquée via React cache().
- Pages programmatiques : /municipalites (index A-Z), /municipalite/[slug]
  (~1 097) et /municipalite/[slug]/[type] (~5 900) — stats agrégées
  (médiane, totaux, croissance 2021-2026), liens HTML vers les fiches,
  municipalités voisines (lib/municipalites.ts, cache mémoire).
- Sitemaps : /sitemap-index.xml (à soumettre dans GSC) → /sitemap.xml
  (7 043 pages) + /estimation/sitemap/0-83.xml (45 000 fiches chacun,
  plages de rowid). robots.ts (disallow /api/, /compte).
- noindex : /compte, /estimation/manuelle (espace d'URL paramétrique).
- Accueil : section « Explorer par municipalité » (maillage indexable).

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

Routes /api/auth/ka/{login,callback} + /api/auth/{me,logout}, session
cookie signée (ka-auth.ts, node:crypto pur), profil hub (hub-profile.ts,
cache 60 s), page /compte carte de membre, AccountButton au header.
(Déployé le 2026-08-13 ; l'intégration au layout arrive avec le commit SEO.)

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

Remplace la carte Leaflet/OSM par le framework partagé @groupe-ka/ka-maps
(moteur Mapbox GL, style Standard 3D par défaut + bouton 2D) : pastilles
de VALEURS ESTIMÉES 2026 (encre, liseré rouge — jamais présentées comme
un prix demandé), grappes avec compte + valeur moyenne clampée,
chargement piloté par le viewport (débounce, annulation, cache, mode
auto), aperçu React bilingue FR/EN, « Me localiser » sur action
explicite, badge Vrai-Prix Maps · Groupe Ka.
/api/nearby : plafonds relevés (halfLat 0,08 / halfLng 0,12 / limit 1500)
— changement additif, contrat iOS 1.1.0 inchangé (défauts identiques).
Consommé via tarball npm (file:../../ka-maps/*.tgz) — Turbopack ne résout
pas les liens symboliques hors racine. leaflet/@types/leaflet retirés.

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

- GET /api/nearby : unités dans une boîte englobante (idx_units_geo),
  tri par distance au centre (sinon l'index renvoie une bande sud),
  plafonds serveur ~2,2 km / 400 unités
- Page /carte : fond OpenStreetMap, points encre/accent, popup éditoriale
  (adresse, type, estimation 2026 → /estimation/[id]), géolocalisation
  « Me localiser », garde de zoom, bilingue FR/EN, entrée nav « Carte »
- Sert aussi l'app iOS native (onglet Carte MapKit, repo vrai-prix-ios)

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

Le modèle inventait des URLs de rapport quand les résultats d'outils
n'étaient plus en contexte. Triple verrou :
- chaque évaluation émet une réf persistante (id + URLs exactes des PDF)
  que le client conserve dans l'historique, masquée à l'affichage ;
- garde serveur : demande de PDF sans réf en contexte → note injectée
  forçant chercher + liens_rapports avant tout lien ;
- endpoints /api/report tolérants (id décoré nettoyé, format=pro* redirigé
  vers le rapport professionnel) ; liens intégrés au dossier/évaluation ;
  resolveId sur tous les outils à identifiant.

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

- Recherche à relaxation progressive : si l'adresse exacte est introuvable,
  Ka présente les correspondances les plus proches (même voie/secteur) au
  lieu de répondre introuvable.
- Nouvel outil dossier_complet : évaluation + marché local + tendance +
  comparables + synthèse chiffrée en un seul appel — réponses d'expert.
- Chat : vrais tableaux HTML pour le markdown, fil avec défilement interne
  (plus aucun saut de page pendant le streaming), gabarit mobile refait
  (hauteur dvh, composer toujours visible, chips adaptées).
- Boucle renforcée : 12 tours, 2200 tokens, appels d'outils parallèles.

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

Page /ka + route /api/ka : boucle agentique en streaming SSE branchée
sur la base SQLite et le moteur d'estimation (recherche FTS, évaluation,
comparables, indice de marché, stats municipales/provinciales, parc,
comparaison, recherche par secteur, rapports). Prompt caching sur
system+outils, clé API via variable d'environnement (jamais versionnée).

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

Estimation hybride (modèle hédonique LightGBM + comparables ajustés),
3,75 M de propriétés, fourchette P10-P90, indice de confiance A-D,
rapports PDF vectoriels, parc immobilier, statistiques provinciales.
Identité éditoriale sharp — accent rouge #ff5148.

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