#!/usr/bin/env python3 """ Schémas Pydantic pour validation des données d'entrée de l'API. Ces schémas correspondent aux colonnes brutes du dataset avant preprocessing, permettant une validation stricte des inputs avec messages d'erreur clairs. """ from enum import Enum from typing import Annotated from pydantic import BaseModel, BeforeValidator, ConfigDict, Field def validate_augmentation(v): """Nettoie le format de l'augmentation (enlève % si présent).""" if isinstance(v, str): v = float(v.replace(" %", "").replace("%", "")) return v # Enums pour les valeurs catégorielles class GenreEnum(str, Enum): """Genre de l'employé.""" M = "M" F = "F" class StatutMaritalEnum(str, Enum): """Statut marital de l'employé.""" CELIBATAIRE = "Célibataire" MARIE = "Marié(e)" DIVORCE = "Divorcé(e)" class DepartementEnum(str, Enum): """Département de l'employé.""" COMMERCIAL = "Commercial" CONSULTING = "Consulting" RESSOURCES_HUMAINES = "Ressources Humaines" class DomaineEtudeEnum(str, Enum): """Domaine d'études de l'employé.""" INFRA_CLOUD = "Infra & Cloud" TRANSFORMATION_DIGITALE = "Transformation Digitale" MARKETING = "Marketing" ENTREPREUNARIAT = "Entrepreunariat" RESSOURCES_HUMAINES = "Ressources Humaines" AUTRE = "Autre" class PosteEnum(str, Enum): """Poste de l'employé.""" CADRE_COMMERCIAL = "Cadre Commercial" ASSISTANT_DIRECTION = "Assistant de Direction" CONSULTANT = "Consultant" TECH_LEAD = "Tech Lead" MANAGER = "Manager" SENIOR_MANAGER = "Senior Manager" REPRESENTANT_COMMERCIAL = "Représentant Commercial" DIRECTEUR_TECHNIQUE = "Directeur Technique" RESSOURCES_HUMAINES = "Ressources Humaines" class FrequenceDeplacementEnum(str, Enum): """Fréquence des déplacements professionnels.""" AUCUN = "Aucun" OCCASIONNEL = "Occasionnel" FREQUENT = "Frequent" class AyantEnfantsEnum(str, Enum): """L'employé a des enfants.""" OUI = "Y" NON = "N" class HeureSupplementairesEnum(str, Enum): """L'employé fait des heures supplémentaires.""" OUI = "Oui" NON = "Non" class EmployeeInput(BaseModel): """ Schéma de validation pour les données d'entrée d'un employé. Tous les champs correspondent aux colonnes brutes des 3 fichiers CSV (sondage, eval, sirh) avant preprocessing. """ # === Données SONDAGE === nombre_participation_pee: int = Field( ..., ge=0, le=3, description="Nombre de participations au PEE (0-3)" ) nb_formations_suivies: int = Field( ..., ge=0, le=6, description="Nombre de formations suivies (0-6)" ) nombre_employee_sous_responsabilite: int = Field( default=1, ge=1, le=1, description="Nombre d'employés sous responsabilité (fixe: 1)", ) distance_domicile_travail: int = Field( ..., ge=1, le=30, description="Distance domicile-travail en km (1-30)" ) niveau_education: int = Field( ..., ge=1, le=5, description="Niveau d'éducation (1-5)" ) domaine_etude: DomaineEtudeEnum = Field(..., description="Domaine d'études") ayant_enfants: AyantEnfantsEnum = Field(..., description="A des enfants (Y/N)") frequence_deplacement: FrequenceDeplacementEnum = Field( ..., description="Fréquence des déplacements" ) annees_depuis_la_derniere_promotion: int = Field( ..., ge=0, description="Années depuis la dernière promotion" ) annes_sous_responsable_actuel: int = Field( ..., ge=0, le=17, description="Années sous le responsable actuel (0-17)" ) # === Données EVALUATION === satisfaction_employee_environnement: int = Field( ..., ge=1, le=4, description="Satisfaction environnement (1-4)" ) note_evaluation_precedente: int = Field( ..., ge=1, le=4, description="Note évaluation précédente (1-4)" ) niveau_hierarchique_poste: int = Field( ..., ge=1, le=5, description="Niveau hiérarchique (1-5)" ) satisfaction_employee_nature_travail: int = Field( ..., ge=1, le=4, description="Satisfaction nature du travail (1-4)" ) satisfaction_employee_equipe: int = Field( ..., ge=1, le=4, description="Satisfaction équipe (1-4)" ) satisfaction_employee_equilibre_pro_perso: int = Field( ..., ge=1, le=4, description="Satisfaction équilibre pro/perso (1-4)" ) note_evaluation_actuelle: int = Field( ..., ge=3, le=4, description="Note évaluation actuelle (3-4)" ) heure_supplementaires: HeureSupplementairesEnum = Field( ..., description="Fait des heures supplémentaires" ) augementation_salaire_precedente: Annotated[ float, BeforeValidator(validate_augmentation) ] = Field( default=..., ge=0, le=100, description="Augmentation salaire précédente (%)" ) # === Données SIRH === age: int = Field(..., ge=18, le=60, description="Âge de l'employé (18-60)") genre: GenreEnum = Field(..., description="Genre") revenu_mensuel: float = Field( ..., ge=1000, le=20000, description="Revenu mensuel (€) (1000-20000)" ) statut_marital: StatutMaritalEnum = Field(..., description="Statut marital") departement: DepartementEnum = Field(..., description="Département") poste: PosteEnum = Field(..., description="Intitulé du poste") nombre_experiences_precedentes: int = Field( ..., ge=0, le=9, description="Nombre d'expériences précédentes (0-9)" ) nombre_heures_travailless: int = Field( default=80, ge=80, le=80, description="Nombre d'heures travaillées par semaine (fixe: 80)", ) annee_experience_totale: int = Field( ..., ge=0, description="Années d'expérience totale" ) annees_dans_l_entreprise: int = Field( ..., ge=0, le=40, description="Années dans l'entreprise (0-40)" ) annees_dans_le_poste_actuel: int = Field( ..., ge=0, le=18, description="Années dans le poste actuel (0-18)" ) model_config = ConfigDict( json_schema_extra={ "example": { # Exemple basé sur la première ligne des CSV "nombre_participation_pee": 0, "nb_formations_suivies": 0, "nombre_employee_sous_responsabilite": 1, "distance_domicile_travail": 1, "niveau_education": 2, "domaine_etude": "Infra & Cloud", "ayant_enfants": "Y", "frequence_deplacement": "Occasionnel", "annees_depuis_la_derniere_promotion": 0, "annes_sous_responsable_actuel": 5, "satisfaction_employee_environnement": 2, "note_evaluation_precedente": 3, "niveau_hierarchique_poste": 2, "satisfaction_employee_nature_travail": 4, "satisfaction_employee_equipe": 1, "satisfaction_employee_equilibre_pro_perso": 1, "note_evaluation_actuelle": 3, "heure_supplementaires": "Oui", "augementation_salaire_precedente": 11.0, "age": 41, "genre": "F", "revenu_mensuel": 5993.0, "statut_marital": "Célibataire", "departement": "Commercial", "poste": "Cadre Commercial", "nombre_experiences_precedentes": 8, "nombre_heures_travailless": 80, "annee_experience_totale": 8, "annees_dans_l_entreprise": 6, "annees_dans_le_poste_actuel": 4, } } ) class PredictionOutput(BaseModel): """Schéma de sortie pour les prédictions.""" prediction: int = Field(..., description="Classe prédite (0=reste, 1=part)") probability_0: float = Field( ..., ge=0, le=1, description="Probabilité de rester (classe 0)" ) probability_1: float = Field( ..., ge=0, le=1, description="Probabilité de partir (classe 1)" ) risk_level: str = Field(..., description="Niveau de risque (Low/Medium/High)") model_config = ConfigDict( json_schema_extra={ "example": { "prediction": 1, "probability_0": 0.35, "probability_1": 0.65, "risk_level": "High", } } ) class HealthCheck(BaseModel): """Schéma pour le endpoint health check.""" status: str = Field(..., description="Status de l'API") model_loaded: bool = Field(..., description="Modèle chargé ou non") model_type: str = Field(..., description="Type du modèle") version: str = Field(..., description="Version de l'API") model_config = ConfigDict( json_schema_extra={ "example": { "status": "healthy", "model_loaded": True, "model_type": "Pipeline", "version": "1.0.0", } } ) class EmployeePrediction(BaseModel): """Prédiction pour un employé dans le batch.""" employee_id: int = Field(..., description="ID de l'employé") prediction: int = Field(..., description="Classe prédite (0=reste, 1=part)") probability_stay: float = Field( ..., ge=0, le=1, description="Probabilité de rester" ) probability_leave: float = Field( ..., ge=0, le=1, description="Probabilité de partir" ) risk_level: str = Field(..., description="Niveau de risque (Low/Medium/High)") class BatchPredictionOutput(BaseModel): """Schéma de sortie pour les prédictions par lots (CSV).""" total_employees: int = Field(..., description="Nombre total d'employés traités") predictions: list[EmployeePrediction] = Field( ..., description="Liste des prédictions" ) summary: dict = Field(..., description="Résumé des prédictions") model_config = ConfigDict( json_schema_extra={ "example": { "total_employees": 100, "predictions": [ { "employee_id": 1, "prediction": 0, "probability_stay": 0.85, "probability_leave": 0.15, "risk_level": "Low", } ], "summary": { "total_stay": 80, "total_leave": 20, "high_risk_count": 15, "medium_risk_count": 10, "low_risk_count": 75, }, } } )