spb/resto-ka

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>

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

L ancienne tabbar 3 onglets bord-à-bord devient la pilule flottante du
standard ka-ui/nav : Découvrir · Recherche · Villes · Favoris, accent orange,
safe-area iOS. Recherche = focus du champ de l accueil (id f-q) ; le fab
Filtres remonte au-dessus de la pilule. Stats/Sources restent au menu.

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

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

- mtl-alim : découverte massive Montréal (CSV open data, ~7 500 fiches food-service)
- tastet : découverte éditoriale (1 516 critiques, coordonnées + lien source)
- chownow/gloriafood/square : Palier 1 takeout (prix réels), dormants jusqu'à
  découverte de leurs intégrations par site-resto (*-discovered.json avec uid porteur)
- doordash/skip : Palier 2 delivery, enrichissement conservateur (jamais de fiche,
  croisement téléphone/postal+civique/GPS+nom, menus étiquetés delivery)
- siteresto : détection des widgets GloriaFood/ChowNow/Square/Clover sur les sites
- dedup : priorités mtl-alim/tastet ; registre sources.json complété (17 sources)
- 7 fichiers de tests (110 tests verts), smoke-runs live validés

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

Le ✕ était le burger du header ; si le header n'est pas épinglé (bas de page),
il défilait hors écran alors que le panneau fixed restait affiché — impossible
de fermer sans Escape. Ajout d'un .mm-close position:fixed en haut à droite du
panneau et burger masqué à l'ouverture (une seule commande de fermeture).

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

Standard KA 2026-08-25 : .mobile-menu passe de position:absolute top:100%
(max-height 480px) à position:fixed inset:0 — menu visible peu importe la
position de scroll. Rang du header (marque + burger→✕) maintenu au-dessus du
panneau, verrou de scroll CSS pur via html:has(.mobile-menu.open).

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>

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

Le connecteur menus maison n emettait aucune image (231/231 fiches sans
photo). Nouveau _extract_images (page d accueil) : og:image/twitter:image
puis <img> (src/srcset/lazy-load, avif inclus), filtres logos/icones/
placeholders/miniatures (-LxH < 300 px, width < 200), dedup des variantes
de taille (WordPress -LxH, Webflow -p-NNN), max 6 photos.

- fiche site-resto emise avec photos + cache detail (reemission comprise)
- fiche OSM d origine enrichie si elle n a pas d images (COALESCE), y
  compris quand le crawl ne trouve ni menu ni contact
- scripts/backfill_images.py : rattrapage ponctuel des fiches deja captees
  (execute 2026-08-23 : 207/231 fiches enrichies, + jumelles OSM)

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

Enrichissement (aucune fiche, aucun prix) : retrouve le site web officiel
des ~10 600 restos OSM sans site connu via leur fiche Google Maps (API
Serper, ll centré sur les coordonnées OSM). Croisement conservateur nom +
GPS <= 400 m, ambigu ignoré ; domaines sociaux/agrégateurs/livraison
rejetés, réservation -> details.reservation_url. Remplit website (+ phone
si vide) et débloque le pipeline site-resto (menus maison dine-in).
Tests hors ligne sur payloads réels (7 passent) ; .env.example
(SERPER_API_KEY, SITE_FINDER_BUDGET) et data/sources.json documentés.

Travail réalisé par une mission agent KA, commité a posteriori.

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

- restoka/seo.py : slugify + index villes groupé par slug (variantes de casse
  fusionnées, libellé majoritaire), SSR /villes et /ville/{slug} avec ItemList
  + BreadcrumbList, API /api/seo/villes et /api/seo/ville/{slug},
  sitemap-villes.xml, maillage interne accueil/fiche vers les pages villes
- frontend : pages React VillesPage/VillePage, routes, lien pied de page

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

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

Incident du 2026-08-22 : les 4 miroirs sont tombés en même temps (kumi 500,
overpass-api.de injoignable, private.coffee 502, osm.jp certificat TLS
invalide) et le run hebdo a fini à 0 POI (retraits suspendus par le garde-fou).

- osm.jp retiré (hostname mismatch permanent), maps.mail.ru ajouté (instance
  planète complète, seul miroir opérationnel pendant l incident)
- 3 rondes de réessai sur l ensemble des miroirs (attente 0/90/300 s) avant
  d abandonner un type d établissement

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

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

Co-Authored-By: Claude Fable 5 <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

Auto-escalade de BaseConnector.get() sur blocage (403/429/503/challenge CF)
ou coupure reseau, via connectors/_resilient.py. Cles lues de l env avec repli
sur ~/.claude/.env (accepte SCRAPFLY_KEY et SCRAPFLY_API_KEY). Reponse
compatible requests.Response; coupe-circuit par hote. Aucun connecteur modifie.

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

Le panneau resto (nom, prix, adresse) était après le menu dans le DOM et
remonté sur mobile via .panel{order:-1} — contraire au standard Groupe Ka
« Ordre des sections — pages détail » (ordre DOM = ordre visuel).

- Resto.tsx : <aside .panel> déplacé en premier enfant de .detail-grid,
  le bloc menu devient .detail-main
- styles.css : order:-1 supprimé ; sur desktop le panneau est placé en
  colonne 2 via grid-column (aucun réordonnancement entre breakpoints)
- Validé Playwright 390px (panneau premier, scrollY=0) + 1440px (panneau
  colonne droite)

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

- frontend/src/App.tsx : backdrop + menu compte rendus à la racine de <body>
  via createPortal (le backdrop-filter du header re-parentait le
  position:fixed → voile de 66 px, et le stacking context z-50 du header
  plaquait le menu SOUS la tabbar z-85 et le fab z-80) ; fermeture à Escape.
- frontend/src/styles.css : .account-backdrop → var(--z-overlay) (800),
  .account-menu → position:fixed ancré sous le header (--header-h 66/58 px) à
  var(--z-modal) (900) ; zone tactile ≥44 px du logo .brand (::after inset
  -8px, rendu inchangé) ; les 7 selects de filtres étaient déjà couverts par
  la règle 16 px ≤900 px + filet anti-zoom global de tokens.css.
- frontend/src/pages/Home.tsx : feuille de filtres mobile (sheetOpen) — gel du
  scroll d arrière-plan (pattern App.tsx) + fermeture à Escape.
- frontend/src/ka/tokens.css (commité avec Stats v2) : socle mobile commun.

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

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