4.2 KiB
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)
migratemonte./backend/migrations:/migrations:ro.apirefuse de démarrer si une migration appliquée a été modifiée (dérive de checksum).onReadypurge 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: voirapi.md. - Front : React Router (
frontend/src/App.tsx) avec gardesRequireAuth/RequireReady/RequireAdminetAppShell(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 sessionlib/session.tsx; dialogues réutilisables danscomponents/dialogs.tsx. - En-têtes nginx : CSP stricte, HSTS,
nosniff,Referrer-Policy,Permissions-Policy(docker/nginx/snippets/).X-Frame-Optionsest remplacé parframe-ancestors 'none'dans la CSP. - Dev : Vite 5174, proxy
/api→http://127.0.0.1:3101. Prod : nginx sert le SPA avec replitry_files … @spa(liens profonds pris en charge).
Sessions
- Cookie
cohaise_session:httpOnly,SameSite=Lax,path=/,securedéduit du schéma réel (et deTRUST_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 dansVARIANT_DIR, métadonnées dansmedia_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/.