PR — Ouverture automatique / create-pr (push) Successful in 3s
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.
91 lines
3.1 KiB
Markdown
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
|
|
```
|