Renommage en Logs Reader et bouton marche/arrêt de la lecture

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Romulus21andClaude Opus 5.5 committed 2026-10-21 11:17:20 +02:00
1 parent 818527b758
commit 05c3934b28
9 files changed
+207 -54

No files matched your search

+20 -9
View File
@@ -1,4 +1,4 @@
# Lara Logs Reader — Spécification
# Logs Reader — Spécification
> Document dérivé du brief `.spec/spec.md`.
> Statut : brouillon v1 — 2026-10-21.
@@ -7,7 +7,7 @@
## 1. Vue d'ensemble
Lara Logs Reader est une application web **locale et mono-utilisateur** qui permet à un développeur de :
Logs Reader est une application web **locale et mono-utilisateur** qui permet à un développeur de :
1. enregistrer un ou plusieurs projets Laravel par leur chemin sur le disque ;
2. voir tous les fichiers de log de chaque projet et en lire les entrées ;
@@ -67,8 +67,8 @@ Lara Logs Reader est une application web **locale et mono-utilisateur** qui perm
- **Persistance** : SQLite via `sqlx`, migrations embarquées (`sqlx::migrate!`) appliquées au démarrage, `PRAGMA foreign_keys = ON`, mode WAL.
- **Scan** : déclenché par chaque appel `unread_summary` (donc au rythme du polling). Les scans concurrents d'un même projet sont sérialisés (mutex par projet) ; un appel qui arrive pendant un scan attend son résultat au lieu d'en relancer un.
- **Configuration** (variables d'environnement) :
- `LLR_DATABASE_URL` — défaut `sqlite://./lara_logs_reader.sqlite?mode=rwc`
- `LLR_ADDR` — défaut `127.0.0.1:3000`
- `LOGS_READER_DATABASE_URL` — défaut `sqlite://./logs_reader.sqlite?mode=rwc`
- `LOGS_READER_ADDR` — défaut `127.0.0.1:3000`
### 3.1 API (server functions)
@@ -83,6 +83,7 @@ Chaque fonction est exposée en `POST /api/<nom>`.
| `mark_all_read` | `project_id: Option<_>` | `()` |
| `unread_summary` | — | `Summary { total, projects[{…, unread, files[{…, unread}]}] }` |
| `get_settings` / `set_refresh_interval` | `seconds: String` | `Settings { refresh_interval_seconds, file_sort }` |
| `set_paused` | `paused: bool` | `()` |
| `set_file_sort` | `sort: "name" \| "modified"` | `()` |
---
@@ -181,8 +182,9 @@ Au scan, si `taille actuelle < scan_offset` **ou** `file_identity` a changé :
- Le favicon est un SVG 32×32 généré côté client (URL `data:`) :
- `total = 0` → icône normale ;
- `total ≥ 1` → icône + pastille rouge avec le nombre (`99+` au-delà de 99) ;
- serveur injoignable → icône + pastille grise « ! ».
- Le titre de l'onglet devient `(N) Lara Logs Reader` quand `N ≥ 1`, `Lara Logs Reader` sinon.
- serveur injoignable → icône + pastille grise « ! » ;
- lecture arrêtée → icône + pastille rouge avec le symbole pause (prioritaire sur les autres états).
- Le titre de l'onglet devient `(N) Logs Reader` quand `N ≥ 1`, `Logs Reader` sinon.
- Le favicon change même si l'onglet est en arrière-plan (les timers en arrière-plan peuvent être ralentis par le navigateur jusqu'à 1 fois par minute : comportement accepté).
### 5.6 Marquage comme lu
@@ -198,6 +200,7 @@ Au scan, si `taille actuelle < scan_offset` **ou** `file_identity` a changé :
- **Tri des fichiers** : par nom (alphabétique, défaut) ou par date de dernière modification (le plus récent en premier, sans date en dernier, nom en départage). Trié par date, l'ancienneté (« il y a 3 h ») remplace la taille. Le choix s'applique à tous les projets et est enregistré dans `settings` (`file_sort`).
- **Formulaire d'ajout** : champ chemin + nom optionnel, message d'erreur sous le champ.
- **Vue fichier** : entrées triées du plus récent au plus ancien, 50 par page, bouton « Charger plus ». Chaque entrée : date, niveau (badge coloré), environnement, première ligne ; le reste (stack trace) est repliable. Filtres par niveau (cases à cocher ; les niveaux absents du fichier sont grisés et désactivés, et se réactivent dès qu'une entrée de ce niveau apparaît) et recherche texte (insensible à la casse, sur le contenu complet de l'entrée).
- **Bouton marche/arrêt de la lecture** : à gauche du titre. Lecture active : un engrenage qui tourne lentement (6 s par tour, immobile si l'utilisateur a demandé moins d'animations). Lecture arrêtée : un bouton rouge avec l'icône « power ». L'arrêt supprime le polling et le rafraîchissement au retour sur l'onglet ; « · lecture arrêtée » s'affiche en rouge à côté du compteur. L'état est enregistré dans `settings` (`paused`). À la reprise, un rafraîchissement part immédiatement. Les actions de l'utilisateur (ouvrir un fichier, marquer comme lu, charger la page) rafraîchissent toujours.
- **Réglages** : intervalle en secondes (champ numérique, 1–3600).
---
@@ -249,10 +252,10 @@ Convention : `Given / When / Then`. « Écrire une entrée » signifie ajouter a
> En tant que développeur, je veux voir dans l'onglet du navigateur s'il y a de nouveaux logs, sans avoir à regarder l'application.
- **AC-05.1** Given 0 non-lu, When 3 entrées sont écrites dans un fichier suivi, Then en ≤ intervalle + 1 s le favicon porte une pastille « 3 » et le titre est `(3) Lara Logs Reader`.
- **AC-05.1** Given 0 non-lu, When 3 entrées sont écrites dans un fichier suivi, Then en ≤ intervalle + 1 s le favicon porte une pastille « 3 » et le titre est `(3) Logs Reader`.
- **AC-05.2** Given 2 non-lus dans `a.log` et 1 dans `b.log` (même projet ou non), Then la pastille affiche « 3 ».
- **AC-05.3** Given 150 non-lus, Then la pastille affiche « 99+ » et le titre `(150) Lara Logs Reader`.
- **AC-05.4** Given des non-lus, When tout est marqué comme lu, Then le favicon redevient normal et le titre `Lara Logs Reader` sans attendre le prochain poll.
- **AC-05.3** Given 150 non-lus, Then la pastille affiche « 99+ » et le titre `(150) Logs Reader`.
- **AC-05.4** Given des non-lus, When tout est marqué comme lu, Then le favicon redevient normal et le titre `Logs Reader` sans attendre le prochain poll.
- **AC-05.5** Given le serveur arrêté, When un poll échoue, Then le favicon affiche la pastille grise « ! » ; When le serveur redémarre, Then au poll suivant le favicon reflète à nouveau le nombre de non-lus.
- **AC-05.6** Given `laravel.log` vidé (`> laravel.log`) puis 2 entrées écrites, Then le fichier compte 2 non-lus.
@@ -293,6 +296,14 @@ Convention : `Given / When / Then`. « Écrire une entrée » signifie ajouter a
- **AC-10.3** Given le tri « Date », When je recharge la page ou redémarre le serveur, Then le tri « Date » est conservé.
- **AC-10.4** Given un projet replié, When je change de tri, Then il reste replié.
### US-11 — Mettre la lecture en pause
> En tant que développeur, je veux arrêter temporairement la lecture des logs, par exemple pendant une session de debug bruyante.
- **AC-11.1** Given la lecture active (engrenage qui tourne), When je clique dessus, Then le bouton devient rouge, le favicon affiche la pastille rouge « pause », « · lecture arrêtée » est affiché, et aucun appel `unread_summary` n'est fait pendant 3 intervalles, même si des entrées sont écrites.
- **AC-11.2** Given la lecture arrêtée, When je recharge la page, Then le bouton est toujours rouge, le favicon toujours en pause, et aucun polling ne reprend.
- **AC-11.3** Given la lecture arrêtée et 1 entrée écrite entre-temps, When je clique sur le bouton rouge, Then l'engrenage réapparaît et le compteur et le favicon sont mis à jour en moins de 1 s.
### US-09 — Conserver l'état entre deux redémarrages
> En tant que développeur, je veux retrouver mes projets et mes compteurs après un redémarrage.