Turnover Predictor

Tu construis Turnover Predictor, une extension du Hackathon BraindCode.

Projet : Turnover Predictor
Produit cible : RapidoRH
Type de projet : Orchestrateur — Un noyau d’exécution unique qui enchaîne plusieurs outils et plusieurs produits en routines.
Promesse : risque de départ
Problème : Les équipes RH suivent risque de départ dans des dossiers, plannings et échanges séparés. Les managers voient les tensions tardivement et les collaborateurs comprennent mal les critères employés. Les données sont sensibles et une synthèse non sourcée peut créer une décision injuste. Turnover Predictor doit aider à préparer et expliquer, sans prendre seul une décision concernant une personne.
Objectif : Donner aux utilisateurs de RapidoRH une vue fiable de risque de départ, en rendant visibles les sources, les règles et les validations humaines nécessaires.

PILE TECHNIQUE
TanStack Start, React, Tailwind, composants shadcn, Lovable Cloud pour l’authentification, la base de données et les fonctions serveur. Tous les appels MCP passent par des fonctions serveur.

IDENTITÉ VISUELLE
CHARTE GRAPHIQUE — RapidoRH

Logo officiel du logiciel : https://build.braindcode.com/__l5e/assets-v1/d1c4e6d8-221b-4162-8ad1-3b87ace8d5cc/rapidorh-logo.png

Logo BraindCode : https://build.braindcode.com/__l5e/assets-v1/b8ab3ddf-7aea-424d-9772-b9ef3a681d1d/braindcode-logo.jpg

Couleurs :
- primary : #7E57C2
- night : #161B2C
- ink : #0F172A
- surface : #FFFFFF
- surface_alt : #F8F5FC
- border : #E5DCF2
- success : #10B981
- warning : #F59E0B
- danger : #EF4444

Typographie : titres Poppins, 600 / corps Poppins, 400 / technique JetBrains Mono.
Titre 30/38, sous-titre 18/26, corps 15/24, heures et durées en tabular-nums.

Rayon 8 px pour les cartes et champs, 6 px pour les boutons, 999 px pour les badges.
Échelle 4 / 8 / 12 / 16 / 24 / 32 / 48. Interface dense : préfère 12 et 16 dans les tableaux.
Icônes lucide-react, trait 1.5 px, taille 16 ou 20 px, jamais colorées en plein.

Règles d'interface :
- Interface RH : planning en grille horaire, charge d'équipe en barres sobres.
- Personnes représentées par leurs initiales dans une pastille, jamais par une photo générée.
- Données sensibles (salaire, évaluation, absence médicale) masquées par défaut, révélées sur action explicite.
- Matrice de compétences en badges de teinte violette graduée, échelle 1 à 5 annoncée en clair.

Interdits :
- Aucun emoji, nulle part.
- Aucun rendu 3D photoréaliste ni illustration décorative générique.
- Aucun dégradé violet/indigo sur fond blanc.
- Aucun logo de marque inventé : n'utilise que les URL de logo fournies.
- La couleur du logiciel reste un accent (bordures, badges, filets, états actifs), jamais un aplat de fond plein écran.

VISUELS DU PROJET
- Image officielle du projet (couverture 16:9) : https://build.braindcode.com/__l5e/assets-v1/48b94465-ffea-43d1-8cf5-0d1ce987aca4/turnover-predictor.jpg
- Accroche : risque de départ
- Punchline : Donner aux utilisateurs de RapidoRH une vue fiable de risque de départ, en rendant visibles les sources, les règles et les validations humaines nécessaires.
- Logo du logiciel : https://build.braindcode.com/__l5e/assets-v1/d1c4e6d8-221b-4162-8ad1-3b87ace8d5cc/rapidorh-logo.png
- Logo BraindCode : https://build.braindcode.com/__l5e/assets-v1/b8ab3ddf-7aea-424d-9772-b9ef3a681d1d/braindcode-logo.jpg
Reprends l'accroche et la punchline dans l'écran d'accueil et la page de partage. Réutilise l'image officielle comme visuel de couverture, ne la remplace pas par une image générée.

