Ajout de la procédure automatisée pour l'importation des données et mise à jour des instructions dans le README

README.md

@@ -9,6 +9,45 @@ Ces manipulations sont décrites ici.
 
 Le client a rempli le canevas. Une relecture du fichier est toujours nécessaire afin de repérer les éventuelles irrégularités.
 
+## Procédure rapide
+
+Pour l'import courant, la procédure recommandée est maintenant automatisée.
+
+Pré-requis:
+- la base PostgreSQL cible doit être accessible
+- le schéma `import` est recréé automatiquement par le script
+- les fichiers csv nécessaires doivent être présents dans `csv/`
+
+Commandes:
+
+```bash
+cd /Users/boriswaaub/Documents/Projets/Clients/Champs-Libres/chill-import-from-canvas
+
+# 1. Nettoyer les données précédemment importées
+PGPASSWORD='!ChangeMe!' psql -v ON_ERROR_STOP=1 -h 127.0.0.1 -p 5454 -U app -d app -f sql/remove-import-data.sql
+
+# 2. Charger les CSV dans le schéma import
+PGPASSWORD='!ChangeMe!' PGHOST=127.0.0.1 PGPORT=5454 PGUSER=app PGDATABASE=app ./import_all_csv.sh
+
+# 3. Exécuter l'import applicatif
+PGPASSWORD='!ChangeMe!' psql -v ON_ERROR_STOP=1 -h 127.0.0.1 -p 5454 -U app -d app -f sql/import.sql
+```
+
+Vérification rapide:
+
+```bash
+PGPASSWORD='!ChangeMe!' psql -h 127.0.0.1 -p 5454 -U app -d app -c "SELECT count(*) AS links_from_imported_periods FROM import.periodes ip JOIN chill_person_accompanying_period_social_issues aps ON aps.accompanyingperiod_id = ip.period_id;"
+```
+
+Important:
+- `sql/import.sql` n'exécute plus le bloc `DOWN` automatiquement.
+- pour annuler un import, utiliser `sql/remove-import-data.sql`.
+- le bloc `DOWN` de `sql/import.sql` reste disponible uniquement si on le demande explicitement:
+
+```bash
+PGPASSWORD='!ChangeMe!' psql -v ON_ERROR_STOP=1 -v run_down=1 -h 127.0.0.1 -p 5454 -U app -d app -f sql/import.sql
+```
+
 ## 1. Préparer les fichiers csv
 
 Le fichier se compose de plusieurs feuilles, chacune doit être sauvée au format csv.