Audit UX vidéo + timeline
L'idée : quelques secondes à quelques minutes d'utilisation réelle contiennent déjà la plupart de ce qui ne va pas. Les problèmes passent inaperçus parce que personne ne voit tout à la fois : ce que la personne a tenté, ce que l'écran a montré, ce que le code a enregistré et ce que le réseau a fait. Cette méthode enregistre tout cela sur une seule horloge, de sorte que chaque image peut être expliquée par ses événements et chaque événement peut être vu dans son cadre. Une IA lit alors l'ensemble en un seul passage.
Résultats
| Fichier | Description |
|---|---|
audit.mp4 | La session, avec des légendes incrustées : noir pour l'intention, rouge pour chaque problème |
events.json | Chaque action, légende, message console, exception, requête (statut, ms, octets, échecs), tâche longue et décalage de mise en page, horodaté sur l'horloge vidéo |
timeline.md | La timeline fusionnée, plus les signaux automatiquement détectés, chacun lié à l'image où il s'est produit |
ai-pack/ | Images clés nommées par le temps vidéo, timeline.md et PROMPT.md, prêts pour tout LLM multimodal à examiner en une seule fois |
findings.md | La liste finale classée : problèmes, lacunes et opportunités, chacun avec preuves, correctif UX et correctif performance |
0. Sécurité
- Utilisez des comptes et des données de test, et n'effectuez des écritures que dans un bac à sable. Les données utilisateur réelles sont en lecture seule.
- Ne publiez jamais de noms, e-mails, numéros de téléphone, identifiants ou jetons. Nettoyez
events.json(URL, texte de la console) avant de partager. - Utilisez un profil de navigateur jetable et fermez-le à la fin.
1. Cadrer la session (2 minutes)
- Nommez une à trois tâches qu'un utilisateur réel vient accomplir, dans ses mots. Par exemple : « trouver la commande », « répondre au client », « changer mon abonnement ».
- Choisissez la durée en fonction de l'interface : 10–60 s pour un écran, 2–5 min pour un flux complet. Des sessions courtes et ciblées sont meilleures que des sessions longues.
2. Agir comme une personne réelle et non technique
- Dites ce que vous voulez faire avant chaque action (une légende
say). - N'utilisez que ce qui est visible. Pas d'URL tapée, pas d'outils de développement, pas de raccourcis cachés.
- Essayez d'abord le chemin évident. S'il échoue, c'est un constat, même si un autre chemin fonctionne.
- Après chaque action, vérifiez que tout concorde : liste, compteurs, en-tête, autres panneaux et la vue de l'autre partie.
- Stressez l'état. Rechargez, revenez en arrière, ouvrez dans un nouvel onglet, utilisez un réseau lent et utilisez la largeur d'un téléphone (390×844).
- Notez les attentes. Si vous attendez, l'utilisateur attend.
Il y a deux façons de piloter :
- Scénarisé. Un
scenario.jsond'étapes. Il est reproductible et le même fichier devient la preuve de régression après le correctif. - Libre.
{"url": "...", "freeSeconds": 90}. Une personne ou un agent pilote le navigateur manuellement pendant que tout est enregistré. À utiliser pour l'exploration.
3. Enregistrer (web : Chrome DevTools Protocol, zéro dépendance)
chrome --remote-debugging-port=9222 --user-data-dir=/tmp/vua # profil jetable
node scripts/record.mjs scenario.json --port 9222 --out ./audit-out
bash scripts/encode.sh ./audit-out # → audit.mp4
node scripts/timeline.mjs ./audit-out # → timeline.md, signals.json, ai-pack/
node scripts/report.mjs ./audit-out --title "X" # → findings.md (constats légendés)
Étapes du scénario : goto, say, click (sélecteur CSS, avec un pointeur visible), type (vitesse humaine), press, scroll, wait et problem (une légende rouge, une capture d'écran et un constat).
Les autres environnements utilisent la même méthode avec une capture différente. Quelle que soit la plateforme, enregistrez l'écran ainsi que les flux de logs et réseau de la plateforme, mettez-les tous sur une seule horloge et passez-les à timeline.mjs sous forme de events.json :
| Plateforme | Écran | Logs et réseau |
|---|---|---|
| iOS | xcrun simctl io booted recordVideo | log stream ; un proxy (mitmproxy) pour le réseau |
| Android | adb shell screenrecord | adb logcat ; un proxy pour le réseau |
| Bureau / Electron | Capture d'écran du système | le port CDP, comme pour le web |
| Terminal / CLI | asciinema | stderr, avec horodatages |
4. Signaux automatiques (trouvés pour vous, vérifiez chacun par rapport à son image)
| Signal | Signification typique |
|---|---|
| js-exception, console-error | Fonctionnalité cassée, souvent silencieuse pour l'utilisateur |
| request-failed, http-5xx, http-4xx | Données manquantes, mauvais état, mauvaises permissions |
| slow-request (≥ 1 s ; P1 à ≥ 3 s) | Une attente que l'utilisateur ressent ; candidat au cache, préchargement ou index |
| heavy-payload (≥ 500 Ko) | Lent sur mobile ; paginer, compresser ou réduire les champs |
| duplicate-request (même appel dans les 2 s) | Travail gaspillé ; dédoublonner ou mettre en cache |
| never-finished | Requête pendante, délai d'attente manquant, spinner infini |
| long-task (≥ 200 ms ; P1 à ≥ 500 ms) | Interface gelée ; diviser le travail, virtualiser, déplacer vers un worker |
| layout-shift (≥ 0.05, sans saisie) | Contenu qui saute ; réserver de l'espace |
Les seuils peuvent être modifiés avec --slow et --big.
5. Examen IA en un seul passage
Donnez à l'IA ai-pack/ (les images clés, timeline.md et PROMPT.md). Elle renvoie, en un seul passage :
- Problèmes, chacun avec sévérité et preuve : une image et les lignes de timeline qui l'expliquent.
- Lacunes : chemins morts, retours manquants, états flous, affordances manquantes et deux écrans en désaccord.
- Opportunités : requêtes à supprimer, mettre en cache ou précharger ; étapes à fusionner ; valeurs par défaut à définir ; ce qu'un concurrent de premier plan fait mieux.
- Un classement de tout par impact utilisateur ÷ effort.
Règle : pas de preuve, pas de ligne. Chaque affirmation cite une image ou un événement.
6. Sévérité
- P0 : perte de données, mauvais destinataire, fuite de vie privée ou de sécurité, ou la tâche principale est impossible.
- P1 : la tâche principale est cassée ou trompeuse, une action prend plus d'1 s ou une vue plus de 3 s, une exception JS se trouve sur le chemin principal, ou deux surfaces sont en désaccord.
- P2 : friction, formulation confuse, problème esthétique ou requêtes gaspillées.
7. Boucler la boucle
- Corrigez d'abord les P0, puis les P1, avec un petit changement par constat.
- Réexécutez le même scénario après chaque correctif. Sa nouvelle timeline est la preuve : le signal a disparu et le timing s'est amélioré. Joignez l'avant et l'après.
- Conservez les scénarios comme une bibliothèque. Les réexécuter après chaque version permet de détecter les régressions en quelques secondes.