VARIABLES CSS À DÉCLARER
--color-primary: #7E57C2;
--color-night: #161B2C;
--color-ink: #0F172A;
--color-surface: #FFFFFF;
--color-surface-alt: #F8F5FC;
--color-border: #E5DCF2;
--color-success: #10B981;
--color-warning: #F59E0B;
--color-danger: #EF4444;
--font-heading: Poppins, 600;
--font-body: Poppins, 400;
--font-mono: JetBrains Mono;

Tu vas produire l'interface d'une extension tierce du logiciel RapidoRH, éditée par un développeur indépendant dans le cadre du Hackathon BraindCode.\n\nIDENTITÉ À RESPECTER\nMon extension est un produit distinct : elle porte son propre nom et sa propre identité, mais elle doit être visuellement compatible avec RapidoRH et signaler clairement son appartenance à l'écosystème BraindCode.\n\nCouleur d'accent produit : #7E57C2\nTypographie produit : Arial / Poppins, fallback Poppins\nLogo produit : https://build.braindcode.com/__l5e/assets-v1/d1c4e6d8-221b-4162-8ad1-3b87ace8d5cc/rapidorh-logo.png, à afficher uniquement dans une mention d'appartenance du type « Extension pour RapidoRH », jamais comme logo principal de mon application.\n\nRÈGLES D'USAGE DES LOGOS\nNe jamais déformer, incliner, recolorer ou recomposer le logo RapidoRH ni le logo BraindCode.\nNe jamais laisser croire que l'extension est éditée par BraindCode.\nRespecter la zone de protection autour de chaque logo.\n\nSYSTÈME VISUEL DEMANDÉ\nFond clair par défaut, surfaces sombres en #161B2C, texte #000000, gris de bordure #C1C1C1, une seule couleur d'accent : #7E57C2. Monospace pour tout élément technique.\nComposants : cartes, tableaux denses, badges d'état, barre latérale de navigation.\nInterface en français, sobre, orientée métier.

MVP À LIVRER
- tableau de synthèse de risque de départ
- liste filtrable par équipe et période
- fiche détaillée avec sources
- explication des alertes ou recommandations
- suivi des validations

DONNÉES NÉCESSAIRES
- collaborateurs et structures
- postes, compétences et contrats
- temps, absences et plannings
- historiques et indicateurs RH

ENTITÉS À MODÉLISER
- collaborateur
- équipe
- poste
- événement RH
- recommandation

CAPACITÉS MCP À COUVRIR (à découvrir à l’exécution, jamais en dur)
- lire les référentiels RH autorisés
- consulter les événements et historiques
- filtrer par équipe, période et statut
- obtenir des agrégats sans exposer plus de données que nécessaire

Connecte d'abord le serveur BraindCode Build à l'adresse https://build.braindcode.com/api/mcp. Utilise get_project_context pour récupérer le contexte de cette idée et list_connectors pour connaître uniquement les connecteurs réellement configurés. N'invente jamais d'adresse MCP tierce.

Serveur MCP concerné : RapidoRH — récupère son adresse avec get_project_context. Authentification OAuth 2.0 révocable. Prévois néanmoins la connexion de plusieurs serveurs : un seul mécanisme, plusieurs connecteurs découverts via list_connectors.

CONNEXION AUX SERVEURS MCP (RapidoRH)

Construis une couche de connexion MCP générique, utilisable pour FoodEatUp, RapidoCRM, RapidoCMS et RapidoRH.

1. Table de connecteurs : clé du serveur, nom affiché, URL HTTPS, type d'authentification (aucun, clé, OAuth), statut (connecte, deconnecte, erreur), dernier test, message d'erreur. Lecture réservée aux comptes autorisés.
2. Table de secrets séparée : jeton d'accès, jeton de rafraîchissement, clé API, expiration. Jamais lisible depuis le navigateur, jamais renvoyée par une fonction serveur.
3. Dialogue MCP en JSON-RPC 2.0 sur HTTP « Streamable » côté serveur uniquement :
   - en-têtes : Content-Type: application/json et Accept: application/json, text/event-stream ;
   - séquence : initialize (protocolVersion 2025-06-18), puis notifications/initialized, puis tools/list, puis tools/call ;
   - conserver l'identifiant de session renvoyé dans l'en-tête Mcp-Session-Id et le renvoyer sur les appels suivants ;
   - accepter aussi bien une réponse JSON qu'un flux d'événements, en extrayant les lignes data: ;
   - délai maximum 15 secondes, messages d'erreur lisibles (injoignable, non autorisé, délai dépassé).
