cyrille-elie commited on
Commit
918a304
·
1 Parent(s): 3995c84

Docs: Update to README.md

Browse files
Files changed (1) hide show
  1. README.md +34 -1
README.md CHANGED
@@ -201,4 +201,37 @@ Voici un test rapide pour vérifier que l'API est en ligne (nécessite que l'API
201
 
202
  ```bash
203
  curl -X GET "[http://127.0.0.1:8000/](http://127.0.0.1:8000/)"
204
- ```
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
201
 
202
  ```bash
203
  curl -X GET "[http://127.0.0.1:8000/](http://127.0.0.1:8000/)"
204
+ ```
205
+
206
+ ## 🛠️ Maintenance et Protocole de Mise à Jour
207
+
208
+ Pour assurer la pertinence et la performance continue de ce modèle de prédiction d'attrition, le protocole de mise à jour suivant est envisagé :
209
+
210
+ 1. **Surveillance des Performances :**
211
+ * Les prédictions de l'API étant enregistrées dans la table `api_prediction_logs`, il sera possible (avec un outillage futur) de comparer ces prédictions aux départs réels observés pour évaluer la performance du modèle en continu.
212
+ * Une baisse significative des métriques clés (ex: F2-score, rappel pour la classe "départ") indiquera un besoin de ré-évaluation.
213
+
214
+ 2. **Ré-entraînement du Modèle :**
215
+ * **Fréquence :** Un ré-entraînement est à envisager :
216
+ * Périodiquement (ex: tous les 6 mois ou annuellement) avec les données les plus récentes de la table `employees`.
217
+ * Lorsque de nouvelles features pertinentes sont identifiées et ajoutées.
218
+ * Si une dérive significative des données d'entrée est détectée.
219
+ * Si les performances du modèle en production baissent en dessous d'un seuil acceptable.
220
+ * **Procédure :** Le script `src/modeling/train_model.py` est utilisé pour le ré-entraînement. Le nouveau modèle sauvegardé devra ensuite être redéployé.
221
+
222
+ 3. **Mise à Jour des Données d'Entraînement :**
223
+ * Un processus régulier (à définir) pour mettre à jour la table `employees` avec les données RH les plus récentes est nécessaire pour que les ré-entraînements soient basés sur des informations à jour. Cela pourrait impliquer de relancer périodiquement une version adaptée de `scripts/populate_employees_table.py` ou un pipeline ETL plus robuste.
224
+
225
+ 4. **Revue des Features :**
226
+ * Périodiquement, il est bon de revoir la pertinence des features utilisées et d'explorer si de nouvelles données disponibles pourraient améliorer le modèle.
227
+
228
+ 5. **Mise à Jour des Dépendances :**
229
+ * Les dépendances du projet (Python, librairies) doivent être mises à jour régulièrement pour des raisons de sécurité et pour bénéficier des dernières améliorations.
230
+ * Utiliser `poetry show --outdated` pour identifier les dépendances obsolètes.
231
+ * Mettre à jour avec `poetry update <nom_librairie>` ou `poetry update`.
232
+ * **Crucial :** Après une mise à jour des dépendances, relancer l'intégralité des tests et potentiellement un ré-entraînement/évaluation pour s'assurer de la non-régression.
233
+
234
+ 6. **Documentation :**
235
+ * Toute modification significative du modèle, des features, de l'architecture, ou du processus de ré-entraînement doit être reflétée dans cette documentation.
236
+
237
+ Ce protocole initial servira de base et pourra être affiné avec le temps et l'expérience acquise sur le modèle en production (ou en simulation de production).