From b1a20c40be3e0e1dc20a2fbb14a92761e41d28ac Mon Sep 17 00:00:00 2001 From: maxime Date: Mon, 9 Nov 2026 12:46:33 +0100 Subject: [PATCH] =?UTF-8?q?D-145=20:=20le=20support=20automatique=20dans?= =?UTF-8?q?=20LibreDesk,=20une=20note=20priv=C3=A9e=20par=20Gitea=20Action?= =?UTF-8?q?s=20(d=C3=A9p=C3=B4t=20Support-AI)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- CLAUDE.md | 2 +- docs/decisions.md | 8 ++++++++ 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index ee1bd94..aea8cf7 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -14,7 +14,7 @@ Cadrage du product owner : sous-projet G, santé des sites et notifications au c - **Maquettes du site** (D-022, D-039) : client « System Summary », une page par station, un bloc par domaine ; support « Home », une notification par station et par domaine Orange ou Red, liée à la vue client (D-025). - **Déplacements, le cap actuel : le journal du matin** (D-056). Une anomalie de déplacement est ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, train, toile d'araignée, turbulence…), parfois un vrai mouvement (E-004, incident de Barcelone). Détecteurs élémentaires classés par catégorie (D-074), onglet `Journal` de la maquette Explore, amélioration par `/events-learner` (D-057), base d'events `events/` revue par `/review-event` (D-075). Les détecteurs s'alignent sur toutes les étiquettes de `labeling/auto/`, sans events (D-118) : l'`etiqueteur` étiquette en amont, puis `/detector-learner ` (D-116, D-132) : une famille sur toutes les stations, le `detectors-critic` juge les détecteurs face aux étiquettes, le `detectors-upgrader` les adapte, le `detectors-control` garde toutes les stations et familles ; l'analyste, le `tool-builder` et l'`event-builder` (D-088 à D-092, D-097) sont hors de la séance ; la carte des événements apprend de chaque event validé (D-087). Tout le suivi est dans le plan vivant `docs/superpowers/plans/2026-10-23-journal-du-matin.md`. - **Support** (D-079, D-113) : `/support ` répond à la question d'un client, et à elle seule (premier cas : LENZSPITZE, nuit du 26 au 27.10) ; `/support ` fait le rapport de situation de la station à partir de ses étiquettes (`labeling/auto/`), appuyé d'images ; `/presentation ` le met en diapositives PDF à la charte AIMsight, par la fabrique Typst `~/docfactory-presentation` (D-114). Rapports par mois. -- **Support par l'API Claude** (D-133), le passage à l'opérationnel : sous-projet autonome `API/`, séparé de `.claude/`, deux clients API (support, analyste), un PDF qui répond au mail du client ; workflow validé par l'utilisateur le 2026-11-05 sur un premier cas réel (Crissier, LENZSPITZE, `API/cases/`) ; la copie des détecteurs à rafraîchir après leur optimisation. La web app `app/` (React, Mantine, FastAPI, D-137, D-138) les pilote, et centralise le diagnostic manuel : pages Support et Data (les images y sont, D-143). En essai (D-142) : l'assistant LibreDesk seul, avec les outils texte de l'analyste, face au duo, sur Crissier ; procédure et état dans `docs/libredesk/essai-assistant.md`. Préalable : les détecteurs lisent la caméra et les métriques (point 78 du plan vivant). +- **Support par l'API Claude** (D-133), le passage à l'opérationnel : sous-projet autonome `API/`, séparé de `.claude/`, deux clients API (support, analyste), un PDF qui répond au mail du client ; workflow validé par l'utilisateur le 2026-11-05 sur un premier cas réel (Crissier, LENZSPITZE, `API/cases/`) ; la copie des détecteurs à rafraîchir après leur optimisation. La web app `app/` (React, Mantine, FastAPI, D-137, D-138) les pilote, et centralise le diagnostic manuel : pages Support et Data (les images y sont, D-143). Dans LibreDesk (D-145) : le dépôt à part `~/Support-AI` dépose la proposition des agents en note privée, par Gitea Actions ; l'humain la copie et l'envoie ; l'essai de l'assistant LibreDesk (D-142) est mis de côté. Préalable : les détecteurs lisent la caméra et les métriques (point 78 du plan vivant). - **Agent de diagnostic** (D-046, D-058, D-082) : gardé dans le doute, pour un cas que les détecteurs n'expliquent pas. - **En attente** : agents LLM côté serveur (D-027) et enquête par API (D-042), documents seulement ; communication avec la caméra (dev container, D-038), en attente de la doc de l'API REST ; détection des sauts et tendances (D-055, onglet `Displacements`), très expérimentale. - **Prochaine étape** : diff --git a/docs/decisions.md b/docs/decisions.md index 9e70141..98f9723 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -1326,3 +1326,11 @@ Règles du journal : - **Options écartées** : changer les phrases dans `detectors/categories.py` (travaillées par `/detector-learner`) : la web app les découpe ; une largeur minimale des barres très courtes (le contour peut les cacher), laissée pour l'instant par l'utilisateur. - **Conséquence** : les étiquettes de l'utilisateur et celles de l'étiqueteur se mêlent dans `labeling/auto/`, sans marque de leur auteur ; si une séance change la phrase du journal, le découpage message / action est à revoir. + +## D-145 — 2026-11-09 — Le support automatique dans LibreDesk : une note privée, par Gitea Actions, dans le dépôt Support-AI + +- **Statut** : adoptée (phase 1 faite). Complète D-133 ; met de côté D-142. +- **Décision** : les mails des clients reçus dans LibreDesk passent par les agents support et analyste, et leur proposition revient **en note privée** dans la conversation ; un humain la relit, la copie dans sa réponse et l'envoie lui-même. Le tout vit dans un dépôt Gitea à part, `Support-AI` (`~/Support-AI`), sans service à héberger : `python -m support_diagnostic.run`, lancé par un workflow Gitea Actions ; les agents y sont copiés de `API/` (`agents/PROVENANCE.md`). L'état est porté par des étiquettes LibreDesk : `tri:diagnostic` (posée à la main par Maxime pour l'instant), puis `diag:en-cours`, `diag:fait`, `diag:ignore`, `diag:erreur` ; `diag:relancer` pour refaire un diagnostic. Le compte LibreDesk « Agent IA » n'a que cinq permissions, sans `messages:write` : LibreDesk refuse toute réponse au client. Lancement à la main pour l'instant, en simulation par défaut. +- **Pourquoi** : rester aligné sur l'infrastructure de l'entreprise (Gitea et LibreDesk), ne dépendre ni du poste ni d'un service maison ; ce sont de vrais mails de clients : aucun envoi automatique (spec de Maxime et Claude, `Support-AI/docs/spec.md`, 2026-11-09). +- **Options écartées** : l'assistant IA de LibreDesk (il répond lui-même au client par mail et ne lit pas les notes privées, vérifié dans le code de LibreDesk v2.9) ; un bouton qui reprend la proposition dans la réponse (« Générer une réponse » et un outil à nous : il faut un service web toujours allumé, trop de complexité pour l'instant ; `Support-AI/docs/pistes.md`) ; le brouillon de réponse (rangé par utilisateur, invisible des humains) ; déployer la web app `app/`. +- **Conséquence** : vérifié de bout en bout le 2026-11-09 sur le mail de test de Maxime (note posée par « Agent IA », puis simulation par Gitea Actions). Le runner n'a pas les données des stations : les notes disent qu'elles manquent, à régler avant un diagnostic utile. Les copies de `API/` vieillissent comme celles de D-133 ; les vérifications de LibreDesk et Gitea sont dans `Support-AI/docs/verifications.md`.