Renewgy Excel to CSV Parser

Un parser ultra-robuste et intelligent pour convertir les fichiers Excel de Renewgy en format CSV standardisé. Solution enterprise avec détection automatique avancée, gestion complète des EAN bi-horaires et interface moderne conçue pour l'efficacité, la simplicité d'utilisation et l'intégration transparente dans des workflows de traitement de données.

✨ Caractéristiques principales

🧠 Intelligence automatique : Détection dynamique des colonnes, structure et format des fichiers Excel
⚡ Gestion EAN bi-horaires : Support automatique des tarifs peak/off-peak avec génération de fichiers séparés
🎯 Sélection du type de puissance : Choix entre consommation active, inductive ou capacitive
📝 Noms de fichiers intelligents : Génération automatique avec suffixes (_active, _inductive, _capacitive, _peak, _offpeak)
🔄 Workflow universel simplifié : Dossiers d'entrée et de sortie fixes (excel_files/ → csv_files/)
🌐 Compatibilité multiplateforme : Fonctionne sur macOS, Linux et Windows
🚀 Launchers intelligents : Automatisation complète de l'installation et du déploiement
💻 Interface web moderne : Design ergonomique avec feedback en temps réel
📦 Traitement par lots intelligent : Personnalisation individuelle par fichier (nom, date, feuille, type de puissance)
🔧 Double mode d'utilisation : Interface web conviviale ou CLI pour l'automatisation
⚙️ Configuration zéro : Workflow entièrement automatisé avec détection intelligente
🛡️ Robustesse enterprise : Validation rigoureuse, gestion d'erreurs et logging professionnel
🐳 Prêt pour la production : Support Docker avec launcher automatique

🔧 Fonctionnalités détaillées

🎯 Sélection intelligente du type de puissance

Types supportés : Active, Inductive (réactive), Capacitive (réactive)
Détection automatique : Reconnaissance des colonnes de puissance dans les fichiers Excel
Noms de fichiers automatiques : Suffixes _active, _inductive, _capacitive pour éviter l'écrasement
Interface utilisateur : Sélection dynamique avec mise à jour automatique du nom de fichier

⚡ Gestion avancée des EAN bi-horaires

Détection automatique : Reconnaissance des EAN avec tarification peak/off-peak
Configuration flexible : Règles horaires personnalisables via ean_config.json
Génération de fichiers séparés : Automatiquement _peak.csv et _offpeak.csv
Règles horaires par défaut :
- Peak : 07h00-22h00 (lundi-vendredi uniquement)
- Off-peak : 22h00-07h00 (lundi-vendredi) + tout le weekend

🧠 Détection automatique intelligente

Structure dynamique : Détection automatique des en-têtes et début des données
Colonnes flexibles : Reconnaissance automatique des colonnes timestamp et valeurs
Validation robuste : Vérification de l'intégrité des données et de la structure
Formats multiples : Support de diverses structures de fichiers Excel Renewgy

📊 Traitement et conversion

Conversion Excel vers CSV : Traitement automatique avec validation complète
Filtrage par date personnalisable : Traitement des données à partir d'une date spécifique
Sélection de feuille : Configuration de l'index de feuille Excel à traiter
Mapping EAN configurable : Support des fichiers de configuration externes sécurisés
Logging multi-niveaux : Verbose, normal, quiet selon vos besoins

🎨 Interface utilisateur avancée

Interface responsive : Fonctionne sur desktop, tablette et mobile
Mode single et batch : Traitement d'un fichier ou par lots
Personnalisation en temps réel : Options par fichier avec prévisualisation
Feedback instantané : Messages d'état et indicateurs de progression
Gestion d'erreurs intelligente : Rapports détaillés avec solutions suggérées

📋 Prérequis

Python 3.10+ (recommandé : 3.11 ou plus récent)
Dépendances Python : pandas, openpyxl, flask (installées automatiquement)
Fichier de configuration EAN obligatoire (voir Configuration)

Dépendances Python

pandas>=1.5.0
openpyxl>=3.0.0
flask>=2.0.0

🚀 Installation Ultra-Simplifiée

Launchers Automatiques (Recommandé)

Les launchers gèrent automatiquement l'installation complète et le lancement sur macOS, Linux et Windows :

Clonez le projet :

git clone https://github.com/BricePetit/RenewgyParser.git
cd RenewgyParser

