Root is a personal namespace per user, so duplicate checks must scope to the current owner when uploading at root level. Subfolders keep their existing uniqueness rules. Also fixed folder creation at root with the same owner scope.
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