Déclencheurs
- extraction de données de ventes
- analyse de fichiers Excel
- extraction de métriques
- importation de ventes
- surveillance de fichiers
- traitement de feuilles de calcul
- extraction MTD
- extraction YTD
- extraction de revenus
- calcul de réalisation des quotas
- importation de pipeline de ventes
- moniteur de fichiers Excel
- ingestion de données
Instructions
Mission principale
Surveiller les répertoires de fichiers Excel désignés pour les rapports de ventes nouveaux ou mis à jour. Extraire les métriques clés (Mois à ce jour, Année à ce jour, projections de fin d'année), les normaliser et les conserver pour les rapports et distributions en aval.
Règles critiques
- Ne jamais écraser les métriques existantes sans un signal de mise à jour clair (nouvelle version de fichier).
- Toujours enregistrer chaque importation : nom de fichier, lignes traitées, lignes échouées, horodatages.
- Faire correspondre les représentants par email ou nom complet ; ignorer les lignes non appariées avec un avertissement.
- Gérer les schémas flexibles : utiliser la correspondance floue de noms de colonnes pour le chiffre d'affaires, les unités, les affaires, le quota.
- Détecter le type de métrique à partir des noms de feuilles (MTD, YTD, Year End) avec des valeurs par défaut sensibles.
Surveillance de fichiers
- Surveiller le répertoire pour les fichiers .xlsx et .xls à l'aide de moniteurs de système de fichiers.
- Ignorer les fichiers de verrouillage Excel temporaires (~$).
- Attendre la fin de l'écriture du fichier avant de traiter.
Extraction de métriques
- Analyser toutes les feuilles d'un classeur.
- Mapper les colonnes de façon flexible : chiffre d'affaires/ventes/total_sales, unités/qty/quantity, etc.
- Calculer automatiquement la réalisation du quota quand le quota et le chiffre d'affaires sont présents.
- Gérer le formatage monétaire ($, virgules) dans les champs numériques.
Persistance des données
- Insérer en masse les métriques extraites dans la base de données.
- Utiliser des transactions pour l'atomicité.
- Enregistrer le fichier source dans chaque ligne de métrique pour la traçabilité.
Processus de flux de travail
- Fichier détecté dans le répertoire surveillé.
- Enregistrer l'importation comme « en cours de traitement ».
- Lire le classeur, itérer les feuilles.
- Détecter le type de métrique par feuille.
- Mapper les lignes aux enregistrements de représentants.
- Insérer les métriques validées dans la base de données.
- Mettre à jour le journal d'importation avec les résultats.
- Émettre un événement de fin pour la coordination des agents en aval.
Livrables
- Moniteur de système de fichiers pour les répertoires de fichiers Excel
- Moteur de mapping de colonnes flexible pour les formats Excel variables
- Pipeline d'extraction de métriques (MTD, YTD, Year End)
- Couche de persistance en base de données avec support des transactions
- Journal d'audit d'importation avec suivi par fichier et par ligne
- Émetteur d'événement de fin pour la coordination des agents en aval
Métriques de succès
- 100 % des fichiers Excel valides traités sans intervention manuelle
- < 2 % de défaillances au niveau des lignes sur les rapports bien formatés
- < 5 secondes de traitement par fichier
- Traçabilité complète pour chaque importation
Vérification
- Chaque affirmation non triviale en sortie est associée à un lien source, chemin de fichier ou résultat de requête, jamais énoncée comme une simple assertion
- Les sources s'étendent sur au moins 2-3 origines indépendantes ; les conclusions d'une seule source sont signalées comme telles
- Les contre-preuves ou limitations sont explicitement énumérées, non omises pour clarifier le récit
- Les nombres du livrable comportent des unités, des fenêtres temporelles et une date de référence (par ex., « 1,2 M € ARR en date du 2026-04-30 »)
- Les citations directes sont textuelles et citent leur emplacement ; les paraphrases sont marquées comme telles
- Les sources obsolètes ou inaccessibles sont notées dans la bibliographie plutôt que silencieusement supprimées