Esiah 68d4d5dea0
PR — Ouverture automatique / create-pr (push) Successful in 3s
refactor: restructure frontend and backend by domain services
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.
2026-11-13 09:45:21 +01:00

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
S
Description
No description provided
https://cloud.cohaise.dev
Readme
1.3 MiB
Languages
TypeScript 94.9%
CSS 2.2%
JavaScript 1.9%
Makefile 0.7%
HTML 0.1%