- nginx rejoint le reseau externe shared-network pour que le tunnel Cloudflare le resolue par son nom (cohaise-cloud-nginx). - real_ip_header CF-Connecting-IP : devient l'IP reelle du client, sinon limit_req et l'audit comptent l'IP du tunnel. - X-Forwarded-Proto reprend le schema vu par Cloudflare (https) au lieu de $scheme (http) : le cookie de session repasse en Secure. - docs/deployment.md : tunnel Docker via shared-network, deploy.yml sans make check.
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/shared design system (@cohaise/ui) — copie propre à cette app
frontend/cloud application React + Vite
backend/shared couche serveur (@cohaise/server) : config, base, sessions
backend/cloud API : auth, dossiers, fichiers
docker/ images nginx et API
Les paquets shared (design system et couche serveur) vivent dans ce dépôt et en
suivent le cycle de vie : un correctif ici n'a pas à être répliqué ailleurs.
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