refactor(storage): enforce per-user max_file_bytes limit on upload pipelines (#20)
CD — Deployment / deploy (push) Successful in 22s
CD — Deployment / deploy (push) Successful in 22s
* Validate Content-Length on single-part upload route against user limit * Check total expected size on chunked upload session creation * Re-evaluate user limit at finalization to reject dynamic quota reductions * Clean up temporary files on payload size rejection (413) * Add 60-second polling interval for periodic fetching of messages and images --------- Co-authored-by: xEsiah <[email protected]> Reviewed-on: #20 Reviewed-by: Esiah <[email protected]> Co-authored-by: Gitea Actions <-[email protected]>
This commit was merged in pull request #20.
This commit is contained in:
+27
-3
@@ -54,6 +54,27 @@ d'adresse).
|
||||
| PUT | `/api/cloud/files/:id/star` | `requireAuth` |
|
||||
| DELETE | `/api/cloud/files/:id` | `requireAuth` + écriture (corbeille) |
|
||||
|
||||
### Envoi resumable (gros fichiers)
|
||||
|
||||
Au-delà de la limite de corps de requête de Cloudflare (100 MB en Free/Pro), le
|
||||
client découpe le fichier en morceaux de 50 MiB. Une session est créée en base,
|
||||
le temporaire est préalloué sous `MEDIA_DIR/.uploads`, puis les morceaux sont
|
||||
écrits à l'offset courant. La finalisation vérifie le nom et les droits une
|
||||
dernière fois, calcule le SHA-256, publie le fichier et met à jour les quotas.
|
||||
|
||||
| Méthode | Chemin | Garde |
|
||||
| --- | --- | --- |
|
||||
| POST | `/api/cloud/uploads` | `requireAuth` (nom, `folderId`, `size`, `mimeType`) |
|
||||
| GET | `/api/cloud/uploads/:id` | `requireAuth` (propriétaire de la session, donne l'offset de reprise) |
|
||||
| PUT | `/api/cloud/uploads/:id/chunks` | `requireAuth` (corps brut, `Content-Length` obligatoire) |
|
||||
| POST | `/api/cloud/uploads/:id/complete` | `requireAuth` (vérifie taille, nom, droits, quotas) |
|
||||
| DELETE | `/api/cloud/uploads/:id` | `requireAuth` (annule et supprime le temporaire) |
|
||||
|
||||
Les sessions expirent après 24 h ; une purge au démarrage puis toutes les
|
||||
heures supprime les temporaires orphelins. Un morceau interrompu ne fait pas
|
||||
avancer le curseur : le client interroge `GET /uploads/:id` puis reprend à
|
||||
l'offset exact.
|
||||
|
||||
### Corbeille, recherche, galerie
|
||||
|
||||
| Méthode | Chemin | Garde |
|
||||
@@ -157,6 +178,8 @@ par tous les membres authentifiés, en écriture pour son propriétaire.
|
||||
| Contrôle | Détail |
|
||||
| --- | --- |
|
||||
| Corps | `PUT /files` en flux brut (pas de multipart), `?name=` et `?folderId=` |
|
||||
| Gros fichiers | au-delà de 90 MiB, le front bascule sur `/uploads` (morceaux de 50 MiB) pour rester sous la limite Cloudflare |
|
||||
| Reprise | l'ID de session est conservé localement ; un envoi interrompu repart de `uploadedBytes` |
|
||||
| Taille | plafond `users.max_file_bytes`, vérifié en flux (coupure si dépassement) |
|
||||
| Quota | `users.used_bytes` + quota `storage_locations`, revérifiés avant écriture |
|
||||
| Disque | `diskUsage()` (`statfs`) avant écriture ; `507` `INSUFFICIENT_STORAGE` si le support est plein |
|
||||
@@ -197,11 +220,12 @@ par fichier, dérive refusée au démarrage.
|
||||
| `007_chat.sql` | `chat_messages` (salon global, auteur `ON DELETE SET NULL`) |
|
||||
| `008_user_preferences.sql` | préférences d'affichage, `user_file_stars`, `chat_reads` |
|
||||
| `009_chat_edits_and_pins.sql` | `chat_messages.edited_at`, `chat_messages.is_pinned`, index `idx_chat_messages_pinned`, `idx_chat_messages_edited` |
|
||||
| `010_upload_sessions.sql` | `upload_sessions` (envoi resumable, temporaire préalloué, expiration) |
|
||||
|
||||
Tables actives : `users, user_sessions, folders, folder_permissions, files,
|
||||
media_metadata, file_variants, user_avatars, chat_messages, storage_locations,
|
||||
settings, password_reset_tokens, email_change_requests, audit_logs,
|
||||
user_file_stars, chat_reads`.
|
||||
media_metadata, file_variants, user_avatars, chat_messages, upload_sessions,
|
||||
storage_locations, settings, password_reset_tokens, email_change_requests,
|
||||
audit_logs, user_file_stars, chat_reads`.
|
||||
|
||||
## Erreurs métier
|
||||
|
||||
|
||||
Reference in New Issue
Block a user