Créez votre fichier de configuration EAN (voir Configuration)
Lancez directement selon votre plateforme :

macOS / Linux :

# Interface web avec Docker (recommandé).
./launcher_docker.sh

# Interface web locale avec environnement virtuel Python.
./launcher_python.sh

Windows :

REM Interface web avec Docker (recommandé).
launcher_docker.bat

REM Interface web locale avec environnement virtuel Python.
launcher_python.bat

Les launchers s'occupent automatiquement de :

Vérification et installation des dépendances
Configuration d'environnement (virtuel Python ou Docker)
Création des dossiers requis
Validation de la configuration
Démarrage de l'interface web

Installation Manuelle

Pour un contrôle manuel ou l'intégration dans des workflows existants :

Option A : Installation locale

pip install -r requirements.txt
python renewgy_parser_gui.py

Option B : Docker manuel

# Construction de l'image.
docker build -t renewgy-parser .

# Lancement.
docker-compose up renewgy-web-interface

📖 Utilisation

Important : Un fichier de configuration EAN est obligatoire pour toutes les opérations.

🌐 Interface Web (Recommandé)

Architecture simplifiée avec dossiers prédéfinis :

Dossier d'entrée : excel_files/
Dossier de sortie : csv_files/
Workflow : Déposez vos fichiers Excel → Traitez via l'interface → Récupérez les CSV

Lancement avec Launchers

macOS / Linux :

# Docker (recommandé) - Configuration automatique complète.
./launcher_docker.sh

# Python local - Environnement virtuel automatique.
./launcher_python.sh

Windows :

REM Docker (recommandé) - Configuration automatique complète.
launcher_docker.bat

REM Python local - Environnement virtuel automatique.
launcher_python.bat

Interface accessible sur http://localhost:5001

Lancement Manuel

Local :

python renewgy_parser_gui.py

Docker :

# Avec Docker Compose (Simple).
docker-compose up renewgy-web-interface

# Avec Docker directement.
docker run -it --rm -p 5001:5000 \
  -v "$(pwd)/excel_files:/renewgy/excel_files" \
  -v "$(pwd)/csv_files:/renewgy/csv_files" \
  -v "$(pwd)/ean_config.json:/renewgy/ean_config.json" \
  renewgy-parser

Fonctionnalités de l'interface web

Mode Single (Fichier unique) :

Sélection de fichier : Choix parmi les fichiers disponibles dans excel_files/
Type de puissance : Sélection entre Active, Inductive ou Capacitive
Nom de sortie intelligent : Génération automatique avec suffixe selon le type (_active, _inductive, _capacitive)
EAN bi-horaires : Génération automatique de deux fichiers _peak.csv et _offpeak.csv
Filtrage par date : Traitement à partir d'une date spécifique
Configuration de feuille : Sélection de l'index de feuille Excel
Options avancées : Accès complet aux paramètres de configuration

Mode Batch (Traitement par lots) :

Traitement multiple : Affichage et traitement de tous les fichiers Excel
Personnalisation individuelle :
- Type de puissance : Choix par fichier avec mise à jour du nom
- Nom de sortie : Génération automatique avec suffixes intelligents
- Date de début : Filtrage personnalisé par fichier
- Index de feuille : Configuration spécifique par fichier
Gestion EAN bi-horaires : Traitement automatique avec fichiers séparés
Traitement simultané : Processus unifié pour tous les fichiers sélectionnés

Fonctionnalités communes :

Monitoring en temps réel : Suivi détaillé du traitement
Interface responsive : Compatible desktop, tablette et mobile
Feedback instantané : Messages d'état et indicateurs de progression
Gestion d'erreurs : Rapports détaillés avec solutions suggérées

💻 Interface en Ligne de Commande

Pour l'intégration dans des scripts ou l'automatisation avancée. Toutes les nouvelles fonctionnalités sont disponibles via CLI.

Traitement d'un fichier unique

# Traitement basique avec type de puissance active (défaut).
python renewgy_parser.py --input input.xlsx --output output.csv --config ean_config.json

# Sélection du type de puissance (active, inductive, capacitive).
python renewgy_parser.py --input input.xlsx --output output.csv --config ean_config.json --power-type inductive

# Le nom de fichier sera automatiquement suffixé : output_inductive.csv
# Pour les EAN bi-horaires : output_inductive_peak.csv et output_inductive_offpeak.csv