4. Écran d'administration des connecteurs : une carte par produit avec son logo et sa couleur d'accent, champ URL, choix d'authentification, bouton « Tester la connexion », pastille de statut et nombre d'outils découverts.
5. L'URL de chaque serveur MCP est saisie dans cet écran. N'invente jamais une adresse et n'en code aucune en dur.

OUTILS DÉCOUVERTS À L'EXÉCUTION

1. Après chaque connexion réussie, appelle tools/list et enregistre pour chaque outil : nom, titre, description, schéma d'entrée, serveur d'origine et indicateur « lecture seule / modifiant / destructif ».
2. Construis un registre unifié en mémoire, indexé par nom normalisé, fusionnant les outils de tous les serveurs connectés. En cas de doublon, préfixe par la clé du serveur.
3. Expose une recherche d'outil par intention en français (mots-clés sur le nom, le titre et la description) afin que l'assistant choisie l'outil pertinent sans liste figée.
4. N'écris jamais un nom d'outil MCP en dur dans le code ni dans l'interface : tout part du registre. Si un outil attendu est absent, affiche-le honnêtement plutôt que de simuler.
5. Valide systématiquement les paramètres contre le schéma d'entrée réel avant tout appel, et affiche les erreurs de validation à l'utilisateur.
6. Prévois un rafraîchissement manuel du registre et un affichage « N outils disponibles sur M serveurs ».

ORCHESTRATEUR D'EXÉCUTION

Tous les chemins d'appel d'outil (interface, assistant, routine automatique) passent par un noyau serveur unique. Ce noyau, et lui seul, réalise dans cet ordre :

1. Résolution de l'outil dans le registre unifié.
2. Validation des paramètres contre le schéma réel ; refus explicite sans consommation de quota.
3. Garde-fou : toute action modifiante ou destructrice exige une confirmation humaine explicite, transmise comme paramètre de confirmation. Sans elle, refus.
4. Consommation d'un quota par compte et par jour, avec refus lisible quand il est épuisé.
5. Journal d'exécution : outil, serveur, paramètres non sensibles, statut, durée, résultat résumé, erreur éventuelle.
6. Retour d'un résultat typé succès/échec, jamais une exception brute.

Ajoute au-dessus un planificateur : à partir d'une demande en langage naturel, il propose une suite d'étapes (outil + paramètres), l'affiche pour validation, puis l'exécute étape par étape avec possibilité d'arrêt. Les routines enregistrées rejouent une suite d'étapes et sont visibles dans un tableau de bord : dernières exécutions, taux de succès, durée moyenne, erreurs récentes.

SÉCURITÉ — RÈGLES NON NÉGOCIABLES

1. Aucun jeton, clé ou identifiant MCP dans le navigateur, dans le code source, dans une variable publique ou dans un journal.
2. Seules les URL HTTPS sont acceptées. Refuse les adresses locales, les réseaux privés et les redirections automatiques.
3. Tout appel MCP part du serveur. Le navigateur n'envoie qu'une intention et des paramètres validés.
4. Chaque appel est journalisé sans secret : utilisateur, serveur, outil, statut, durée.
5. Les actions destructrices exigent une confirmation humaine explicite et sont toujours réversibles ou tracées.
6. Les données affichées respectent les droits du compte connecté : jamais d'élévation de privilèges pour « faire fonctionner » une fonctionnalité.
7. Aucune donnée client réelle en démonstration : jeu de données fictif crédible.

TESTS ET LIVRABLES

1. Tests automatiques : validation des paramètres, refus d'une action sensible non confirmée, épuisement du quota, serveur MCP injoignable, outil absent du registre.
2. Tests manuels documentés : connexion d'un serveur, découverte des outils, exécution d'une action lecture, exécution d'une action sensible confirmée, consultation du journal.
3. États d'interface à couvrir : vide, chargement, erreur, résultat, confirmation.
4. Rapport de tests exportable, avec date, périmètre et résultats.
5. Livrables : dépôt public, serveur MCP de l'extension documenté et joignable, déclaration dans Plan'It, plugin publié sur plugin.braindcode.com, validation par un modèle tiers (Claude, Mistral ou OpenAI).
6. Vérifie le rendu sur ordinateur et sur téléphone avant de considérer le projet terminé.

