CD — Deployment / deploy (push) Successful in 33s
PR automatique de feat/ui-glass-layout-icons vers main. --------- Co-authored-by: xEsiah <[email protected]> Reviewed-on: #21 Reviewed-by: Esiah <[email protected]> Co-authored-by: Gitea Actions <-[email protected]>
100 lines
4.2 KiB
Markdown
100 lines
4.2 KiB
Markdown
# 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`](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/`.
|