Feat : Log recorder

README.md

@@ -25,7 +25,8 @@ IP publique nécessaire, et obs-websocket reste sur `127.0.0.1`.
 - Commandes unitaires ou groupées : démarrer/arrêter/mettre en pause/découper un
   enregistrement, démarrer/arrêter un stream, changer de scène, de profil, de collection,
   changer le dossier d'enregistrement.
-- Journal d'évènements horodaté, persistant et diffusé en direct.
+- Journal d'évènements horodaté, persistant et diffusé en direct, plus un
+  [historique par VM](#historique-par-vm) filtrable (🕘 sur la fiche de l'agent).
 - Reconnexion automatique de bout en bout (agent → serveur, agent → OBS, dashboard → serveur).
 - [Pause automatique pendant les shows privés](#pause-automatique-pendant-les-shows-privés)
   (Stripchat), avec reprise et rappel du plein écran au retour du flux public.
@@ -212,6 +213,28 @@ Un preset trop lourd pour la VM fait chuter les images par seconde : la qualité
 baisse alors malgré un meilleur CRF. Après un changement, surveille « FPS » et « Frames
 perdues » sur la fiche de l'agent.
 
+## Historique par VM
+
+Le journal en bas de page mélange toutes les machines. Le bouton 🕘 de la fiche d'un agent
+ouvre son historique à lui : mêmes entrées, filtrées sur cette VM, groupées par jour et du
+plus récent au plus ancien.
+
+Chaque entrée porte un **type d'évènement** — `record.paused`, `obs.disconnected`,
+`fullscreen.restored`, `preset.applied`… — qui lui donne son pictogramme et sa couleur, et
+qui alimente les filtres : Enregistrement, OBS, Surveillance, Problèmes.
+
+Ce champ est facultatif dans le protocole. Une entrée écrite avant cette version, ou
+envoyée par un agent qui n'a pas encore été mis à jour, s'affiche sans pictogramme plutôt
+que de disparaître.
+
+Les pauses détectées valent d'être soulignées : elles proviennent de l'évènement
+`RecordStateChanged` d'OBS, pas de la commande envoyée. L'historique montre donc aussi
+les pauses déclenchées depuis l'interface d'OBS sur la VM, que le dashboard n'aurait
+aucun autre moyen de connaître.
+
+La rétention est celle du journal global (`LOG_RETENTION`) : les entrées les plus
+anciennes sont purgées, toutes VM confondues.
+
 ## API HTTP
 
 Toutes les routes hors `/api/login` exigent `Authorization: Bearer <jeton de session>`.
@@ -226,7 +249,8 @@ Toutes les routes hors `/api/login` exigent `Authorization: Bearer <jeton de ses
 | `DELETE` | `/api/agents/:id` | Supprime l'agent |
 | `POST` | `/api/agents/:id/command` | `{ action, params }`, attend le résultat de l'agent |
 | `POST` | `/api/commands/bulk` | Même action sur plusieurs agents, résultat par agent |
-| `GET` | `/api/logs?limit=` | Journal récent |
+| `GET` | `/api/logs?limit=` | Journal récent, toutes VM confondues |
+| `GET` | `/api/agents/:id/logs?limit=` | Historique d'une VM, ordre chronologique |
 | `GET` | `/healthz` | Sonde de vie (non authentifiée) |
 
 Actions disponibles : `obs.connect`, `obs.disconnect`, `obs.refresh`, `record.start`,