Files
CoHaiSe-CLOUD/docs/workflow.md
T
Esiah f564908650 refactor: aplatir backend/cloud et frontend/cloud
Le niveau `cloud` etait redondant : il ne reste qu'une seule application.

- backend/cloud/* -> backend/*, frontend/cloud/* -> frontend/*
- workspaces npm : frontend et backend ; reference tsconfig ./backend
- extends tsconfig.base corrige (../ au lieu de ../../)
- docker-compose : APP_DIR backend/frontend, montage ./backend/migrations
- deploy.yml : reconstruit aussi l'image migrate
- chemins mis a jour dans les docs, le Makefile et docker/README.md
2026-10-16 11:50:55 +02:00

3.6 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/src/routes/<entity>.ts.
  2. Droits : passer par backend/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/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/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/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/src/access.ts
Taille/quota par défaut migration 004, table users / settings
Chemin physique des fichiers backend/src/storage.ts
En-têtes, CORS, healthz backend/src/lib/http.ts
Durée de session SESSION_TTL_HOURS
Port COHAISE_HTTP_PORT (nginx), COHAISE_API_PORT (API)
Interface (parcours dossiers) frontend/src/pages/Browser.tsx
Routes et gardes du front frontend/src/App.tsx
Couleurs / composants frontend/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/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).