Rafraîchissement par projet, nom obligatoire et fichiers anciens masqués

- 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 <noreply@anthropic.com>
This commit is contained in:
Romulus21andClaude Opus 5.5 committed 2026-10-21 13:24:11 +02:00
1 parent 86c8f1bb49
commit e44e0fd162
9 files changed
+483 -215

No files matched your search

+41 -27
View File
@@ -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/<nom>`.
| 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<String>` (cf. 5.1) |
| `remove_project` | `project_id` | `()` |
| `read_entries` | `file_id`, `limit` (≤ 2000), `levels: Vec<String>`, `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, `<dialog>` natif) : ouverte par « + Ajouter un projet » ou par le bouton ✎ d'un projet (pré-remplie). Champs : chemin du projet, nom (optionnel), dossiers de logs (zone de texte, un par ligne, proposés d'après le chemin, cf. 5.1), vhost Apache (optionnel). En modification, un bouton « Retirer ce projet » en bas à gauche le supprime après confirmation (c'est le seul moyen de retirer un projet). Message d'erreur dans la fenêtre ; elle se ferme quand l'enregistrement ou le retrait réussit, par « Annuler », Échap ou un clic sur le fond.
- **Fenêtre de projet** (modale, `<dialog>` natif) : ouverte par « + Ajouter un projet » ou par le bouton ✎ d'un projet (pré-remplie). Champs : chemin du projet, nom (obligatoire, proposé d'après le chemin), dossiers de logs (zone de texte, un par ligne, proposés d'après le chemin, cf. 5.1), vhost Apache (optionnel). En modification, un bouton « Retirer ce projet » en bas à gauche le supprime après confirmation (c'est le seul moyen de retirer un projet). Message d'erreur dans la fenêtre ; elle se ferme quand l'enregistrement ou le retrait réussit, par « Annuler », Échap ou un clic sur le fond.
- **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.
- **Logs Apache** : les logs Apache sont listés sous le titre « Apache », après les logs du projet, par nom de fichier suivi de leur rôle (« erreurs » ou « accès »), le chemin complet en info-bulle.
- **Réglages** : intervalle en secondes (champ numérique, 1–3600).
- **Fichiers anciens** : champ numérique « Masquer les fichiers non modifiés depuis (jours) » dans la fenêtre de projet, vide par défaut (aucun fichier masqué), sinon un entier ≥ 1 (« Le nombre de jours doit être un entier positif. »). Un fichier est masqué si sa dernière modification remonte à plus de N × 24 h ; un fichier sans date reste affiché. Les fichiers masqués ne sont ni listés ni comptés dans les non-lus, mais restent scannés : une nouvelle entrée change leur date et les fait réapparaître. Sous le projet, « N fichiers anciens masqués » les signale ; le message « Aucun fichier de log pour l'instant. » n'apparaît pas si des fichiers sont masqués.
- **Rafraîchissement** : liste déroulante dans la fenêtre de projet (« Jamais », « 5 s » … « 1 h », 5 s par défaut). Un projet réglé sur « jamais » porte un ⏸ dans la liste ; l'info-bulle de son nom rappelle l'intervalle. Il n'y a plus de page de réglages.
### 5.8 Logs Apache du vhost
@@ -245,7 +250,7 @@ Au scan, si `taille actuelle < scan_offset` **ou** `file_identity` a changé :
## 6. User stories et critères d'acceptation
Convention : `Given / When / Then`. « Écrire une entrée » signifie ajouter au fichier une ligne `[2026-10-21 10:00:00] local.ERROR: message\n`. Tous les délais s'entendent avec un intervalle de 1 s sauf mention contraire.
Convention : `Given / When / Then`. « Écrire une entrée » signifie ajouter au fichier une ligne `[2026-10-21 10:00:00] local.ERROR: message\n`. Tous les délais s'entendent avec un projet rafraîchi toutes les 5 s sauf mention contraire.
### US-01 — Ajouter un projet
@@ -257,7 +262,7 @@ Convention : `Given / When / Then`. « Écrire une entrée » signifie ajouter a
- **AC-01.2** Given le même répertoire, When j'ajoute `/tmp/app/` puis `/tmp/../tmp/app`, Then la 2ᵉ et la 3ᵉ tentative sont refusées avec « Ce projet est déjà enregistré ».
- **AC-01.3** Given un lien `/tmp/link → /tmp/app` et `/tmp/app` déjà enregistré, When j'ajoute `/tmp/link`, Then l'ajout est refusé (même chemin canonique).
- **AC-01.4** Given `laravel.log` contient 10 entrées, When j'ajoute le projet, Then le compteur de non-lus du projet vaut 0.
- **AC-01.5** Given un nom saisi « Mon API », When j'ajoute le projet, Then il s'affiche sous le nom « Mon API ».
- **AC-01.5** Given le chemin `/tmp/app` saisi, Then le nom proposé est « app » ; When je le remplace par « Mon API » et j'ajoute le projet, Then il s'affiche sous le nom « Mon API ». When le nom est vide, Then l'ajout est refusé avec « Veuillez saisir un nom. ».
- **AC-01.6** Given `~/code/app` valide, When je saisis `~/code/app`, Then le projet est enregistré avec le chemin absolu.
### US-02 — Lister tous les fichiers de log d'un projet
@@ -279,20 +284,29 @@ Convention : `Given / When / Then`. « Écrire une entrée » signifie ajouter a
- **AC-03.4** Given un fichier contenant des octets non UTF-8, When il est affiché, Then les entrées s'affichent avec le caractère `�` à la place des octets invalides, sans erreur.
- **AC-03.5** Given un fichier de 1 Gio, When je l'ouvre, Then la première page s'affiche en < 2 s après l'indexation initiale et la mémoire du serveur reste < 200 Mio.
### US-04 — Configurer l'intervalle de rafraîchissement
### US-14 — Masquer les fichiers anciens
> En tant que développeur, je veux choisir la fréquence de lecture des logs, pour arbitrer entre réactivité et charge.
> En tant que développeur, je veux ne pas voir les vieux logs journaliers d'un projet, pour trouver vite ceux qui vivent encore.
- **AC-04.1** Given une première installation, When j'ouvre les réglages, Then l'intervalle vaut 5 s.
- **AC-04.2** Given l'intervalle à 5 s, When je saisis 30 et j'enregistre, Then le client n'appelle plus `unread_summary` qu'une fois toutes les 30 s (± 1 s), sans rechargement de page.
- **AC-04.3** When je saisis `0`, `3601`, `-5`, `abc` ou une valeur vide, Then l'enregistrement est refusé avec « L'intervalle doit être un entier entre 1 et 3600 secondes » et la valeur précédente est conservée.
- **AC-04.4** Given l'intervalle à 30 s, When je redémarre le serveur, Then l'intervalle vaut toujours 30 s.
- **AC-14.1** Given `laravel-2026-09-01.log` modifié il y a 50 j et `laravel.log` modifié il y a 1 h, When je règle « 30 » jours, Then seul `laravel.log` est listé, suivi de « 1 fichier ancien masqué ».
- **AC-14.2** Given le réglage à 30 j et 2 non-lus dans un fichier masqué, Then le total ne les compte pas ; When une entrée y est écrite, Then le fichier réapparaît avec 3 non-lus.
- **AC-14.3** When je vide le champ, Then tous les fichiers sont à nouveau listés. When je saisis `0`, Then l'enregistrement est refusé avec « Le nombre de jours doit être un entier positif. ».
### US-04 — Choisir le rafraîchissement d'un projet
> En tant que développeur, je veux régler la fréquence de relecture de chaque projet, pour suivre de près le projet sur lequel je travaille sans relire en permanence les autres.
- **AC-04.1** Given un nouveau projet, When j'ouvre la fenêtre d'ajout, Then le rafraîchissement vaut « 5 s » et la liste propose Jamais, 5 s, 15 s, 30 s, 1 min, 5 min, 15 min, 30 min, 1 h.
- **AC-04.2** Given un projet A à 5 s et un projet B à 1 min, When une entrée est écrite dans chacun, Then A la signale en ≤ 6 s et B en ≤ 61 s.
- **AC-04.3** Given un projet réglé sur « Jamais », When des entrées sont écrites, Then ses compteurs ne changent pas et un ⏸ est affiché à côté de son nom ; When j'ouvre un de ses fichiers, Then les nouvelles entrées s'affichent.
- **AC-04.4** When une valeur hors de la liste est envoyée à `add_project` ou `update_project`, Then l'enregistrement est refusé avec « Intervalle de rafraîchissement invalide. ».
- **AC-04.5** Given un projet à 15 min, When je redémarre le serveur, Then il est toujours à 15 min. Les projets existants avant cette version prennent l'ancien intervalle global, arrondi au choix supérieur.
### US-05 — Être notifié des nouvelles entrées par le favicon
> 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) Logs Reader`.
- **AC-05.1** Given 0 non-lu, When 3 entrées sont écrites dans un fichier suivi, Then en ≤ 6 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) 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.
@@ -340,7 +354,7 @@ Convention : `Given / When / Then`. « Écrire une entrée » signifie ajouter a
> 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.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 15 s, 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.
@@ -395,13 +409,13 @@ Convention : `Given / When / Then`. « Écrire une entrée » signifie ajouter a
| E15 | Texte sans ligne d'en-tête valide | Regex | Entrée `UNKNOWN` (cf. 5.3) | — |
| E16 | Fichier très volumineux | — | Lecture par blocs ; jamais de chargement complet | — |
| E17 | Entrée gigantesque (> 1 Mio) | Taille `end - start` | Affichage tronqué | « Entrée tronquée (X Mio). » |
| E18 | Intervalle invalide | Validation client et serveur | Refus, ancienne valeur conservée | cf. AC-04.3 |
| E18 | Intervalle invalide | Validation serveur (choix de la liste) | Refus, ancienne valeur conservée | cf. AC-04.4 |
| E19 | `log_file_id` / `project_id` inconnu | Requête vide | Erreur 404 de la server function | « Élément introuvable, la liste a été rafraîchie. » |
| E20 | Base SQLite inaccessible au démarrage | Échec de connexion/migration | Arrêt du processus, code de sortie ≠ 0 | Log console explicite avec le chemin |
| E21 | Base verrouillée en cours d'exécution | `SQLITE_BUSY` | `busy_timeout` de 5 s, puis erreur renvoyée au client ; aucun état partiel (transaction) | « Base de données occupée, nouvel essai au prochain rafraîchissement. » |
| E22 | Base corrompue | `PRAGMA quick_check` au démarrage | Arrêt du processus | Log console explicite |
| E23 | Port déjà utilisé | `bind` échoue | Arrêt, code de sortie ≠ 0 | « L'adresse `<addr>` est déjà utilisée. » |
| E24 | Serveur injoignable côté client | Échec réseau du poll | Favicon gris « ! », bandeau discret ; on continue de poller au même intervalle | « Serveur injoignable. » |
| E24 | Serveur injoignable côté client | Échec réseau du poll | Favicon gris « ! », bandeau discret ; on continue de poller toutes les 5 s | « Serveur injoignable. » |
| E25 | Scans simultanés (plusieurs onglets) | Mutex par projet | Un seul scan à la fois, résultats partagés ; pas de double indexation | — |
| E26 | Vhost inexistant, illisible ou sans directive de log | Validation serveur | Refus, vhost précédent conservé | « Le fichier « p » n'existe pas. », « Accès refusé à « p ». », « Aucune directive ErrorLog ni CustomLog dans « p ». » |
| E27 | Vhost supprimé ou illisible après configuration | Lecture au scan | `vhost_error` renseigné, fichiers Apache connus conservés en l'état | Message sous le titre « Apache » |
@@ -417,13 +431,13 @@ Ces propriétés doivent être vraies après toute opération et peuvent être v
- **INV-02 Ordre des offsets** — Pour tout fichier présent : `0 ≤ read_offset ≤ scan_offset ≤ size`.
- **INV-03 Index cohérent** — Les entrées indexées d'un fichier sont disjointes, contiguës et triées : pour deux entrées consécutives `e1, e2`, `e1.end_offset = e2.start_offset` ; la dernière se termine à `scan_offset` ; `entries_count` = nombre de lignes d'index.
- **INV-04 Aucune entrée partielle ni doublon** — Chaque entrée complète du fichier est indexée exactement une fois ; aucune entrée incomplète n'est indexée.
- **INV-05 Calcul des non-lus** — `unread(f)` = nombre d'entrées indexées de `f` avec `start_offset ≥ read_offset` ; `unread(f) ≥ 0` ; `unread(f) = 0` si `f` est manquant ou est un log d'accès Apache ; `total = Σ unread(f)` sur les fichiers présents des projets accessibles.
- **INV-05 Calcul des non-lus** — `unread(f)` = nombre d'entrées indexées de `f` avec `start_offset ≥ read_offset` ; `unread(f) ≥ 0` ; `unread(f) = 0` si `f` est manquant, masqué (trop ancien) ou est un log d'accès ; `total = Σ unread(f)` sur les fichiers présents des projets accessibles.
- **INV-06 Le curseur n'avance que par l'utilisateur** — Un scan ne fait jamais avancer `read_offset` ; seuls `mark_read`, `mark_all_read` et l'ajout initial d'un projet (5.1) le font avancer. Seule une rotation (5.4) le fait reculer (à 0).
- **INV-07 Monotonie hors rotation** — En l'absence de rotation, `scan_offset` et `read_offset` sont croissants dans le temps.
- **INV-08 Confinement** — Tout fichier du projet suivi a un chemin canonique sous l'un de ses dossiers de logs ; tout log Apache suivi est déclaré par le vhost du projet.
- **INV-09 Unicité** — Un chemin canonique correspond à au plus un projet ; un couple (projet, chemin relatif) à au plus un fichier.
- **INV-10 Cascade** — Après suppression d'un projet, aucune ligne de `log_files`, `log_entries_index` ou `read_cursors` ne le référence.
- **INV-11 Bornes de l'intervalle** — `refresh_interval_seconds` stocké est toujours un entier dans `[1, 3600]`.
- **INV-11 Intervalle valide** — `refresh_seconds` d'un projet est toujours l'un de 0, 5, 15, 30, 60, 300, 900, 1800, 3600.
- **INV-12 Persistance** — Sans changement des fichiers sur le disque, un redémarrage ne change aucun compteur de non-lus.
- **INV-13 Idempotence du scan** — Deux scans successifs sans modification des fichiers produisent le même état en base.
- **INV-14 Atomicité** — Le scan d'un fichier (mise à jour de l'index + `scan_offset`) est fait dans une seule transaction : un crash au milieu laisse l'état précédent.