# Tourisme Gaspésie — événements (ATR) (`gaspesie`)

> Fiche générée le 2026-08-25 19:01 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.

**Statut : actif** · Type : `tourisme-regional` · Connecteur : `sortika/connectors/gaspesie.py`

## Description

- **Source** : [Tourisme Gaspésie — événements (ATR)](https://www.tourisme-gaspesie.com/fr/festival-et-evenements/)
- **Couverture** : Gaspésie–Îles-de-la-Madeleine
- **Extraction** : Scrapfly (asp, country=ca, sans render_js) : liste (1 crédit) + fiches incrémentales (GASP_FICHE_MAX/sync, re-visite 14 j, cache v2) — titre h1, plage FR, og:description/og:image + JSON-LD Organization → GPS exact, adresse/ville/CP structurés, site web officiel
- **Note** : RÉACTIVÉE 2026-08-21 (Phase 4) : la vague Scrapfly consignée annoncée en Phase 3. Ancienne URL /evenements-gaspesie.html morte (404) → /fr/festival-et-evenements/ (28 fiches, ~6 datées à l'amorce).

## Accès

- **Type** : tourisme-regional
- **Endpoint** (`BASE`) : `https://www.tourisme-gaspesie.com`
- **Auth** : Aucune côté source ; `SCRAPFLY_API_KEY` requis pour le backend Scrapfly
- **Pagination** : aucune (flux unique)
- **Backend** : Scrapfly (anti-bot / rendu JS) via `base.get_scrapfly()`
- **Throttle** : 1.5 s entre requêtes
- **Accès légal** : Contenu public de l'ATR ; WAF contourné avec modération (budget ≤ 9 crédits Scrapfly/sync, consigné Phase 4), attribution + lien vers la fiche officielle

<details><summary>En-tête documentaire du connecteur</summary>

> connectors/gaspesie.py : Tourisme Gaspésie — festivals et événements (ATR,
> Phase 4). Région parmi les plus faibles au baseline (Phase 3 : candidate
> prioritaire consignée pour une vague Scrapfly) — la voici.
> Source    : https://www.tourisme-gaspesie.com/fr/festival-et-evenements/
> (CMS Umbraco). Le site est derrière un WAF : 403 sur GET
> identifié (revérifié 2026-08-21) → extraction via SCRAPFLY
> (asp, country=ca, sans render_js — le HTML est rendu serveur),
> usage consigné et budgeté (GASP_FICHE_MAX/sync). La liste
> publie les 27 fiches d'un coup (pagination purement côté
> client, 12/page — revérifié 2026-08-25) : rien de caché.
> Extraction: liste (1 crédit) → fiches détail incrémentales (cache
> data/gaspesie_cache.json, GASP_FICHE_MAX/sync, re-visite 14 j
> — festivals annuels stables, version v=2) : titre <h1>, plage
> de dates FR (« 18 au 21 juin 2026 »), og:description, og:image.
> ENRICHI (2026-08-25) : JSON-LD Organization de la fiche → GPS
> exact (GeoCoordinates), adresse civique/ville/code postal
> structurés, site web officiel (sameAs non-réseau-social).
> Pas d'heure ni de tarif structurés → jamais inventés.
> Accès     : contenu public de l'ATR ; anti-bot contourné avec modération
> (≤ 1 + GASP_FICHE_MAX crédits Scrapfly/sync, re-visite 14 j),
> attribution et lien vers la fiche officielle conservés.

</details>

## Champs récupérés → schéma

Complétude mesurée sur les **7 événements actifs** de la source ; exemples tirés d'un événement réel (`gaspesie:noel-en-gaspesie`).

| Champ (`events.*`) | Description | Complétude | Exemple réel |
|---|---|---|---|
| `title` — Titre | titre de l'événement | 100 % | Noël en Gaspésie |
| `description` — Description | texte descriptif (source ou fiche détail) | 100 % | Événement proposant un temps des fêtes inoubliable dans les décors magnifiques de la Baie-des-Ch… |
| `url` — URL | lien vers la fiche originale / billetterie | 100 % | https://www.tourisme-gaspesie.com/fr/festival-et-evenements/noel-en-gaspesie/ |
| `categories` — Catégories | taxonomie canonique Sorti-Ka (JSON) | 100 % | ["autre"] |
| `venue` — Salle (venue) | nom du lieu | 0 % | ∅ |
| `address` — Adresse | adresse civique | 100 % | 99, place Suzanne-Guité |
| `city` — Ville | municipalité | 100 % | New Richmond |
| `region` — Région | région administrative | 100 % | Gaspésie–Îles-de-la-Madeleine |
| `lat` — GPS (lat/lng) | coordonnées géographiques | 86 % | 48.1618644, -65.8618622 |
| `start_date` — Date début | date locale AAAA-MM-JJ | 100 % | 2026-11-21 |
| `end_date` — Date fin | date locale AAAA-MM-JJ | 100 % | 2026-12-31 |
| `start_time` — Heure (start_time) | heure locale HH:MM (Québec) | 0 % | ∅ |
| `end_time` — Heure de fin (end_time) | heure locale HH:MM (Québec) | 0 % | ∅ |
| `status` — Statut | cancelled / postponed / soldout (NULL = prévu) | 0 % | ∅ |
| `is_free` — Gratuité (is_free) | 1 gratuit / 0 payant / NULL inconnu | 0 % | ∅ |
| `price_min` — Prix min | tarif minimal réel ($) | 0 % | ∅ |
| `price_label` — Libellé prix | étiquette tarifaire affichable | 0 % | ∅ |
| `artists` — Artistes | têtes d'affiche / lineup (JSON) | 0 % | [] |
| `organizer` — Organisateur | promoteur / organisme | 0 % | ∅ |
| `image` — Image | visuel (og:image ou média source) | 100 % | https://www.tourisme-gaspesie.com/media/goglqxb2/noel-en-gaspesie-evenement-1-_mainpicture.jpg?w… |
| `website` — Site web | site officiel de l'événement | 0 % | ∅ |

## Fréquence & budgets

- **Cadence** : horaire (watcher PM2) — cache 14 j, ~2 fiches re-visitées/j
- **Budgets / plafonds (variables d'environnement)** :

| Variable | Défaut | Rôle |
|---|---|---|
| `GASP_FICHE_MAX` | `8` | — |
- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).

## Volumétrie & complétude live

*(mesuré le 2026-08-25 19:01 EDT dans `data/sortika.db`)*

- **Événements en base** : 26 (dont **7 actifs**)
- **GPS** : 6/7 actifs (86 %)
- **Prix** : 0/7 actifs (0 %)
- **Heure (start_time)** : 0/7 actifs (0 %)
- **Heure de fin** : 0/7 actifs (0 %)
- **Statut (annulé/reporté/complet)** : 0/7 actifs (0 %)
- **Artistes** : 0/7 actifs (0 %)
- **Image** : 7/7 actifs (100 %)
- **Salle (venue)** : 0/7 actifs (0 %)
- **Dernier sync** : 2026-08-25 18:01 — fetched 25, +0 ajoutés, ~0 mis à jour, -0 retirés
- **Syncs enregistrés** (sync_log) : 81

## Erreurs & dépannage

Aucune erreur dans `sync_log` pour cette source. ✅

- Rejouer un sync isolé : `python3 run.py sync --source gaspesie` (ou via le watcher PM2) ; inspecter ensuite `sync_log` : `sqlite3 data/sortika.db "SELECT * FROM sync_log WHERE source='gaspesie' ORDER BY ts DESC LIMIT 5;"`

## Licence / attribution

- Contenu public de l'ATR ; WAF contourné avec modération (budget ≤ 9 crédits Scrapfly/sync, consigné Phase 4), attribution + lien vers la fiche officielle

## Historique

- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).
- **2026-08-19 — Phase 2 (travail de moine)** : colonnes additives `end_time`, `status` (annulé/reporté/complet) et `quarantine` (règles anti-aberrations, non publié mais réintégrable) ; règle d'ARCHIVAGE des événements terminés à chaque cycle (jamais supprimés) ; dedup_key inclut désormais l'heure (les séances multiples d'un même jour ne sont plus écrasées à l'affichage) ; alerte « 0 événement futur / chute > 80 % » par source (data/future_counts.json + /api/sources) ; heure et description La Vitrine ; end_time/organisateur/statut Eventbrite ; og:description Atuvu ; premières parties + portes + tournée evenko ; offres billets Bandsintown ; taxonomie type-event + description intégrale Brossard ; image Longueuil ; géocodage par ADRESSE CIVIQUE prioritaire ; villes normalisées au Répertoire MAMH (data/villes_canon.json) ; laval consignée « morte-a-la-source ».

Commits touchant `sortika/connectors/gaspesie.py` :

- `5973906` 2026-08-21 Phase 4 — 7 nouveaux connecteurs : régions manquantes (Montérégie, Centre-du-Québec, Chaudière-Appalaches, Gaspésie via Scrapfly) + billetteries QC (TicketAcces, Réseau Ovation, Tuxedo via acteur Apify ka-tuxedo)