Files
CoHaiSe-CLOUD/docs/workflow.md
T
Esiah 75da61ac93 refactor: fold shared ui/server packages into the cloud app
Le depot ne contient plus qu'une seule application : plus de paquets
@cohaise/ui ni @cohaise/server.

- backend/shared/src -> backend/cloud/src/lib (socle serveur inline)
- frontend/shared/src -> frontend/cloud/src/{ui,styles,fonts}
- imports @cohaise/server / @cohaise/ui remplaces par des chemins relatifs
- package.json, tsconfig, Dockerfiles et docker-compose sans workspace partage
- docs (README, architecture, standards, workflow, agents, api, security,
  deployment, docker) alignes sur la structure autonome
2026-10-16 11:47:20 +02:00

3.7 KiB

Workflow — CoHaiSe Cloud

Boucle de développement

make dev       # Vite sur http://localhost:5174, proxy /api → 127.0.0.1:3101

Le front tourne hors Docker ; l'API et la base doivent être levées :

make up        # db + migrate + api (+ nginx si besoin)

Le proxy vite.config.ts envoie /api vers 3101, donc les appels fetch('/api/cloud/…') du code source fonctionnent à l'identique en dev et en prod.

Vérification

make check                    # npm run typecheck puis npm run build
curl -I http://localhost:8083/healthz
curl -s http://localhost:3101/healthz

Il n'y a ni linter, ni framework de test, ni CI : typecheck + build sont les seules garanties automatiques. .editorconfig porte les conventions.

Après un changement de docker/nginx/cloud.conf : l'image doit être reconstruite (docker compose build nginx && docker compose up -d nginx) — le fichier est copié dans l'image, pas monté.

Modifier une route

  1. Schéma d'entrée : Zod dans backend/cloud/src/routes/<entity>.ts.
  2. Droits : passer par backend/cloud/src/access.ts (jamais par un paramètre venu du client).
  3. Réponse : renvoyer 404 si la ressource n'est pas censée exister pour ce compte, 403 seulement pour une règle explicite.
  4. Erreur métier : AppError depuis backend/cloud/src/lib/errors.ts.
  5. Audit si l'action est sensible (audit() dans access.ts).
  6. make check, puis redémarrage de l'API (docker compose up -d api).

Modifier le schéma

  1. Écrire backend/cloud/migrations/00N_….sql (número suivant, jamais éditer un fichier déjà appliqué).
  2. Vérifier : docker compose run --rm migrate node dist/cli.js --dir /migrations --check
  3. Appliquer : make migrate ou redémarrage de l'API.
  4. Décrire la migration dans docs/api.md (tableau des migrations).

Le DDL MariaDB n'est pas transactionnel : une migration interrompue peut laisser la base à moitié migrée. Dans ce cas, corriger par une nouvelle migration, pas en éditant l'ancienne (le checksum bloquerait le démarrage).

Modifier le design system

Le design system vit dans frontend/cloud/src/ui (+ src/styles).

  • tokens.css porte les couleurs et typographies ; ne pas en coder ailleurs.
  • Après modification : make front (le build Vite reprend tout).

Où changer quoi

Besoin Fichier
Droit d'accès à un dossier/fichier backend/cloud/src/access.ts
Taille/quota par défaut migration 004, table users / settings
Chemin physique des fichiers backend/cloud/src/storage.ts
En-têtes, CORS, healthz backend/cloud/src/lib/http.ts
Durée de session SESSION_TTL_HOURS
Port COHAISE_HTTP_PORT (nginx), COHAISE_API_PORT (API)
Interface (parcours dossiers) frontend/cloud/src/pages/Browser.tsx
Routes et gardes du front frontend/cloud/src/App.tsx
Couleurs / composants frontend/cloud/src/styles/tokens.css

Git

  • Branche main, remote origin https://git.cohaise.dev/Esiah/CoHaiSe-CLOUD.git.
  • Aucun commit pour l'instant : l'historique est vierge.
  • .gitignore exclut .env, .env.* (sauf .env.example), backups/, node_modules/, dist/, *.tsbuildinfo.

Pièges connus

  1. .env local désynchronisé de .env.example : les clés COHAISE_* manquantes basculent silencieusement sur les défauts compose.
  2. README de paquet (docker/README.md, backend/cloud/README.md) : états antérieurs du dépôt. Se fier à ce dossier docs/.
  3. Limitation de débit active (applicatif + nginx) : une rafale peut renvoyer 419/503.
  4. CSP stricte : aucun script inline dans index.html (voir public/theme.js).