Job·Ka

Tous les emplois des employeurs québécois

Les grands sites d'emploi mélangent annonces payantes, doublons repostés et offres mortes. L'offre originale — celle de la page carrière de l'employeur — est la seule source fiable. Job·Ka se branche directement sur les systèmes de recrutement (ATS) des employeurs québécois : 1 104 connecteurs employeurs directs sur 23 plateformes ATS (Workday, SmartRecruiters, Greenhouse, Dayforce, Breezy, Workable, Lever, Ashby, BambooHR, JazzHR, Recruitee, ADP WFN, Zoho Recruit, SuccessFactors, Njoyn, Teamtailor, WP Job Manager, iCIMS, Taleo Business Edition, Taleo, UltiPro/UKG, Digital Recruiters, Workland/réseau Atlas + sites carrières maison), complétés par 3 portails publics (Guichet-Emplois, Jobillico, Espresso-Jobs) — l'offre directe gagne toujours.

Résultat en base (au 2026-08-28) : 22 634 offres actives de 1 733 employeurs (1 048 sources actives), dont 21 243 offres directes et 7 114 avec salaire affiché (moyenne 61 681 $/an, médiane 57 325 $/an) — salaires normalisés en $/h et $/an, jamais inventés. Chaque offre est traçable à sa source et la candidature se fait chez l'employeur. Pour qui ? Les chercheurs d'emploi québécois qui veulent l'inventaire réel, à jour et transparent, des postes affichés dans la province — resynchronisé jour et nuit.

# Chiffres clés (live sur /api/stats, vérifiés au 2026-08-28)

# Visite guidée

Captures du 2026-08-28 (desktop 1440×900) — design « éditorial premium ». Chaque capture pointe vers la page réelle sur www.job-ka.com.

# 1. Accueil — job-ka.com

La porte d'entrée : recherche plein texte + filtres (ville, catégorie, salaire, télétravail…), chiffres clés live tirés de /api/stats et offres récentes. Le badge « Offre directe » distingue immédiatement les offres captées sur la page carrière de l'employeur.

# 2. Répertoire des villes — /villes

Toutes les villes du Québec où des offres sont actives, avec leur volume — des pages SEO programmatiques rendues en HTML côté serveur (/ville/{slug}), indexables et rapides.

# 3. Carte des offres — /carte

Les 21 044 offres géocodées sur une carte MapLibre GL (sans jeton), alimentée par GET /api/jobs.geojson. Géocodage Nominatim + repli officiel Adresses Québec (MERN), validé par bounding box provinciale — jamais inventé.

# 4. Sources — /sources

La transparence au premier plan : le registre public des 1 048 sources actives (employeurs directs par plateforme ATS + portails), avec l'état de chaque connecteur. Chaque offre est traçable à son origine.

# 5. Observatoire de l'emploi — /stats

Le tableau de bord analytique (kit stats v3 Groupe KA) : volumes par ville, catégorie, salaire, mode de travail… avec rapports PDF téléchargeables, y compris des rapports personnalisés.

# 6. Espace employeurs — /employeurs

Les employeurs québécois peuvent déposer leurs offres directement (POST /api/employeurs/offres) — modération manuelle avant publication.

# 7. Contact — /contact

Contact direct avec le Groupe KA — questions, retraits, partenariats, signalements.

# 8. Page ville — /ville/montreal

L'exemple type des pages villes : 8 176 offres à Montréal, filtrables sur place, avec métriques claires (salaire affiché, séniorité, mode de travail) issues de l'enrichissement des connecteurs.

# 9. Fiche d'offre — /emploi/{uid}

Une fiche complète (ici un poste chez 4Refuel, capté directement sur son ATS Dayforce) : description, salaire normalisé, exigences, localisation, JSON-LD JobPosting pour le SEO — et le bouton Postuler qui mène chez l'employeur, jamais ailleurs.

# 10. Favoris « Mon univers Ka » — /favoris

Les offres sauvegardées avec le cœur, synchronisées via KA ID (le SSO du Groupe KA) — le même compte retrouve ses favoris sur les 13 sites de l'écosystème.

📷 Captures précédentes (refonte du 2026-08-25, mobile + desktop)

# Mobile

Accueil — recherche d'offres	Offres à Montréal — métriques claires	Fiche d'offre — exigences, séniorité
Carte des offres géocodées	Observatoire de l'emploi	Nav v2 — panneau plein écran

# Desktop

