spb/vrai-prix

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

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

La règle hors @layer « body > * { position: relative } » (peinture au-dessus
du grain) écrasait l'utilitaire Tailwind sticky du header — les styles
non-layered gagnent sur @layer utilities. Exception explicite
« body > header { position: sticky; top: 0 } » : le menu du haut reste
visible en scrollant, mobile comme desktop.

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

Pilule flottante fixe en bas (standard ka-ui/nav, variante Next.js) :
Estimer · Marché · Ventes · Méthode, accent rouge signature, bilingue fr/en,
safe-area iOS. Estimer mène immédiatement à la recherche d adresse (focus du
champ héros, id vp-adresse) ; Ventes ancre le flux des dernières ventes
réelles de l accueil (id ventes).

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

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

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

municipalityCenter/municipalityPercentile faisaient un SCAN des 3,7 M
d'unités à chaque page d'estimation (COLLATE NOCASE ≠ idx_units_mun
BINARY) ; recentSales scannait 750 k transactions avec tri temporaire.
Sous trafic crawlers, better-sqlite3 (synchrone) gelait l'event loop :
next-server à 100 % CPU pendant 10 h, port 8090 muet, site down.

Index créés sur la base live + bootstrap CREATE INDEX IF NOT EXISTS
dans getDb() pour survivre à une reconstruction de la base.
Requêtes vérifiées : covering index, pages < 0,32 s sous 20 req
parallèles (avant : plusieurs secondes chacune, empilement infini).

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

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

- report-stats.ts : catalogFromDashboard() + buildCustomReport(spec)
  (dispatch par bloc, conversions tableau, sommaire, gabarit Groupe-KA)
- routes /api/stats/catalog (GET) + /api/stats/report/custom (POST)
- kacharts.tsx v3 : ReportBuilder intégré à PdfButton (modal, ordre,
  rendus, modèles localStorage) — SPEC.md §3bis

Bloc KA_ANALYTICS ajouté en fin de ka-agent.js par le déploiement du
tableau de bord admin-ka : identifiant visiteur anonyme (localStorage
KA_VID) + battement par minute vers administration-ka.com/collect
(site, vid, chemin). Commité a posteriori — état déployé en prod.

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

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

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

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>

scripts/hedonic-retrain.py (sklearn HGB ≈ LightGBM, log-prix, encodages
locaux par voisinage, pondération de récence) — bench équitable sur les
ventes jamais vues par le build laptop (> 2026-07-27, n=4849) :

- unifamilial : laptop meilleur (10,3 % vs 13 % MdAPE) → conservé ;
- terrain 62→36 %, autre 79→52 % → challenger appliqué sur ces 926k unités ;
- P10/P90 laptop recalibrés (couverture 18,5/16,8 % → 10,1/9,8 %) ;
- clamp p10 ≤ est ≤ p90 (38 826 violations du build laptop → 0).

Sauvegarde intégrale dans units_est_prev (rollback documenté §10).

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

Ajoute les ventes récentes directement dans data/vraiprix.db sur le nœud,
sans reconstruire la base (le pipeline batch reste sur le laptop).

- scripts/qub-token.mjs : Bearer QUB via login Scrapfly (connect.qub.ca,
  Akamai + reCAPTCHA v3, réessais sur sessions neuves) puis /api/checklogin.
- scripts/ingest-jdm.mjs : balayage des 1478 secteurs /v1/locations/all →
  /v1/map (quadtree si plafond), mapping vers schéma transactions, spatial-
  join units (id_provinc/valeur_role), INSERT OR IGNORE (dédup par id).
- Planifié quotidiennement via pm2 (vrai-prix-ingest, cron 08:00).
- Gap 2026-07-27 → 2026-08-12 comblé province-wide (+4189 ventes, match 100%).
- Doc : PIPELINE-DONNEES.md section 9.

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

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

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>

Documente le pipeline qui produit data/vraiprix.db (il tourne sur le laptop,
pas sur le nœud) : sources amont (rôles MAMH 2021-2026 FGDB/GPKG Données
Québec licence ouverte ; transactions api.qub.ca scrapées en quadtree avec
token Bearer manuel), étapes (extract_roles → merge_transactions kNN 2 passes
99,88 % → hedonic LightGBM 4 modèles → build_vrai_prix_db → build_stats),
livraison scp 1,5 Go vers M3U96a, volumétrie vérifiée live (3 747 008 unités,
745 119 transactions, market_index 268), complétude (GPS 100 %, frontage
83 %, année 79 %), risques (token manuel, non-reproductible sur nœud, rôle
2027) et procédure de rafraîchissement pas à pas.

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

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

Ajout des balises window.KA_AGENT={site:"vrai-prix"} et /ka-agent.js
en fin de <body> du layout racine. Coexiste avec l agent Ka de /ka.

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

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>

GET /api/stats expose en JSON les agrégats de src/data/stats.json (unités,
valeur totale et médiane 2026, croissance, logements, municipalités,
transactions, version du modèle, date de génération). Import statique du
JSON, aucune base de données ; Cache-Control public max-age=600 + CORS
ouvert en lecture. Consommé par groupe-ka.com pour ses métriques live.

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