TalentVision — Documentation

Documentation technique de la plateforme Sodexo Ma Carrière, déployée sur sodexo.coconutservices.fr. Gestion des talents, compétences, évolutions de carrière, et 3 bots IA connectés à Langflow.

Architecture

Arborescence du projet

Base de données — Cloudflare D1

La base sodexo-talent utilise Cloudflare D1 (SQLite distribué). Le schéma est défini dans schema.sql et les données initiales dans seed.sql.

Tables

Table employees — Colonnes principales

Déploiement de la base

# Créer la base D1
npx wrangler d1 create sodexo-talent

# Appliquer le schéma
npx wrangler d1 execute sodexo-talent --file=schema.sql

# Insérer les données initiales
npx wrangler d1 execute sodexo-talent --file=seed.sql

API — Employees

GET /api/employees

Liste paginable et filtrable de tous les collaborateurs.

Réponse :

{
  "employees": [
    {
      "id": "alexandre-esteves",
      "first_name": "Alexandre",
      "last_name": "Esteves",
      "job_title": "Chef de projet digital",
      "evolution_score": 82,
      "risk_level": "low",
      "badge_label": "Haut Potentiel",
      ...
    }
  ]
}

API — Employee Detail

GET /api/employees/:id

Profil complet d'un collaborateur avec toutes ses données associées.

Réponse :

{
  "employee": { ... },
  "skills": [
    { "name": "Leadership", "percentage": 88, "category": "soft" }
  ],
  "gaps": [
    { "competence": "Anglais C1", "gap_level": "moyen", "training_recommendation": "..." }
  ],
  "career_path": [
    { "title": "...", "company": "Sodexo", "date_range": "2022-...", "status": "current" }
  ],
  "turnover_factors": [ ... ],
  "evaluations": [ ... ],
  "context_signals": [ ... ]
}

API — Stats

GET /api/stats

KPI globaux du dashboard.

{
  "stats": [
    { "key": "total_employees", "value": "847", "change_label": "+12", "change_direction": "up" },
    { "key": "avg_evolution_score", "value": "72", ... },
    { "key": "turnover_risk", "value": "8.2%", ... },
    { "key": "high_potential", "value": "23", ... }
  ]
}

API — Notifications

GET /api/notifications

Liste des notifications, triées par date décroissante.

{
  "notifications": [
    {
      "id": 1,
      "title": "Nouvelle évaluation",
      "message": "Antoine Moreau a complété son auto-évaluation",
      "timestamp": "2025-01-15T10:30:00Z",
      "is_read": 0,
      "icon": "eval",
      "target_page": "/BackOffice/antoine-moreau.html"
    }
  ]
}

POST /api/notifications/read

Marque toutes les notifications comme lues. Body vide.

// Response
{ "success": true }

API — Search

GET /api/search?q=...

Proxy vers l'API Brave Search. Utilisé pour la recherche contextuelle.

Langflow — ChatbotFAQ

POST /api/chat

Proxy vers le flow Langflow ChatbotFAQ. Répond aux questions RH des collaborateurs.

// Request
{ "message": "Combien de jours de congés me reste-t-il ?" }

// Response
{ "response": "Selon votre solde actuel, il vous reste..." }

Langflow — Extraction CV

POST /api/extract-cv

Upload de CV (PDF/DOCX) pour extraction automatique des compétences via Langflow.

// Response
{
  "results": [
    { "file": "cv-moreau.pdf", "result": "Compétences extraites : ..." }
  ]
}

Langflow — Matching Évolution

POST /api/matching

Déclenche le pipeline de matching candidat/poste via Langflow.

// Request
{ "action": "start" }

// Response
{ "status": "running", "result": "Pipeline démarré pour 847 collaborateurs..." }

Mode DEMO / PROD / DOC

Un toggle 3 boutons est présent dans la topbar de toutes les pages. Le mode est persisté via localStorage('sodexo_mode').

JavaScript (/shared/mode.js)

var SODEXO_MODE = localStorage.getItem('sodexo_mode') || 'demo';

function setMode(mode) {
  SODEXO_MODE = mode;
  localStorage.setItem('sodexo_mode', mode);
  // Met à jour les boutons + appelle onModeChange() si défini
}

function apiFetch(endpoint) {
  return fetch('/api' + endpoint).then(function(r) { return r.json(); });
}

function apiPost(endpoint, data) {
  return fetch('/api' + endpoint, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(data)
  }).then(function(r) { return r.json(); });
}

Design Tokens

Variables CSS définies dans /shared/dashboard.css :

Vues par rôle

Les pages profils disposent de 3 vues avec des informations différentes selon le rôle :

Le toggle de rôle est dans la topbar des pages profils. Il ajoute la classe role-{role} sur <body> et le CSS masque les sections non autorisées.

Variables d'environnement

Déploiement

wrangler.toml

name = "sodexo"
compatibility_date = "2024-01-01"
pages_build_output_dir = "."

[[d1_databases]]
binding = "DB"
database_name = "sodexo-talent"
database_id = "<ID>"

Commandes

# Déploiement via GitHub (auto)
git add . && git commit -m "deploy" && git push

# Ou déploiement direct
npx wrangler pages deploy .

# Migration DB
npx wrangler d1 execute sodexo-talent --file=schema.sql
npx wrangler d1 execute sodexo-talent --file=seed.sql

TalentVision Documentation — Sodexo Ma Carrière — Généré par Claude Code