# 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 : routes (src/routes/*Routes.ts) + services (src/services/*Service.ts) docker/ images nginx et API ``` Chaque application porte son propre code : le socle serveur (`backend/src/{config,middleware,utils}`) et le design system (`frontend/src/ui`) appartiennent au Cloud et ne sont partagés avec aucun autre dépôt. ## Démarrer ```bash 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` | poivre HMAC 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 ```bash 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 : ```bash make admin ARGS="--email moi@exemple.fr --first Jean --last Dupont" make admin ARGS="--email moi@exemple.fr --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 ```bash make check # types + build ```