PR — Ouverture automatique / create-pr (push) Failing after 1s
Standalone files & media application: React/Vite frontend with the @cohaise/ui design system, Hono + MariaDB backend, nginx reverse proxy, Docker Compose stack, migrations 000-006, and project docs. Adds Gitea Actions workflows for deployment, automatic pull requests, and Renovate dependency updates.
4.0 KiB
4.0 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)
migratemonte./backend/cloud/migrations:/migrations:ro.apirefuse de démarrer si une migration appliquée a été modifiée (dérive de checksum).onReadypurge les sessions et la corbeille expirées.- volumes :
app_data(HTML),db_data(MariaDB),media_data.
API et front
- API
/api/cloud: voirapi.md. - Front : React Router (
frontend/cloud/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/.