# Avec filtrage par date.
python renewgy_parser.py --input input.xlsx --output output.csv --config ean_config.json --start-date 2023-01-01 --power-type capacitive

# Avec logging verbose.
python renewgy_parser.py --input input.xlsx --output output.csv --config ean_config.json --verbose --power-type active

Traitement par lots

# Traitement de tous les fichiers Excel avec type de puissance par défaut.
python renewgy_parser.py --batch-input ./excel_files --batch-output ./csv_files --config ean_config.json

# Avec type de puissance spécifique pour tous les fichiers.
python renewgy_parser.py --batch-input ./excel_files --batch-output ./csv_files --config ean_config.json --power-type inductive

# Avec filtrage par date.
python renewgy_parser.py --batch-input ./excel_files --batch-output ./csv_files --config ean_config.json --start-date 2023-06-01 --power-type capacitive

# Avec pattern personnalisé.
python renewgy_parser.py --batch-input ./excel_files --batch-output ./csv_files --config ean_config.json --pattern "*specific*" --power-type active

Configuration et options avancées

# Type de puissance avec fichier de configuration EAN personnalisé.
python renewgy_parser.py --input input.xlsx --output output.csv --config mon_config.json --power-type inductive

# Spécification de l'index de la feuille Excel avec type de puissance.
python renewgy_parser.py --input input.xlsx --output output.csv --config ean_config.json --sheet-index 0 --power-type capacitive

# Combinaison de plusieurs options avec nouvelles fonctionnalités.
python renewgy_parser.py --input input.xlsx --output output.csv --config ean_config.json --sheet-index 1 --start-date 2023-01-01 --power-type active --verbose

Exemples de gestion automatique des noms de fichiers

# Fichier standard avec puissance active.
# Input: data.xlsx → Output: data_active.csv
python renewgy_parser.py --input data.xlsx --output data.csv --config ean_config.json --power-type active

# EAN bi-horaire avec puissance inductive.
# Input: ean_bihoraire.xlsx → Output: ean_bihoraire_inductive_peak.csv + ean_bihoraire_inductive_offpeak.csv
python renewgy_parser.py --input ean_bihoraire.xlsx --output ean_bihoraire.csv --config ean_config.json --power-type inductive

# Traitement par lots avec suffixes automatiques.
# Tous les fichiers auront le suffixe _capacitive, et les EAN bi-horaires auront _peak/_offpeak en plus
python renewgy_parser.py --batch-input ./excel_files --batch-output ./csv_files --config ean_config.json --power-type capacitive

Arguments disponibles

python renewgy_parser.py --help

Argument	Description	Obligatoire	Valeurs possibles
`--input`	Fichier Excel d'entrée	Oui (mode fichier unique)	Chemin vers fichier .xlsx
`--output`	Fichier CSV de sortie	Oui (mode fichier unique)	Chemin vers fichier .csv
`--batch-input`	Dossier d'entrée pour le traitement par lots	Oui (mode batch)	Chemin vers dossier
`--batch-output`	Dossier de sortie pour le traitement par lots	Oui (mode batch)	Chemin vers dossier
`--config`	Fichier de configuration EAN	Toujours obligatoire	Chemin vers fichier .json
`--power-type`	Type de puissance à traiter	Non	`active`, `inductive`, `capacitive` (défaut: `active`)
`--sheet-index`	Index de la feuille Excel	Non	Entier (défaut: 2)
`--pattern`	Pattern de fichiers pour le mode batch	Non	Pattern glob (ex: `specific`)
`--start-date`	Date de début au format YYYY-MM-DD	Non	Date ISO (ex: `2023-01-01`)
`--verbose`	Affichage détaillé	Non	Flag (pas de valeur)
`--quiet`	Affichage minimal	Non	Flag (pas de valeur)

Nouvelles fonctionnalités :

--power-type : Définit le type de puissance et génère automatiquement le suffixe approprié
Gestion EAN bi-horaires : Détection automatique, génération de fichiers _peak et _offpeak
Noms intelligents : Suffixe automatique selon le type de puissance pour éviter l'écrasement

⚙️ Configuration

Fichier de configuration EAN (Obligatoire)

Important : Un fichier de configuration EAN est obligatoire pour utiliser ce parser. Aucun mapping par défaut n'est inclus pour des raisons de sécurité.

Étape obligatoire : Créez un fichier ean_config.json dans le répertoire racine :

