<!--
=============================================================================
Job·Ka — Groupe KA
Auteur  : Simon-Pierre Boucher
Contact : contact@spboucher.ai
Fichier : docs/connecteurs/ats-successfactors.md
Rôle    : Fiche plateforme ATS successfactors — mécanique partagée + tableau des 11 tenants
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.
=============================================================================
-->

# Plateforme ATS `successfactors`

**11 employeurs connectés** via cette plateforme — **1451 offres actives**. Module partagé : `jobka/connectors/successfactors.py` ; un employeur = une sous-classe d'environ 10 lignes.

## Description & mécanique

> Plateforme SAP SuccessFactors (Career Site Builder, ex-jobs2web).
>
> Deux formats de « sitemap.xml » selon la génération du site :
> - RSS 2.0 : <item> avec titre « Poste (VILLE, PROV, PAYS[, CP]) » ET la
>   description HTML complète — tout en une requête ;
> - urlset  : URLs /job/<Ville>-<titre>-<Prov>-<CP>/<id>/ + lastmod ; la
>   description est lue sur la page détail (microdonnées itemprop, avec cache
>   BD + budget). Le filtre Québec s'appuie sur la province/le code postal
>   présents dans le slug — aucun détail hors Québec n'est visité.

## Accès

- **Pagination** : parcours de sitemap XML
- **Backend** : GET/POST direct `requests` (throttlé, User-Agent `JobKaBot/1.0` identifié)
- **Auth** : aucune — API/pages publiques du site carrières.
- **Throttle** : 1.0 s entre requêtes.
- **Budgets (env)** : `JOBKA_SF_DETAIL_LIMIT` (défaut `150`)

## Tenants connectés

| Employeur | Actives | Salaire | GPS | Mode | Dernier sync | OK |
|---|---|---|---|---|---|---|
| [Bombardier](bombardier.md) | 741 | 0 % | 100 % | 86 % | 2026-09-21 16:40 | ✅ |
| [Alstom](alstom.md) | 237 | 7 % | 100 % | 3 % | 2026-09-21 16:36 | ✅ |
| [Cascades](cascades.md) | 108 | 74 % | 100 % | 19 % | 2026-09-21 16:45 | ✅ |
| [Deloitte Canada](deloitte.md) | 108 | 98 % | 100 % | 100 % | 2026-09-21 16:52 | ✅ |
| [TELUS](telus.md) | 66 | 0 % | 100 % | 3 % | 2026-09-21 17:37 | ✅ |
| [Hydro-Québec](hydroquebec.md) | 53 | 34 % | 77 % | 0 % | 2026-09-21 17:12 | ✅ |
| [Kiewit (Ganotec)](kiewit_ganotec.md) | 52 | 0 % | 100 % | 0 % | 2026-09-21 17:19 | ✅ |
| [Domtar](domtar.md) | 29 | 0 % | 100 % | 0 % | 2026-09-21 16:53 | ✅ |
| [VIA Rail Canada](via_rail.md) | 24 | 0 % | 100 % | 0 % | 2026-09-21 17:40 | ✅ |
| [Énergir](energir.md) | 18 | 0 % | 100 % | 6 % | 2026-09-21 16:56 | ✅ |
| [Canada Vie](canada_vie.md) | 15 | 0 % | 100 % | 0 % | 2026-09-21 16:41 | ✅ |

## 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 l'employeur » 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/successfactors.py` :

- `30c58c2` 2026-09-13 [ka6] fix connecteur alstom: faux positif de supervision (réponse sitemap transitoirement illisible) — garde-fou _fetch_sitemap dans la plateforme successfactors — le statut stale vient d'un unique sync found=0 à 06:14 (contre une médiane stable de 224), alors que le connecteur est INTACT : le sitemap RSS live (24 Mo, 2285 items monde) parse 224 offres QC au rejeu. Vraie faiblesse corrigée : SuccessFactorsConnector.fetch() avalait silencieusement une réponse 200 sans racine <rss>/<urlset> (page de maintenance/anti-bot, corps vide) — pas d'<item> ni de <loc> → [] → faux « 0 trouvé, ok ». Nouveau _fetch_sitemap sur le modèle de njoyn._fetch_listing (7938ca6) : 3 essais avec backoff 10-20 s, retry sur RequestException transitoire et sur réponse sans racine sitemap, échec explicite (RuntimeError, offres conservées) après 3 réponses illisibles ; un sitemap valide mais vide après 3 essais reste accepté (tenant légitimement sans offre, le garde-fou de dérive suspend déjà les retraits). Test unitaire ajouté (retry maintenance+ConnectTimeout, échec explicite après 3 corps vides, tolérance tenant vide). Sync rejoué post-patch : found=224 en 8,9 s, ok. 103 tests pytest verts. pm2 restart job-ka-sync OK, site 200.
- `856863d` 2026-08-25 Vague D implémentée — 75 nouveaux connecteurs (968 -> 1044 employeurs), ~768 offres QC
- `49067dd` 2026-08-19 Connecteurs phase 2 — correctifs et enrichissement champ par champ. Correctifs : villes SuccessFactors à trait d'union (préfixe municipal MAMH sur le slug, bogue « St »/« Pointe »), colonne date Taleo = date LIMITE chez agnico_eagle (+ garde-fou date future). Enrichissement : SmartRecruiters experienceLevel/function/industry/language/refNumber (lignes de liste, zéro requête), BambooHR locationType→work_mode, Breezy is_remote/logo_url/streetAddress, JSON-LD logo/industry/educationRequirements/skills (portails+icims+DR), Ashby applyUrl + composantes Bonus/Equity/Commission, Lever applyUrl + blocs opening/additional + allLocations, Workable application_url + function/industry, Recruitee careers_apply_url + description FR (translations) + expérience/scolarité + heures/sem, Greenhouse language + requisition_id, Workday externalUrl→apply_url + work_mode via facette Remote Type + clé cache v2, Guichet-Emplois avantages structurés + langue de travail, njoyn apply_url en colonne ; secours cache périmé quand le budget détail est épuisé (plus de fiches vidées)
- `4917d57` 2026-08-18 8 nouveaux ATS (Taleo, Njoyn, UltiPro, iCIMS, SuccessFactors, ADP WFN, Digital Recruiters, Workland) + 23 employeurs publics/parapublics et grands employeurs QC