<!--
=============================================================================
Job·Ka — Groupe KA
Auteur  : Simon-Pierre Boucher
Contact : contact@spboucher.ai
Fichier : docs/connecteurs/richelieu.md
Rôle    : Fiche connecteur — Quincaillerie Richelieu (employeur direct, ATS adp)
Généré  : 2026-09-21 18:06 EDT par scripts/gen_connector_docs.py — NE PAS ÉDITER,
          relancer le script pour régénérer.
=============================================================================
-->

# Quincaillerie Richelieu (`richelieu`)

**Employeur direct** · Plateforme ATS : [`adp`](ats-adp.md) · Statut registre : actif · Connecteur : `jobka/connectors/richelieu.py`

## Description

- **Site** : [Quincaillerie Richelieu](https://www.richelieu.com)
- **Page carrières** : https://workforcenow.adp.com/mascsr/default/mdf/recruitment/recruitment.html?cid=a43f2867-2f0c-434c-8680-d6c5543c4dc5&ccId=19000101_000001&lang=fr_CA
- **Secteurs** : Distribution / Grossiste
- **Région** : Montréal
- Offres marquées **« Offre directe »** dans l'app (badge) : la candidature se fait chez l'employeur, jamais via un intermédiaire.

## Accès

- **Mécanique** : voir la fiche plateforme [`ats-adp.md`](ats-adp.md) — API JSON publique du site carrières, backend `requests` direct (Scrapfly seulement si indiqué sur la fiche plateforme).
- **Identifiants du tenant** (attributs du connecteur) :

| Attribut | Valeur |
|---|---|
| `CCID` | `19000101_000001` |
| `CID` | `a43f2867-2f0c-434c-8680-d6c5543c4dc5` |
| `EMPLOYER` | `Quincaillerie Richelieu` |
| `LANG` | `fr_CA` |
- **Throttle** : 1.0 s entre requêtes.
- **Filtre Québec** : seuls les postes localisés au Québec sont conservés (facette serveur quand l'ATS en offre une, sinon `is_quebec_location` côté client).

## Champs → schéma

Complétude mesurée sur les **11 offres actives** de la source (base live, 2026-09-21 18:06 EDT).

| Champ (`jobs.*`) | Rôle | Complétude |
|---|---|---|
| `title` — Titre | titre du poste | 100 % |
| `employer` — Employeur | nom de l'entreprise | 100 % |
| `url` — URL | lien direct vers l'offre originale | 100 % |
| `description` — Description | texte complet (HTML nettoyé) | 100 % |
| `city` — Ville | municipalité normalisée | 100 % |
| `region` — Région | région administrative | 100 % |
| `address` — Adresse | adresse du lieu de travail | 0 % |
| `postal_code` — Code postal | code postal si publié | 100 % |
| `work_mode` — Mode | presentiel / hybride / teletravail | 0 % |
| `employment_type` — Type | temps_plein / temps_partiel / … | 91 % |
| `salary` — Salaire ($) | bornes numériques normalisées $/h et $/an | 0 % |
| `salary_label` — Libellé salaire | texte salarial original | 0 % |
| `benefits` — Avantages | avantages sociaux publiés (JSON) | 0 % |
| `requirements` — Exigences | scolarité, expérience, langues (JSON) | 73 % |
| `date_posted` — Date de parution | ISO 8601 | 100 % |
| `date_deadline` — Date limite | date limite pour postuler | 0 % |
| `category` — Catégorie | taxonomie interne (TI, Santé, …) | 100 % |
| `language` — Langue | fr / en / bilingue (source ou heuristique) | 100 % |
| `company_logo` — Logo employeur | URL du logo si exposé par la source | 0 % |
| `apply_url` — Candidature | lien de candidature directe | 0 % |
| `gps` — GPS | lat/lng (géocodage sans invention) | 100 % |

Exemple réel : *Partenaire d’affaires, Ressources humaines - Ouest Canadien* — Saint Laurent · ∅ · parue le 2026-09-02.

## Fréquence & budgets

- **Cadence** : resynchronisation **horaire** (PM2 `job-ka-sync` = `run.py watch 60`), suivie du géocodage en lot puis de la déduplication inter-sources.
- **Throttle** : 1.0 s minimum entre deux requêtes vers la source (`request_delay`).
- **Budgets / plafonds (variables d'environnement)** :

| Variable | Défaut |
|---|---|
| `JOBKA_ADP_DETAIL_LIMIT` | `80` |
- Cache BD des pages détail (`detail_cache`) : le détail d'une offre n'est re-téléchargé que si sa ligne de liste change.

## Volumétrie & complétude live

*(mesuré le 2026-09-21 18:06 EDT dans `data/jobka.db`)*

- **Offres en base** : 17 (dont **11 actives**, 0 masquées comme doublons `dup_of`)
- **Salaire** : 0/11 actives (0 %)
- **GPS** : 11/11 actives (100 %)
- **Mode** : 0/11 actives (0 %)
- **Parution** : 11/11 actives (100 %)
- **Dernier sync** : 2026-09-21 17:30 — trouvées 11, +0, ~0, -0
- **Syncs enregistrés** (`sync_log`) : 229

## Erreurs & dépannage

Erreurs relevées dans `sync_log` :

| Erreur | Occurrences | Dernière fois |
|---|---|---|
| Expecting value: line 1 column 1 (char 0) | 6 | 2026-08-30 01:17 |

- Rejouer un sync isolé : `.venv/bin/python run.py sync richelieu` puis inspecter `sync_log` : `sqlite3 data/jobka.db "SELECT * FROM sync_log WHERE source='richelieu' ORDER BY ts DESC LIMIT 5;"`
- Garde-fous : une source qui retourne ≤ 25 % de sa médiane historique déclenche une alerte et les retraits sont suspendus ; une offre doit manquer 2 syncs consécutifs avant `active=0`.

## Licence / conformité

**Flux public du site carrières officiel de l'employeur** (API JSON de l'ATS ou HTML rendu serveur) — le même contenu que la page carrière affiche publiquement, prévu pour la diffusion des offres, sans authentification. Chaque offre conserve son URL originale et le bouton « Postuler chez Quincaillerie Richelieu » renvoie chez l'employeur. Aucune donnée personnelle de candidat n'est collectée. User-Agent identifié `JobKaBot/1.0 (+https://www.job-ka.com; contact@spboucher.ai)` sur les accès directs ; requêtes throttlées et plafonnées par budgets.

## Historique

**Mission connecteurs du 2026-08-18** — passage de 135 à 217 employeurs directs connectés, de 9 à 17 plateformes ATS, ajout de 3 portails agrégateurs et du canal de dépôt direct :
- `fd4bfc8` qualité lieux : rejet des villes hors Québec, bâtiments McGill → Montréal ;
- `5a66f48` +59 employeurs (sondage massif d'ATS + détection de pages carrières) ;
- `4917d57` 8 nouveaux ATS (Taleo, Njoyn, UltiPro, iCIMS, SuccessFactors, ADP WFN, Digital Recruiters, Workland) + 23 employeurs publics/parapublics ;
- `f6e7571` portails Guichet-Emplois, Jobillico, Espresso-Jobs — l'offre directe gagne toujours la canonique (dédup) ;
- `744cbfc` badge « Offre directe », stats directes/portails, dépôt direct employeurs ;
- `1604ff9` reprise sur coupure WAF Guichet-Emplois (retry + acquis partiel).

Commits touchant `jobka/connectors/richelieu.py` :

- `6952882` 2026-08-30 [ka6] snapshot pré-mission strathmore
- `f3f4cad` 2026-08-29 Revert "[ka6] fix connecteur richelieu: aucun bug — maintenance PLANIFIÉE d'ADP Workforce Now Canada (vendredi soir) : depuis ~22:00 EDT le 2026-08-28, toute requête vers workforcenow.adp.com (API liste job-requisitions, API détail, page carrières) reçoit un 302 BigIP vers sorry.adp.com/maintenance/ annonçant « available after August 29, 2026 2:00 AM Eastern », d'où l'échec « Expecting value: line 1 column 1 » du sync de 22:04. Panne pour TOUT LE MONDE, vérifiée depuis le nœud, via proxy résidentiel canadien Oxylabs ET via Scrapfly asp (même page maintenance) = ni blocage IP ni anti-bot. Preuve que la plateforme entière est visée : les 16 autres connecteurs ADP passés AVANT ~22 h étaient tous ok (volumes normaux), strathmore passé à 22:15 a échoué à l'identique. Le statut stale vient de la cadence du cycle complet (~4 h entre deux passages de richelieu) + 1 seul échec. Aucun changement de code : le cycle horaire job-ka-sync reprendra seul après 2:00 AM ET. Les 10 offres actives (= médiane 10.0) sont préservées en base — un sync en échec ne purge rien (removed=0). Sync isolé rejoué pour trace (302 maintenance reproduit via le connecteur réel, actives=10 après). Note de contexte ajoutée au connecteur. pm2 restart job-ka-sync OK, site local 200, www.job-ka.com 200."
- `e152035` 2026-08-28 [ka6] fix connecteur richelieu: aucun bug — maintenance PLANIFIÉE d'ADP Workforce Now Canada (vendredi soir) : depuis ~22:00 EDT le 2026-08-28, toute requête vers workforcenow.adp.com (API liste job-requisitions, API détail, page carrières) reçoit un 302 BigIP vers sorry.adp.com/maintenance/ annonçant « available after August 29, 2026 2:00 AM Eastern », d'où l'échec « Expecting value: line 1 column 1 » du sync de 22:04. Panne pour TOUT LE MONDE, vérifiée depuis le nœud, via proxy résidentiel canadien Oxylabs ET via Scrapfly asp (même page maintenance) = ni blocage IP ni anti-bot. Preuve que la plateforme entière est visée : les 16 autres connecteurs ADP passés AVANT ~22 h étaient tous ok (volumes normaux), strathmore passé à 22:15 a échoué à l'identique. Le statut stale vient de la cadence du cycle complet (~4 h entre deux passages de richelieu) + 1 seul échec. Aucun changement de code : le cycle horaire job-ka-sync reprendra seul après 2:00 AM ET. Les 10 offres actives (= médiane 10.0) sont préservées en base — un sync en échec ne purge rien (removed=0). Sync isolé rejoué pour trace (302 maintenance reproduit via le connecteur réel, actives=10 après). Note de contexte ajoutée au connecteur. pm2 restart job-ka-sync OK, site local 200, www.job-ka.com 200.
- `856863d` 2026-08-25 Vague D implémentée — 75 nouveaux connecteurs (968 -> 1044 employeurs), ~768 offres QC