Ajout du dossier api avec la géolocalisation automatique des casernes de pompiers

api/scripts/README.md

@@ -0,0 +1,66 @@
+# Scripts Utilitaires
+
+Ce dossier contient des scripts utilitaires pour la gestion des bases de données et l'automatisation de tâches.
+
+## Structure
+
+- `php/` : Scripts PHP pour la manipulation des données et l'intégration avec l'API
+- `shell/` : Scripts shell pour l'automatisation et les opérations système
+- `python/` : Scripts Python pour le traitement des données et l'analyse
+- `cron/` : Scripts et configurations pour les tâches programmées
+
+## Migration geosector → geosector_app
+
+Les scripts de migration permettent de transférer des données de la base MySQL geosector (sur un serveur distant) vers la base MariaDB geosector_app (locale).
+
+### Prérequis
+
+- Accès SSH au serveur distant hébergeant la base MySQL geosector
+- Accès à la base de données MariaDB geosector_app locale
+- Droits suffisants pour lire/écrire dans les deux bases
+- Clé SSH pour l'authentification au serveur distant
+
+### Utilisation
+
+1. Configurer les paramètres de connexion dans le fichier `config.php` :
+   - Paramètres SSH (serveur, port, utilisateur, clé)
+   - Paramètres de la base de données source (distante)
+   - Paramètres de la base de données cible (locale)
+
+2. Exécuter le script de migration souhaité :
+   ```
+   php php/migrate_users.php
+   ```
+   ou
+   ```
+   ./shell/migrate_table.sh users
+   ```
+
+3. Pour comparer les schémas de tables entre les deux bases :
+   ```
+   python python/compare_schemas.py users
+   ```
+   ./bash/migrate_table.sh users
+   ```
+
+## Tâches programmées (cron)
+
+Les scripts dans le dossier `cron/` peuvent être configurés pour s'exécuter automatiquement via crontab.
+
+Exemple de configuration crontab pour exécuter la synchronisation quotidienne :
+
+```
+# Synchronisation quotidienne à 2h du matin
+0 2 * * * php /chemin/vers/api/scripts/cron/sync_databases.php > /dev/null 2>&1
+```
+
+## Fonctionnement du tunnel SSH
+
+Les scripts établissent automatiquement un tunnel SSH pour accéder à la base de données distante :
+
+1. Vérification de l'existence d'un tunnel déjà établi
+2. Création d'un tunnel SSH si nécessaire
+3. Exécution des opérations de base de données via le tunnel
+4. Fermeture propre du tunnel à la fin du script
+
+Les tunnels utilisent un port local (par défaut 13306) pour rediriger vers le port MySQL du serveur distant.