spb/resto-ka

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

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

- restoka/hubfav.py : client HMAC du hub (calqué sur foodka/hubfav.py) —
  toggle synchrone, lecture avec cache mémoire 30 s invalidé au toggle
- web.py : GET /api/favorites (liste du hub + fiches locales) et
  POST /api/favorites/toggle, protégés par la session KA ID (401 sinon)
- auth.py : retrait des anciennes routes locales /api/favoris (plus aucun
  stockage local des favoris)
- frontend : favorites.tsx (FavProvider/FavButton), cœur ♥ sur les cartes
  ET la fiche détail (non connecté : clic → connexion KA ID), page /favoris
  branchée au hub, entrée Favoris dans la nav, icône IcoHeart, .fav-btn.big

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

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

- restoka/seo.py (nouveau, calqué louka/seo.py) : head unique par route
  (title, description, canonical, hreflang fr-ca, og:* locale fr_CA,
  twitter, JSON-LD) + contenu essentiel serveur dans #root
- accueil : title/h1 avec compte de restos, régions, menus récents,
  WebSite + Organization
- fiche /resto/{uid} : JSON-LD Restaurant (PostalAddress QC/CA, geo,
  servesCuisine, telephone, priceRange, image) + BreadcrumbList,
  og:image = photo du resto, 404/410, canonical vers le uid maître
  pour les doublons inter-sources
- robots.txt (Disallow /api/, /favoris, /docs) + sitemap index,
  sitemap-pages et sitemap-restos-{n} chunkés à 10 000 (lastmod)
- pages statiques /stats /sources /contact : title/description uniques
- web.py : include_router(seo.router) avant le fallback SPA
- frontend/index.html : lang fr-CA

- kit vendorisé mis au niveau canonique v2 (kacharts.tsx, kapdf.py, SPEC.md)
- backend stats.py : 10 KPI (deltas + sparklines), 6 jauges de complétude,
  4 séries quotidiennes, multi-courbes prix moyen par ville, ajouts par
  source empilés, 4 répartitions, 3 distributions (prix de plats, capacités
  RACJ, notes Yelp), heatmap horaire des relevés, 6 tableaux, 12 records
- /api/stats/report : 5 modes (complet|synthese|tendances|repartitions|
  donnees), inconnu -> complet, filename(mode)
- page /stats : jauges, StatSummary, MultiLine/Stacked/Histogram/HourHeatmap,
  PdfButton v2 (menu 5 rapports)

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

- yelp-scrape : notes/avis Yelp SANS clé (1 page de recherche yelp.ca/resto
  via Scrapfly ASP, cache Apollo embarqué) -> details.yelp, croisement
  conservateur nom+civique+ville, budget 80 pages/cycle, re-visite 30 j,
  indépendants d abord. Yelp Fusion (yelp) reprend la main si clé fournie.
- ubereats : menus livraison + notes via sitemaps publics (index local
  37 087 slugs CA, 30 j) + __REACT_QUERY_STATE__ des pages resto ; croisement
  conservateur (téléphone / postal+civique / GPS<120 m + nom) avec restos
  EXISTANTS seulement, menus en price_context delivery, budget 60 pages/cycle.
- permits (racj) : permis d alcool en vigueur (Données Québec, CC-BY 4.0),
  regroupés par établissement et croisés comme MAPAQ -> details.permis_alcool
  (1 924 restos croisés au premier run).
- /api/stats : with_yelp_rating, with_ubereats, with_alcohol_permit ;
  ingest.enrich appelle permits.sync (guard 6 j) ; registre sources.json (9)
  + docs générées ; 73 tests verts (9 nouveaux, tout hors ligne).

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

- MAPAQ (Données Québec, CC-BY 4.0) : module restoka/inspections.py — import
  des 2 994 condamnations (listecondamnation.csv) dans la table liée
  inspections, croisement CONSERVATEUR avec les restaurants (nom+lieu avec
  CP ou civique exigé ; adresse+nom hors tokens de ville — jamais la mauvaise
  succursale d une chaîne, jamais deux voisins d un centre commercial) :
  288 condamnations croisées sur 204 restos. details.mapaq + endpoint
  GET /api/restaurants/{uid}/inspections + compteurs /api/stats.
- Horaires : restoka/hours.py — parseur opening_hours OSM (plages de jours,
  double service, off, 24/7, PH ignoré ; l exotique reste en brut) + JSON-LD
  schema.org. Câblé dans le connecteur OSM et backfillé : 2 656/2 939 tags
  bruts structurés par jour (90,4 %).
- site-resto : extraction téléphone (tel:/JSON-LD/regex, E.164, garde
  anti-annuaire de chaîne), horaires JSON-LD et lien de réservation
  (OpenTable, Libro, Resto Loco…) -> COALESCE conservateur sur la fiche OSM
  (db.enrich_contact) + details.reservation_url (pending_enrichment).
