Files
CoHaiSe-CLOUD/docs/architecture.md
T
Esiah 93c6942cd5
PR — Ouverture automatique / create-pr (push) Successful in 3s
feat(ui): glass layout, icon actions and new icon set
2026-11-03 23:31:25 +01:00

4.2 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
Hono backend/src/index.ts (src/lib pour le socle)
MariaDB (mysql2) backend/src/lib/db.ts
Nodemailer backend/src/lib/mail.ts
sharp (vignettes) backend/src/media.ts
Validation Zod backend/src/lib/config.ts et chaque route

Découpage

backend/src/lib/    socle serveur : config, db, mail, mail-template, ratelimit, http, service, auth, errors
backend/src/        routes/, access.ts, storage.ts, media.ts, admin.ts
backend/migrations/ 000 … 006
frontend/src/ui/    design system (boutons, cartes, champs, spinner)
frontend/src/       router + AppShell + pages/
docker/                   Dockerfile(.app/.api), nginx/, publish.sh

backend/src/lib porte la mécanique générique (sessions, erreurs, migrations, courriel, limitation de débit), le reste de backend porte le métier : droits, quotas, chemins disque, traitement média. Tout vit dans un seul paquet, sans dépendance de workspace.

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/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, la corbeille et les envois inachevés, puis un balayage horaire reprend ces purges sans redémarrage.
  • 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/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/.