README.md

---
title: Superstore Profit API
emoji: ⚡
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
tags:
- data-analytics
- superstore
- fastapi
- machine-learning
- python
pinned: false
license: cc-by-nc-sa-4.0
---

# 🚀 Superstore Profit API

Ce Space héberge l'**API backend** du [*projet d'analyse et de prédiction des ventes Superstore*](https://mayal-superstore.streamlit.app). 

## 🎯 Ce que c'est et ce que ça fait

Développée avec **FastAPI**, cette API REST est un microservice sécurisé dont le rôle est de servir les prédictions de notre [*modèle de Machine Learning*](https://huggingface.co/kjd-dktech/superstore-profit-predictor).

Son objectif principal est de **prédire le profit (la marge) généré par des transactions de vente au détail** en fonction de plusieurs caractéristiques (Montant des ventes, Taux de réduction, Sous-catégorie de produit, Région, Segment client). 

Elle gère de manière autonome :
- L'inférence du modèle (prédictions unitaires ou par lots).
- L'authentification des utilisateurs (génération et validation de clés API hachées).
- La limitation des requêtes (Rate-Limiting) pour éviter les abus.
- Une interface d'administration intégrée.

## 🔗 Liens utiles

- **Interface utilisateur (Dashboard Frontend) :** [mayal-superstore.streamlit.app](https://mayal-superstore.streamlit.app)
- **Code source complet :** [GitHub - kjd-dktech/superstore-sales-analytics](https://github.com/kjd-dktech/superstore-sales-analytics)
- **Modèle ML utilisé :** [Hugging Face - kjd-dktech/superstore-profit-predictor](https://huggingface.co/kjd-dktech/superstore-profit-predictor)