- Yelp Fusion : connecteur d enrichissement complet (rating, review_count,
  price, categories, phone -> details.yelp ; croisement par téléphone puis
  /businesses/matches, GPS <300 m si ambigu, budget 450 req/run). Livré en
  SkipSource « clé requise » (YELP_API_KEY absente) — nouveau patron
  SkipSource dans base.py + .env.example.
- Overpass 406 : overpass-api.de refuse les UA déguisés en navigateur mais
  accepte un UA de bot honnête — UA dédié OVERPASS_UA (vérifié live, 200).
- Colonne restaurants.details (migration auto, jamais touchée par
  sync_source), registre data/sources.json à 6 sources, /api/stats expose
  inspections/inspections_matched/restaurants_with_inspections.
- Tests : 64 au vert (51 existants + 13 nouveaux : hours, inspections,
  extraction contact).

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

- /api/stats/dashboard (contrat commun ka-ui/stats/SPEC.md) : KPI avec
  deltas, séries quotidiennes (nouveaux restos, plats suivis en cumul),
  répartitions (cuisines, gammes de prix, types), géo par région,
  heatmap des nouveautés, tableaux (villes, chaînes, nouveaux, syncs),
  records — 100 % calculé de la DB réelle, cache mémoire 5 min.
- /api/stats/report : PDF estampillé Groupe-KA (kapdf/fpdf2), modes
  complet et synthèse, filename normalisé groupe-ka_resto-ka_stats_*.
- Page /stats réécrite sur le kit kacharts (KPI, sélecteur de période,
  courbes, anneau, barres, heatmap, DataTable, records, bouton PDF).
- kapdf : correctif — la couverture ne porte plus le pied de page
  standard (footer déclenché après la retombée de cover_mode).
- fpdf2 ajouté aux dépendances.

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

- Vendorisation du package ka-ui (frontend/src/ka/) : tokens.css, ecosystem.json,
  KaFooter.tsx, GroupeKaBadge.tsx
- tokens.css importé avant styles.css ; styles.css réduit à l accent SAFRAN
  (--accent #f08c00, soft #fdeed7, deep #b96a00, on-accent #141814) + alias --lime,
  socle dupliqué retiré, classes métier passées sur var(--accent)
- Header : badge « Un service Groupe KA » (desktop >= 900 px + menu mobile)
- Footer : KaFooter commun (contacts, avertissement, écosystème) + rangée de nav
  locale et crédit OpenStreetMap au-dessus
- Nouvelle page /contact (infos d ecosystem.json, lien hub, création de compte
  KA ID -> groupe-ka.com/connexion) + prefixe SPA « contact » dans web.py
- SEO : titre « Resto-Ka — Un service Groupe KA »

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

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

- Connecteur de découverte OpenStreetMap (Overpass, ODbL, attribution) :
  13 531 établissements nommés (restos, fast-foods, cafés, bars, crèmeries,
  boulangeries) → 14 055 fiches actives, 17/17 régions couvertes.
- +10 intégrations UEAT (Boustan 65, Ben & Florentine 54, NO.900 32,
  Sushi Taxi 30, Cochon Dingue, Salvatoré, Belle Province, Madisons, Freddy)
  → 29 intégrations, 738 restos avec menu complet, 79 159 plats avec prix.
- Déduplication chaîne↔découverte (suffixe de succursale retranché, OSM
  toujours derrière la fiche à menu) : 215 doublons masqués.
- Régions : repli par ancres géographiques couvrant les 17 régions.
- UI : filtre « Avec menu complet / Fiche seulement », tri « Menus d'abord »
  par défaut, tuile restos avec menu, attribution OSM au pied de page.
- 45 tests (fixtures Overpass + UEAT réelles hors ligne).

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

- Pipeline complet calqué sur Lou·Ka : connecteurs auto-découverts, schéma
  Restaurant + menu imbriqué (sections → items → prix → options), validation
  stricte (price_context/price_source obligatoires), menus conservés PAR
  contexte, historique des prix par item, alertes de dérive, délai de grâce.
- Connecteur templatisé UEAT (API GraphQL, prix takeout réels) : 19 marques,
  542 restos, 61 330 plats (98 % avec photo, 69 % avec options), 14/17 régions.
- Géocodage Nominatim + Adresses Québec (96 %), régions ville→région,
  déduplication inter-sources (succursales jamais fusionnées).
- Frontend Vite/React 18/TS — design « éditorial sharp » Groupe KA, recherche
  par resto ET par plat (groupée par marque), pagination numérotée, images,
  options en pastilles avec suppléments, badges de contexte de prix.
- 41 tests (fixtures UEAT réelles hors ligne). Déployé : www.resto-ka.com
  (M3U96b:8115, PM2 + ngrok + sync hebdo).

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