Auditoria de UX com vídeo + linha do tempo
A ideia: alguns segundos a alguns minutos de uso real já contêm a maior parte do que está errado. Os problemas passam despercebidos porque ninguém vê tudo ao mesmo tempo: o que a pessoa tentou, o que a tela mostrou, o que o código registrou e o que a rede fez. Este método grava tudo no mesmo relógio, para que cada quadro possa ser explicado por seus eventos e cada evento possa ser visto em seu quadro. Uma IA então lê a imagem completa em uma única passada.
Saídas
| Arquivo | O que é |
|---|---|
audit.mp4 | A sessão, com legendas inseridas: preto para intenção, vermelho para cada problema |
events.json | Cada ação, legenda, mensagem de console, exceção, requisição (status, ms, bytes, falhas), tarefa longa e mudança de layout, com timestamp no relógio do vídeo |
timeline.md | A linha do tempo fusionada, mais sinais detectados automaticamente, cada um vinculado ao quadro onde ocorreu |
ai-pack/ | Keyframes nomeados pelo tempo do vídeo, timeline.md e PROMPT.md, prontos para qualquer LLM multimodal revisar de uma só vez |
findings.md | A lista final classificada: problemas, lacunas e oportunidades, cada um com evidência, uma correção de UX e uma correção de desempenho |
0. Segurança
- Use contas de teste e dados de teste, e faça escritas apenas em um sandbox. Dados reais de usuário são somente leitura.
- Nunca publique nomes, e-mails, números de telefone, IDs ou tokens. Limpe
events.json(URLs, texto do console) antes de compartilhar. - Use um perfil de navegador descartável e feche-o ao final.
1. Enquadre a sessão (2 minutos)
- Nomeie de um a três trabalhos que um usuário real vem fazer, nas palavras dele. Por exemplo: "encontrar o pedido", "responder ao cliente", "mudar meu plano".
- Escolha a duração para caber na interface: 10–60 s para uma tela, 2–5 min para um fluxo inteiro. Sessões mais curtas e focadas vencem as longas.
2. Aja como uma pessoa real, não técnica
- Diga o que pretende antes de cada movimento (uma legenda
say). - Use apenas o que está visível. Sem URLs digitadas, sem dev tools, sem atalhos ocultos.
- Tente o caminho óbvio primeiro. Quando falhar, isso é um achado, mesmo que outra rota funcione.
- Após cada ação, verifique se tudo concorda: lista, contadores, cabeçalho, outros painéis e a visão da outra parte.
- Estresse o estado. Recarregue, volte, abra em uma nova aba, use uma rede lenta e use largura de telefone (390×844).
- Anote as esperas. Se você espera, o usuário espera.
Existem duas maneiras de dirigir:
- Roteirizado. Um
scenario.jsonde passos. É repetível, e o mesmo arquivo se torna a prova de regressão após a correção. - Livre.
{"url": "...", "freeSeconds": 90}. Uma pessoa ou um agente dirige o navegador manualmente enquanto tudo é gravado. Use para exploração.
3. Grave (web: Chrome DevTools Protocol, zero dependências)
chrome --remote-debugging-port=9222 --user-data-dir=/tmp/vua # perfil descartável
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 (achados legendados)
Passos do cenário: goto, say, click (seletor CSS, com ponteiro visível), type (velocidade humana), press, scroll, wait, e problem (uma legenda vermelha, uma captura de tela e um achado).
Outros ambientes usam o mesmo método com uma captura diferente. Seja qual for a plataforma, grave a tela mais os fluxos de log e rede da plataforma, coloque todos no mesmo relógio e passe para timeline.mjs como events.json:
| Plataforma | Tela | Logs e rede |
|---|---|---|
| iOS | xcrun simctl io booted recordVideo | log stream; um proxy (mitmproxy) para rede |
| Android | adb shell screenrecord | adb logcat; um proxy para rede |
| Desktop / Electron | Captura de tela do SO | a porta CDP, como para a web |
| Terminal / CLI | asciinema | stderr, com timestamps |
4. Sinais automáticos (encontrados para você, verifique cada um contra seu quadro)
| Sinal | Significado típico |
|---|---|
| js-exception, console-error | Funcionalidade quebrada, geralmente silenciosa para o usuário |
| request-failed, http-5xx, http-4xx | Dados ausentes, estado errado, permissões ruins |
| slow-request (≥ 1 s; P1 em ≥ 3 s) | Uma espera que o usuário sente; candidato para cache, pré-busca ou um índice |
| heavy-payload (≥ 500 KB) | Lento no celular; paginar, comprimir ou podar campos |
| duplicate-request (mesma chamada dentro de 2 s) | Trabalho desperdiçado; deduplicar ou cachear |
| never-finished | Requisição pendurada, timeout ausente, spinner para sempre |
| long-task (≥ 200 ms; P1 em ≥ 500 ms) | Interface congelada; dividir o trabalho, virtualizar, mover para um worker |
| layout-shift (≥ 0.05, sem entrada) | Conteúdo pula; reservar espaço |
Os limites podem ser alterados com --slow e --big.
5. Revisão única por IA
Dê à IA ai-pack/ (os keyframes, timeline.md e PROMPT.md). Ela retorna, em uma única passada:
- Problemas, cada um com gravidade e evidência: um quadro e as linhas da linha do tempo que o explicam.
- Lacunas: becos sem saída, feedback ausente, estados pouco claros, affordances faltando e duas telas que discordam.
- Oportunidades: requisições para remover, cachear ou pré-buscar; passos para mesclar; padrões para definir; o que um concorrente principal faz melhor.
- Uma classificação de tudo por impacto ÷ esforço.
Regra: sem evidência, sem linha. Cada afirmação cita um quadro ou um evento.
6. Gravidade
- P0: perda de dados, destinatário errado, vazamento de privacidade ou segurança, ou a tarefa principal é impossível.
- P1: a tarefa principal está quebrada ou enganosa, uma ação leva mais de 1 s ou uma visualização mais de 3 s, uma exceção JS está no caminho principal, ou duas superfícies discordam.
- P2: atrito, texto confuso, um problema cosmético ou requisições desperdiçadas.
7. Feche o ciclo
- Corrija P0 primeiro, depois os P1s, com uma pequena mudança por achado.
- Reexecute o mesmo cenário após cada correção. Sua nova linha do tempo é a prova: o sinal se foi e o tempo está melhor. Anexe o antes e o depois.
- Mantenha os cenários como uma biblioteca. Reexecutá-los após cada lançamento pega regressões em segundos.