Agent Tracker — service Docker

Statut : prototype personnel en service, code public disponible. Le Tracker conserve le journal et l’état des rappels ; Telegram fournit l’interface. L’essai d’appels Twilio est conservé comme historique, désactivé. Voir le dépôt et ses tests.

Son rôle

Le service reçoit un message court, extrait uniquement les informations explicitement présentes, calcule un repère temporel et ajoute une ligne structurée au journal personnel. Une seconde route expose un état minimal afin qu’un workflow puisse décider s’il faut rester silencieux ou proposer une relance.

flowchart LR
    TG[Workflow Telegram] -->|écriture| A[Agent Tracker]
    A --> J[Journal personnel]
    J --> A
    A -->|état minimal| RM[Workflow de relance]

Le déploiement réel, ses montages et ses adresses restent privés. Le dépôt public contient le code, les tests et des modèles n8n expurgés.

Les trois fiches du système

Couche	Responsabilité	Fiche
Docker / FastAPI	Enregistrer, lire le journal et produire un état.	Cette page
n8n / Telegram	Recevoir un message et retourner la réponse du Tracker.	Entrée Telegram
n8n / relance	Vérifier périodiquement l’état et choisir un canal de rappel.	Relances programmées

Contrats publics à stabiliser

Écriture

{
  "chat_id": "identifiant_exemple",
  "message": "texte saisi par l'utilisateur"
}

Réponse attendue :

{
  "reply": "confirmation ou question courte"
}

État pour les relances

Le nouvel endpoint POST /rappels/claim/{chat_id} réserve au plus un rappel par jour dans SQLite. Il répond avec reminder_allowed, status, reason, next_check_after et un texte générique. Sans activation par /rappel_on, il ne déclenche rien. L’ancienne route d’état destinée à Twilio renvoie toujours besoin_relance: false.

Garde-fous vérifiés

L’état est persistant, lié au chat autorisé et limité à un rappel quotidien entre 08 h et 21 h (Europe/Paris). /rappel_off, /rappel_pause et /rappel_fait permettent d’arrêter, reporter ou acquitter. L’autorisation expire après sept jours. Les tests couvrent le changement de jour, RESET, la limite quotidienne et l’échec d’écriture du journal.

Code et limites

Le dépôt Agent Tracker fournit FastAPI, les tests, un README de déploiement et les deux modèles de workflows Telegram nettoyés. Les credentials, identifiants de chat, journaux et données personnelles en sont exclus. L’envoi Telegram réel doit encore être vérifié de bout en bout sur un chat de test ; la réservation du rappel précède l’envoi, donc une panne d’envoi ne déclenche pas de nouvelle tentative automatique le même jour.

Agent Tracker est un outil personnel d’organisation et de journalisation. Il ne remplace ni un suivi médical, ni un dispositif d’urgence.

ORIORIS