SPB Git forge

spb/job-ka

Public
229commits 1branches 0releases
38.1 MBsize
maindefault branch
39 min agolast push
HTML 82.1% Python 14.6% TypeScript 1.9% CSS 1% JavaScript 0.5%
9.2 KB

# Quincaillerie Richelieu (richelieu)

Employeur direct · Plateforme ATS : adp · Statut registre : actif · Connecteur : jobka/connectors/richelieu.py

# Description

# Accès

  • Mécanique : voir la fiche plateforme 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