a7de6a488b
Validé sur PC Windows (DESKTOP-58D5CAC, 2560x1600) : - 8 clics résolus visuellement (1 anchor_template, 1 som_text_match, 6 som_vlm) - Score moyen 0.75, temps moyen 1.6s - Texte tapé correctement (bonjour, test word, date, email) - 0 retries, 2 actions non vérifiées (OK) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
4.0 KiB
Requirements Document
Introduction
L'agent v0 capture correctement les sessions utilisateur mais échoue systématiquement lors de l'upload vers le serveur API avec une erreur HTTP 401 "unauthorized". Cette spécification vise à résoudre le problème d'authentification entre l'agent de capture et le serveur API.
Glossary
- Agent_v0: Agent de capture cross-platform qui enregistre les sessions utilisateur
- API_Server: Serveur API qui reçoit et traite les sessions uploadées
- Upload_Queue: Queue locale des sessions en attente d'upload
- Authentication_Token: Token d'authentification pour autoriser les uploads
- Session_File: Fichier ZIP chiffré contenant une session capturée
Requirements
Requirement 1: Diagnostic d'authentification
User Story: En tant qu'administrateur système, je veux diagnostiquer le problème d'authentification, afin de comprendre pourquoi les uploads échouent.
Acceptance Criteria
- WHEN l'agent tente un upload, THE System SHALL log les détails de la requête d'authentification
- WHEN le serveur rejette l'authentification, THE System SHALL log la raison exacte du rejet
- THE Diagnostic_Tool SHALL vérifier la configuration d'authentification côté agent
- THE Diagnostic_Tool SHALL vérifier la configuration d'authentification côté serveur
- WHEN un diagnostic est lancé, THE System SHALL tester la connectivité réseau vers l'API
Requirement 2: Configuration d'authentification
User Story: En tant qu'administrateur système, je veux configurer l'authentification de l'agent, afin qu'il puisse s'authentifier auprès du serveur API.
Acceptance Criteria
- THE Agent_v0 SHALL utiliser un token d'authentification valide pour les uploads
- WHEN aucun token n'est configuré, THE Agent_v0 SHALL utiliser un token par défaut ou demander configuration
- THE Configuration_System SHALL permettre de définir l'URL du serveur API
- THE Configuration_System SHALL permettre de définir le token d'authentification
- WHEN la configuration change, THE Agent_v0 SHALL recharger les paramètres d'authentification
Requirement 3: Gestion des erreurs d'authentification
User Story: En tant qu'utilisateur de l'agent, je veux que les erreurs d'authentification soient gérées gracieusement, afin que les sessions ne soient pas perdues.
Acceptance Criteria
- WHEN un upload échoue avec HTTP 401, THE Agent_v0 SHALL conserver la session localement
- WHEN l'authentification est corrigée, THE Agent_v0 SHALL reprendre l'upload des sessions en queue
- THE Agent_v0 SHALL limiter le nombre de tentatives d'upload par session
- WHEN toutes les tentatives échouent, THE Agent_v0 SHALL notifier l'utilisateur du problème
- THE Agent_v0 SHALL permettre un retry manuel des uploads échoués
Requirement 4: Validation de l'authentification
User Story: En tant qu'administrateur système, je veux valider que l'authentification fonctionne, afin de m'assurer que les uploads réussiront.
Acceptance Criteria
- THE System SHALL fournir un outil de test d'authentification
- WHEN le test d'authentification est lancé, THE System SHALL vérifier la validité du token
- THE System SHALL tester un upload factice pour valider l'authentification complète
- WHEN l'authentification est valide, THE System SHALL confirmer le succès
- WHEN l'authentification échoue, THE System SHALL fournir des instructions de correction
Requirement 5: Monitoring des uploads
User Story: En tant qu'administrateur système, je veux monitorer le statut des uploads, afin de détecter rapidement les problèmes d'authentification.
Acceptance Criteria
- THE System SHALL maintenir un log des tentatives d'upload avec leur statut
- THE System SHALL compter les succès et échecs d'upload
- WHEN le taux d'échec dépasse un seuil, THE System SHALL alerter l'administrateur
- THE System SHALL fournir un dashboard du statut des uploads
- THE System SHALL permettre de relancer les uploads échoués en batch