CD — Deployment / deploy (push) Successful in 34s
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. --------- Co-authored-by: xEsiah <[email protected]> Reviewed-on: #26 Reviewed-by: Esiah <[email protected]> Co-authored-by: Gitea Actions <-[email protected]>
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
|
|
```
|