netig.net

À faire

• limiter le spam sur /contact/send
• développer les demandes d'adhésion et leur examen par le Noyau
• développer l'espace personnel des membres
• afficher les recettes et les dépenses sur la page d'accueil
• gérer les accès aux services selon la situation des membres

Développement

Installer les dépendances :

bundle install

Créer un fichier .env à la racine du projet :

SESSION_SECRET=...
RODAUTH_HMAC_SECRET=...
RODAUTH_DOMAIN=netig.net
BASE_URL=http://[::1]:9292
SMTP_PASSWORD=...

Générer SESSION_SECRET et RODAUTH_HMAC_SECRET avec :

openssl rand -hex 64

Ne pas versionner le fichier .env.

Base de données

En développement, la base est créée dans :

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 :

bundle exec ruby bin/migrate

Serveur

Démarrer le serveur de développement :

bundle exec puma

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.

Initialisation du Noyau

Pour tester l'espace du Noyau, désigner un ou plusieurs comptes de test depuis le terminal :

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.

La date de l'assemblée est demandée lors de l'exécution.

Shell interactif

Pour ouvrir un shell interactif :

bundle exec irb -r dotenv/load -r ./netig.rb

Production

Docker Compose fournit les variables d'environnement via env_file et définit RACK_ENV=production.

Le fichier d'environnement doit notamment définir :

DATABASE_PATH=../db/netig.sqlite3
SESSION_SECRET=...
RODAUTH_HMAC_SECRET=...
RODAUTH_DOMAIN=netig.net
BASE_URL=https://netig.net
SMTP_PASSWORD=...

Générer les deux secrets avec :

openssl rand -hex 64

Ne pas versionner le fichier contenant ces variables.

Base de données

La base de production est stockée dans :

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 :

bundle exec ruby bin/migrate

Initialisation du premier Noyau

Une fois l'inscription publique disponible, les membres fondateurs créent leurs comptes depuis le site et vérifient leurs adresses électroniques.

Après leur désignation par l'assemblée constitutive, initialiser le Noyau depuis le conteneur applicatif :

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 enregistre leurs adhésions comme acceptées et leur attribue la qualité de membre du Noyau.

La date de l'assemblée constitutive est demandée lors de l'exécution.