Files
CoHaiSe-CLOUD/docs/architecture.md
T
Esiah a22f18d860
CD — Déploiement / deploy (push) Failing after 1s
chore: store database and media on host bind mounts
Move MariaDB and media data out of /var/lib/docker onto the host disk via CLOUD_DB_DIR and CLOUD_MEDIA_DIR (default ../db, ../media). Only the frontend build output remains a named volume.
2026-10-16 10:47:12 +02:00

4.1 KiB

Architecture — CoHaiSe Cloud

Fichiers et médias : arborescence de dossiers, envoi, téléchargement, corbeille, recherche, galerie, partage nominatif, comptes et administration. Une API Node/TypeScript, une base MariaDB, un stockage de fichiers monté en volume.

Pile

Élément Où
React 19 + Vite 8 + Tailwind 4 + react-router-dom 7 frontend/cloud
Hono backend/cloud/src/index.ts (@cohaise/server pour le socle)
MariaDB (mysql2) backend/shared/src/db.ts
Nodemailer backend/shared/src/mail.ts
sharp (vignettes) backend/cloud/src/media.ts
Validation Zod backend/shared/src/config.ts et chaque route

Découpage

backend/shared/    @cohaise/server : config, db, mail, ratelimit, http, service, auth, errors
backend/cloud/     routes/, access.ts, storage.ts, media.ts, cli.ts
backend/cloud/migrations/   000 … 006
frontend/shared/   @cohaise/ui : Design System (boutons, cartes, champs, spinner)
frontend/cloud/    router + AppShell + pages/
docker/            Dockerfile(.app/.api), nginx/, publish.sh

backend/shared est générique (sessions, erreurs, migrations, courriel, limitation de débit) ; backend/cloud porte le métier : droits, quotas, chemins disque, traitement média.

Chaîne de démarrage

docker-compose.yml — projet cohaise-cloud, 5 services :

db ──healthy──▶ migrate (runMigrations + assertNoDrift, puis s'arrête)
                     │
                     └──service_completed_successfully──▶ api ──▶ nginx
app-build (publish.sh, terminé avant nginx)
  • migrate monte ./backend/cloud/migrations:/migrations:ro.
  • api refuse de démarrer si une migration appliquée a été modifiée (dérive de checksum). onReady purge les sessions et la corbeille expirées.
  • stockage : app_data (volume Docker, HTML), $CLOUD_DB_DIR (MariaDB) et $CLOUD_MEDIA_DIR (fichiers) en bind mounts hôte.

API et front

  • API /api/cloud : voir api.md.
  • Front : React Router (frontend/cloud/src/App.tsx) avec gardes RequireAuth / RequireReady / RequireAdmin et AppShell (components/AppShell.tsx) : navigation latérale, en-tête, contenu.
  • Pages : Login, ForgotPassword, ResetPassword, ConfirmEmail, ChangePassword, Browser, Search, Gallery, Trash, Profile, Admin (comptes / stockage / journal).
  • Client HTTP unique lib/api.ts (base /api/cloud, same-origin) ; contexte de session lib/session.tsx ; dialogues réutilisables dans components/dialogs.tsx.
  • En-têtes nginx : CSP stricte, HSTS, nosniff, Referrer-Policy, Permissions-Policy (docker/nginx/snippets/). X-Frame-Options est remplacé par frame-ancestors 'none' dans la CSP.
  • Dev : Vite 5174, proxy /api → http://127.0.0.1:3101. Prod : nginx sert le SPA avec repli try_files … @spa (liens profonds pris en charge).

Sessions

  • Cookie cohaise_session : httpOnly, SameSite=Lax, path=/, secure déduit du schéma réel (et de TRUST_PROXY).
  • En base, uniquement le SHA-256 du jeton. TTL SESSION_TTL_HOURS.
  • Changement de mot de passe ⇒ révocation des autres sessions ; gestion fine depuis la page compte.

Stockage et médias

  • MEDIA_DIR=/data/media/originals, VARIANT_DIR=/data/media/variants.
  • Chemin physique ${MEDIA_DIR}/<slug>/<uuid><ext> (storage.ts), nom affiché jamais dans le chemin.
  • media.ts : classification (image/video/audio/document/archive/other), vignette (sharp, seuil 480 px) écrite dans VARIANT_DIR, métadonnées dans media_metadata / file_variants. Indexation best-effort après upload.
  • Avatars dans user_avatars.

Corbeille

Suppression douce (deleted_at). purgeExpiredTrash (démarrage + accès) purge au-delà de trash_retention_days. Restauration et purge manuelles exposées via /trash.

Limites connues

  • Upload séquentiel par <input type=file> : pas de drag & drop, pas de reprise de transfert, pas de multipart.
  • docker/README.md (et tout README de paquet) peut décrire un état antérieur : se fier à docs/.