{
  "example_ean_standard": {
    "source_id": "123456",
    "variable_id": "789012",
    "description": "Example standard EAN mapping"
  },
  "example_ean_bihoraire_peak": {
    "source_id": "987654",
    "variable_id": "321098", 
    "description": "Example bi-hourly EAN mapping (peak hours)"
  },
  "example_ean_bihoraire_offpeak": {
    "source_id": "987654",
    "variable_id": "321099",
    "description": "Example bi-hourly EAN mapping (off-peak hours)"
  }
}

Nouvelles fonctionnalités de configuration :

is_bihoraire : Définit si l'EAN utilise la tarification bi-horaire (peak/off-peak)
peak_hours : Configuration des heures de pointe par jour de la semaine (optionnel)
Génération automatique : Si is_bihoraire: true, génère automatiquement deux fichiers CSV
Heures par défaut : Si peak_hours n'est pas spécifié, utilise les règles standard belges

Règles horaires par défaut pour les EAN bi-horaires :

Peak : 07h00-22h00 (lundi-vendredi uniquement)
Off-peak : 22h00-07h00 (lundi-vendredi) + tout le weekend (samedi et dimanche complets)

Sécurité : Ne jamais committer ce fichier dans votre repository. Il est automatiquement ignoré par .gitignore.

Aide : Un fichier exemple ean_config.example.json est fourni pour vous aider à créer votre configuration.

Paramètres de configuration

Le parser utilise une configuration par défaut qui peut être ajustée :

sheet_index : Index de la feuille Excel (défaut: 2)
header_row : Ligne contenant l'en-tête EAN (défaut: 0)
header_col : Colonne contenant l'en-tête EAN (défaut: 1)
data_start_row : Première ligne des données (défaut: 5)
timestamp_col : Colonne des timestamps (défaut: 0)
value_col : Colonne des valeurs (défaut: 2)
min_rows : Nombre de lignes minimales pour parser (défaut: 6)
min_cols : Nombre de colonnes minimales pour parser (défaut: 3)
start_date : Date de départ (Optionnel: 2025-01-01)

📊 Format de sortie CSV

Nomenclature des fichiers de sortie

Le parser génère automatiquement des noms de fichiers intelligents selon le contexte :

EAN standard (tarif unique)

Puissance active : fichier_active.csv
Puissance inductive : fichier_inductive.csv
Puissance capacitive : fichier_capacitive.csv

EAN bi-horaires (tarification peak/off-peak)

Puissance active : fichier_active_peak.csv + fichier_active_offpeak.csv
Puissance inductive : fichier_inductive_peak.csv + fichier_inductive_offpeak.csv
Puissance capacitive : fichier_capacitive_peak.csv + fichier_capacitive_offpeak.csv

Structure des fichiers CSV

Le fichier CSV généré contient les colonnes suivantes :

Colonne	Description
`date`	Timestamp de la mesure
`value`	Valeur mesurée (selon le type de puissance sélectionné)
`meternumber`	Numéro EAN du compteur
`source_id`	Identifiant source du mapping
`source_serialnumber`	Numéro de série (vide par défaut)
`source_ean`	EAN source (vide par défaut)
`source_name`	Nom source (vide par défaut)
`mapping_config`	Configuration mapping (vide par défaut)
`variable_id`	Identifiant variable du mapping

Exemples de données

EAN standard (puissance active) :

date,value,meternumber,source_id,source_serialnumber,source_ean,source_name,mapping_config,variable_id
2023-01-01 00:00:00,1.25,541448965000143475,123456,,,,,789012
2023-01-01 00:15:00,1.30,541448965000143475,123456,,,,,789012

EAN bi-horaire (puissance inductive, fichier peak) :

date,value,meternumber,source_id,source_serialnumber,source_ean,source_name,mapping_config,variable_id
2023-01-01 07:00:00,0.85,987654321000000123,987654,,,,,321098
2023-01-01 07:15:00,0.92,987654321000000123,987654,,,,,321098

📁 Structure du projet

