From e44e0fd16238629d6dd4c320761bb8c711e1105f Mon Sep 17 00:00:00 2001
From: Romulus21
Date: Wed, 21 Oct 2026 13:24:11 +0200
Subject: [PATCH] =?UTF-8?q?Rafra=C3=AEchissement=20par=20projet,=20nom=20o?=
=?UTF-8?q?bligatoire=20et=20fichiers=20anciens=20masqu=C3=A9s?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
- Chaque projet choisit sa fréquence de relecture (jamais, 5 s … 1 h) ; le
serveur ne relit que les projets dus, le fichier affiché est toujours à
jour. Le réglage global et sa page disparaissent (migration de l'ancien
intervalle vers chaque projet).
- Le nom du projet est obligatoire, proposé d'après le chemin.
- Les fichiers non modifiés depuis N jours peuvent être masqués ; ils ne
comptent plus dans les non-lus et réapparaissent dès qu'ils changent.
Co-Authored-By: Claude Opus 5.5
---
.spec/specification.md | 68 ++++----
README.md | 2 +-
migrations/0006_project_refresh.sql | 20 +++
migrations/0007_hide_old_files.sql | 3 +
src/api.rs | 75 ++++++---
src/app.rs | 241 ++++++++++++++++------------
src/model.rs | 104 +++++++++---
src/scanner.rs | 138 +++++++++++++---
src/server.rs | 47 ++++--
9 files changed, 483 insertions(+), 215 deletions(-)
create mode 100644 migrations/0006_project_refresh.sql
create mode 100644 migrations/0007_hide_old_files.sql
diff --git a/.spec/specification.md b/.spec/specification.md
index fe5733a..3c3cc16 100644
--- a/.spec/specification.md
+++ b/.spec/specification.md
@@ -12,7 +12,7 @@ Logs Reader est une application web **locale et mono-utilisateur** qui permet à
1. enregistrer un ou plusieurs projets (Laravel, Symfony, Node… : n'importe quel dossier) par leur chemin sur le disque et leurs dossiers de logs ;
2. voir tous les fichiers de log de chaque projet et en lire les entrées, y compris les logs Apache du vhost du projet ;
3. être prévenu, via le **favicon** et le titre de l'onglet, de toute nouvelle entrée apparue depuis sa dernière consultation ;
-4. choisir l'intervalle de rafraîchissement.
+4. choisir, pour chaque projet, la fréquence de relecture de ses logs.
### 1.1 Périmètre
@@ -42,7 +42,7 @@ Logs Reader est une application web **locale et mono-utilisateur** qui permet à
| **Offset de scan** | Position (en octets) jusqu'à laquelle le fichier a été lu et découpé en entrées complètes. |
| **Curseur de lecture** | Position (en octets) de fin de la dernière entrée **consultée** par l'utilisateur, une par fichier. |
| **Non-lu** | Une entrée complète qui commence à un offset ≥ curseur de lecture. |
-| **Intervalle** | Délai en secondes entre deux rafraîchissements côté client. |
+| **Intervalle** | Délai entre deux relectures automatiques des logs d'un projet, choisi par projet : jamais, 5 s, 15 s, 30 s, 1 min, 5 min, 15 min, 30 min ou 1 h. |
| **Vhost** | Fichier de configuration Apache rattaché à un projet (au plus un), identifié par son chemin canonique. |
| **Log Apache** | Fichier déclaré par une directive `ErrorLog` (log d'erreurs) ou `CustomLog`/`TransferLog` (log d'accès) du vhost. |
@@ -69,7 +69,7 @@ Logs Reader est une application web **locale et mono-utilisateur** qui permet à
- **Build** : `cargo-leptos` (features `ssr` / `hydrate`), Tailwind CSS intégré via la config `tailwind-input-file` de cargo-leptos.
- **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.
+- **Scan** : déclenché par chaque appel `unread_summary` (donc au rythme du polling) pour les projets dont l'intervalle est écoulé (cf. 5.5), et par `read_entries` pour le projet du fichier affiché. 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) :
- `LOGS_READER_DATABASE_URL` — défaut `sqlite://./logs_reader.sqlite?mode=rwc`
- `LOGS_READER_ADDR` — défaut `127.0.0.1:3000`
@@ -80,15 +80,15 @@ Chaque fonction est exposée en `POST /api/`.
| Fonction | Entrée | Sortie |
|---|---|---|
-| `add_project` | `path`, `name`, `log_dirs` (un par ligne), `vhost` (vides = défaut / aucun) | `()` |
-| `update_project` | `project_id`, `path`, `name`, `log_dirs`, `vhost` (vhost vide = retirer) | `()` |
+| `add_project` | `path`, `name`, `refresh_seconds`, `hide_after_days` (vide = aucun), `log_dirs` (un par ligne), `vhost` (vides = défaut / aucun) | `()` |
+| `update_project` | `project_id`, `path`, `name`, `refresh_seconds`, `hide_after_days`, `log_dirs`, `vhost` (vhost vide = retirer) | `()` |
| `suggest_log_dirs` | `path` | `Vec` (cf. 5.1) |
| `remove_project` | `project_id` | `()` |
| `read_entries` | `file_id`, `limit` (≤ 2000), `levels: Vec`, `query: String` | `EntriesPage { entries, has_more, scan_offset, read_offset, levels }` |
| `mark_read` | `file_id`, `up_to` | `()` |
| `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 }` |
+| `get_settings` | — | `Settings { file_sort, paused }` |
| `set_paused` | `paused: bool` | `()` |
| `set_file_sort` | `sort: "name" \| "modified"` | `()` |
@@ -105,6 +105,8 @@ CREATE TABLE projects (
vhost_path TEXT, -- vhost Apache, chemin canonique
vhost_error TEXT, -- vhost illisible
log_dirs TEXT NOT NULL DEFAULT 'storage/logs', -- dossiers de logs, un par ligne
+ refresh_seconds INTEGER NOT NULL DEFAULT 5, -- 0 (jamais), 5, 15, 30, 60, 300, 900, 1800, 3600
+ hide_after_days INTEGER, -- masque les fichiers plus anciens ; NULL = aucun
created_at TEXT NOT NULL
);
@@ -144,7 +146,7 @@ CREATE TABLE settings (
key TEXT PRIMARY KEY,
value TEXT NOT NULL
);
--- valeurs initiales : ('refresh_interval_seconds', '5'), ('file_sort', 'name')
+-- valeurs : ('file_sort', 'name' | 'modified'), ('paused', '0' | '1')
```
- Le **contenu** des entrées n'est pas stocké : il est relu dans le fichier à partir de `start_offset`/`end_offset`. L'index permet compteurs, filtres par niveau et pagination sans tout relire.
@@ -159,7 +161,7 @@ CREATE TABLE settings (
1. Le chemin saisi est nettoyé (trim) ; `~` en tête est remplacé par `$HOME`.
2. Il est canonicalisé (`std::fs::canonicalize`).
3. Il est valide si c'est un répertoire (aucun fichier particulier n'est exigé).
-4. Le nom par défaut est le nom du dernier segment du chemin.
+4. Le nom est obligatoire (« Veuillez saisir un nom. ») ; la fenêtre propose le dernier segment du chemin tant que l'utilisateur ne l'a pas saisi lui-même.
5. **Dossiers de logs** : un par ligne (ou séparés par des virgules), relatifs à la racine ; espaces, `./` en tête et `/` final retirés, doublons ignorés. Chacun doit être un sous-dossier (ni `.`, ni `..`, ni chemin absolu) existant et lisible.
6. **Proposition** : quand le chemin est saisi (et tant que l'utilisateur n'a pas modifié le champ), la fenêtre propose les dossiers existants parmi : `storage/logs` si `artisan` existe (Laravel), `var/log` si `bin/console` existe (Symfony), puis `storage/logs`, `var/log`, `var/logs`, `logs`, `log`.
7. Un vhost Apache peut être indiqué (optionnel, cf. 5.8). Il faut au moins un dossier de logs ou un vhost. Si un champ est invalide, rien n'est enregistré.
@@ -167,7 +169,7 @@ CREATE TABLE settings (
### 5.1 bis Modification d'un projet
-- Le nom, le chemin, les dossiers de logs et le vhost se modifient avec les mêmes règles qu'à l'ajout (nom vide → dernier segment du chemin ; vhost vide → aucun vhost).
+- Le nom, le chemin, les dossiers de logs et le vhost se modifient avec les mêmes règles qu'à l'ajout (nom obligatoire ; vhost vide → aucun vhost).
- Un nouveau chemin déjà enregistré par un autre projet est refusé (« Ce projet est déjà enregistré. »).
- Changer de chemin supprime les fichiers suivis de l'ancien chemin ; ceux du nouveau sont indexés avec leur curseur en fin de fichier. Retirer un dossier de logs supprime ses fichiers. Les fichiers qui deviennent suivis (nouveau chemin, nouveau dossier, nouveau vhost) ne comptent pas leur historique en non-lu ; les autres gardent leurs curseurs.
- La modification et le scan qui suit se font sous le verrou du scanner.
@@ -202,8 +204,10 @@ Au scan, si `taille actuelle < scan_offset` **ou** `file_identity` a changé :
### 5.5 Rafraîchissement et notification
-- Le client appelle `unread_summary` au chargement de la page puis toutes les `refresh_interval_seconds` secondes.
-- Le nouvel intervalle s'applique dès l'enregistrement, sans recharger la page (le timer est recréé).
+- Le client appelle `unread_summary` au chargement de la page puis toutes les 5 s (le plus court des intervalles).
+- Le serveur ne relit que les projets dont l'intervalle est écoulé (marge de 1 s, pour qu'un poll un peu en avance ne fasse pas attendre un cycle de plus) ; les autres gardent leurs compteurs. Un projet réglé sur « jamais » n'est jamais relu ainsi. L'heure de la dernière relecture de chaque projet est tenue en mémoire : au démarrage du serveur, tous les projets (sauf « jamais ») sont relus au premier poll.
+- **Fichier affiché** : `read_entries` relit d'abord le projet du fichier, quel que soit son intervalle. Le fichier ouvert est donc à jour à chaque poll, y compris pour un projet « jamais ».
+- Un nouvel intervalle s'applique dès l'enregistrement du projet, sans recharger la page.
- 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) ;
@@ -223,11 +227,12 @@ Au scan, si `taille actuelle < scan_offset` **ou** `file_identity` a changé :
- **Barre latérale** : liste des projets, chacun dépliable en liste de fichiers (chemin relatif à la racine, ou au dossier de logs s'il n'y en a qu'un ; taille ; badge de non-lus). Fichiers manquants grisés. Un projet replié le reste aux rafraîchissements.
- **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`).
-- **Fenêtre de projet** (modale, `