Courriels - gabarit HTML brande (logo, couleur #b71c1c, bouton, mention ne pas repondre) dans backend/src/lib/mail-template.ts ; repli texte conserve - MailMessage gagne un champ html optionnel - MAIL_LOGO_URL (defaut PUBLIC_ORIGIN/logo.png) + logo.png servi par le front - notification au nouvel utilisateur a la creation du compte admin - forgot-password, email-change et reset-password passent par le gabarit Espace disque - diskUsage() (statfs) dans storage.ts (total/free/available) - upload et avatar refuses si le disque est plein (507 INSUFFICIENT_STORAGE) - quota d'emplacement borne par la capacite reelle du disque - statistiques disque exposees aux endpoints admin Exploitation - make purge-logs : vide le journal d'audit - make reset : cloud vierge en conservant les administrateurs - docker/reset-cloud.sql ; documentation deployment.md et api.md
CoHaiSe Cloud
Fichiers et médias : arborescence de dossiers, envoi, téléchargement. Application autonome — front et back dans ce dépôt.
Structure
frontend application React + Vite, design system inclus (src/ui, src/styles)
backend API : socle serveur (src/lib), auth, dossiers, fichiers, médias
docker/ images nginx et API
Chaque application porte son propre code : le socle serveur (backend/src/lib)
et le design system (frontend/src/ui) appartiennent au Cloud et ne sont
partagés avec aucun autre dépôt.
Démarrer
cp .env.example .env # puis renseigner les mots de passe et SESSION_SECRET
make up # front + API + base, migrations comprises
make front # reconstruire et publier le front
L'app répond sur http://localhost:8083 (variable COHAISE_HTTP_PORT).
| Variable | Rôle | Défaut |
|---|---|---|
COHAISE_HTTP_PORT |
port nginx côté machine hôte | 8083 |
COHAISE_API_PORT |
port de l'API | 3101 |
COHAISE_DB_PORT |
port MariaDB | 3407 |
CLOUD_DB_USER / CLOUD_DB_PASSWORD |
identifiants base | — |
CLOUD_DB_ROOT_PASSWORD |
root, pour la sauvegarde | — |
SESSION_SECRET |
signature des sessions, obligatoire | — |
Le démarrage échoue avec la liste exacte des variables manquantes ou mal formées, avant l'ouverture d'aucun port. C'est voulu.
Commandes
make help # liste complète
make ps # état des conteneurs
make logs # journaux
make front # reconstruire et publier le front
make migrate # appliquer les migrations SQL explicitement
make backup # dump horodaté dans ./backups
make admin ARGS=... # créer ou réinitialiser un compte
make dev # Vite sur 5174, API sur 3101, sans Docker
make check # typecheck + build
Comptes
Le premier compte se crée par CLI, jamais par une route publique :
make admin ARGS="--email [email protected] --first Jean --last Dupont"
make admin ARGS="--email [email protected] --reset"
Les mots de passe sont lus par le conteneur lui-même : ils ne transitent ni par la ligne de commande ni par le dépôt.
Migrations
Les fichiers sont numérotés et appliqués dans l'ordre. Une migration déjà appliquée ne se modifie jamais : une correction passe par un nouveau fichier.
| Fichier | Contenu |
|---|---|
000_schema_migrations.sql |
table de suivi des versions |
001_initial_schema.sql |
schéma initial |
002_reference_data.sql |
rôles, étapes, pays, réglages |
003_integrity_backstop.sql |
clé étrangère users.role_id, CHECK d'intégrité |
004_cloud_requirements.sql |
exigences du Cloud |
005_storage_location_realign.sql |
emplacement physique des fichiers |
Au démarrage, runMigrations() ne joue que les migrations manquantes, et
assertNoDrift() refuse de servir si un fichier déjà appliqué a été modifié entre
temps : une base non maîtrisée rend l'API inaccessible plutôt que de renvoyer des
erreurs 500.
Tests
make check # types + build