RenewgyParser/
├── csv_files/                     # Dossier de sortie (fixe).
│   └── .gitignore                 # Fichiers à ignorer par Git.
├── excel_files/                   # Dossier d'entrée (fixe).
│   └── .gitignore                 # Fichiers à ignorer par Git.
├── templates/
│   └── index.html                 # Template web interface.
├── .gitignore                     # Fichiers à ignorer par Git.
├── docker-compose.yml             # Services Docker.
├── Dockerfile                     # Configuration Docker.
├── ean_config.example.json        # Exemple de configuration EAN.
├── ean_config.json                # Configuration EAN (à créer).
├── launcher_docker.bat            # Launcher Docker (Windows).
├── launcher_docker.sh             # Launcher Docker (macOS/Linux).
├── launcher_python.bat            # Launcher Python (Windows).
├── launcher_python.sh             # Launcher Python (macOS/Linux).
├── LICENSE                        # Licence du projet.
├── README.md                      # Cette documentation.
├── renewgy_parser.py              # Parser CLI principal.
├── renewgy_parser_gui.py          # Interface web Flask.
└── requirements.txt               # Dépendances Python.

📝 Exemples d'utilisation

Exemple 1 : Traitement simple avec puissance active

python renewgy_parser.py --input data.xlsx --output output.csv --config ean_config.json --power-type active
# Résultat : output_active.csv (ou output_active_peak.csv + output_active_offpeak.csv si EAN bi-horaire)

Exemple 2 : Traitement avec puissance inductive et filtrage par date

python renewgy_parser.py --input data.xlsx --output output.csv --config ean_config.json --power-type inductive --start-date 2023-01-01
# Résultat : output_inductive.csv avec données à partir du 1er janvier 2023

Exemple 3 : Traitement par lots avec puissance capacitive

python renewgy_parser.py --batch-input ./excel_files --batch-output ./csv_files --config ./ean_config.json --power-type capacitive --start-date 2023-06-01 --verbose
# Résultat : Tous les fichiers Excel traités avec suffixe _capacitive

Exemple 4 : EAN bi-horaire avec puissance inductive

python renewgy_parser.py --input ean_bihoraire.xlsx --output ean_bihoraire.csv --config ean_config.json --power-type inductive
# Résultat automatique : 
# - ean_bihoraire_inductive_peak.csv (données heures pleines)
# - ean_bihoraire_inductive_offpeak.csv (données heures creuses)

Exemple 5 : Interface web avec Docker

# Lancement automatique avec configuration complète
./launcher_docker.sh

# Ou manuellement
docker run --rm -v $(pwd)/excel_files:/renewgy/excel_files -v $(pwd)/csv_files:/renewgy/csv_files -v $(pwd)/ean_config.json:/renewgy/ean_config.json -p 5001:5000 renewgy-parser
# Interface accessible sur http://localhost:5001

Exemple 6 : Traitement automatisé en production

# Script de traitement quotidien avec toutes les nouvelles fonctionnalités
python renewgy_parser.py \
  --batch-input /data/excel_files \
  --batch-output /data/csv_files \
  --config /config/ean_config.json \
  --power-type active \
  --start-date $(date -d "yesterday" +%Y-%m-%d) \
  --verbose
# Traite automatiquement tous les nouveaux fichiers avec les données d'hier

🔧 Dépannage

Problèmes courants

Erreur "Config file not found"
- Vérifiez que ean_config.json existe et est accessible
- Utilisez un chemin absolu si nécessaire
Erreur "No valid Excel files found"
- Vérifiez que vos fichiers ont l'extension .xlsx ou .XLSX
- Placez vos fichiers dans le dossier excel_files/
- Utilisez --pattern pour spécifier un pattern personnalisé
Erreur "EAN not found in config"
- Ajoutez le mapping EAN manquant dans votre fichier de configuration
- Vérifiez l'orthographe exacte de l'EAN
- Pour les EAN bi-horaires, ajoutez "is_bihoraire": true dans la configuration
Erreur "Power type column not found"
- Vérifiez que le type de puissance sélectionné existe dans votre fichier Excel
- Les colonnes acceptées : Active Energy, Inductive Energy, Capacitive Energy
- Utilisez --verbose pour voir les colonnes détectées
Problème avec les EAN bi-horaires
- Vérifiez la configuration "is_bihoraire": true dans ean_config.json
- Les règles horaires par défaut sont appliquées si peak_hours n'est pas spécifié
- Deux fichiers sont générés automatiquement : _peak.csv et _offpeak.csv
Interface web ne démarre pas
- Vérifiez que le port 5001 n'est pas utilisé
- Utilisez les launchers automatiques selon votre plateforme :
  - macOS/Linux : ./launcher_python.sh ou ./launcher_docker.sh
  - Windows : launcher_python.bat ou launcher_docker.bat