Ajoute à ce projet la couche d'accès au serveur MCP RapidoRH, hébergé par une application Laravel.\n\nRÈGLE NON NÉGOCIABLE\nAucun jeton, aucune clé, aucun identifiant MCP ne doit exister côté navigateur. Tout appel passe par une fonction serveur qui joue le rôle de proxy.\n\nÀ CONSTRUIRE\n1. Une fonction serveur mcp-proxy qui reçoit une action et ses paramètres, ajoute l'authentification depuis les secrets du projet, appelle le serveur MCP, et renvoie la réponse. Les secrets ne sont jamais journalisés.\n2. Une authentification par jeton porteur émis par Laravel, avec rafraîchissement et gestion de l'expiration. Sur 401, demander une reconnexion sans réessayer en boucle.\n3. Une découverte dynamique des outils au démarrage : lister les outils exposés, les mettre en cache pour la session, ne jamais coder une liste en dur.\n4. Une isolation stricte par établissement ou compte client ; refuser tout appel sans périmètre.\n5. Une distinction lecture / écriture avec confirmation explicite avant toute écriture.\n6. Un journal des appels : horodatage, outil, périmètre, statut, durée.\n7. Des erreurs lisibles en français avec comportement de repli.\n\nÀ NE PAS FAIRE\nN'invente aucun nom d'outil : construis le code autour de la liste découverte à l'exécution. N'implémente aucune écriture avant que la lecture ne fonctionne de bout en bout.

Les skills, routines et plugins publiables se trouvent sur https://plugin.braindcode.com. Cette marketplace complète le MCP BraindCode mais ne remplace pas son adresse de connexion.

ROUTINE & LOOP-ENGINEERING
Une extension livrée ne vaut que par ce qu'elle fait tourner. Connecte-toi au serveur MCP de la marketplace de prompts et de routines : https://plugin.braindcode.com/mcp (catalogue public sur https://plugin.braindcode.com).
Outils de routine disponibles côté marketplace : chercher_prompts, prompts_pour_agent, lister_routines, obtenir_routine, proposer_routine, mettre_a_jour_routine, planifier_routine, installer_routine, enregistrer_execution_routine, journal_routine, auditer_routines, rendre_verdict_routine, promouvoir_routine, lister_boucles, obtenir_boucle, definir_kpi, enregistrer_kpi, serie_kpi, rattacher_kpi_routine, alertes_kpi, tableau_de_bord, ma_semaine, lister_mcp, routines_pour_mcp. Découvre-les à l'exécution, n'en code aucun en dur.
Avant d'écrire du code, cherche s'il existe déjà une routine ou un prompt éprouvé pour RapidoRH et repars de là.
Quand le projet est livré, écris sa routine par défaut avec les six champs obligatoires — objectif chiffré et échéance, déclencheur, outils MCP autorisés, garde-fous chiffrés, point d'arrêt humain, mesure (KPI et sa source) — fais-la auditer avec auditer_routines, puis propose-la avec proposer_routine. Elle s'exécutera ensuite dans Plan'It.
Points d'arrêt humains non négociables : dépenser de l'argent, publier publiquement, écrire à un client, signer. L'agent prépare, l'humain valide. Aucune clé d'API ni jeton dans un prompt ou dans le navigateur.

ÉCRANS À CONSTRUIRE
- tableau de bord
- liste des collaborateurs ou événements
- détail d’un signal
- paramètres et droits

ÉTATS À GÉRER
- chargement
- aucune donnée
- données sensibles masquées
- validation requise
- action confirmée

ACTIONS SENSIBLES — CONFIRMATION HUMAINE OBLIGATOIRE
- modifier le dossier d’un collaborateur
- valider un contrat, une absence ou une dépense
- envoyer une communication RH

NOTES DE CADRAGE
Commencer sur un jeu de données fictif et limiter chaque lecture au strict nécessaire. Expliquer les critères sans produire de classement opaque. Toute décision individuelle reste sous contrôle d’un responsable habilité.

SUIVI BRAINDCODE
Enregistre l'avancement avec save_project_progress, utilise check_project_readiness avant la publication, puis publish_project pour créer la vitrine publique sur build.braindcode.com.