spb/resto-ka

1# MAPAQ — Inspections alimentaires (condamnations) — connecteur `mapaq`23_Fiche générée automatiquement par `scripts/gen_connector_docs.py` le 2026-08-18 06:06 — ne pas éditer à la main, régénérer._45**État : actif** · Palier (tier) : 5 · Backend : direct67## Description de la source89Connecteur MAPAQ — « Condamnations des établissements alimentaires » (Données Québec, jeu 515374ee…, CSV listecondamnation.csv, licence CC-BY 4.0). Inspections alimentaires condamnées : établissement, adresse, dates, amende, motif (INSALUBRITE…). Alimente la table LIÉE `inspections` + croisement CONSERVATEUR avec les restaurants (jamais de fusion hasardeuse : nom normalisé + ville/code postal, ou code postal + civique + similarité de nom). Ce n'est PAS une source de fiches restaurant : c'est un enrichissement conformité/qualité appelé par ingest.enrich() (cadence hebdomadaire, guard via sync_log source='mapaq').1011- **Plateforme** : donnees-quebec · **Site** : https://www.donneesquebec.ca/recherche/dataset/condamnations-des-etablissements-alimentaires-et-condamnations-concernant-le-bien-etre-des-anim12- **Extraction (registre)** : CSV ouvert listecondamnation.csv (Données Québec) -> table liée `inspections` + croisement CONSERVATEUR avec les restaurants (nom normalisé + ville/code postal, ou code postal + civique + similarité de nom). Résumé conformité dans details.mapaq, endpoint GET /api/restaurants/{uid}/inspections.13- **Contexte de prix** : aucun14- **Module** : `restoka/inspections.py` — `(module fonctionnel, pas de classe)`1516## Accès1718- **Type d'accès** : jeu de données ouvert (CSV, Données Québec)19- **Endpoint de base** : https://www.donneesquebec.ca/recherche/dataset/515374ee-ce34-464f-9875-7d1af3fa9b2a/resource/40105615-3abf-414b-bcba-182e8f2c5eb2/download/listecondamnation.csv20- **URLs du module** : https://www.donneesquebec.ca/recherche/dataset/21- **Pagination** : réponse unique (pas de pagination)22- **Backend anti-bot / rendu** : requests direct (session UA RestoKaBot, throttling poli)23- **Authentification** : aucune — accès public/anonyme2425## Champs récupérés → schéma cible2627Source d'**enrichissement** : alimente la table `inspections` (exploitant, établissement, adresse, dates, amende, motif) puis croisement conservateur avec `restaurants.uid` (nom normalisé + ville/code postal, ou code postal + civique + similarité de nom — colonne `matched_by`). Pas de fiches restaurant propres.2829## Fréquence & budget3031- **Cadence déclarée (registre)** : hebdomadaire (guard 6 jours dans ingest.enrich)32- **Cadence observée** (médiane sync_log) : —33- **Dernier passage OK** : 2026-08-18 02:53 — 2994 trouvées, +2994 / ~0 / -03435## Volumétrie & complétude3637- **Inspections MAPAQ** : 2994 condamnations (288 croisées avec un resto, amendes cumulées 5 023 013 $), infractions de 2017-03-14 à 2026-06-0938- **Runs journalisés (60 derniers)** : 1, dont 0 en erreur3940## Erreurs connues & dépannage4142Aucune erreur dans les 60 derniers runs journalisés.4344Rejouer la source seule : `python3 run.py sync mapaq` · vérifier `sync_log` (`SELECT * FROM sync_log WHERE source='mapaq' ORDER BY ts DESC LIMIT 5;`).4546## Licence, attribution & conditions4748- **Cadre d'accès (registre, `acces_legal`)** : Données ouvertes du gouvernement du Québec, licence CC-BY 4.0 — attribution MAPAQ/Données Québec affichée avec les inspections.49- **Licence** : donnée ouverte CC-BY 4.0 (Données Québec) — mention de la source « MAPAQ / Données Québec » affichée.50- Retrait sur demande : contact@spboucher.ai.5152## Historique5354- 2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par `scripts/gen_connector_docs.py`).55