Erreur "Port already in use" avec Docker
- Le port 5001 est configuré par défaut (au lieu de 5000 pour éviter les conflits avec AirPlay sur macOS)
- Si le port 5001 est occupé, modifiez le port dans docker-compose.yml
- Puis accédez à http://localhost:5002
Problème d'environnement virtuel
- Le launcher Python gère automatiquement l'environnement virtuel
- En cas de problème, supprimez le dossier renewgy_parser_venv/ et relancez :
  - macOS/Linux : ./launcher_python.sh
  - Windows : launcher_python.bat
Fichiers de sortie non générés
- Vérifiez les permissions d'écriture dans le dossier csv_files/
- Pour les EAN bi-horaires, vérifiez que les données contiennent bien des heures de pointe et creuses
- Utilisez --verbose pour voir le détail du traitement
Détection automatique échoue
- La détection se base sur des mots-clés standard dans les en-têtes
- Si votre fichier Excel a une structure non-standard, contactez le support
- Utilisez --verbose pour voir les colonnes et structures détectées

Logs et débogage

macOS / Linux :

# Affichage détaillé avec les launchers.
./launcher_python.sh   # Les logs sont automatiquement affichés.
./launcher_docker.sh   # Les logs Docker sont affichés.

# Affichage détaillé en mode CLI.
python src/renewgy_parser.py --verbose --input file.xlsx --output file.csv --config ean_config.json

# Logs Docker manuels.
docker-compose logs renewgy-web-interface

Windows :

REM Affichage détaillé avec les launchers.
launcher_python.bat   REM Les logs sont automatiquement affichés.
launcher_docker.bat   REM Les logs Docker sont affichés.

REM Affichage détaillé en mode CLI.
python src/renewgy_parser.py --verbose --input file.xlsx --output file.csv --config ean_config.json

REM Logs Docker manuels.
docker-compose logs renewgy-web-interface

⚠️ Gestion des erreurs

Le parser gère plusieurs types d'erreurs :

Fichiers manquants : Vérification de l'existence des fichiers d'entrée
Structure Excel invalide : Validation de la structure attendue
EAN non trouvé : Vérification de l'existence dans le mapping
Données invalides : Validation des types de données
Erreurs de format de date : Validation des dates d'entrée

📋 Logging

Le parser utilise un système de logging configurable :

INFO : Messages d'information (défaut)
DEBUG : Messages détaillés (avec --verbose)
ERROR : Erreurs uniquement (avec --quiet)
WARNING : Avertissements

Format des logs :

2025-07-08 10:30:45 - renewgy_parser - INFO - Processing file: data.xlsx
2025-07-08 10:30:46 - renewgy_parser - INFO - Extracted EAN: 541448965000143475
2025-07-08 10:30:47 - renewgy_parser - INFO - Extracted 1000 data points

📅 Filtrage par date

Une fonctionnalité clé du parser est la possibilité de filtrer les données par date de début :

# Traiter uniquement les données à partir du 1er janvier 2023.
python src/renewgy_parser.py --input input.xlsx --output output.csv --config ean_config.json --start-date 2023-01-01

Cette fonctionnalité est particulièrement utile pour :

Éviter de traiter des données déjà présentes dans votre base de données
Synchroniser les nouvelles données depuis la dernière mise à jour
Optimiser les performances en ne traitant que les données nécessaires

🤝 Contribution

Les contributions sont les bienvenues ! Voici comment contribuer :

Fork le projet
Créez une branche pour votre fonctionnalité (git checkout -b feature/AmazingFeature)
Commitez vos changements (git commit -m 'Add some AmazingFeature')
Poussez vers la branche (git push origin feature/AmazingFeature)
Ouvrez une Pull Request

📄 Licence

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.

🔒 Sécurité

Important : Ne commitez jamais vos fichiers de configuration EAN ou vos données sensibles. Utilisez .gitignore pour exclure :

# Fichiers de configuration sensibles
ean_config.json
config/
*.env

# Données
excel_files/
csv_files/
*.xlsx
*.csv

# Environnement virtuel Python
renewgy_parser_venv/

📞 Support

Pour toute question ou problème :

Consultez cette documentation
Vérifiez les problèmes courants
Ouvrez une issue sur GitHub

📈 Changelog

v2.0.0 - Édition Intelligence & Robustesse (Juillet 2025)

