feat(chat,files): edit messages, pin several of them, drag-and-drop upload

Chat messages can now be rewritten by their author only, at any time, with a
"(edited)" marker whose tooltip carries the full date and time down to the
second. The edit is enforced by the SQL filter on user_id, so a message of
someone else answers 404, exactly like a message that does not exist.

Several messages can be pinned at once in the same chat room. Pinning is open
to every member of the room: it is a reading convenience, not a way to take
over someone else's content. A dedicated GET on /chat/pins is required because
the id cursor only reports recent messages, and pinning an old one would
otherwise stay invisible.

The message list is synchronised with two cursors: the id one for new
messages, a timestamp one for rewrites. The server computes that timestamp
before running the query and returns it as-is, in the very frame used by
edited_at, so the client never converts it and cannot drift by a timezone
offset.

Files can now be dropped on the current folder or on any sub-folder card. The
drop zone only reacts to file drags, and the pointer moving from a child
element to another no longer makes the overlay flicker.

A deleted message leaves the pinned list, and its physical file is removed
from the disk as before.
This commit is contained in:
2026-10-22 10:11:39 +02:00
parent cbe33bf563
commit 6fed804a02
9 changed files with 697 additions and 33 deletions
+37 -2
View File
@@ -78,8 +78,11 @@ identifiant (`after`), sans WebSocket.
| Méthode | Chemin | Garde |
| --- | --- | --- |
| GET | `/api/cloud/folders/:folderId/chat/members` | `requireAuth` + `canRead` |
| GET | `/api/cloud/folders/:folderId/chat/messages?after=&limit=` | `requireAuth` + `canRead` |
| GET | `/api/cloud/folders/:folderId/chat/messages?after=&limit=&editedAfter=` | `requireAuth` + `canRead` |
| POST | `/api/cloud/folders/:folderId/chat/messages` | `requireAuth` + `canRead` (limiteur 20 / 10 s par compte) |
| PATCH | `/api/cloud/folders/:folderId/chat/messages/:id` | `requireAuth` + `canRead` + **auteur du message** (limiteur 20 / 10 s par compte) |
| PUT | `/api/cloud/folders/:folderId/chat/messages/:id/pin` | `requireAuth` + `canRead` (limiteur 20 / 10 s par compte) |
| GET | `/api/cloud/folders/:folderId/chat/pins` | `requireAuth` + `canRead` |
| DELETE | `/api/cloud/folders/:folderId/chat/messages/:id` | `requireAuth` + `canRead` (auteur ou gestionnaire du dossier, soft-delete) |
`GET .../chat/members` renvoie les membres du salon, c'est-à-dire les comptes qui
@@ -87,6 +90,35 @@ ont accès au dossier : propriétaire, titulaires d'une permission nominative no
expirée, rôle global `admin`, et tous les comptes actifs si le dossier est
`public` (prénom, nom, rôle, présence d'avatar, `last_login_at`).
**Édition.** `PATCH .../chat/messages/:id` réécrit le corps du message et pose
`edited_at`. Seul l'auteur peut le faire, sans limite de temps : le filtre
`user_id` est porté par la requête SQL, donc un message d'autrui renvoie le
même `404` qu'un message inexistant. Le gestionnaire du dossier peut supprimer
un message, mais pas le réécrire à la place de son auteur.
**Épinglage.** `PUT .../chat/messages/:id/pin` bascule `is_pinned` en base
(bascule atomique, safe face à deux clics croisés). Plusieurs messages peuvent
être épinglés en même temps dans un même salon. Tout membre du salon peut
épingler et désépingler, y compris un message qu'il n'a pas écrit. La lecture
dédiée `GET .../chat/pins` est nécessaire parce que le curseur `after` ne
remonte que les messages plus récents : un épinglage posé sur un ancien
message resterait invisible sans elle.
**Synchronisation.** `GET .../chat/messages` accepte deux curseurs : `after`
(identifiant, messages plus récents) et `editedAfter` (horodatage, messages
réécrits depuis). Le second rattrape les réécritures d'anciens messages, que le
premier ne peut pas voir. `edited_at` est null pour un message jamais modifié.
Le curseur d'édition est un horodatage de la base au format
`AAAA-MM-JJTHH:MM:SS.ffffff`, et non un horodatage ISO : il est renvoyé tel quel
par la réponse (`cursor`) et doit être renvoyé tel quel par le client. Comparer
une chaîne ISO (UTC) à un `DATETIME` stocké en heure locale décalerait la
fenêtre de la différence de fuseau. Le serveur calcule son curseur **avant** la
requête de lecture : une réécriture survenue entre les deux porte un
horodatage postérieur au curseur, elle sera donc vue au tour suivant plutôt que
perdue. Une valeur qui ne respecte pas le format est ignorée, le serveur
utilise alors le sien.
### Administration (`role_slug = admin`)
| Méthode | Chemin |
@@ -163,10 +195,13 @@ par fichier, dérive refusée au démarrage.
| `005_storage_location_realign.sql` | réalignement des emplacements |
| `006_public_folder.sql` | `folders.access_type` / `is_system`, dossier `Public` |
| `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` |
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`.
settings, password_reset_tokens, email_change_requests, audit_logs,
user_file_stars, chat_reads`.
## Erreurs métier