🚀 Auto-deploy from GitHub Actions

.github/workflows/deploy.yml

@@ -1,4 +1,4 @@
-name: Deploy to Hugging Face Spaces
+name: Deploiement vers Hugging Face Spaces
 
 on:
   push:
@@ -19,12 +19,16 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v5
         with:
-          python-version: "3.10"
+          python-version: "3.11"
 
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
           if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+          pip install -e .
+
+      - name: Préparer les données et le modèle
+        run: python main.py
 
       - name: Deploy to Hugging Face Space
         env:
@@ -33,7 +37,7 @@ jobs:
           git config --global user.email "actions@github.com"
           git config --global user.name "GitHub Actions"
           git clone https://huggingface.co/spaces/stephmnt/projet_05 hf_space
-          rsync -av --exclude '.git' --exclude 'output/' --exclude 'models/' ./ hf_space/
+          rsync -av --exclude '.git' --exclude 'docs' ./ hf_space/
           cd hf_space
           git add .
           git commit -m "🚀 Auto-deploy from GitHub Actions" || echo "No changes to commit"

.github/workflows/static.yml

@@ -0,0 +1,37 @@
+name: Deploiement de la documentation
+
+on:
+  push:
+    branches: ["main"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: 'docs/site'
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -1,19 +1,18 @@
-# Data
-/data/
-
-# Mac OS-specific storage files
+# Spécifique à ce projet
 .DS_Store
 *.code-workspace
 *.pdf
 /output/
 questions.md
-*.pdf
-
+/reports/
+/data/
+runtime.txt
 
 # vim
 *.swp
 *.swo
 
+
 ## https://github.com/github/gitignore/blob/e8554d85bf62e38d6db966a50d2064ac025fd82a/Python.gitignore
 
 # Byte-compiled / optimized / DLL files
@@ -86,9 +85,6 @@ instance/
 # Scrapy stuff:
 .scrapy
 
-# MkDocs documentation
-docs/site/
-
 # PyBuilder
 .pybuilder/
 target/
@@ -166,9 +162,6 @@ venv.bak/
 # Rope project settings
 .ropeproject
 
-# mkdocs documentation
-/site
-
 # mypy
 .mypy_cache/
 .dmypy.json

README.md

@@ -10,13 +10,14 @@ pinned: true
 short_description: Projet 05 formation Openclassrooms
 ---
 
-# projet_05
+# projet_05 : Déployez un modèle de Machine Learning
 
 <a target="_blank" href="https://cookiecutter-data-science.drivendata.org/">
     <img src="https://img.shields.io/badge/CCDS-Project%20template-328F97?logo=cookiecutter" />
 </a>
 
-Déployez un modèle de Machine Learning
+[![mkdocs-shield]][mkdocs-url]
+
 
 ## Organisation du projet
 
@@ -305,10 +306,6 @@ Project Link: [https://github.com/github_username/repo_name](https://github.com/
 [stars-url]: https://github.com/stephmnt/OCR_projet05/stargazers
 [issues-shield]: https://img.shields.io/github/issues/stephmnt/OCR_projet05.svg?style=for-the-badge
 [issues-url]: https://github.com/stephmnt/OCR_projet05/issues
-[license-shield]: https://img.shields.io/github/license/stephmnt/OCR_projet05.svg?style=for-the-badge
-[license-url]: https://github.com/stephmnt/OCR_projet05/blob/master/LICENSE.txt
-[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
-[linkedin-url]: https://linkedin.com/in/stephanemanet
 [product-screenshot]: images/screenshot.png
 [Noobie]: https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16
 <!-- Shields.io badges. You can a comprehensive list with many more badges at: https://github.com/inttter/md-badges -->
@@ -328,9 +325,15 @@ Project Link: [https://github.com/github_username/repo_name](https://github.com/
 [Bootstrap-url]: https://getbootstrap.com
 [JQuery.com]: https://img.shields.io/badge/jQuery-0769AD?style=for-the-badge&logo=jquery&logoColor=white
 [JQuery-url]: https://jquery.com 
+<!-- OK -->
+[license-shield]: https://img.shields.io/github/license/stephmnt/OCR_projet05.svg?style=for-the-badge
+[license-url]: https://github.com/stephmnt/OCR_Projet05/blob/main/LICENSE
+[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
+[linkedin-url]: https://linkedin.com/in/stephanemanet
 <!-- TODO: -->
-[Postgres]: https://img.shields.io/badge/Postgres-%23316192.svg?logo=postgresql&logoColor=white
-[Python]: https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=fff)
-[MkDocs]: https://img.shields.io/badge/MkDocs-526CFE?logo=materialformkdocs&logoColor=fff
+[postgres-shield]: https://img.shields.io/badge/Postgres-%23316192.svg?logo=postgresql&logoColor=white
+[python-shield]: https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=fff)
+[mkdocs-shield]: https://img.shields.io/badge/MkDocs-526CFE?logo=materialformkdocs&logoColor=fff
+[mkdocs-url]: https://stephmnt.github.io/OCR_Projet05/
 [NumPy]: https://img.shields.io/badge/NumPy-4DABCF?logo=numpy&logoColor=fff
-[![Pandas](https://img.shields.io/badge/Pandas-150458?logo=pandas&logoColor=fff)](#)
+[![Pandas](https://img.shields.io/badge/Pandas-150458?logo=pandas&logoColor=fff)](#)

app.py

@@ -17,12 +17,30 @@ SCHEMA_PATH = Path("data/processed/schema.json")
 
 
 def _load_schema(path: Path) -> dict[str, Any]:
+    """Load the schema definition stored as JSON.
+
+    Args:
+        path: Path to the schema.json file.
+
+    Returns:
+        A dictionary describing the schema or an empty dict if the file is missing.
+    """
     if not path.exists():
         return {}
     return json.loads(path.read_text(encoding="utf-8"))
 
 
 def _infer_features(metadata: dict, schema: dict, pipeline) -> list[str]:
+    """Infer the ordered list of features expected by the model.
+
+    Args:
+        metadata: Metadata produced during training.
+        schema: Schema derived from `features.py`.
+        pipeline: Loaded sklearn pipeline (optional).
+
+    Returns:
+        List of feature names in the order expected by the model.
+    """
     if schema:
         candidates = schema.get("numerical_features", []) + schema.get("categorical_features", [])
         if candidates:
@@ -37,6 +55,18 @@ def _infer_features(metadata: dict, schema: dict, pipeline) -> list[str]:
 
 
 def _convert_input(payload: Any, headers: list[str]) -> pd.DataFrame:
+    """Normalize any user input into a validated DataFrame.
+
+    Args:
+        payload: Raw table coming from Gradio (DataFrame, list, etc.).
+        headers: Expected column names.
+
+    Returns:
+        A sanitized DataFrame.
+
+    Raises:
+        gr.Error: If no valid row is provided.
+    """
     if isinstance(payload, pd.DataFrame):
         df = payload.copy()
     elif payload is None:
@@ -50,6 +80,7 @@ def _convert_input(payload: Any, headers: list[str]) -> pd.DataFrame:
 
 
 def _ensure_model():
+    """Ensure that a pipeline has been loaded before inference."""
     if PIPELINE is None:
         raise gr.Error(
             "Aucun modèle entrainé n'a été trouvé. Lancez `python projet_05/modeling/train.py` puis relancez l'application."
@@ -57,6 +88,7 @@ def _ensure_model():
 
 
 def score_table(table):
+    """Score data entered via the interactive table."""
     _ensure_model()
     df = _convert_input(table, FEATURE_ORDER)
     drop_cols = [TARGET_COLUMN] if TARGET_COLUMN else None
@@ -70,6 +102,7 @@ def score_table(table):
 
 
 def score_csv(upload):
+    """Score a CSV uploaded by the user."""
     _ensure_model()
     if upload is None:
         raise gr.Error("Veuillez déposer un fichier CSV.")
@@ -85,6 +118,7 @@ def score_csv(upload):
 
 
 def predict_from_form(*values):
+    """Score a single row coming from the form tab."""
     _ensure_model()
     if not FEATURE_ORDER:
         raise gr.Error("Impossible de générer le formulaire sans configuration des features.")
@@ -132,7 +166,7 @@ with gr.Blocks(title="Prédicteur d'attrition") as demo:
 
     if PIPELINE is None:
         gr.Markdown(
-            "⚠️ **Aucun modèle disponible.** Lancez les scripts `dataset.py`, `features.py` puis `modeling/train.py`."
+            "**Aucun modèle disponible.** Lancez les scripts `dataset.py`, `features.py` puis `modeling/train.py`."
         )
     else:
         gr.Markdown(f"Seuil de décision actuel : **{THRESHOLD:.2f}**")

hf_space/hf_space/.gitignore

@@ -4,6 +4,11 @@
 # Mac OS-specific storage files
 .DS_Store
 *.code-workspace
+*.pdf
+/output/
+questions.md
+*.pdf
+
 
 # vim
 *.swp

hf_space/hf_space/README.md

@@ -1,5 +1,3 @@
-# projet_05
-
 ---
 title: OCR_Projet05
 emoji: 🔥
@@ -12,6 +10,8 @@ pinned: true
 short_description: Projet 05 formation Openclassrooms
 ---
 
+# projet_05
+
 <a target="_blank" href="https://cookiecutter-data-science.drivendata.org/">
     <img src="https://img.shields.io/badge/CCDS-Project%20template-328F97?logo=cookiecutter" />
 </a>
@@ -76,17 +76,6 @@ Déployez un modèle de Machine Learning
 
 --------
 
----
-title: Projet 05
-emoji: 👀
-colorFrom: indigo
-colorTo: green
-sdk: gradio
-sdk_version: 5.49.1
-app_file: app.py
-pinned: false
----
-
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 <!-- Improved compatibility of back to top link: See: https://github.com/othneildrew/Best-README-Template/pull/73 -->
@@ -99,8 +88,6 @@ Check out the configuration reference at https://huggingface.co/docs/hub/spaces-
 *** Thanks again! Now go create something AMAZING! :D
 -->
 
-
-
 <!-- PROJECT SHIELDS -->
 <!--
 *** I'm using markdown "reference style" links for readability.
@@ -118,8 +105,6 @@ Check out the configuration reference at https://huggingface.co/docs/hub/spaces-
 [![LinkedIn][linkedin-shield]][linkedin-url]
 ![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/:user/:repo/:workflow)
 
-
-
 <!-- PROJECT LOGO -->
 <br />
 <div align="center">
@@ -143,8 +128,6 @@ Check out the configuration reference at https://huggingface.co/docs/hub/spaces-
   </p>
 </div>
 
-
-
 <!-- TABLE OF CONTENTS -->
 <details>
   <summary>Table of Contents</summary>
@@ -191,8 +174,6 @@ Here's a blank template to get started. To avoid retyping too much info, do a se
 
 <p align="right">(<a href="#readme-top">back to top</a>)</p>
 
-
-
 <!-- GETTING STARTED -->
 ## Getting Started
 
@@ -212,20 +193,19 @@ This is an example of how to list things you need to use the software and how to
 pip install -r requirements.txt
 uvicorn app.main:app --reload
 
-1. Get a free API Key at [https://example.com](https://example.com)
-2. Clone the repo
+1. Clone the repo
    ```sh
-   git clone https://github.com/github_username/repo_name.git
+   git clone https://github.com/stephmnt/OCR_Projet05.git
    ```
-3. Install NPM packages
+2. Install NPM packages
    ```sh
    npm install
    ```
-4. Enter your API in `config.js`
+3. Enter your API in `config.js`
    ```js
    const API_KEY = 'ENTER YOUR API';
    ```
-5. Change git remote url to avoid accidental pushes to base project
+4. Change git remote url to avoid accidental pushes to base project
    ```sh
    git remote set-url origin github_username/repo_name
    git remote -v # confirm the changes

hf_space/hf_space/hf_space/hf_space/.github/workflows/deploy.yml

@@ -33,8 +33,8 @@ jobs:
           git config --global user.email "actions@github.com"
           git config --global user.name "GitHub Actions"
           git clone https://huggingface.co/spaces/stephmnt/projet_05 hf_space
-          rsync -av --exclude '.git' ./ hf_space/
+          rsync -av --exclude '.git' --exclude 'output/' --exclude 'models/' ./ hf_space/
           cd hf_space
           git add .
           git commit -m "🚀 Auto-deploy from GitHub Actions" || echo "No changes to commit"
-          git push https://stephmnt:$HF_TOKEN@huggingface.co/spaces/stephmnt/projet_05 main
+          git push https://stephmnt:$HF_TOKEN@huggingface.co/spaces/stephmnt/projet_05 main

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/README.md

@@ -1,5 +1,17 @@
 # projet_05
 
+---
+title: OCR_Projet05
+emoji: 🔥
+colorFrom: purple
+colorTo: purple
+sdk: gradio
+sdk_version: 5.49.1
+app_file: app.py
+pinned: true
+short_description: Projet 05 formation Openclassrooms
+---
+
 <a target="_blank" href="https://cookiecutter-data-science.drivendata.org/">
     <img src="https://img.shields.io/badge/CCDS-Project%20template-328F97?logo=cookiecutter" />
 </a>
@@ -57,6 +69,11 @@ Déployez un modèle de Machine Learning
     └── plots.py                <- Code to create visualizations
 ```
 
+## Code hérité réutilisé
+
+- `scripts_projet04/brand` : charte graphique OpenClassrooms (classe `Theme`, palettes, YAML). Le module `projet_05/branding.py` en est la porte d'entrée et applique automatiquement le thème.
+- `scripts_projet04/manet_projet04/shap_generator.py` : fonctions `shap_global` / `shap_local` utilisées par `projet_05/modeling/train.py` pour reproduire les visualisations SHAP.
+
 --------
 
 ---
@@ -93,6 +110,7 @@ Check out the configuration reference at https://huggingface.co/docs/hub/spaces-
 *** https://www.markdownguide.org/basic-syntax/#reference-style-links
 -->
 [![Contributors][contributors-shield]][contributors-url]
+[![Python][python]][python]
 [![Forks][forks-shield]][forks-url]
 [![Stargazers][stars-shield]][stars-url]
 [![Issues][issues-shield]][issues-url]
@@ -236,7 +254,7 @@ _For more examples, please refer to the [Documentation](https://example.com)_
 - [ ] Feature 3
     - [ ] Nested Feature
 
-See the [open issues](https://github.com/github_username/repo_name/issues) for a full list of proposed features (and known issues).
+See the [open issues](https://github.com/stephmnt/OCR_projet05/issues) for a full list of proposed features (and known issues).
 
 <p align="right">(<a href="#readme-top">back to top</a>)</p>
 
@@ -299,18 +317,18 @@ Project Link: [https://github.com/github_username/repo_name](https://github.com/
 
 <!-- MARKDOWN LINKS & IMAGES -->
 <!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
-[contributors-shield]: https://img.shields.io/github/contributors/github_username/repo_name.svg?style=for-the-badge
-[contributors-url]: https://github.com/github_username/repo_name/graphs/contributors
-[forks-shield]: https://img.shields.io/github/forks/github_username/repo_name.svg?style=for-the-badge
-[forks-url]: https://github.com/github_username/repo_name/network/members
-[stars-shield]: https://img.shields.io/github/stars/github_username/repo_name.svg?style=for-the-badge
-[stars-url]: https://github.com/github_username/repo_name/stargazers
-[issues-shield]: https://img.shields.io/github/issues/github_username/repo_name.svg?style=for-the-badge
-[issues-url]: https://github.com/github_username/repo_name/issues
-[license-shield]: https://img.shields.io/github/license/github_username/repo_name.svg?style=for-the-badge
-[license-url]: https://github.com/github_username/repo_name/blob/master/LICENSE.txt
+[contributors-shield]: https://img.shields.io/github/contributors/stephmnt/OCR_projet05.svg?style=for-the-badge
+[contributors-url]: https://github.com/stephmnt/OCR_projet05/graphs/contributors
+[forks-shield]: https://img.shields.io/github/forks/stephmnt/OCR_projet05.svg?style=for-the-badge
+[forks-url]: https://github.com/stephmnt/OCR_projet05/network/members
+[stars-shield]: https://img.shields.io/github/stars/stephmnt/OCR_projet05.svg?style=for-the-badge
+[stars-url]: https://github.com/stephmnt/OCR_projet05/stargazers
+[issues-shield]: https://img.shields.io/github/issues/stephmnt/OCR_projet05.svg?style=for-the-badge
+[issues-url]: https://github.com/stephmnt/OCR_projet05/issues
+[license-shield]: https://img.shields.io/github/license/stephmnt/OCR_projet05.svg?style=for-the-badge
+[license-url]: https://github.com/stephmnt/OCR_projet05/blob/master/LICENSE.txt
 [linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
-[linkedin-url]: https://linkedin.com/in/linkedin_username
+[linkedin-url]: https://linkedin.com/in/stephanemanet
 [product-screenshot]: images/screenshot.png
 [Noobie]: https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16
 <!-- Shields.io badges. You can a comprehensive list with many more badges at: https://github.com/inttter/md-badges -->
@@ -331,10 +349,8 @@ Project Link: [https://github.com/github_username/repo_name](https://github.com/
 [JQuery.com]: https://img.shields.io/badge/jQuery-0769AD?style=for-the-badge&logo=jquery&logoColor=white
 [JQuery-url]: https://jquery.com 
 <!-- TODO: -->
-[![Postgres](https://img.shields.io/badge/Postgres-%23316192.svg?logo=postgresql&logoColor=white)](#)
-[![Python](https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=fff)](#)
-[![Sphinx](https://img.shields.io/badge/Sphinx-000?logo=sphinx&logoColor=fff)](#)
-[![MkDocs](https://img.shields.io/badge/MkDocs-526CFE?logo=materialformkdocs&logoColor=fff)](#)
-[![NumPy](https://img.shields.io/badge/NumPy-4DABCF?logo=numpy&logoColor=fff)](#)
+[Postgres]: https://img.shields.io/badge/Postgres-%23316192.svg?logo=postgresql&logoColor=white
+[Python]: https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=fff)
+[MkDocs]: https://img.shields.io/badge/MkDocs-526CFE?logo=materialformkdocs&logoColor=fff
+[NumPy]: https://img.shields.io/badge/NumPy-4DABCF?logo=numpy&logoColor=fff
 [![Pandas](https://img.shields.io/badge/Pandas-150458?logo=pandas&logoColor=fff)](#)
-[![Slack](https://img.shields.io/badge/Slack-4A154B?logo=slack&logoColor=fff)](#)[text](../projet_04/.gitignore)

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/LICENSE

@@ -0,0 +1,10 @@
+
+The MIT License (MIT)
+Copyright (c) 2025, Stéphane Manet
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/Makefile

@@ -0,0 +1,85 @@
+#################################################################################
+# GLOBALS                                                                       #
+#################################################################################
+
+PROJECT_NAME = OCR_projet05
+PYTHON_VERSION = 3.10
+PYTHON_INTERPRETER = python
+
+#################################################################################
+# COMMANDS                                                                      #
+#################################################################################
+
+
+## Install Python dependencies
+.PHONY: requirements
+requirements:
+	pip install -e .
+	
+
+
+
+## Delete all compiled Python files
+.PHONY: clean
+clean:
+	find . -type f -name "*.py[co]" -delete
+	find . -type d -name "__pycache__" -delete
+
+
+## Lint using ruff (use `make format` to do formatting)
+.PHONY: lint
+lint:
+	ruff format --check
+	ruff check
+
+## Format source code with ruff
+.PHONY: format
+format:
+	ruff check --fix
+	ruff format
+
+
+
+## Run tests
+.PHONY: test
+test:
+	python -m pytest tests
+
+
+## Set up Python interpreter environment
+.PHONY: create_environment
+create_environment:
+	@bash -c "if [ ! -z `which virtualenvwrapper.sh` ]; then source `which virtualenvwrapper.sh`; mkvirtualenv $(PROJECT_NAME) --python=$(PYTHON_INTERPRETER); else mkvirtualenv.bat $(PROJECT_NAME) --python=$(PYTHON_INTERPRETER); fi"
+	@echo ">>> New virtualenv created. Activate with:\nworkon $(PROJECT_NAME)"
+	
+
+
+
+#################################################################################
+# PROJECT RULES                                                                 #
+#################################################################################
+
+
+## Make dataset
+.PHONY: data
+data: requirements
+	$(PYTHON_INTERPRETER) projet_05/dataset.py
+
+
+#################################################################################
+# Self Documenting Commands                                                     #
+#################################################################################
+
+.DEFAULT_GOAL := help
+
+define PRINT_HELP_PYSCRIPT
+import re, sys; \
+lines = '\n'.join([line for line in sys.stdin]); \
+matches = re.findall(r'\n## (.*)\n[\s\S]+?\n([a-zA-Z_-]+):', lines); \
+print('Available rules:\n'); \
+print('\n'.join(['{:25}{}'.format(*reversed(match)) for match in matches]))
+endef
+export PRINT_HELP_PYSCRIPT
+
+help:
+	@$(PYTHON_INTERPRETER) -c "${PRINT_HELP_PYSCRIPT}" < $(MAKEFILE_LIST)

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/app.py

@@ -1,7 +1,181 @@
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Any
+
 import gradio as gr
+import pandas as pd
+from loguru import logger
+
+from projet_05.branding import apply_brand_theme
+from projet_05.modeling.predict import load_metadata, load_pipeline, run_inference
+
+MODEL_PATH = Path("models/best_model.joblib")
+METADATA_PATH = Path("models/best_model_meta.json")
+SCHEMA_PATH = Path("data/processed/schema.json")
+
+
+def _load_schema(path: Path) -> dict[str, Any]:
+    if not path.exists():
+        return {}
+    return json.loads(path.read_text(encoding="utf-8"))
+
+
+def _infer_features(metadata: dict, schema: dict, pipeline) -> list[str]:
+    if schema:
+        candidates = schema.get("numerical_features", []) + schema.get("categorical_features", [])
+        if candidates:
+            return candidates
+    features = metadata.get("features", {})
+    explicit = (features.get("numerical") or []) + (features.get("categorical") or [])
+    if explicit:
+        return explicit
+    if pipeline is not None and hasattr(pipeline, "feature_names_in_"):
+        return list(pipeline.feature_names_in_)
+    return []
+
+
+def _convert_input(payload: Any, headers: list[str]) -> pd.DataFrame:
+    if isinstance(payload, pd.DataFrame):
+        df = payload.copy()
+    elif payload is None:
+        df = pd.DataFrame(columns=headers)
+    else:
+        df = pd.DataFrame(payload, columns=headers if headers else None)
+    df = df.dropna(how="all")
+    if df.empty:
+        raise gr.Error("Merci de saisir au moins une ligne complète.")
+    return df
+
+
+def _ensure_model():
+    if PIPELINE is None:
+        raise gr.Error(
+            "Aucun modèle entrainé n'a été trouvé. Lancez `python projet_05/modeling/train.py` puis relancez l'application."
+        )
+
+
+def score_table(table):
+    _ensure_model()
+    df = _convert_input(table, FEATURE_ORDER)
+    drop_cols = [TARGET_COLUMN] if TARGET_COLUMN else None
+    return run_inference(
+        df,
+        PIPELINE,
+        THRESHOLD,
+        drop_columns=drop_cols,
+        required_features=FEATURE_ORDER or None,
+    )
+
+
+def score_csv(upload):
+    _ensure_model()
+    if upload is None:
+        raise gr.Error("Veuillez déposer un fichier CSV.")
+    df = pd.read_csv(upload.name)
+    drop_cols = [TARGET_COLUMN] if TARGET_COLUMN else None
+    return run_inference(
+        df,
+        PIPELINE,
+        THRESHOLD,
+        drop_columns=drop_cols,
+        required_features=FEATURE_ORDER or None,
+    )
+
+
+def predict_from_form(*values):
+    _ensure_model()
+    if not FEATURE_ORDER:
+        raise gr.Error("Impossible de générer le formulaire sans configuration des features.")
+    payload = {feature: value for feature, value in zip(FEATURE_ORDER, values)}
+    df = pd.DataFrame([payload])
+    scored = run_inference(
+        df,
+        PIPELINE,
+        THRESHOLD,
+        required_features=FEATURE_ORDER or None,
+    )
+    row = scored.iloc[0]
+    label = "Risque de départ" if int(row["prediction"]) == 1 else "Reste probable"
+    return {
+        "probability": round(float(row["proba_depart"]), 4),
+        "decision": label,
+        "threshold": THRESHOLD,
+    }
+
+
+# Chargement des artéfacts
+apply_brand_theme()
+
+PIPELINE = None
+METADATA: dict[str, Any] = {}
+THRESHOLD = 0.5
+TARGET_COLUMN: str | None = None
+SCHEMA = _load_schema(SCHEMA_PATH)
+
+try:
+    PIPELINE = load_pipeline(MODEL_PATH)
+    METADATA = load_metadata(METADATA_PATH)
+    THRESHOLD = float(METADATA.get("best_threshold", THRESHOLD))
+    TARGET_COLUMN = METADATA.get("target")
+except FileNotFoundError as exc:
+    logger.warning("Artéfact manquant: {}", exc)
+
+FEATURE_ORDER = _infer_features(METADATA, SCHEMA, PIPELINE)
+
+with gr.Blocks(title="Prédicteur d'attrition") as demo:
+    gr.Markdown("# API Gradio – Prédiction de départ employé")
+    gr.Markdown(
+        "Le modèle applique le pipeline entraîné hors-notebook pour fournir une probabilité de départ ainsi qu'une décision binaire."
+    )
+
+    if PIPELINE is None:
+        gr.Markdown(
+            "⚠️ **Aucun modèle disponible.** Lancez les scripts `dataset.py`, `features.py` puis `modeling/train.py`."
+        )
+    else:
+        gr.Markdown(f"Seuil de décision actuel : **{THRESHOLD:.2f}**")
+
+    with gr.Tab("Formulaire unitaire"):
+        if not FEATURE_ORDER:
+            gr.Markdown("Aucune configuration de features détectée. Utilisez l'onglet CSV pour scorer vos données.")
+        else:
+            form_inputs: list[gr.components.Component] = [] # type: ignore
+            for feature in FEATURE_ORDER:
+                form_inputs.append(
+                    gr.Textbox(label=feature, placeholder=f"Saisir {feature.replace('_', ' ')}")
+                )
+            form_output = gr.JSON(label="Résultat")
+            gr.Button("Prédire").click(
+                fn=predict_from_form,
+                inputs=form_inputs,
+                outputs=form_output,
+            )
+
+    with gr.Tab("Tableau interactif"):
+        table_input = gr.Dataframe(
+            headers=FEATURE_ORDER if FEATURE_ORDER else None,
+            row_count=(1, "dynamic"),
+            col_count=(len(FEATURE_ORDER), "dynamic") if FEATURE_ORDER else (5, "dynamic"),
+            type="pandas",
+        )
+        table_output = gr.Dataframe(label="Prédictions", type="pandas")
+        gr.Button("Scorer les lignes").click(
+            fn=score_table,
+            inputs=table_input,
+            outputs=table_output,
+        )
+
+    with gr.Tab("Fichier CSV"):
+        file_input = gr.File(file_types=[".csv"], label="Déposez votre fichier CSV")
+        file_output = gr.Dataframe(label="Résultats CSV", type="pandas")
+        gr.Button("Scorer le fichier").click(
+            fn=score_csv,
+            inputs=file_input,
+            outputs=file_output,
+        )
 
-def greet(name):
-    return "Hello " + name + "!!"
 
-demo = gr.Interface(fn=greet, inputs="text", outputs="text")
-demo.launch()
+if __name__ == "__main__":
+    demo.launch()

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/.github/workflows/deploy.yml

@@ -1,10 +1,13 @@
-name: Déployer vers Hugging Face Spaces
+name: Deploy to Hugging Face Spaces
 
 on:
   push:
     branches:
       - main
 
+permissions:
+  contents: write
+
 jobs:
   deploy:
     runs-on: ubuntu-latest
@@ -23,7 +26,7 @@ jobs:
           python -m pip install --upgrade pip
           if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
 
-      - name: Push to Hugging Face Space
+      - name: Deploy to Hugging Face Space
         env:
           HF_TOKEN: ${{ secrets.HF_TOKEN }}
         run: |
@@ -33,5 +36,5 @@ jobs:
           rsync -av --exclude '.git' ./ hf_space/
           cd hf_space
           git add .
-          git commit -m "🚀 Auto-deploy from GitHub Actions"
-          git push https://stephmnt:$HF_TOKEN@huggingface.co/spaces/stephmnt/projet_05 main
+          git commit -m "🚀 Auto-deploy from GitHub Actions" || echo "No changes to commit"
+          git push https://stephmnt:$HF_TOKEN@huggingface.co/spaces/stephmnt/projet_05 main

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/.gitignore

@@ -1,2 +1,192 @@
+# Data
+/data/
+
+# Mac OS-specific storage files
+.DS_Store
 *.code-workspace
-.venv/
+
+# vim
+*.swp
+*.swo
+
+## https://github.com/github/gitignore/blob/e8554d85bf62e38d6db966a50d2064ac025fd82a/Python.gitignore
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# MkDocs documentation
+docs/site/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   pixi.lock should be committed to version control for reproducibility
+#   .pixi/ contains the environments and should not be committed
+.pixi/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/README.md

@@ -1,3 +1,64 @@
+# projet_05
+
+<a target="_blank" href="https://cookiecutter-data-science.drivendata.org/">
+    <img src="https://img.shields.io/badge/CCDS-Project%20template-328F97?logo=cookiecutter" />
+</a>
+
+Déployez un modèle de Machine Learning
+
+## Organisation du projet
+
+```
+├── LICENSE            <- Open-source license if one is chosen
+├── Makefile           <- Makefile with convenience commands like `make data` or `make train`
+├── README.md          <- The top-level README for developers using this project.
+├── data
+│   ├── external       <- Data from third party sources.
+│   ├── interim        <- Intermediate data that has been transformed.
+│   ├── processed      <- The final, canonical data sets for modeling.
+│   └── raw            <- The original, immutable data dump.
+│
+├── docs               <- A default mkdocs project; see www.mkdocs.org for details
+│
+├── models             <- Trained and serialized models, model predictions, or model summaries
+│
+├── notebooks          <- Jupyter notebooks. Naming convention is a number (for ordering),
+│                         the creator's initials, and a short `-` delimited description, e.g.
+│                         `1.0-jqp-initial-data-exploration`.
+│
+├── pyproject.toml     <- Project configuration file with package metadata for 
+│                         projet_05 and configuration for tools like black
+│
+├── references         <- Data dictionaries, manuals, and all other explanatory materials.
+│
+├── reports            <- Generated analysis as HTML, PDF, LaTeX, etc.
+│   └── figures        <- Generated graphics and figures to be used in reporting
+│
+├── requirements.txt   <- The requirements file for reproducing the analysis environment, e.g.
+│                         generated with `pip freeze > requirements.txt`
+│
+├── setup.cfg          <- Configuration file for flake8
+│
+└── projet_05   <- Source code for use in this project.
+    │
+    ├── __init__.py             <- Makes projet_05 a Python module
+    │
+    ├── config.py               <- Store useful variables and configuration
+    │
+    ├── dataset.py              <- Scripts to download or generate data
+    │
+    ├── features.py             <- Code to create features for modeling
+    │
+    ├── modeling                
+    │   ├── __init__.py 
+    │   ├── predict.py          <- Code to run model inference with trained models          
+    │   └── train.py            <- Code to train models
+    │
+    └── plots.py                <- Code to create visualizations
+```
+
+--------
+
 ---
 title: Projet 05
 emoji: 👀
@@ -10,3 +71,270 @@ pinned: false
 ---
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+<!-- Improved compatibility of back to top link: See: https://github.com/othneildrew/Best-README-Template/pull/73 -->
+<a id="readme-top"></a>
+<!--
+*** Thanks for checking out the Best-README-Template. If you have a suggestion
+*** that would make this better, please fork the repo and create a pull request
+*** or simply open an issue with the tag "enhancement".
+*** Don't forget to give the project a star!
+*** Thanks again! Now go create something AMAZING! :D
+-->
+
+
+
+<!-- PROJECT SHIELDS -->
+<!--
+*** I'm using markdown "reference style" links for readability.
+*** Reference links are enclosed in brackets [ ] instead of parentheses ( ).
+*** See the bottom of this document for the declaration of the reference variables
+*** for contributors-url, forks-url, etc. This is an optional, concise syntax you may use.
+*** https://www.markdownguide.org/basic-syntax/#reference-style-links
+-->
+[![Contributors][contributors-shield]][contributors-url]
+[![Forks][forks-shield]][forks-url]
+[![Stargazers][stars-shield]][stars-url]
+[![Issues][issues-shield]][issues-url]
+[![project_license][license-shield]][license-url]
+[![LinkedIn][linkedin-shield]][linkedin-url]
+![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/:user/:repo/:workflow)
+
+
+
+<!-- PROJECT LOGO -->
+<br />
+<div align="center">
+  <a href="https://github.com/github_username/repo_name">
+    <img src="images/logo.png" alt="Logo" width="80" height="80">
+  </a>
+
+<h3 align="center">project_title</h3>
+
+  <p align="center">
+    project_description
+    <br />
+    <a href="https://github.com/github_username/repo_name"><strong>Explore the docs »</strong></a>
+    <br />
+    <br />
+    <a href="https://github.com/github_username/repo_name">View Demo</a>
+    &middot;
+    <a href="https://github.com/github_username/repo_name/issues/new?labels=bug&template=bug-report---.md">Report Bug</a>
+    &middot;
+    <a href="https://github.com/github_username/repo_name/issues/new?labels=enhancement&template=feature-request---.md">Request Feature</a>
+  </p>
+</div>
+
+
+
+<!-- TABLE OF CONTENTS -->
+<details>
+  <summary>Table of Contents</summary>
+  <ol>
+    <li>
+      <a href="#about-the-project">About The Project</a>
+      <ul>
+        <li><a href="#built-with">Built With</a></li>
+      </ul>
+    </li>
+    <li>
+      <a href="#getting-started">Getting Started</a>
+      <ul>
+        <li><a href="#prerequisites">Prerequisites</a></li>
+        <li><a href="#installation">Installation</a></li>
+      </ul>
+    </li>
+    <li><a href="#usage">Usage</a></li>
+    <li><a href="#roadmap">Roadmap</a></li>
+    <li><a href="#contributing">Contributing</a></li>
+    <li><a href="#license">License</a></li>
+    <li><a href="#contact">Contact</a></li>
+    <li><a href="#acknowledgments">Acknowledgments</a></li>
+  </ol>
+</details>
+
+
+
+<!-- ABOUT THE PROJECT -->
+## About The Project
+
+[![Product Name Screen Shot][product-screenshot]](https://example.com)
+
+Here's a blank template to get started. To avoid retyping too much info, do a search and replace with your text editor for the following: `github_username`, `repo_name`, `twitter_handle`, `linkedin_username`, `email_client`, `email`, `project_title`, `project_description`, `project_license`
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+
+
+### Built With
+
+* [![Python][Python]][Python-url]
+* [![SQL][SQL]][SQL-url]
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+
+
+<!-- GETTING STARTED -->
+## Getting Started
+
+This is an example of how you may give instructions on setting up your project locally.
+To get a local copy up and running follow these simple example steps.
+
+### Prerequisites
+
+This is an example of how to list things you need to use the software and how to install them.
+* npm
+  ```sh
+  npm install npm@latest -g
+  ```
+
+### Installation
+
+pip install -r requirements.txt
+uvicorn app.main:app --reload
+
+1. Get a free API Key at [https://example.com](https://example.com)
+2. Clone the repo
+   ```sh
+   git clone https://github.com/github_username/repo_name.git
+   ```
+3. Install NPM packages
+   ```sh
+   npm install
+   ```
+4. Enter your API in `config.js`
+   ```js
+   const API_KEY = 'ENTER YOUR API';
+   ```
+5. Change git remote url to avoid accidental pushes to base project
+   ```sh
+   git remote set-url origin github_username/repo_name
+   git remote -v # confirm the changes
+   ```
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+
+
+<!-- USAGE EXAMPLES -->
+## Usage
+
+Use this space to show useful examples of how a project can be used. Additional screenshots, code examples and demos work well in this space. You may also link to more resources.
+
+_For more examples, please refer to the [Documentation](https://example.com)_
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+
+
+<!-- ROADMAP -->
+## Roadmap
+
+- [ ] Feature 1
+- [ ] Feature 2
+- [ ] Feature 3
+    - [ ] Nested Feature
+
+See the [open issues](https://github.com/github_username/repo_name/issues) for a full list of proposed features (and known issues).
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+
+
+<!-- CONTRIBUTING -->
+## Contributing
+
+Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
+
+If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
+Don't forget to give the project a star! Thanks again!
+
+1. Fork the Project
+2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the Branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+### Top contributors:
+
+<a href="https://github.com/github_username/repo_name/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=github_username/repo_name" alt="contrib.rocks image" />
+</a>
+
+
+
+<!-- LICENSE -->
+## License
+
+Distributed under the project_license. See `LICENSE.txt` for more information.
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+
+
+<!-- CONTACT -->
+## Contact
+
+Your Name - [@twitter_handle](https://twitter.com/twitter_handle) - email@email_client.com
+
+Project Link: [https://github.com/github_username/repo_name](https://github.com/github_username/repo_name)
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+
+
+<!-- ACKNOWLEDGMENTS -->
+## Acknowledgments
+
+* []()
+* []()
+* []()
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+
+
+<!-- MARKDOWN LINKS & IMAGES -->
+<!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
+[contributors-shield]: https://img.shields.io/github/contributors/github_username/repo_name.svg?style=for-the-badge
+[contributors-url]: https://github.com/github_username/repo_name/graphs/contributors
+[forks-shield]: https://img.shields.io/github/forks/github_username/repo_name.svg?style=for-the-badge
+[forks-url]: https://github.com/github_username/repo_name/network/members
+[stars-shield]: https://img.shields.io/github/stars/github_username/repo_name.svg?style=for-the-badge
+[stars-url]: https://github.com/github_username/repo_name/stargazers
+[issues-shield]: https://img.shields.io/github/issues/github_username/repo_name.svg?style=for-the-badge
+[issues-url]: https://github.com/github_username/repo_name/issues
+[license-shield]: https://img.shields.io/github/license/github_username/repo_name.svg?style=for-the-badge
+[license-url]: https://github.com/github_username/repo_name/blob/master/LICENSE.txt
+[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
+[linkedin-url]: https://linkedin.com/in/linkedin_username
+[product-screenshot]: images/screenshot.png
+[Noobie]: https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16
+<!-- Shields.io badges. You can a comprehensive list with many more badges at: https://github.com/inttter/md-badges -->
+[Next.js]: https://img.shields.io/badge/next.js-000000?style=for-the-badge&logo=nextdotjs&logoColor=white
+[Next-url]: https://nextjs.org/
+[React.js]: https://img.shields.io/badge/React-20232A?style=for-the-badge&logo=react&logoColor=61DAFB
+[React-url]: https://reactjs.org/
+[Vue.js]: https://img.shields.io/badge/Vue.js-35495E?style=for-the-badge&logo=vuedotjs&logoColor=4FC08D
+[Vue-url]: https://vuejs.org/
+[Angular.io]: https://img.shields.io/badge/Angular-DD0031?style=for-the-badge&logo=angular&logoColor=white
+[Angular-url]: https://angular.io/
+[Svelte.dev]: https://img.shields.io/badge/Svelte-4A4A55?style=for-the-badge&logo=svelte&logoColor=FF3E00
+[Svelte-url]: https://svelte.dev/
+[Laravel.com]: https://img.shields.io/badge/Laravel-FF2D20?style=for-the-badge&logo=laravel&logoColor=white
+[Laravel-url]: https://laravel.com
+[Bootstrap.com]: https://img.shields.io/badge/Bootstrap-563D7C?style=for-the-badge&logo=bootstrap&logoColor=white
+[Bootstrap-url]: https://getbootstrap.com
+[JQuery.com]: https://img.shields.io/badge/jQuery-0769AD?style=for-the-badge&logo=jquery&logoColor=white
+[JQuery-url]: https://jquery.com 
+<!-- TODO: -->
+[![Postgres](https://img.shields.io/badge/Postgres-%23316192.svg?logo=postgresql&logoColor=white)](#)
+[![Python](https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=fff)](#)
+[![Sphinx](https://img.shields.io/badge/Sphinx-000?logo=sphinx&logoColor=fff)](#)
+[![MkDocs](https://img.shields.io/badge/MkDocs-526CFE?logo=materialformkdocs&logoColor=fff)](#)
+[![NumPy](https://img.shields.io/badge/NumPy-4DABCF?logo=numpy&logoColor=fff)](#)
+[![Pandas](https://img.shields.io/badge/Pandas-150458?logo=pandas&logoColor=fff)](#)
+[![Slack](https://img.shields.io/badge/Slack-4A154B?logo=slack&logoColor=fff)](#)[text](../projet_04/.gitignore)

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/app/main.py

@@ -0,0 +1,7 @@
+import gradio as gr
+
+def greet(name):
+    return "Hello " + name + "!!"
+
+demo = gr.Interface(fn=greet, inputs="text", outputs="text")
+demo.launch()

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/.github/workflows/deploy.yml

@@ -0,0 +1,37 @@
+name: Déployer vers Hugging Face Spaces
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+
+      - name: Push to Hugging Face Space
+        env:
+          HF_TOKEN: ${{ secrets.HF_TOKEN }}
+        run: |
+          git config --global user.email "actions@github.com"
+          git config --global user.name "GitHub Actions"
+          git clone https://huggingface.co/spaces/stephmnt/projet_05 hf_space
+          rsync -av --exclude '.git' ./ hf_space/
+          cd hf_space
+          git add .
+          git commit -m "🚀 Auto-deploy from GitHub Actions"
+          git push https://stephmnt:$HF_TOKEN@huggingface.co/spaces/stephmnt/projet_05 main

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/.gitattributes

@@ -0,0 +1,35 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/.gitignore

@@ -0,0 +1,2 @@
+*.code-workspace
+.venv/

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/README.md

@@ -0,0 +1,12 @@
+---
+title: Projet 05
+emoji: 👀
+colorFrom: indigo
+colorTo: green
+sdk: gradio
+sdk_version: 5.49.1
+app_file: app.py
+pinned: false
+---
+
+Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/app.py

@@ -0,0 +1,7 @@
+import gradio as gr
+
+def greet(name):
+    return "Hello " + name + "!!"
+
+demo = gr.Interface(fn=greet, inputs="text", outputs="text")
+demo.launch()

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/tests/test_app.py

@@ -0,0 +1,17 @@
+import pytest
+from app.main import greet
+
+def test_greet_returns_string():
+    """Vérifie que la fonction retourne bien une chaîne de caractères."""
+    result = greet("Alice")
+    assert isinstance(result, str), "Le résultat doit être une chaîne de caractères."
+
+def test_greet_output_content():
+    """Vérifie que la fonction génère la phrase attendue."""
+    result = greet("Bob")
+    assert result == "Hello Bob!!", f"Résultat inattendu : {result}"
+
+def test_greet_with_empty_string():
+    """Vérifie le comportement si l’entrée est vide."""
+    result = greet("")
+    assert result == "Hello !!", "Le résultat doit gérer les entrées vides."

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/poetry.toml

@@ -0,0 +1,2 @@
+[virtualenvs]
+in-project = true

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/projet_05/__init__.py

@@ -0,0 +1 @@
+from projet_05 import config  # noqa: F401

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/projet_05/config.py

@@ -0,0 +1,32 @@
+from pathlib import Path
+
+from dotenv import load_dotenv
+from loguru import logger
+
+# Load environment variables from .env file if it exists
+load_dotenv()
+
+# Paths
+PROJ_ROOT = Path(__file__).resolve().parents[1]
+logger.info(f"PROJ_ROOT path is: {PROJ_ROOT}")
+
+DATA_DIR = PROJ_ROOT / "data"
+RAW_DATA_DIR = DATA_DIR / "raw"
+INTERIM_DATA_DIR = DATA_DIR / "interim"
+PROCESSED_DATA_DIR = DATA_DIR / "processed"
+EXTERNAL_DATA_DIR = DATA_DIR / "external"
+
+MODELS_DIR = PROJ_ROOT / "models"
+
+REPORTS_DIR = PROJ_ROOT / "reports"
+FIGURES_DIR = REPORTS_DIR / "figures"
+
+# If tqdm is installed, configure loguru with tqdm.write
+# https://github.com/Delgan/loguru/issues/135
+try:
+    from tqdm import tqdm
+
+    logger.remove(0)
+    logger.add(lambda msg: tqdm.write(msg, end=""), colorize=True)
+except ModuleNotFoundError:
+    pass

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/projet_05/dataset.py

@@ -0,0 +1,29 @@
+from pathlib import Path
+
+from loguru import logger
+from tqdm import tqdm
+import typer
+
+from projet_05.config import PROCESSED_DATA_DIR, RAW_DATA_DIR
+
+app = typer.Typer()
+
+
+@app.command()
+def main(
+    # ---- REPLACE DEFAULT PATHS AS APPROPRIATE ----
+    input_path: Path = RAW_DATA_DIR / "dataset.csv",
+    output_path: Path = PROCESSED_DATA_DIR / "dataset.csv",
+    # ----------------------------------------------
+):
+    # ---- REPLACE THIS WITH YOUR OWN CODE ----
+    logger.info("Processing dataset...")
+    for i in tqdm(range(10), total=10):
+        if i == 5:
+            logger.info("Something happened for iteration 5.")
+    logger.success("Processing dataset complete.")
+    # -----------------------------------------
+
+
+if __name__ == "__main__":
+    app()

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/projet_05/features.py

@@ -0,0 +1,29 @@
+from pathlib import Path
+
+from loguru import logger
+from tqdm import tqdm
+import typer
+
+from projet_05.config import PROCESSED_DATA_DIR
+
+app = typer.Typer()
+
+
+@app.command()
+def main(
+    # ---- REPLACE DEFAULT PATHS AS APPROPRIATE ----
+    input_path: Path = PROCESSED_DATA_DIR / "dataset.csv",
+    output_path: Path = PROCESSED_DATA_DIR / "features.csv",
+    # -----------------------------------------
+):
+    # ---- REPLACE THIS WITH YOUR OWN CODE ----
+    logger.info("Generating features from dataset...")
+    for i in tqdm(range(10), total=10):
+        if i == 5:
+            logger.info("Something happened for iteration 5.")
+    logger.success("Features generation complete.")
+    # -----------------------------------------
+
+
+if __name__ == "__main__":
+    app()

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/projet_05/modeling/predict.py

@@ -0,0 +1,30 @@
+from pathlib import Path
+
+from loguru import logger
+from tqdm import tqdm
+import typer
+
+from projet_05.config import MODELS_DIR, PROCESSED_DATA_DIR
+
+app = typer.Typer()
+
+
+@app.command()
+def main(
+    # ---- REPLACE DEFAULT PATHS AS APPROPRIATE ----
+    features_path: Path = PROCESSED_DATA_DIR / "test_features.csv",
+    model_path: Path = MODELS_DIR / "model.pkl",
+    predictions_path: Path = PROCESSED_DATA_DIR / "test_predictions.csv",
+    # -----------------------------------------
+):
+    # ---- REPLACE THIS WITH YOUR OWN CODE ----
+    logger.info("Performing inference for model...")
+    for i in tqdm(range(10), total=10):
+        if i == 5:
+            logger.info("Something happened for iteration 5.")
+    logger.success("Inference complete.")
+    # -----------------------------------------
+
+
+if __name__ == "__main__":
+    app()

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/projet_05/modeling/train.py

@@ -0,0 +1,30 @@
+from pathlib import Path
+
+from loguru import logger
+from tqdm import tqdm
+import typer
+
+from projet_05.config import MODELS_DIR, PROCESSED_DATA_DIR
+
+app = typer.Typer()
+
+
+@app.command()
+def main(
+    # ---- REPLACE DEFAULT PATHS AS APPROPRIATE ----
+    features_path: Path = PROCESSED_DATA_DIR / "features.csv",
+    labels_path: Path = PROCESSED_DATA_DIR / "labels.csv",
+    model_path: Path = MODELS_DIR / "model.pkl",
+    # -----------------------------------------
+):
+    # ---- REPLACE THIS WITH YOUR OWN CODE ----
+    logger.info("Training some model...")
+    for i in tqdm(range(10), total=10):
+        if i == 5:
+            logger.info("Something happened for iteration 5.")
+    logger.success("Modeling training complete.")
+    # -----------------------------------------
+
+
+if __name__ == "__main__":
+    app()

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/projet_05/plots.py

@@ -0,0 +1,29 @@
+from pathlib import Path
+
+from loguru import logger
+from tqdm import tqdm
+import typer
+
+from projet_05.config import FIGURES_DIR, PROCESSED_DATA_DIR
+
+app = typer.Typer()
+
+
+@app.command()
+def main(
+    # ---- REPLACE DEFAULT PATHS AS APPROPRIATE ----
+    input_path: Path = PROCESSED_DATA_DIR / "dataset.csv",
+    output_path: Path = FIGURES_DIR / "plot.png",
+    # -----------------------------------------
+):
+    # ---- REPLACE THIS WITH YOUR OWN CODE ----
+    logger.info("Generating plot from data...")
+    for i in tqdm(range(10), total=10):
+        if i == 5:
+            logger.info("Something happened for iteration 5.")
+    logger.success("Plot generation complete.")
+    # -----------------------------------------
+
+
+if __name__ == "__main__":
+    app()

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["flit_core >=3.2,<4"]
+build-backend = "flit_core.buildapi"
+
+[project]
+name = "projet_05"
+version = "0.0.1"
+description = "D\u00e9ployez un mod\u00e8le de Machine Learning"
+authors = [
+  { name = "St\u00e9phane Manet" },
+]
+license = { file = "LICENSE" }
+readme = "README.md"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License"
+]
+dependencies = [
+    "loguru",
+    "mkdocs",
+    "pip",
+    "pytest",
+    "python-dotenv",
+    "ruff",
+    "tqdm",
+    "typer",
+    "imbalanced-learn (>=0.14.0,<0.15.0)",
+    "scikit-learn (>=1.4.2,<2.0.0)",
+    "matplotlib (>=3.10.7,<4.0.0)",
+    "numpy (>=2.3.4,<3.0.0)",
+    "pandas (>=2.3.3,<3.0.0)",
+    "pyyaml (>=6.0.3,<7.0.0)",
+    "scipy (>=1.16.3,<2.0.0)",
+    "seaborn (>=0.13.2,<0.14.0)",
+    "shap (>=0.49.1,<0.50.0)",
+    "gradio (>=5.49.1,<6.0.0)",
+    "joblib (>=1.4.2,<2.0.0)"
+]
+
+requires-python = ">=3.11,<3.13"
+
+
+[tool.ruff]
+line-length = 99
+src = ["projet_05"]
+include = ["pyproject.toml", "projet_05/**/*.py"]
+
+[tool.ruff.lint]
+extend-select = ["I"]  # Add import sorting
+
+[tool.ruff.lint.isort]
+known-first-party = ["projet_05"]
+force-sort-within-sections = true

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/tests/test_data.py

@@ -0,0 +1,5 @@
+import pytest
+
+
+def test_code_is_tested():
+    assert False

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/projet_05/__init__.py

@@ -1 +1,4 @@
 from projet_05 import config  # noqa: F401
+from projet_05.settings import Settings, load_settings  # noqa: F401
+
+__all__ = ["config", "Settings", "load_settings"]

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/projet_05/branding.py

@@ -0,0 +1,52 @@
+from __future__ import annotations
+
+from functools import lru_cache
+from pathlib import Path
+from typing import Union
+
+from scripts_projet04.brand.brand import (  # type: ignore[import-not-found]
+    Theme,
+    ThemeConfig,
+    configure_brand,
+    load_brand,
+    make_diverging_cmap,
+)
+
+ROOT_DIR = Path(__file__).resolve().parents[1]
+DEFAULT_BRAND_PATH = ROOT_DIR / "scripts_projet04" / "brand" / "brand.yml"
+
+
+def _resolve_path(path: Union[str, Path, None]) -> Path:
+    if path is None:
+        return DEFAULT_BRAND_PATH
+    return Path(path).expanduser().resolve()
+
+
+@lru_cache(maxsize=1)
+def load_brand_config(path: Union[str, Path, None] = None) -> ThemeConfig:
+    """Load the brand YAML once and return the parsed ThemeConfig."""
+    cfg_path = _resolve_path(path)
+    return load_brand(cfg_path)
+
+
+@lru_cache(maxsize=1)
+def apply_brand_theme(path: Union[str, Path, None] = None) -> ThemeConfig:
+    """
+    Apply the OpenClassrooms/TechNova brand theme globally.
+
+    Returns the ThemeConfig so callers can inspect colors if needed.
+    """
+    cfg_path = _resolve_path(path)
+    cfg = configure_brand(cfg_path)
+    Theme.apply()
+    return cfg
+
+
+__all__ = [
+    "Theme",
+    "ThemeConfig",
+    "apply_brand_theme",
+    "load_brand_config",
+    "make_diverging_cmap",
+    "DEFAULT_BRAND_PATH",
+]

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/projet_05/dataset.py

@@ -1,28 +1,202 @@
+from __future__ import annotations
+
+import sqlite3
 from pathlib import Path
 
+import numpy as np
+import pandas as pd
 from loguru import logger
-from tqdm import tqdm
 import typer
 
-from projet_05.config import PROCESSED_DATA_DIR, RAW_DATA_DIR
+from projet_05.config import INTERIM_DATA_DIR
+from projet_05.settings import Settings, load_settings
+
+app = typer.Typer(help="Préparation et fusion des données sources.")
+
+
+# ---------------------------------------------------------------------------
+# Utilitaires
+# ---------------------------------------------------------------------------
+def safe_read_csv(path: Path, *, dtype=None) -> pd.DataFrame:
+    """Read a CSV file and return an empty frame when it fails."""
+    try:
+        logger.info("Lecture du fichier {}", path)
+        return pd.read_csv(path, dtype=dtype)
+    except FileNotFoundError:
+        logger.warning("Fichier absent: {}", path)
+        return pd.DataFrame()
+    except Exception as exc:  # pragma: no cover - log + empty dataframe
+        logger.error("Impossible de lire {} ({})", path, exc)
+        return pd.DataFrame()
+
+
+def clean_text_values(df: pd.DataFrame) -> pd.DataFrame:
+    """Normalize textual values that often materialize missing values."""
+    replace_tokens = [
+        "",
+        " ",
+        "  ",
+        "   ",
+        "nan",
+        "NaN",
+        "NAN",
+        "None",
+        "JE ne sais pas",
+        "je ne sais pas",
+        "Je ne sais pas",
+        "Unknow",
+        "Unknown",
+        "non pertinent",
+        "Non pertinent",
+        "NON PERTINENT",
+    ]
+    normalized = df.copy()
+    normalized = normalized.replace(replace_tokens, np.nan)
+
+    for column in normalized.select_dtypes(include="object"):
+        normalized[column] = (
+            normalized[column].replace(replace_tokens, np.nan).astype("string").str.strip()
+        )
+    return normalized
+
+
+def _harmonize_id_column(df: pd.DataFrame, column: str, *, digits_only: bool = True) -> pd.DataFrame:
+    data = df.copy()
+    if column not in data.columns:
+        return data
+
+    if digits_only:
+        extracted = data[column].astype(str).str.extract(r"(\\d+)")
+        data[column] = pd.to_numeric(extracted[0], errors="coerce")
+    data[column] = pd.to_numeric(data[column], errors="coerce").astype("Int64")
+    return data
+
+
+def _rename_column(df: pd.DataFrame, source: str, target: str) -> pd.DataFrame:
+    if source not in df.columns:
+        return df
+    return df.rename(columns={source: target})
+
+
+def _log_id_diagnostics(df: pd.DataFrame, *, name: str, col_id: str) -> None:
+    if col_id not in df.columns:
+        logger.warning("La colonne {} est absente du fichier {}.", col_id, name)
+        return
+    total = len(df)
+    uniques = df[col_id].nunique(dropna=True)
+    duplicates = total - uniques
+    logger.info(
+        "{name}: {total} lignes | {uniques} identifiants uniques | {duplicates} doublons",
+        name=name,
+        total=total,
+        uniques=uniques,
+        duplicates=duplicates,
+    )
+
+
+def _persist_sql_trace(df_dict: dict[str, pd.DataFrame], settings: Settings) -> pd.DataFrame:
+    """
+    Reproduire la fusion SQL décrite dans le notebook.
 
-app = typer.Typer()
+    Chaque DataFrame est stocké dans une base SQLite éphémère pour
+    conserver une traçabilité de la requête exécutée.
+    """
+    db_path = settings.db_file
+    sql_path = settings.sql_file
 
+    db_path.parent.mkdir(parents=True, exist_ok=True)
+    sql_path.parent.mkdir(parents=True, exist_ok=True)
 
+    if db_path.exists():
+        db_path.unlink()
+
+    query = f"""
+    SELECT *
+    FROM sirh
+    INNER JOIN evaluation USING ({settings.col_id})
+    INNER JOIN sond USING ({settings.col_id});
+    """.strip()
+
+    with db_path.open("wb") as _:
+        pass  # just ensure the file exists for sqlite on some platforms
+
+    with sqlite3.connect(db_path) as conn:
+        for name, frame in df_dict.items():
+            frame.to_sql(name, conn, index=False, if_exists="replace")
+        merged = pd.read_sql_query(query, conn)
+
+    sql_path.write_text(query, encoding="utf-8")
+    return merged
+
+
+def build_dataset(settings: Settings) -> pd.DataFrame:
+    """Load, clean, harmonize and merge the three raw sources."""
+    sirh = clean_text_values(
+        safe_read_csv(settings.path_sirh).pipe(
+            _harmonize_id_column, settings.col_id, digits_only=True
+        )
+    )
+    evaluation = clean_text_values(
+        safe_read_csv(settings.path_eval)
+        .pipe(_rename_column, "eval_number", settings.col_id)
+        .pipe(_harmonize_id_column, settings.col_id, digits_only=True)
+    )
+    sond = clean_text_values(
+        safe_read_csv(settings.path_sondage)
+        .pipe(_rename_column, "code_sondage", settings.col_id)
+        .pipe(_harmonize_id_column, settings.col_id, digits_only=True)
+    )
+
+    for name, frame in {"sirh": sirh, "evaluation": evaluation, "sond": sond}.items():
+        _log_id_diagnostics(frame, name=name, col_id=settings.col_id)
+
+    frames = {
+        "sirh": sirh,
+        "evaluation": evaluation,
+        "sond": sond,
+    }
+    merged = _persist_sql_trace(frames, settings)
+
+    missing_cols = [settings.col_id] if settings.col_id not in merged.columns else []
+    if missing_cols:
+        raise KeyError(
+            f"La colonne {settings.col_id} est absente de la fusion finale. "
+            "Vérifiez vos fichiers sources."
+        )
+
+    logger.success("Fusion réalisée: {} lignes / {} colonnes", *merged.shape)
+    return merged
+
+
+def save_dataset(df: pd.DataFrame, output_path: Path) -> None:
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+    df.to_csv(output_path, index=False)
+    logger.success("Fichier fusionné sauvegardé dans {}", output_path)
+
+
+# ---------------------------------------------------------------------------
+# CLI
+# ---------------------------------------------------------------------------
 @app.command()
 def main(
-    # ---- REPLACE DEFAULT PATHS AS APPROPRIATE ----
-    input_path: Path = RAW_DATA_DIR / "dataset.csv",
-    output_path: Path = PROCESSED_DATA_DIR / "dataset.csv",
-    # ----------------------------------------------
+    settings_path: Path = typer.Option(
+        None,
+        "--settings",
+        "-s",
+        help="Chemin vers un fichier settings.yml personnalisé.",
+    ),
+    output_path: Path = typer.Option(
+        INTERIM_DATA_DIR / "merged.csv",
+        "--output",
+        "-o",
+        help="Chemin de sortie du dataset fusionné.",
+    ),
 ):
-    # ---- REPLACE THIS WITH YOUR OWN CODE ----
-    logger.info("Processing dataset...")
-    for i in tqdm(range(10), total=10):
-        if i == 5:
-            logger.info("Something happened for iteration 5.")
-    logger.success("Processing dataset complete.")
-    # -----------------------------------------
+    """Entrypoint Typer pour reproduire la fusion des données brutes."""
+
+    settings = load_settings(settings_path) if settings_path else load_settings()
+    df = build_dataset(settings)
+    save_dataset(df, output_path)
 
 
 if __name__ == "__main__":

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/projet_05/explainability.py

@@ -0,0 +1,102 @@
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Tuple
+
+import numpy as np
+import pandas as pd
+from loguru import logger
+
+from projet_05.branding import Theme, apply_brand_theme, make_diverging_cmap
+from scripts_projet04.manet_projet04.shap_generator import (  # type: ignore[import-not-found]
+    shap_global,
+    shap_local,
+)
+
+apply_brand_theme()
+
+
+def _shape_array(values) -> np.ndarray:
+    if hasattr(values, "values"):
+        arr = np.array(values.values)
+    else:
+        arr = np.array(values)
+    return np.nan_to_num(arr, copy=False)
+
+
+def compute_shap_summary(
+    pipeline,
+    X: pd.DataFrame,
+    y: pd.Series,
+    *,
+    max_samples: int = 500,
+) -> Tuple[pd.DataFrame | None, object | None]:
+    """
+    Reuse the historical `shap_global` helper to build the plots and a tabular summary.
+
+    Returns
+    -------
+    summary_df : pd.DataFrame | None
+        Moyenne absolue des valeurs SHAP (ordre décroissant).
+    shap_values : shap.Explanation | None
+        Objet renvoyé par shap_global pour des analyses locales ultérieures.
+    """
+    cmap = make_diverging_cmap(Theme.PRIMARY, Theme.SECONDARY)
+    shap_values, _, feature_names = shap_global(
+        pipeline,
+        X,
+        y,
+        sample_size=max_samples,
+        cmap=cmap,
+    )
+    if shap_values is None or feature_names is None:
+        logger.warning("Impossible de générer les résumés SHAP.")
+        return None, None
+
+    shap_array = _shape_array(shap_values)
+    if shap_array.ndim == 1:
+        shap_array = shap_array.reshape(-1, 1)
+    mean_abs = np.abs(shap_array).mean(axis=0)
+    summary = (
+        pd.DataFrame({"feature": list(feature_names), "mean_abs_shap": mean_abs})
+        .sort_values("mean_abs_shap", ascending=False)
+        .reset_index(drop=True)
+    )
+    return summary, shap_values
+
+
+def save_shap_summary(summary: pd.DataFrame, output_path: Path) -> None:
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+    summary.to_csv(output_path, index=False)
+    logger.info("Résumé SHAP sauvegardé dans {}", output_path)
+
+
+def export_local_explanations(
+    pipeline,
+    shap_values,
+    X: pd.DataFrame,
+    custom_index: int | None = None,
+) -> None:
+    """
+    Génère trois cas d'usage par défaut (impact max, risque max, risque min)
+    et un indice custom optionnel pour la trace historique.
+    """
+    if shap_values is None:
+        return
+
+    shap_array = _shape_array(shap_values)
+    idx_impact = int(np.argmax(np.sum(np.abs(shap_array), axis=1)))
+    shap_local(idx_impact, shap_values)
+
+    y_proba_all = pipeline.predict_proba(X)[:, 1]
+    idx_highrisk = int(np.argmax(y_proba_all))
+    shap_local(idx_highrisk, shap_values)
+
+    idx_lowrisk = int(np.argmin(y_proba_all))
+    shap_local(idx_lowrisk, shap_values, text_scale=0.6)
+
+    if custom_index is not None:
+        shap_local(custom_index, shap_values, max_display=8)
+
+
+__all__ = ["compute_shap_summary", "save_shap_summary", "export_local_explanations"]

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/projet_05/features.py

@@ -1,28 +1,170 @@
+from __future__ import annotations
+
+import json
+from datetime import datetime
 from pathlib import Path
 
+import numpy as np
+import pandas as pd
 from loguru import logger
-from tqdm import tqdm
 import typer
 
-from projet_05.config import PROCESSED_DATA_DIR
+from projet_05.config import INTERIM_DATA_DIR, PROCESSED_DATA_DIR
+from projet_05.settings import Settings, load_settings
+
+app = typer.Typer(help="Génération des features et nettoyage de la cible.")
+
+TARGET_MAPPING = {
+    "1": 1,
+    "0": 0,
+    "oui": 1,
+    "non": 0,
+    "true": 1,
+    "false": 0,
+    "quitte": 1,
+    "reste": 0,
+    "yes": 1,
+    "no": 0,
+}
+
+
+# ---------------------------------------------------------------------------
+# Utilitaires cœur de pipeline
+# ---------------------------------------------------------------------------
+def _load_merged_dataset(path: Path) -> pd.DataFrame:
+    if not path.exists():
+        raise FileNotFoundError(
+            f"Le fichier fusionné {path} est introuvable. Lancez `python projet_05/dataset.py` d'abord."
+        )
+    logger.info("Chargement du dataset fusionné depuis {}", path)
+    return pd.read_csv(path)
+
+
+def _normalize_target(df: pd.DataFrame, settings: Settings) -> pd.DataFrame:
+    if settings.target not in df.columns:
+        raise KeyError(f"La variable cible '{settings.target}' est absente du fichier.")
+
+    normalized = (
+        df[settings.target]
+        .astype(str)
+        .str.strip()
+        .str.lower()
+        .map(TARGET_MAPPING)
+    )
+    df = df.copy()
+    df[settings.target] = normalized
+    before = len(df)
+    df = df[df[settings.target].isin([0, 1])].copy()
+    dropped = before - len(df)
+    if dropped:
+        logger.warning("Suppression de {} lignes avec une cible invalide.", dropped)
+    df[settings.target] = df[settings.target].astype(int)
+    return df
+
+
+def _safe_ratio(df: pd.DataFrame, numerator: str, denominator: str, output: str) -> None:
+    if numerator not in df.columns or denominator not in df.columns:
+        return
+    denominator_series = df[denominator].replace({0: np.nan})
+    df[output] = df[numerator] / denominator_series
+
+
+def _engineer_features(df: pd.DataFrame, settings: Settings) -> pd.DataFrame:
+    engineered = df.copy()
 
-app = typer.Typer()
+    col = "augementation_salaire_precedente"
+    if col in engineered:
+        engineered[col] = (
+            engineered[col]
+            .astype(str)
+            .str.replace("%", "", regex=False)
+            .str.replace(",", ".", regex=False)
+            .str.strip()
+        )
+        engineered[col] = pd.to_numeric(engineered[col], errors="coerce") / 100
 
+    _safe_ratio(engineered, "augementation_salaire_precedente", "revenu_mensuel", "augmentation_par_revenu")
+    _safe_ratio(engineered, "annees_dans_le_poste_actuel", "annee_experience_totale", "annee_sur_poste_par_experience")
+    _safe_ratio(engineered, "nb_formations_suivies", "annee_experience_totale", "nb_formation_par_experience")
+    _safe_ratio(
+        engineered, "annees_depuis_la_derniere_promotion", "annee_experience_totale", "dern_promo_par_experience"
+    )
 
+    if settings.sat_cols:
+        existing = [col for col in settings.sat_cols if col in engineered.columns]
+        if existing:
+            engineered["score_moyen_satisfaction"] = engineered[existing].mean(axis=1)
+
+    if "note_evaluation_actuelle" in engineered.columns and "note_evaluation_precedente" in engineered.columns:
+        engineered["evolution_note"] = (
+            engineered["note_evaluation_actuelle"] - engineered["note_evaluation_precedente"]
+        )
+
+    return engineered
+
+
+def build_features(settings: Settings, *, input_path: Path) -> pd.DataFrame:
+    df = _load_merged_dataset(input_path)
+    df = _normalize_target(df, settings)
+    df = _engineer_features(df, settings)
+    return df
+
+
+def save_features(df: pd.DataFrame, output_path: Path) -> None:
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+    df.to_csv(output_path, index=False)
+    logger.success("Dataset enrichi sauvegardé dans {}", output_path)
+
+
+def save_schema(settings: Settings, output_path: Path) -> None:
+    schema = {
+        "target": settings.target,
+        "col_id": settings.col_id,
+        "numerical_features": list(settings.num_cols),
+        "categorical_features": list(settings.cat_cols),
+        "satisfaction_features": list(settings.sat_cols),
+        "generated_at": datetime.utcnow().isoformat(),
+    }
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+    output_path.write_text(json.dumps(schema, indent=2), encoding="utf-8")
+    logger.info("Schéma sauvegardé dans {}", output_path)
+
+
+# ---------------------------------------------------------------------------
+# CLI
+# ---------------------------------------------------------------------------
 @app.command()
 def main(
-    # ---- REPLACE DEFAULT PATHS AS APPROPRIATE ----
-    input_path: Path = PROCESSED_DATA_DIR / "dataset.csv",
-    output_path: Path = PROCESSED_DATA_DIR / "features.csv",
-    # -----------------------------------------
+    settings_path: Path = typer.Option(
+        None,
+        "--settings",
+        "-s",
+        help="Chemin optionnel vers un fichier settings.yml personnalisé.",
+    ),
+    input_path: Path = typer.Option(
+        INTERIM_DATA_DIR / "merged.csv",
+        "--input",
+        "-i",
+        help="Chemin du fichier issu de la fusion.",
+    ),
+    output_path: Path = typer.Option(
+        PROCESSED_DATA_DIR / "dataset.csv",
+        "--output",
+        "-o",
+        help="Chemin du fichier enrichi.",
+    ),
+    schema_path: Path = typer.Option(
+        PROCESSED_DATA_DIR / "schema.json",
+        "--schema",
+        help="Chemin de sauvegarde du schéma de features.",
+    ),
 ):
-    # ---- REPLACE THIS WITH YOUR OWN CODE ----
-    logger.info("Generating features from dataset...")
-    for i in tqdm(range(10), total=10):
-        if i == 5:
-            logger.info("Something happened for iteration 5.")
-    logger.success("Features generation complete.")
-    # -----------------------------------------
+    """Pipeline Typer pour préparer le dataset enrichi."""
+
+    settings = load_settings(settings_path) if settings_path else load_settings()
+    df = build_features(settings, input_path=input_path)
+    save_features(df, output_path)
+    save_schema(settings, schema_path)
 
 
 if __name__ == "__main__":

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/projet_05/modeling/predict.py

@@ -1,29 +1,99 @@
+from __future__ import annotations
+
+import json
 from pathlib import Path
 
+import numpy as np
+import pandas as pd
+from joblib import load
 from loguru import logger
-from tqdm import tqdm
 import typer
 
 from projet_05.config import MODELS_DIR, PROCESSED_DATA_DIR
 
-app = typer.Typer()
+app = typer.Typer(help="Inférence à partir du pipeline entraîné.")
+
+
+def load_pipeline(model_path: Path):
+    if not model_path.exists():
+        raise FileNotFoundError(f"Modèle introuvable: {model_path}")
+    logger.info("Chargement du modèle {}", model_path)
+    return load(model_path)
+
+
+def load_metadata(metadata_path: Path) -> dict:
+    if not metadata_path.exists():
+        raise FileNotFoundError(f"Fichier métadonnées introuvable: {metadata_path}")
+    return json.loads(metadata_path.read_text(encoding="utf-8"))
+
+
+def run_inference(
+    df: pd.DataFrame,
+    pipeline,
+    threshold: float,
+    drop_columns: list[str] | None = None,
+    required_features: list[str] | None = None,
+) -> pd.DataFrame:
+    features = df.drop(columns=drop_columns or [], errors="ignore")
+    if required_features:
+        for col in required_features:
+            if col not in features.columns:
+                features[col] = np.nan
+        features = features[required_features]
+    proba = pipeline.predict_proba(features)[:, 1]
+    predictions = (proba >= threshold).astype(int)
+    output = df.copy()
+    output["proba_depart"] = proba
+    output["prediction"] = predictions
+    return output
 
 
 @app.command()
 def main(
-    # ---- REPLACE DEFAULT PATHS AS APPROPRIATE ----
-    features_path: Path = PROCESSED_DATA_DIR / "test_features.csv",
-    model_path: Path = MODELS_DIR / "model.pkl",
-    predictions_path: Path = PROCESSED_DATA_DIR / "test_predictions.csv",
-    # -----------------------------------------
+    model_path: Path = typer.Option(
+        MODELS_DIR / "best_model.joblib",
+        "--model-path",
+        help="Pipeline entraîné sauvegardé via train.py",
+    ),
+    metadata_path: Path = typer.Option(
+        MODELS_DIR / "best_model_meta.json",
+        "--metadata-path",
+        help="Fichier JSON contenant le seuil optimal.",
+    ),
+    features_path: Path = typer.Option(
+        PROCESSED_DATA_DIR / "dataset.csv",
+        "--features",
+        "-f",
+        help="Jeu de features sur lequel produire des prédictions.",
+    ),
+    predictions_path: Path = typer.Option(
+        PROCESSED_DATA_DIR / "predictions.csv",
+        "--output",
+        "-o",
+        help="Chemin de sauvegarde des prédictions.",
+    ),
 ):
-    # ---- REPLACE THIS WITH YOUR OWN CODE ----
-    logger.info("Performing inference for model...")
-    for i in tqdm(range(10), total=10):
-        if i == 5:
-            logger.info("Something happened for iteration 5.")
-    logger.success("Inference complete.")
-    # -----------------------------------------
+    """Entrypoint Typer pour générer un fichier de prédictions."""
+
+    pipeline = load_pipeline(model_path)
+    metadata = load_metadata(metadata_path)
+    threshold = metadata.get("best_threshold", 0.5)
+    features_cfg = metadata.get("features", {})
+    required_features = (features_cfg.get("numerical") or []) + (features_cfg.get("categorical") or [])
+    df = pd.read_csv(features_path)
+    logger.info("Dataset chargé: {} lignes", len(df))
+
+    target_col = metadata.get("target")
+    predictions = run_inference(
+        df,
+        pipeline,
+        threshold,
+        drop_columns=[target_col] if target_col else None,
+        required_features=required_features or None,
+    )
+    predictions_path.parent.mkdir(parents=True, exist_ok=True)
+    predictions.to_csv(predictions_path, index=False)
+    logger.success("Prédictions sauvegardées dans {}", predictions_path)
 
 
 if __name__ == "__main__":

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/projet_05/modeling/train.py

@@ -1,29 +1,342 @@
+from __future__ import annotations
+
+import json
+from dataclasses import dataclass
 from pathlib import Path
+from typing import Dict, Tuple
 
+import numpy as np
+import pandas as pd
+from imblearn.over_sampling import SMOTE
+from imblearn.pipeline import Pipeline as ImbPipeline
+from joblib import dump
 from loguru import logger
-from tqdm import tqdm
+from sklearn.base import clone
+from sklearn.compose import ColumnTransformer
+from sklearn.ensemble import RandomForestClassifier
+from sklearn.impute import SimpleImputer
+from sklearn.linear_model import LogisticRegression
+from sklearn.metrics import (
+    f1_score,
+    precision_recall_curve,
+    precision_score,
+    recall_score,
+    roc_auc_score,
+)
+from sklearn.model_selection import GridSearchCV, StratifiedKFold, cross_val_predict
+from sklearn.pipeline import Pipeline
+from sklearn.preprocessing import OneHotEncoder, StandardScaler
 import typer
 
-from projet_05.config import MODELS_DIR, PROCESSED_DATA_DIR
+from projet_05.config import MODELS_DIR, PROCESSED_DATA_DIR, REPORTS_DIR
+from projet_05.explainability import (
+    compute_shap_summary,
+    export_local_explanations,
+    save_shap_summary,
+)
+from projet_05.settings import Settings, load_settings
+
+app = typer.Typer(help="Entraînement et sélection du meilleur modèle.")
+
+
+def _clean_values(payload: dict) -> dict:
+    def _convert(value):
+        if isinstance(value, (np.floating, np.integer)):
+            return value.item()
+        return value
+
+    return {key: _convert(value) for key, value in payload.items()}
+
+
+@dataclass
+class ModelResult:
+    name: str
+    best_estimator: ImbPipeline
+    best_params: dict
+    best_threshold: float
+    metrics: Dict[str, float]
+
+
+def load_processed_dataset(path: Path) -> pd.DataFrame:
+    if not path.exists():
+        raise FileNotFoundError(
+            f"Dataset traité introuvable ({path}). Lancez `python projet_05/features.py`."
+        )
+    logger.info("Chargement du dataset préparé depuis {}", path)
+    return pd.read_csv(path)
+
+
+def split_features_target(df: pd.DataFrame, settings: Settings) -> Tuple[pd.DataFrame, pd.Series]:
+    if settings.target not in df.columns:
+        raise KeyError(f"La cible {settings.target} est absente du dataset.")
+    y = df[settings.target].astype(int)
+    drop_cols = [settings.target]
+    if settings.col_id in df.columns:
+        drop_cols.append(settings.col_id)
+    X = df.drop(columns=drop_cols, errors="ignore")
+    return X, y
+
+
+def build_preprocessor(settings: Settings, X: pd.DataFrame) -> ColumnTransformer:
+    numeric_features = [col for col in settings.num_cols if col in X.columns]
+    categorical_features = [col for col in settings.cat_cols if col in X.columns]
+    if not numeric_features:
+        numeric_features = X.select_dtypes(include="number").columns.tolist()
+    if not categorical_features:
+        categorical_features = X.select_dtypes(exclude="number").columns.tolist()
+
+    numeric_transformer = Pipeline(
+        steps=[
+            ("imputer", SimpleImputer(strategy="median")),
+            ("scaler", StandardScaler()),
+        ]
+    )
+    categorical_transformer = Pipeline(
+        steps=[
+            ("imputer", SimpleImputer(strategy="most_frequent")),
+            ("encoder", OneHotEncoder(handle_unknown="ignore", sparse_output=False)),
+        ]
+    )
+    transformers = []
+    if numeric_features:
+        transformers.append(("num", numeric_transformer, numeric_features))
+    if categorical_features:
+        transformers.append(("cat", categorical_transformer, categorical_features))
+    if not transformers:
+        raise ValueError("Aucune feature disponible pour l'entraînement.")
+    return ColumnTransformer(transformers=transformers)
+
+
+def get_models(random_state: int):
+    return {
+        "LogReg_balanced": (
+            LogisticRegression(
+                max_iter=2000,
+                class_weight="balanced",
+                random_state=random_state,
+            ),
+            [
+                {
+                    "clf__solver": ["lbfgs"],
+                    "clf__penalty": ["l2"],
+                    "clf__C": [0.1, 1.0, 10.0],
+                },
+                {
+                    "clf__solver": ["liblinear"],
+                    "clf__penalty": ["l1", "l2"],
+                    "clf__C": [0.1, 1.0, 10.0],
+                },
+            ],
+        ),
+        "RF_balanced": (
+            RandomForestClassifier(
+                n_estimators=300,
+                max_depth=8,
+                min_samples_split=10,
+                min_samples_leaf=5,
+                class_weight="balanced_subsample",
+                random_state=random_state,
+            ),
+            {
+                "clf__n_estimators": [200, 300, 500],
+                "clf__max_depth": [6, 8, 10],
+                "clf__min_samples_split": [5, 10, 15],
+                "clf__min_samples_leaf": [2, 5, 8],
+            },
+        ),
+    }
+
 
-app = typer.Typer()
+def _compute_best_threshold(y_true, y_proba):
+    precision, recall, thresholds = precision_recall_curve(y_true, y_proba)
+    f1_scores = 2 * (precision * recall) / (precision + recall + 1e-8)
+    best_idx = np.nanargmax(f1_scores)
+    if thresholds.size == 0:
+        return 0.5
+    best_idx = min(best_idx, thresholds.size - 1)
+    return thresholds[best_idx]
+
+
+def evaluate_models(X, y, settings: Settings, preprocessor: ColumnTransformer) -> list[ModelResult]:
+    cv = StratifiedKFold(n_splits=5, shuffle=True, random_state=settings.random_state)
+    results: list[ModelResult] = []
+
+    for name, (model, grid) in get_models(settings.random_state).items():
+        logger.info("Entraînement du modèle {}", name)
+        pipe = ImbPipeline(
+            steps=[
+                ("prep", preprocessor),
+                ("smote", SMOTE(random_state=settings.random_state)),
+                ("clf", model),
+            ]
+        )
+        search = GridSearchCV(
+            estimator=pipe,
+            param_grid=grid,
+            cv=cv,
+            scoring="f1",
+            n_jobs=-1,
+        )
+        search.fit(X, y)
+        best_pipe = search.best_estimator_
+
+        y_proba = cross_val_predict(best_pipe, X, y, cv=cv, method="predict_proba")[:, 1]
+        threshold = _compute_best_threshold(y, y_proba)
+        y_pred = (y_proba >= threshold).astype(int)
+
+        metrics = {
+            "f1": f1_score(y, y_pred),
+            "recall": recall_score(y, y_pred),
+            "precision": precision_score(y, y_pred),
+            "roc_auc": roc_auc_score(y, y_proba),
+        }
+        logger.info("Scores {} -> {}", name, metrics)
+        results.append(
+            ModelResult(
+                name=name,
+                best_estimator=best_pipe,
+                best_params=search.best_params_,
+                best_threshold=threshold,
+                metrics=metrics,
+            )
+        )
+    return results
+
+
+def compute_dummy_baseline(y: pd.Series) -> dict:
+    majority = int(y.mode().iloc[0])
+    y_pred = np.full_like(y, fill_value=majority)
+    return {
+        "strategy": "most_frequent",
+        "majority_class": majority,
+        "f1": f1_score(y, y_pred),
+        "recall": recall_score(y, y_pred),
+        "precision": precision_score(y, y_pred, zero_division=0),
+        "roc_auc": 0.5,
+    }
+
+
+def fit_final_pipeline(
+    best_result: ModelResult,
+    X: pd.DataFrame,
+    y: pd.Series,
+    settings: Settings,
+):
+    sm = SMOTE(random_state=settings.random_state)
+    X_bal, y_bal = sm.fit_resample(X, y)
+    final_preprocessor = build_preprocessor(settings, X)
+    clf = clone(best_result.best_estimator.named_steps["clf"])
+    final_pipe = Pipeline(
+        steps=[
+            ("prep", final_preprocessor),
+            ("clf", clf),
+        ]
+    )
+    final_pipe.fit(X_bal, y_bal)
+    logger.success(
+        "Modèle {} ré-entraîné sur {} lignes équilibrées.", best_result.name, len(X_bal)
+    )
+    return final_pipe
+
+
+def save_artifacts(
+    pipeline: Pipeline,
+    results: list[ModelResult],
+    best_result: ModelResult,
+    baseline: dict,
+    settings: Settings,
+    model_path: Path,
+    metadata_path: Path,
+    shap_path: Path,
+    X: pd.DataFrame,
+    y: pd.Series,
+):
+    model_path.parent.mkdir(parents=True, exist_ok=True)
+    dump(pipeline, model_path)
+    logger.success("Pipeline sauvegardé dans {}", model_path)
+
+    metadata = {
+        "best_model": best_result.name,
+        "best_threshold": float(best_result.best_threshold),
+        "best_params": best_result.best_params,
+        "metrics": _clean_values(best_result.metrics),
+        "all_results": [
+            {
+                "model": r.name,
+                "metrics": _clean_values(r.metrics),
+                "best_threshold": float(r.best_threshold),
+                "best_params": r.best_params,
+            }
+            for r in results
+        ],
+        "baseline": _clean_values(baseline),
+        "features": {
+            "numerical": list(settings.num_cols),
+            "categorical": list(settings.cat_cols),
+        },
+        "target": settings.target,
+    }
+    metadata_path.parent.mkdir(parents=True, exist_ok=True)
+    metadata_path.write_text(json.dumps(metadata, indent=2), encoding="utf-8")
+    logger.info("Métadonnées sauvegardées dans {}", metadata_path)
+
+    shap_summary, shap_values = compute_shap_summary(pipeline, X, y)
+    if shap_summary is not None:
+        save_shap_summary(shap_summary, shap_path)
+        export_local_explanations(pipeline, shap_values, X)
 
 
 @app.command()
 def main(
-    # ---- REPLACE DEFAULT PATHS AS APPROPRIATE ----
-    features_path: Path = PROCESSED_DATA_DIR / "features.csv",
-    labels_path: Path = PROCESSED_DATA_DIR / "labels.csv",
-    model_path: Path = MODELS_DIR / "model.pkl",
-    # -----------------------------------------
+    settings_path: Path = typer.Option(None, "--settings", "-s", help="Chemin alternatif vers settings.yml."),
+    input_path: Path = typer.Option(
+        PROCESSED_DATA_DIR / "dataset.csv",
+        "--input",
+        "-i",
+        help="Dataset enrichi issu de projet_05/features.py",
+    ),
+    model_path: Path = typer.Option(
+        MODELS_DIR / "best_model.joblib",
+        "--model-path",
+        help="Chemin de sauvegarde du pipeline entraîné.",
+    ),
+    metadata_path: Path = typer.Option(
+        MODELS_DIR / "best_model_meta.json",
+        "--metadata-path",
+        help="Chemin de sauvegarde des métriques et métadonnées.",
+    ),
+    shap_path: Path = typer.Option(
+        REPORTS_DIR / "shap_summary.csv",
+        "--shap-path",
+        help="Chemin de sortie du résumé SHAP.",
+    ),
 ):
-    # ---- REPLACE THIS WITH YOUR OWN CODE ----
-    logger.info("Training some model...")
-    for i in tqdm(range(10), total=10):
-        if i == 5:
-            logger.info("Something happened for iteration 5.")
-    logger.success("Modeling training complete.")
-    # -----------------------------------------
+    """Script principal pour lancer l'entraînement complet."""
+
+    settings = load_settings(settings_path) if settings_path else load_settings()
+    df = load_processed_dataset(input_path)
+    X, y = split_features_target(df, settings)
+    preprocessor = build_preprocessor(settings, X)
+    results = evaluate_models(X, y, settings, preprocessor)
+    if not results:
+        raise RuntimeError("Aucun modèle évalué. Vérifiez la configuration.")
+    best_result = max(results, key=lambda r: r.metrics["f1"])
+    baseline = compute_dummy_baseline(y)
+    logger.info("Baseline Dummy -> {}", baseline)
+
+    final_pipeline = fit_final_pipeline(best_result, X, y, settings)
+    save_artifacts(
+        final_pipeline,
+        results,
+        best_result,
+        baseline,
+        settings,
+        model_path,
+        metadata_path,
+        shap_path,
+        X,
+        y,
+    )
 
 
 if __name__ == "__main__":

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/projet_05/settings.py

@@ -0,0 +1,114 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from functools import lru_cache
+import os
+from pathlib import Path
+from typing import Iterable
+
+import yaml
+
+DEFAULT_SETTINGS_PATH = Path(__file__).with_name("settings.yml")
+
+
+@dataclass(frozen=True)
+class Settings:
+    random_state: int = 42
+    path_sirh: Path = field(default_factory=lambda: Path("data/raw/sirh.csv"))
+    path_eval: Path = field(default_factory=lambda: Path("data/raw/evaluation.csv"))
+    path_sondage: Path = field(default_factory=lambda: Path("data/raw/sondage.csv"))
+    col_id: str = "id_employee"
+    target: str = "a_quitte_l_entreprise"
+    num_cols: tuple[str, ...] = ()
+    cat_cols: tuple[str, ...] = ()
+    sat_cols: tuple[str, ...] = ()
+    first_vars: tuple[str, ...] = ()
+    subsample_frac: float = 1.0
+    sql_file: Path = field(default_factory=lambda: Path("merge_sql.sql"))
+    db_file: Path = field(default_factory=lambda: Path("merge_temp.db"))
+
+    def as_dict(self) -> dict:
+        """Return a serializable representation (useful for logging/tests)."""
+        return {
+            "random_state": self.random_state,
+            "path_sirh": str(self.path_sirh),
+            "path_eval": str(self.path_eval),
+            "path_sondage": str(self.path_sondage),
+            "col_id": self.col_id,
+            "target": self.target,
+            "num_cols": list(self.num_cols),
+            "cat_cols": list(self.cat_cols),
+            "sat_cols": list(self.sat_cols),
+            "first_vars": list(self.first_vars),
+            "subsample_frac": self.subsample_frac,
+            "sql_file": str(self.sql_file),
+            "db_file": str(self.db_file),
+        }
+
+
+def _ensure_iterable(values: Iterable[str] | None, *, field_name: str) -> tuple[str, ...]:
+    if values is None:
+        return ()
+    if isinstance(values, str):
+        msg = f"'{field_name}' doit être une liste et non une chaîne isolée."
+        raise TypeError(msg)
+    return tuple(v for v in values if v)
+
+
+def _resolve_path(candidate: str | os.PathLike[str] | None, *, base_dir: Path) -> Path:
+    if not candidate:
+        raise ValueError("Aucun chemin n'a été fourni dans le fichier de configuration.")
+    resolved = Path(candidate)
+    if not resolved.is_absolute():
+        resolved = (base_dir / resolved).resolve()
+    return resolved
+
+
+def _load_raw_settings(path: Path) -> dict:
+    with path.open("r", encoding="utf-8") as handle:
+        data = yaml.safe_load(handle) or {}
+    if not isinstance(data, dict):
+        raise ValueError(f"Le fichier de configuration {path} doit contenir un dictionnaire YAML.")
+    return data
+
+
+@lru_cache
+def load_settings(custom_path: str | os.PathLike[str] | None = None) -> Settings:
+    """
+    Charger la configuration projet depuis un fichier YAML.
+
+    L'ordre de recherche est :
+    1. Argument `custom_path` si fourni.
+    2. Variable d'environnement `PROJET05_SETTINGS`.
+    3. Fichier par défaut `projet_05/settings.yml`.
+    """
+
+    env_path = os.environ.get("PROJET05_SETTINGS")
+    raw_path = Path(custom_path or env_path or DEFAULT_SETTINGS_PATH)
+
+    if not raw_path.exists():
+        raise FileNotFoundError(
+            f"Fichier de configuration introuvable : {raw_path}. "
+            "Initialisez-le depuis projet_05/settings.yml ou indiquez PROJET05_SETTINGS."
+        )
+
+    base_dir = raw_path.parent
+    payload = _load_raw_settings(raw_path)
+    paths_block = payload.get("paths", {})
+
+    settings = Settings(
+        random_state=int(payload.get("random_state", Settings.random_state)),
+        path_sirh=_resolve_path(paths_block.get("sirh", Settings().path_sirh), base_dir=base_dir),
+        path_eval=_resolve_path(paths_block.get("evaluation", Settings().path_eval), base_dir=base_dir),
+        path_sondage=_resolve_path(paths_block.get("sondage", Settings().path_sondage), base_dir=base_dir),
+        col_id=payload.get("col_id", Settings.col_id),
+        target=payload.get("target", Settings.target),
+        num_cols=_ensure_iterable(payload.get("num_cols"), field_name="num_cols"),
+        cat_cols=_ensure_iterable(payload.get("cat_cols"), field_name="cat_cols"),
+        sat_cols=_ensure_iterable(payload.get("sat_cols"), field_name="sat_cols"),
+        first_vars=_ensure_iterable(payload.get("first_vars"), field_name="first_vars"),
+        subsample_frac=float(payload.get("subsample_frac", Settings.subsample_frac)),
+        sql_file=_resolve_path(paths_block.get("sql_file", Settings().sql_file), base_dir=base_dir),
+        db_file=_resolve_path(paths_block.get("db_file", Settings().db_file), base_dir=base_dir),
+    )
+    return settings

hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/hf_space/projet_05/settings.yml

@@ -0,0 +1,56 @@
+random_state: 42
+col_id: id_employee
+target: a_quitte_l_entreprise
+subsample_frac: 0.5
+
+paths:
+  sirh: ../data/raw/sirh.csv
+  evaluation: ../data/raw/evaluation.csv
+  sondage: ../data/raw/sondage.csv
+  sql_file: ../reports/merge_sql.sql
+  db_file: ../data/interim/merge_temp.db
+
+num_cols:
+  - age
+  - revenu_mensuel
+  - annees_dans_l_entreprise
+  - annees_dans_le_poste_actuel
+  - annees_depuis_la_derniere_promotion
+  - distance_domicile_travail
+  - nombre_participation_pee
+  - note_evaluation_actuelle
+  - note_evaluation_precedente
+  - annees_depuis_le_changement_deposte
+  - annee_experience_totale
+  - nb_formations_suivies
+  - satisfaction_employee_environnement
+  - satisfaction_employee_nature_travail
+  - satisfaction_employee_equipe
+  - satisfaction_employee_equilibre_pro_perso
+  - augmentation_par_revenu
+  - annee_sur_poste_par_experience
+  - nb_formation_par_experience
+  - score_moyen_satisfaction
+  - dern_promo_par_experience
+  - evolution_note
+
+cat_cols:
+  - genre
+  - departement
+  - frequence_deplacement
+  - etat_civil
+  - niveau_etudes
+  - role
+  - type_contrat
+
+sat_cols:
+  - satisfaction_employee_environnement
+  - satisfaction_employee_nature_travail
+  - satisfaction_employee_equipe
+  - satisfaction_employee_equilibre_pro_perso
+
+first_vars:
+  - age
+  - revenu_mensuel
+  - annees_dans_l_entreprise
+  - note_evaluation_actuelle