documentation wiki osm, ajout dashboard issues osmose

README.md

@@ -119,6 +119,94 @@ Options disponibles :
 
 Cette commande utilise le fichier `communes_france.csv` à la racine du projet et crée des objets Stats pour les communes qui n'en ont pas encore. Les objets sont créés avec les informations du CSV et complétés avec des données supplémentaires (coordonnées, budget, etc.). Les objets sont sauvegardés par paquets de 100 pour optimiser les performances.
 
+## Génération de statistiques pour toute la France
+
+Le projet inclut un ensemble de commandes Symfony qui permettent de générer des statistiques de complétion pour toutes les communes de France. Ces commandes doivent être exécutées dans l'ordre suivant :
+
+### 1. Récupération des polygones des villes
+Récupère les polygones des villes selon leur zone donnée par le code INSEE :
+```shell
+php bin/console app:retrieve-city-polygons [insee-code] [options]
+```
+
+Arguments :
+- `insee-code` : (Optionnel) Code INSEE spécifique à traiter
+
+Options :
+- `--limit=N` ou `-l N` : Limite le nombre de villes à traiter
+- `--force` ou `-f` : Force la récupération même si le polygone existe déjà
+
+Cette commande :
+- Crée le dossier `counting_osm_objects/polygons` s'il n'existe pas
+- Utilise le script Python `get_poly.py` pour récupérer les polygones des communes
+- Affiche une barre de progression et un résumé des résultats
+
+### 2. Extraction des données OSM pour chaque zone INSEE
+Extrait les données OSM pour chaque zone INSEE à partir du fichier france-latest.osm.pbf :
+```shell
+php bin/console app:extract-insee-zones [insee-code] [options]
+```
+
+Arguments :
+- `insee-code` : (Optionnel) Code INSEE spécifique à traiter
+
+Options :
+- `--limit=N` ou `-l N` : Limite le nombre de villes à traiter
+- `--force` ou `-f` : Force l'extraction même si le fichier JSON existe déjà
+- `--keep-pbf` ou `-k` : Conserve les fichiers PBF intermédiaires
+
+Cette commande :
+- Télécharge automatiquement le fichier france-latest.osm.pbf depuis Geofabrik s'il n'existe pas
+- Crée le dossier `insee_extracts` s'il n'existe pas
+- Utilise osmium pour extraire les données OSM pour chaque zone INSEE
+- Convertit les données extraites en format JSON
+- Affiche une barre de progression et un résumé des résultats
+
+### 3. Traitement des extraits JSON pour calculer les mesures de thèmes
+Traite les extraits JSON des zones INSEE pour calculer les mesures de thèmes :
+```shell
+php bin/console app:process-insee-extracts [insee-code] [options]
+```
+
+Arguments :
+- `insee-code` : (Optionnel) Code INSEE spécifique à traiter
+
+Options :
+- `--limit=N` ou `-l N` : Limite le nombre de villes à traiter
+- `--force` ou `-f` : Force le traitement même si déjà effectué
+
+Cette commande :
+- Utilise le service Motocultrice pour traiter les données
+- Met à jour la date de labourage dans l'entité Stats
+- Affiche une barre de progression et un résumé des résultats
+
+### Exemple d'utilisation pour générer des statistiques pour toute la France
+
+```shell
+# 1. Récupérer les polygones de toutes les communes
+php bin/console app:retrieve-city-polygons
+
+# 2. Extraire les données OSM pour chaque zone INSEE
+php bin/console app:extract-insee-zones
+
+# 3. Traiter les extraits JSON pour calculer les mesures de thèmes
+php bin/console app:process-insee-extracts
+```
+
+Pour traiter une seule commune (par exemple avec le code INSEE 75056 pour Paris) :
+```shell
+php bin/console app:retrieve-city-polygons 75056
+php bin/console app:extract-insee-zones 75056
+php bin/console app:process-insee-extracts 75056
+```
+
+### Dépendances
+
+Pour exécuter ces commandes, vous aurez besoin de :
+- Python 3 avec les bibliothèques requises pour `get_poly.py`
+- Osmium Tool (`osmium`) installé sur votre système
+- Suffisamment d'espace disque pour stocker le fichier france-latest.osm.pbf (~4 Go) et les extraits JSON
+
 # Routes d'administration
 
 ## Création des Stats manquantes à partir du CSV