Files
CoHaiSe-CLOUD/README.md
T
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

91 lines
3.1 KiB
Markdown

# 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 [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
```bash
make check # types + build
```