Accueil — design éditorial premium	Résultats par ville — Montréal
Fiche d'offre — lien direct vers l'ATS de l'employeur	Carte des offres
Répertoire des villes (pages SEO)	Statistiques — 22 900+ postes

🗄️ Les captures d'époque sont conservées dans docs/archive/.

# Nouveautés front-end (2026-08-25)

• Refonte visuelle majeure — design éditorial premium sur tout le site.
• Affichage des offres repensé — métriques claires (salaire, exigences, séniorité) issues de l'enrichissement des 1 100+ connecteurs (phase 3).
• Vagues D et E de connecteurs ATS — +135 employeurs (JazzHR, Teamtailor, Zoho Recruit…).
• Nav mobile v2 — hamburger + panneau plein écran (standard KA 2026-08-25).
• Widget ka-agent v4 — cartes d'offres cliquables et choix en boutons.

# Guide pas à pas (« Utiliser le site en 4 étapes », depuis /doc)

Étape 1 — Arriver sur l'accueil	Étape 2 — Chercher et filtrer les offres
Étape 3 — Lire la fiche et postuler chez l'employeur	Étape 4 — Explorer par la carte (et plus)

# Fonctionnalités

• Recherche filtrée — texte, ville, catégorie (16 catégories : TI, Santé, Finance, Ingénierie…), région, langue, mode de travail (dont télétravail), type d'emploi, salaire minimum / « salaire affiché », tri, pagination.
• Connecteurs auto-découverts — toute sous-classe de BaseConnector avec un source_id est enregistrée par pkgutil ; brancher un nouvel employeur sur une plateforme ATS = ~10 lignes. Politesse : throttling par source, User-Agent identifiable JobKaBot/1.0, budgets de requêtes, cache des pages détail.
• Diff engine anti-dérive — comparaison par content_hash à chaque sync ; une offre absente 2 syncs passe active=0 (jamais de DELETE) ; si une source retourne ≤ 25 % de sa médiane historique, alerte et retraits suspendus.
• Salaires normalisés, jamais inventés — parse_salary() exige un signe monétaire ou une unité explicite, bornes de plausibilité, conversion $/h ↔ $/an, historique des changements (salary_log).
• Géocodage sans invention — Nominatim + repli officiel Adresses Québec (MERN), cache persistant, validation par bounding box provinciale ; carte des offres (MapLibre, sans jeton) via GET /api/jobs.geojson.
• Déduplication inter-sources direct-prioritaire — union-find avec second signal concordant ; en cas de doublon, l'offre de la page carrière (badge « Offre directe ») devient la canonique, les copies portail sont masquées (dup_of), jamais supprimées.
• Quarantaine qualité — offres douteuses exclues des points d'accès publics (jobka/quality.py), supervisables via quarantined=1.
• Dépôt direct employeurs — /employeurs (POST /api/employeurs/offres), modération manuelle.
• SEO programmatique — SSR léger (accueil, fiches JSON-LD JobPosting, pages statiques), robots.txt, sitemaps, pages /villes + /ville/{slug} rendues en HTML.
• Page /stats — tableau de bord analytique + rapports PDF Groupe-KA (kit kacharts/kapdf v3, rapports personnalisés) ; favoris « Mon univers Ka » (KA ID, cœur sur cartes et fiche, page /favoris).
• Conformité documentée — docs/CONFORMITE.md (base d'accès par famille de sources, attribution, zéro donnée personnelle de candidat) + une fiche générée par connecteur dans docs/connecteurs/ (1 133 fiches).
• Tests hors ligne — 74 tests pytest : fixtures HTTP enregistrées et rejouées, invariants (uid uniques, URLs absolues, salaires plausibles).
• Supervision par agents gardiens — les connecteurs sont surveillés en continu (gardien ka6) : chaque panne de source est diagnostiquée (panne externe vs bug), documentée dans le connecteur et commitée — un sync en échec ne purge jamais rien.

# Connecteurs & sources

Registre descriptif : data/sources.json (1 108 entrées, dont 1 en modération) ; une fiche de conformité par connecteur dans docs/connecteurs/ (1 133 fiches, index : docs/connecteurs/INDEX.md, régénérables par scripts/gen_connector_docs.py).

Cadence de resync : horaire, jour et nuit — le watcher PM2 job-ka-sync (run.py watch 60) enchaîne sync + géocodage + déduplication ; le diff engine par content_hash gère le cycle de vie (retrait après 2 syncs d'absence, anti-dérive à ≤ 25 % de la médiane historique). Les connecteurs fragiles passent par une chaîne de fetch anti-bot résiliente (Oxylabs → Scrapfly → Bright Data).

# Architecture

Sources (23 plateformes ATS + sites maison + 3 portails)
   → connecteurs auto-découverts (jobka/connectors/)
   → finalize() — normalisation commune (schema.py, normalize.py)
   → SQLite data/jobka.db — diff par content_hash, cycle de vie, anti-dérive (db.py)
   → géocodage (geocode.py) + déduplication (dedup.py) + quarantaine (quality.py)
   → API FastAPI (web.py) + frontend React/Vite servi en statique (frontend/dist)

• Backend : Python + FastAPI (uvicorn) — API JSON, SSR SEO léger, stats, PDF (fpdf2), SSO/favoris KA ID.
• Base de données : SQLite (data/jobka.db, non versionnée) — offres, historique salarial, cache de géocodage, journal des syncs.
• Frontend : React 18 + Vite + TypeScript, carte MapLibre GL (sans jeton), design system Groupe KA ; build servi en statique par FastAPI.
• Anti-bot : chaîne résiliente Oxylabs → Scrapfly → Bright Data pour certaines pages carrières maison (SCRAPFLY_API_KEY).

# API — endpoints principaux

# Données & conformité

• Provenance : API publiques des plateformes ATS (base légale documentée dans docs/CONFORMITE.md), pages carrières publiques, portails publics ; zéro donnée personnelle de candidat — Job·Ka n'indexe que des offres.
• Attribution : chaque offre conserve son URL originale ; la candidature se fait chez l'employeur (badge « Offre directe » sur les sources directes).
• Cadence : resync horaire jour et nuit (run.py watch 60) ; retrait doux après 2 syncs d'absence ; anti-dérive à ≤ 25 % de la médiane historique.
• Salaires : jamais inventés — signe monétaire ou unité explicite obligatoire, bornes de plausibilité, conversion $/h ↔ $/an documentée.
• Traçabilité : 1 133 fiches de conformité générées (docs/connecteurs/), registre data/sources.json auditable (sources écartées documentées avec raisons).

# Structure du repo

# Démarrage rapide

ssh M3U96a && cd ~/apps/job-ka
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt   # au besoin
.venv/bin/python -m pytest                    # 74 tests hors ligne (fixtures rejouées)
.venv/bin/python run.py sync <source>         # valider un connecteur précis
.venv/bin/python run.py sync                  # sync complet (toutes les sources)
.venv/bin/python run.py serve 8096            # API + frontend statique
cd frontend && npm install && npm run build   # rebuild du frontend (tsc -b && vite build)

# Développement (remote-first)

⚠️ La source de vérité est le repo git sur le nœud M3U96a (~/apps/job-ka) — on n'édite jamais les copies laptop. Toute modification se fait sur le nœud via SSH : édition, tests, build frontend au besoin, redémarrage PM2, puis commit + push depuis le nœud.

• Remote origin = spbgit (git perso, https://git.spboucher.ai) — sur M3U96a, l'origin est le chemin local /Users/simon-pierreboucher/srv/git/job-ka.git (bare repo).
• On ne pousse que le code : data/*.db, frontend/dist/ et .env ne sont jamais versionnés — le serveur maintient ses données lui-même.

cd ~/apps/job-ka
.venv/bin/python -m pytest                    # avant de pousser
cd frontend && npm run build && cd ..         # si le frontend a changé
pm2 restart job-ka-web                        # après changement
git add <fichiers> && git commit -m "…" && git push origin main

# Variables d'environnement

Noms seulement — aucun secret n'est versionné.

# Déploiement

Détails : docs/deploiement.md.

# Documentation

• Guide utilisateur en ligne : www.job-ka.com/doc/ — à quoi sert le site, utilisation en 4 étapes, provenance des données, FAQ.
• Guide PDF téléchargeable : job-ka-documentation.pdf.
• Conformité & connecteurs : docs/CONFORMITE.md + une fiche par connecteur dans docs/connecteurs/ (1 133 fiches, index : docs/connecteurs/INDEX.md).

# Historique

# Écosystème Groupe KA

# Contact

Simon-Pierre Boucher — fondateur, Groupe KA 📧 contact@spboucher.ai

© Groupe KA — Simon-Pierre Boucher · contact@spboucher.ai

Ce dépôt vit sur spbgit (git perso — https://git.spboucher.ai).