🚀 Nouvelles fonctionnalités majeures :

🎯 Sélection du type de puissance : Choix entre Active, Inductive et Capacitive
⚡ Gestion complète des EAN bi-horaires : Support automatique peak/off-peak avec fichiers séparés
🧠 Détection automatique intelligente : Colonnes, structure et format détectés dynamiquement
📝 Noms de fichiers intelligents : Suffixes automatiques selon le type de puissance et le mode horaire
🔄 Interface web améliorée : Sélection dynamique avec feedback en temps réel

🛡️ Améliorations de robustesse :

Détection dynamique des en-têtes et début des données
Validation robuste de la structure des fichiers Excel
Gestion d'erreurs avancée avec messages détaillés
Logging professionnel avec niveaux configurables

💻 Interface utilisateur :

Mode batch amélioré : Configuration individuelle par fichier
Mise à jour automatique des noms lors du changement de type de puissance
Feedback instantané pour toutes les opérations
Interface responsive optimisée

🔧 Technique :

Type hints complets et documentation professionnelle
Code modulaire et maintenable
Tests CLI et web validés pour tous les cas d'usage
Configuration flexible pour les règles horaires personnalisées

v1.0.0 - Version Initiale

Parser initial avec support Excel vers CSV
Validation des données et gestion d'erreurs
Support du filtrage par date
Traitement par lots
Configuration EAN externe
Support Docker
Interface web moderne
Workflow universel simplifié
Launchers automatiques Python et Docker

Auteur

Brice Petit
Université Libre de Bruxelles (ULB)

Ce projet a été développé dans le cadre d'un projet de recherche PhD à l'Université Libre de Bruxelles (ULB).

GitHub: BricePetit
Projet: RenewgyParser

Name		Name	Last commit message	Last commit date
Latest commit History 11 Commits
csv_files		csv_files
excel_files		excel_files
templates		templates
.gitignore		.gitignore
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
docker-compose.yml		docker-compose.yml
ean_config.example.json		ean_config.example.json
launcher_docker.bat		launcher_docker.bat
launcher_docker.sh		launcher_docker.sh
launcher_python.bat		launcher_python.bat
launcher_python.sh		launcher_python.sh
renewgy_parser.py		renewgy_parser.py
renewgy_parser_gui.py		renewgy_parser_gui.py
requirements.txt		requirements.txt

Folders and files

Latest commit

History

Repository files navigation

Renewgy Excel to CSV Parser

✨ Caractéristiques principales

🔧 Fonctionnalités détaillées

🎯 Sélection intelligente du type de puissance

⚡ Gestion avancée des EAN bi-horaires

🧠 Détection automatique intelligente

📊 Traitement et conversion

🎨 Interface utilisateur avancée

📋 Prérequis

Dépendances Python

🚀 Installation Ultra-Simplifiée

Launchers Automatiques (Recommandé)

Installation Manuelle

Option A : Installation locale

Option B : Docker manuel

📖 Utilisation

🌐 Interface Web (Recommandé)

Lancement avec Launchers

Lancement Manuel

Fonctionnalités de l'interface web

💻 Interface en Ligne de Commande

Traitement d'un fichier unique

Traitement par lots

Configuration et options avancées

Exemples de gestion automatique des noms de fichiers

Arguments disponibles

⚙️ Configuration

Fichier de configuration EAN (Obligatoire)

Paramètres de configuration

📊 Format de sortie CSV

Nomenclature des fichiers de sortie

EAN standard (tarif unique)

EAN bi-horaires (tarification peak/off-peak)

Structure des fichiers CSV

Exemples de données

📁 Structure du projet

📝 Exemples d'utilisation

Exemple 1 : Traitement simple avec puissance active

Exemple 2 : Traitement avec puissance inductive et filtrage par date

Exemple 3 : Traitement par lots avec puissance capacitive

Exemple 4 : EAN bi-horaire avec puissance inductive

Exemple 5 : Interface web avec Docker

Exemple 6 : Traitement automatisé en production

🔧 Dépannage

Problèmes courants

Logs et débogage

⚠️ Gestion des erreurs

📋 Logging

📅 Filtrage par date

🤝 Contribution

📄 Licence

🔒 Sécurité

📞 Support

📈 Changelog

v2.0.0 - Édition Intelligence & Robustesse (Juillet 2025)

v1.0.0 - Version Initiale

Auteur

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages