ADR 0079 – Bilan sobre dans la revue hebdomadaire

Statut : Accepté (2026-10-16, mode autonome)

Idée de la vague 3 du document d’idées : en fin de revue, voir en une ligne ce que la semaine a produit, sans tableau de bord supplémentaire.

Décision

• GET /api/journee/bilan?date=&zone= : les sept jours qui finissent le jour donné (aujourd’hui par défaut, fuseau du navigateur). Il réutilise la lecture du journal de JourneeService (ADR 0067) sur la période entière : totaux de nœuds créés, terminés et modifiés, nombre de nœuds terminés par jour, et la liste des terminés, les plus récents d’abord (200 au plus).
• Mêmes règles que la journée pour « terminé » (état final du workflow de config/, entré dans la période et encore là à la fin), avec une différence : sur une semaine, un nœud créé puis terminé compte parmi les terminés (sur une journée, « créé » prime). Il reste compté parmi les créés (les trois totaux ne s’additionnent donc pas) ; la page Journée, elle, le range parmi les créés seulement. « Créés » inclut ce que le système crée (occurrence suivante d’une récurrence, connecteurs).
• Clé de revue recap: true (facultative) : le résumé final de la revue affiche alors « Bilan des sept derniers jours » (totaux, terminés par jour, dix premiers terminés avec lien vers la page Journée). La revue hebdomadaire l’active ; une revue sans la clé n’appelle rien.
• Aucune écriture, aucun nouvel événement.

Alternatives écartées

• Widget de tableau de bord : le besoin est le moment de la revue, pas un suivi permanent.
• Graphique : une ligne de nombres par jour suffit à un bilan « sobre ».
• Période réglable : sept jours collent à la revue hebdomadaire ; la page Journée couvre le reste.

Limites connues

• Au-delà de 20 000 événements par jour de la période (le plafond de la Journée, multiplié par sept), les totaux sont incomplets (annoncé à l’écran).
• Le bilan se lit sur le journal : un nœud supprimé définitivement n’y figure plus.