Split the monolithic backend (lib/, routes/, access.ts, storage.ts, media.ts) into a layered structure inspired by JeanXXIII-CRM: - config/: appConfig, db - middleware/: auth (session, roles, cookies) - models/: shared types - routes/: *Routes.ts (thin HTTP handlers) - services/: *Service.ts (business logic, one per domain) - utils/: errors, http, migrate, ratelimit, validators, service bootstrap Frontend likewise: services/*Service.ts + apiClient, contexts/, types/, utils/format. Route files now carry the "Routes" suffix; service files are named authService.ts, ratelimit.ts, etc. and live in their own files, frontend and backend separated. Updated docs and READMEs to reflect the new layout. Typecheck and builds pass.
3.1 KiB
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
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
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