Improve script

README.md

@@ -34,12 +34,27 @@ openssl rand -hex 64
 
 Ne pas versionner le fichier `.env`.
 
+### Base de données
+
+En développement, la base est créée dans :
+
+```text
+db/development.sqlite3
+```
+
+Ce chemin est utilisé par défaut. Il est possible de le modifier
+avec la variable d'environnement `DATABASE_PATH`.
+
+Le chemin indiqué est relatif au fichier `lib/database.rb`.
+
 Créer ou mettre à jour la base de données :
 
 ```sh
 bundle exec ruby bin/migrate
 ```
 
+### Serveur
+
 Démarrer le serveur de développement :
 
 ```sh
@@ -50,22 +65,25 @@ Créer des comptes de test depuis le site :
 
 http://[::1]:9292/create-account
 
-Les personnes physiques et les personnes morales peuvent créer
-un compte. L'adresse électronique doit être vérifiée avant de
-pouvoir se connecter.
+Les personnes physiques et les personnes morales peuvent créer un compte.
+L'adresse électronique doit être vérifiée avant de pouvoir se connecter.
 
-Pour tester l'espace du Noyau, désigner un ou plusieurs comptes
-de test depuis le terminal :
+### Initialisation du Noyau
+
+Pour tester l'espace du Noyau, désigner un ou plusieurs comptes de test
+depuis le terminal :
 
 ```sh
 bundle exec ruby bin/initialize-core
 ```
 
-En développement, un seul membre suffit. Cette commande peut
-être réexécutée pour ajouter d'autres membres au Noyau.
+En développement, un seul membre suffit. Cette commande peut être
+réexécutée pour ajouter d'autres membres au Noyau.
 
 La date de l'assemblée est demandée lors de l'exécution.
 
+### Shell interactif
+
 Pour ouvrir un shell interactif :
 
 ```sh
@@ -80,6 +98,7 @@ et définit `RACK_ENV=production`.
 Le fichier d'environnement doit notamment définir :
 
 ```dotenv
+DATABASE_PATH=../db/netig.sqlite3
 SESSION_SECRET=...
 RODAUTH_HMAC_SECRET=...
 RODAUTH_DOMAIN=netig.net
@@ -87,11 +106,34 @@ BASE_URL=https://netig.net
 SMTP_PASSWORD=...
 ```
 
-Générer les deux secrets avec `openssl rand -hex 64`.
+Générer les deux secrets avec :
+
+```sh
+openssl rand -hex 64
+```
+
 Ne pas versionner le fichier contenant ces variables.
 
-Créer ou mettre à jour la base de données dans le conteneur
-applicatif avant de démarrer la nouvelle version :
+### Base de données
+
+La base de production est stockée dans :
+
+```text
+db/netig.sqlite3
+```
+
+Le chemin `../db/netig.sqlite3` est relatif au fichier
+`lib/database.rb`. Il désigne donc le dossier `db/` à la racine
+du projet.
+
+Le dossier `db/` doit être conservé entre les déploiements et rester
+accessible en écriture par l'utilisateur qui exécute Puma.
+
+Il doit également être inclus dans les sauvegardes.
+
+Créer ou mettre à jour la base de données dans le conteneur applicatif,
+avec les mêmes variables d'environnement que l'application, avant
+de démarrer la nouvelle version :
 
 ```sh
 bundle exec ruby bin/migrate
@@ -111,8 +153,8 @@ bundle exec ruby bin/initialize-core
 ```
 
 Cette commande doit être exécutée une seule fois en production.
-Elle exige au moins trois personnes physiques disposant d'un
-compte vérifié.
+Elle exige au moins trois personnes physiques disposant d'un compte
+vérifié.
 
 Elle enregistre leurs adhésions comme acceptées et leur attribue
 la qualité de membre du Noyau.