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>
75 lines
4.0 KiB
Markdown
75 lines
4.0 KiB
Markdown
# 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
|
|
|
|
1. WHEN l'agent tente un upload, THE System SHALL log les détails de la requête d'authentification
|
|
2. WHEN le serveur rejette l'authentification, THE System SHALL log la raison exacte du rejet
|
|
3. THE Diagnostic_Tool SHALL vérifier la configuration d'authentification côté agent
|
|
4. THE Diagnostic_Tool SHALL vérifier la configuration d'authentification côté serveur
|
|
5. 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
|
|
|
|
1. THE Agent_v0 SHALL utiliser un token d'authentification valide pour les uploads
|
|
2. WHEN aucun token n'est configuré, THE Agent_v0 SHALL utiliser un token par défaut ou demander configuration
|
|
3. THE Configuration_System SHALL permettre de définir l'URL du serveur API
|
|
4. THE Configuration_System SHALL permettre de définir le token d'authentification
|
|
5. 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
|
|
|
|
1. WHEN un upload échoue avec HTTP 401, THE Agent_v0 SHALL conserver la session localement
|
|
2. WHEN l'authentification est corrigée, THE Agent_v0 SHALL reprendre l'upload des sessions en queue
|
|
3. THE Agent_v0 SHALL limiter le nombre de tentatives d'upload par session
|
|
4. WHEN toutes les tentatives échouent, THE Agent_v0 SHALL notifier l'utilisateur du problème
|
|
5. 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
|
|
|
|
1. THE System SHALL fournir un outil de test d'authentification
|
|
2. WHEN le test d'authentification est lancé, THE System SHALL vérifier la validité du token
|
|
3. THE System SHALL tester un upload factice pour valider l'authentification complète
|
|
4. WHEN l'authentification est valide, THE System SHALL confirmer le succès
|
|
5. 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
|
|
|
|
1. THE System SHALL maintenir un log des tentatives d'upload avec leur statut
|
|
2. THE System SHALL compter les succès et échecs d'upload
|
|
3. WHEN le taux d'échec dépasse un seuil, THE System SHALL alerter l'administrateur
|
|
4. THE System SHALL fournir un dashboard du statut des uploads
|
|
5. THE System SHALL permettre de relancer les uploads échoués en batch |