- add users.theme and users.language, exposed in the session and through a new GET/PATCH /account/preferences endpoint - replace the global files.is_starred flag with a user_file_stars join table and backfill existing stars to the file owner - track chat read state per user (chat_reads) and expose GET /chat/unread for folder badges - expose GET /directory listing active users - drop the unused folders.description column - let the admin audit log be filtered by user and action, with facets
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