🎮 Neptunia - Analyse de Données League of Legends

📝 Description

Application Streamlit dédiée à l'analyse de performances et de données pour l'équipe esport Neptunia sur League of Legends. Cette application permet de tracker les statistiques des joueurs, analyser les matchs d'entraînement (scrims) et les matchs officiels, ainsi que de générer des dashboards de performance d'équipe.

✨ Fonctionnalités

🏠 Page Principale

• Interface d'accueil avec branding Neptunia
• Navigation vers les différents modules d'analyse

📊 Tracker (SoloQ)

• Statistiques individuelles : Suivi des performances en SoloQ pour chaque joueur
• Métriques suivies :
  • Win/Loss ratio
  • KDA (Kill/Death/Assist)
  • CSD@15 (Creep Score Difference à 15 min)
  • Vision Score
  • XP@15 (Différence d'XP à 15 minutes)
  • DPM (Damage par Minute)
  • DPG (Damage par Gold)
  • KP (Kill Participation)
• Onglets par joueur : Données organisées par position
• Intégration Google Sheets : Synchronisation automatique des données

🎯 Scrims

• Gestion et analyse des matchs d'entraînement
• Suivi des performances en équipe
• Analyse comparative des différentes compositions

🏆 Games Officiels

• Analyse des matchs officiels
• Statistiques de compétition
• Historique des performances

📈 Dashboard Équipe

• Statistiques générales : Vue d'ensemble des performances d'équipe
• Données par joueur : Analyses individuelles approfondies
• Ajout de scrims : Interface pour enregistrer de nouveaux matchs d'entraînement
• Bases de données : Choix entre SCRIM et GA (Games Officiels)

🛠️ Technologies Utilisées

• Frontend : Streamlit
• Données : Pandas, NumPy
• API : Riot Games API
• Base de données : MongoDB (PyMongo)
• Stockage : Google Sheets (gspread)
• Visualisation : Plotly
• Autres : python-dotenv, ratelimit

🚀 Installation

Prérequis

• Python 3.8+
• Clé API Riot Games
• Compte de service Google pour l'accès aux Sheets
• Base de données MongoDB

Installation des dépendances

pip install -r requirements.txt

Configuration

1. Variables d'environnement : Créer un fichier .env avec :

   api_riot_key=votre_cle_api_riot
   API_RIO_KEY_TEMP=cle_api_secondaire

"URI_MONGO" = clef_Mongo

2. **Google Sheets** : Placer le fichier JSON d'authentification

3. **MongoDB** : Configurer la connexion à votre base de données MongoDB

## 🎯 Utilisation

### Lancement de l'application
```bash
streamlit run main.py

Navigation

• Tracker : Consultez les statistiques SoloQ des joueurs
• Scrims : Analysez les matchs d'entraînement
• Games Officiels : Examinez les performances en compétition
• Dashboard Équipe : Vue d'ensemble et gestion des données

👥 Équipe Neptunia

Composition actuelle

• TOP : NEP Zerkome
• JUNGLE : Furosse le prout
• MIDDLE : Astrosine
• BOTTOM : Idirzz
• UTILITY : Jojonnyjohnson

📊 Structure des Données

Métriques Principales

• CSD@15 : Différence de sbires à 15 minutes
• KDA : Ratio Kill/Death/Assist
• Vision Score : Impact en vision (wards posés/détectés)
• XP@15 : Différence d'expérience à 15 minutes
• DPM : Dégâts par minute
• DPG : Dégâts par or dépensé
• KP : Participation aux kills d'équipe

Sources de Données

• Riot API : Données de matchs en temps réel
• Google Sheets : Stockage et synchronisation
• MongoDB : Base de données pour les analyses avancées

🔧 Architecture

Data-Analyse-Streamlit-Esport/
├── main.py                 # Application principale
├── main_fonction.py        # Fonctions API Riot
├── tracker.py             # Logique du tracker
├── constants.py           # Configuration des joueurs
├── pages/                 # Pages Streamlit
│   ├── 1_Tracker.py
│   ├── 2_Scrims.py
│   ├── 3_Game officiel.py
│   └── 4_Dashboard_Team.py
├── fonction/              # Modules fonctionnels
│   ├── _dashboard.py
│   ├── _extraction_games.py
│   ├── _mongo.py
│   └── _misc.py
├── img/                   # Ressources visuelles
└── JSONs/                 # Fichiers de configuration

🎨 Interface

L'application utilise un design personnalisé avec :

• Logo Neptunia : Branding de l'équipe
• Couleurs thématiques : Design cohérent avec l'identité visuelle
• Navigation intuitive : Accès facile aux différentes fonctionnalités
• Responsive design : Compatible avec différentes tailles d'écran

🤝 Contribution

Développé par LynxSheep

Pour contribuer au projet :

1. Fork le repository
2. Créer une branche pour votre fonctionnalité
3. Commit vos changements
4. Push vers la branche
5. Créer une Pull Request

📄 Licence

Ce projet est destiné à l'usage exclusif de l'équipe Neptunia et à des fins éducatives.

📞 Support

Pour toute question ou support, contactez @LxSheep_ sur Twitter/X.

---

Développé avec ❤️ pour l'équipe Neptunia