Files
CoHaiSe-CLOUD/README.md
T
Gitea ActionsandEsiah f689ab4d57
CD — Deployment / deploy (push) Successful in 34s
refactor: restructure frontend and backend by domain services (#26)
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]>
2026-11-13 09:13:27 +00:00

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