SPB Git forge

spb/job-ka

Public
229commits 1branches 0releases
38.1 MBsize
maindefault branch
4 h agolast push
HTML 82.1% Python 14.6% TypeScript 1.9% CSS 1% JavaScript 0.5%
7.1 KB · 108 lines markdown
Rendered Raw Blame History
1<!--2=============================================================================3Job·Ka — Groupe KA4Auteur  : Simon-Pierre Boucher5Contact : contact@spboucher.ai6Fichier : docs/connecteurs/atlas_workland.md7Rôle    : Fiche connecteur — Réseau Atlas Workland (~80 employeurs QC : CSS, cégeps, Santé Québec, STQ, UQTR…) (employeur direct, ATS workland)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# Réseau Atlas Workland (~80 employeurs QC : CSS, cégeps, Santé Québec, STQ, UQTR…) (`atlas_workland`)1415**Employeur direct** · Plateforme ATS : [`workland`](ats-workland.md) · Statut registre : actif · Connecteur : `jobka/connectors/atlas_workland.py`1617## Description1819- **Site** : [Réseau Atlas Workland (~80 employeurs QC : CSS, cégeps, Santé Québec, STQ, UQTR…)](https://www.workland.com)20- **Page carrières** : https://atlas.workland.com21- **Secteurs** : Éducation, Santé, Secteur public, Multi-employeurs22- **Région** : Québec (province)23- 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-workland.md`](ats-workland.md) — API JSON publique du site carrières, backend `requests` direct (Scrapfly seulement si indiqué sur la fiche plateforme).28- **Throttle** : 1.0 s entre requêtes.29- **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).3031## Champs → schéma3233Complétude mesurée sur les **1226 offres actives** de la source (base live, 2026-09-21 18:06 EDT).3435| Champ (`jobs.*`) | Rôle | Complétude |36|---|---|---|37| `title` — Titre | titre du poste | 100 % |38| `employer` — Employeur | nom de l'entreprise | 100 % |39| `url` — URL | lien direct vers l'offre originale | 100 % |40| `description` — Description | texte complet (HTML nettoyé) | 100 % |41| `city` — Ville | municipalité normalisée | 100 % |42| `region` — Région | région administrative | 99 % |43| `address` — Adresse | adresse du lieu de travail | 0 % |44| `postal_code` — Code postal | code postal si publié | 82 % |45| `work_mode` — Mode | presentiel / hybride / teletravail | 85 % |46| `employment_type` — Type | temps_plein / temps_partiel / … | 68 % |47| `salary` — Salaire ($) | bornes numériques normalisées $/h et $/an | 35 % |48| `salary_label` — Libellé salaire | texte salarial original | 35 % |49| `benefits` — Avantages | avantages sociaux publiés (JSON) | 0 % |50| `requirements` — Exigences | scolarité, expérience, langues (JSON) | 88 % |51| `date_posted` — Date de parution | ISO 8601 | 100 % |52| `date_deadline` — Date limite | date limite pour postuler | 100 % |53| `category` — Catégorie | taxonomie interne (TI, Santé, …) | 81 % |54| `language` — Langue | fr / en / bilingue (source ou heuristique) | 100 % |55| `company_logo` — Logo employeur | URL du logo si exposé par la source | 0 % |56| `apply_url` — Candidature | lien de candidature directe | 0 % |57| `gps` — GPS | lat/lng (géocodage sans invention) | 100 % |5859Exemple réel : *Conseillère ou conseiller au développement philanthropique et partenariats - Fondation du …* — Trois-Rivières · Salaire de départ de 50 000 $ · parue le 2026-09-21.6061## Fréquence & budgets6263- **Cadence** : resynchronisation **horaire** (PM2 `job-ka-sync` = `run.py watch 60`), suivie du géocodage en lot puis de la déduplication inter-sources.64- **Throttle** : 1.0 s minimum entre deux requêtes vers la source (`request_delay`).65- 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.6667## Volumétrie & complétude live6869*(mesuré le 2026-09-21 18:06 EDT dans `data/jobka.db`)*7071- **Offres en base** : 2638 (dont **1226 actives**, 11 masquées comme doublons `dup_of`)72- **Salaire** : 424/1226 actives (35 %)73- **GPS** : 1226/1226 actives (100 %)74- **Mode** : 1036/1226 actives (85 %)75- **Parution** : 1226/1226 actives (100 %)76- **Dernier sync** : 2026-09-21 16:37 — trouvées 1211, +8, ~21, -477- **Syncs enregistrés** (`sync_log`) : 3617879## Erreurs & dépannage8081Erreurs relevées dans `sync_log` :8283| Erreur | Occurrences | Dernière fois |84|---|---|---|85| HTTPSConnectionPool(host='jobs-prod.workland.com', port=443): Max retries exceeded with ur… | 1 | 2026-09-18 12:52 |86| HTTPSConnectionPool(host='jobs-prod.workland.com', port=443): Read timed out. (read timeou… | 1 | 2026-08-22 04:52 |8788- Rejouer un sync isolé : `.venv/bin/python run.py sync atlas_workland` puis inspecter `sync_log` : `sqlite3 data/jobka.db "SELECT * FROM sync_log WHERE source='atlas_workland' ORDER BY ts DESC LIMIT 5;"`89- 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`.9091## Licence / conformité9293**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 Réseau Atlas Workland (~80 employeurs QC : CSS, cégeps, Santé Québec, STQ, UQTR…) » 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.9495## Historique9697**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 :98- `fd4bfc8` qualité lieux : rejet des villes hors Québec, bâtiments McGill → Montréal ;99- `5a66f48` +59 employeurs (sondage massif d'ATS + détection de pages carrières) ;100- `4917d57` 8 nouveaux ATS (Taleo, Njoyn, UltiPro, iCIMS, SuccessFactors, ADP WFN, Digital Recruiters, Workland) + 23 employeurs publics/parapublics ;101- `f6e7571` portails Guichet-Emplois, Jobillico, Espresso-Jobs — l'offre directe gagne toujours la canonique (dédup) ;102- `744cbfc` badge « Offre directe », stats directes/portails, dépôt direct employeurs ;103- `1604ff9` reprise sur coupure WAF Guichet-Emplois (retry + acquis partiel).104105Commits touchant `jobka/connectors/atlas_workland.py` :106107- `86b0d0b` 2026-08-19 Famille Workland réécrite sur l'API JSON publique du frontal Atlas (jobs-prod published-external + default-profiles) : descriptions complètes fr/en, lieux géocodés, dates, mode de travail — 2 requêtes par cycle pour TOUT le réseau. Nouveau connecteur réseau atlas_workland (~80 employeurs QC : CSS scolaires, cégeps, CIUSSS Ouest-de-l'Île, Santé Québec Côte-Nord, ICM, STQ, UQTR, INRS… ; 1 238 offres QC). Connecteur cssdm retiré (couvert par le réseau), fixture remplacée par atlas_workland (sous-ensemble rejouable). Corrige la limite « workland description 0 % ».108