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%
10.0 KB · 111 lines markdown
Rendered Raw Blame History
1<!--2=============================================================================3Job·Ka — Groupe KA4Auteur  : Simon-Pierre Boucher5Contact : contact@spboucher.ai6Fichier : docs/connecteurs/eq3_ltd.md7Rôle    : Fiche connecteur — EQ3 (employeur direct, ATS breezy)8Généré  : 2026-09-21 18:06 EDT par scripts/gen_connector_docs.py — NE PAS ÉDITER,9          relancer le script pour régénérer.10=============================================================================11-->1213# EQ3 (`eq3_ltd`)1415**Employeur direct** · Plateforme ATS : [`breezy`](ats-breezy.md) · Statut registre : actif · Connecteur : `jobka/connectors/eq3_ltd.py`1617## Description1819- **Site** : [EQ3](https://www.eq3.com)20- **Page carrières** : https://eq3-ltd.breezy.hr21- **Secteurs** : Commerce de détail, Meuble22- **Région** : Brossard, Laval, Montréal23- Offres marquées **« Offre directe »** dans l'app (badge) : la candidature se fait chez l'employeur, jamais via un intermédiaire.2425## Accès2627- **Mécanique** : voir la fiche plateforme [`ats-breezy.md`](ats-breezy.md) — API JSON publique du site carrières, backend `requests` direct (Scrapfly seulement si indiqué sur la fiche plateforme).28- **Identifiants du tenant** (attributs du connecteur) :2930| Attribut | Valeur |31|---|---|32| `EMPLOYER` | `EQ3` |33| `ORG` | `eq3-ltd` |34- **Throttle** : 1.0 s entre requêtes.35- **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).3637## Champs → schéma3839Complétude mesurée sur les **16 offres actives** de la source (base live, 2026-09-21 18:06 EDT).4041| Champ (`jobs.*`) | Rôle | Complétude |42|---|---|---|43| `title` — Titre | titre du poste | 100 % |44| `employer` — Employeur | nom de l'entreprise | 100 % |45| `url` — URL | lien direct vers l'offre originale | 100 % |46| `description` — Description | texte complet (HTML nettoyé) | 100 % |47| `city` — Ville | municipalité normalisée | 100 % |48| `region` — Région | région administrative | 100 % |49| `address` — Adresse | adresse du lieu de travail | 12 % |50| `postal_code` — Code postal | code postal si publié | 0 % |51| `work_mode` — Mode | presentiel / hybride / teletravail | 0 % |52| `employment_type` — Type | temps_plein / temps_partiel / … | 100 % |53| `salary` — Salaire ($) | bornes numériques normalisées $/h et $/an | 56 % |54| `salary_label` — Libellé salaire | texte salarial original | 56 % |55| `benefits` — Avantages | avantages sociaux publiés (JSON) | 0 % |56| `requirements` — Exigences | scolarité, expérience, langues (JSON) | 19 % |57| `date_posted` — Date de parution | ISO 8601 | 100 % |58| `date_deadline` — Date limite | date limite pour postuler | 0 % |59| `category` — Catégorie | taxonomie interne (TI, Santé, …) | 94 % |60| `language` — Langue | fr / en / bilingue (source ou heuristique) | 100 % |61| `company_logo` — Logo employeur | URL du logo si exposé par la source | 0 % |62| `apply_url` — Candidature | lien de candidature directe | 0 % |63| `gps` — GPS | lat/lng (géocodage sans invention) | 94 % |6465Exemple réel : *Consultant(e) en Design Temps Partiel* — Laval · Nos consultant(e)s en design à temps partiel gagnent généralement entre 18 $ et 25 $ par h… · parue le 2026-09-21.6667## Fréquence & budgets6869- **Cadence** : resynchronisation **horaire** (PM2 `job-ka-sync` = `run.py watch 60`), suivie du géocodage en lot puis de la déduplication inter-sources.70- **Throttle** : 1.0 s minimum entre deux requêtes vers la source (`request_delay`).71- 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.7273## Volumétrie & complétude live7475*(mesuré le 2026-09-21 18:06 EDT dans `data/jobka.db`)*7677- **Offres en base** : 32 (dont **16 actives**, 0 masquées comme doublons `dup_of`)78- **Salaire** : 9/16 actives (56 %)79- **GPS** : 15/16 actives (94 %)80- **Mode** : 0/16 actives (0 %)81- **Parution** : 16/16 actives (100 %)82- **Dernier sync** : 2026-09-21 16:56 — trouvées 15, +4, ~0, -083- **Syncs enregistrés** (`sync_log`) : 3588485## Erreurs & dépannage8687Aucune erreur dans `sync_log` pour cette source.8889- Rejouer un sync isolé : `.venv/bin/python run.py sync eq3_ltd` puis inspecter `sync_log` : `sqlite3 data/jobka.db "SELECT * FROM sync_log WHERE source='eq3_ltd' ORDER BY ts DESC LIMIT 5;"`90- 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`.9192## Licence / conformité9394**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 EQ3 » 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.9596## Historique9798**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 :99- `fd4bfc8` qualité lieux : rejet des villes hors Québec, bâtiments McGill → Montréal ;100- `5a66f48` +59 employeurs (sondage massif d'ATS + détection de pages carrières) ;101- `4917d57` 8 nouveaux ATS (Taleo, Njoyn, UltiPro, iCIMS, SuccessFactors, ADP WFN, Digital Recruiters, Workland) + 23 employeurs publics/parapublics ;102- `f6e7571` portails Guichet-Emplois, Jobillico, Espresso-Jobs — l'offre directe gagne toujours la canonique (dédup) ;103- `744cbfc` badge « Offre directe », stats directes/portails, dépôt direct employeurs ;104- `1604ff9` reprise sur coupure WAF Guichet-Emplois (retry + acquis partiel).105106Commits touchant `jobka/connectors/eq3_ltd.py` :107108- `f5cd86d` 2026-09-16 [ka6] fix connecteur eq3_ltd: retrait immédiat des offres CONFIRMÉES fermées — dans la nuit du 15 au 16/09, EQ3 a réellement fermé ses 12 postes (« Position Closed » vérifié live sur chacune des 12 pages /p/, plus aucun formulaire APPLY), étape suivante du délisting du board traité en 6012d1c ; le repli « board délisté » a fonctionné exactement comme conçu (re-vérification des 12 offres, rejet des pages fermées → found=0, volume désormais légitime), mais la garde anti-dérive du moteur (found=0 vs médiane 12 → retraits suspendus) maintenait les 12 offres fermées EN LIGNE sur le site (active=1, miss_count=0) pendant que la fenêtre de médiane (DRIFT_HISTORY=5) se vidait — correct pour un connecteur cassé, injustifié quand la fermeture est PROUVÉE page par page. Correctif tenant-spécifique dans eq3_ltd.py seul (db.py intact) : le repli collecte les uid des offres dont la page /p/ affiche « Position Closed » et les désactive directement (_deactivate_closed, UPDATE active=0), fermeture vérifiée à la source — les offres injoignables ou hors QC continuent de suivre le chemin normal miss_count. Vérifié live : la page carrières officielle eq3.com pointe toujours vers eq3-ltd.breezy.hr (pas de migration d'ATS), /json toujours [], validThrough des 12 offres tous dans le passé. Test unitaire adapté (offre « Position Closed » → retrait direct capturé, vivante conservée, hors-QC simplement lâchée). Sync réel rejoué : 12 offre(s) confirmée(s) fermée(s) — retirées, 0 offre active restante en base, found=0 légitime (le tenant n'a plus aucun poste ouvert ; dès republication le chemin normal /json reprend seul). 105 tests pytest verts. pm2 restart job-ka-sync OK, site 200.109- `6012d1c` 2026-09-15 [ka6] fix connecteur eq3_ltd: repli « board délisté » — /json vide alors que les 12 offres restent EN LIGNE (re-vérification live des pages /p/) — le 2026-09-15 vers 12:07, le board Breezy eq3-ltd a cessé de lister ses postes (/json et /json?verbose=true = [] — vérifié direct, UA navigateur ET proxy résidentiel CA —, sitemap.xml sans aucune offre, HTML %LABEL_NO_POSITIONS%) alors que les 12 offres QC connues sont toutes encore en ligne et ouvertes aux candidatures (pages /p/ 200 avec JSON-LD JobPosting complet et bouton APPLY, aucune « Position Closed ») et que la page carrières officielle eq3.com/ca/en/aboutus/careers pointe toujours vers ce même board : delisting du portail côté tenant, PAS une dépublication (contrairement aux précédents hera 4990c80/autotradercanada e3bb827 où les offres retirées affichaient « Position Closed »/404). L'API Breezy est saine globalement (bellatrx 14, brandmomentum 34, recruiting 78…) ; aucun slug alternatif (eq3.breezy.hr existe mais vide) ni endpoint de rechange (embed/feed/rss → 302). Correctif tenant-spécifique dans eq3_ltd.py (breezy.py intact) : quand la liste est vide, re-vérification live de chaque offre active connue via sa page /p/ — JSON-LD JobPosting exigé, rejet des pages « Position Closed »/« no longer accepting » et hors Québec, champs frais depuis le JSON-LD (titre, description, ville, date), libellé salarial conservé du dernier état liste (8/12 avec salaire, préservés). Données réelles constatées à la source, jamais inventées ; limite assumée : pas de découverte de NOUVELLES offres tant que le board est délisté — dès que /json redevient non vide, le chemin normal reprend seul et les offres réellement fermées suivront miss_count → retrait. Correction au passage du même artefact sources.json que samsara/delos_data/solmentalhealth/hera : url vide → https://www.eq3.com. Test unitaire ajouté (offre vivante QC conservée avec salaire, « Position Closed » et hors-QC lâchées, repli jamais sollicité sur liste non vide, 0 requête si base vide). Syncs réels rejoués : found=12 (médiane exacte) ×2, updated=4 puis 0, aucune alerte, miss_count=0 partout. 105 tests pytest verts. pm2 restart job-ka-sync OK, site 200.110- `4657429` 2026-08-17 Création massive : 135 connecteurs employeurs québécois sur 9 plateformes ATS111