Commande CLI — StatsNafCodes
title: Commande CLI — StatsNafCodes subtitle: Guide d’utilisation de la commande app/Console/Commands/StatsNafCodes.php icon: lucide:bar-chart status: guide
icon: lucide:help-circle title: Pourquoi cette commande ? Des modifications récentes touchent la gestion des codes NAF et des SIREN (onboarding et édition d’organisations). La commande StatsNafCodes a été ajoutée pour produire rapidement des statistiques sur les codes NAF et l’état des SIREN dans la base — utile pour audits, surveillance qualité des données et contrôles avant déploiement.
icon: lucide:clock title: Automatisation / cron / planification
- Pour exécuter quotidiennement via le scheduler Laravel (app/Console/Kernel.php) :
- $schedule->command(‘stats:naf-codes --format=csv --output=/path/to/store/naf-’.date(‘Y-m-d’).‘.csv’)->daily();
- Ou via crontab en appelant l’artisan directement dans le conteneur :
- 0 2 * * * cd /path/to/project && /usr/bin/php artisan stats:naf-codes --format=csv --output=/var/backups/naf-$(date +%F).csv
icon: lucide:download-cloud title: Structure de sortie (CSV / JSON) Colonnes courantes (exemple CSV)
- naf_code : code NAF (ex. 47.11B)
- naf_label : libellé du code NAF si disponible
- count : nombre total d’organisations associées
- with_siren : nombre d’organisations avec SIREN renseigné et valide
- without_siren : nombre d’organisations sans SIREN ou SIREN invalide
- pct_with_siren : pourcentage d’organisations ayant un SIREN valide Notes:
- En JSON, la structure est un tableau d’objets avec les mêmes champs.
- Si vous avez besoin d’autres colonnes (ex. département, statut juridique), vérifier si la commande prend des flags pour les inclure ou adapter le code source.
icon: lucide:help-circle title: Conseils & dépannage
- Mémoire / timeouts : pour de grandes bases, augmentez memory_limit et max_execution_time ou utilisez --chunk-size pour limiter la lecture.
- Permissions fichier : assurez-vous que l’utilisateur exécutant la commande peut écrire dans le dossier --output.
- Options inconnues : exécutez php artisan help stats:naf-codes pour obtenir la liste exacte des options si la signature diffère.
- Vérification SIREN : la commande peut se baser sur une validation interne (regex / checksum). Si vos règles changent, adaptez la logique dans le service/validator utilisé par la commande.
- Logs : en cas d’erreur, consultez storage/logs/laravel.log pour les traces.
title: Besoin de modifications spécifiques ? desc: Si vous souhaitez ajouter un filtre, un nouveau champ de sortie ou un format d’export, modifiez la commande dans app/Console/Commands/StatsNafCodes.php et proposez une PR. Pour assistance, contactez l’équipe backend. button: Voir le fichier source href: /app/Console/Commands/StatsNafCodes.php
icon: lucide:bar-chart title: Contexte des changements récents
- Des modifications ont été apportées au parcours d’onboarding et à l’édition des organisations pour mieux gérer NAF / SIREN.
- Cette commande facilite l’audit et le suivi de la qualité des données après ces changements.
- Pensez à exécuter la commande après déploiement pour détecter d’éventuelles régressions dans les données (ex. augmentation du nombre d’organisations sans SIREN).