QA_CHECKLIST.md

Focus Timer QA Checklist

Janela e Resize

• Abrir app e confirmar tamanho inicial dentro de 160x140 e 450x450.
• Tentar reduzir abaixo de 160x140 e confirmar que não passa do limite.
• Tentar ampliar acima de 450x450 e confirmar que não passa do limite.
• Fechar e abrir o app e confirmar que posição e tamanho anteriores foram restaurados.

Layout Responsivo

• Em altura < 160, validar layout micro (controles ocultos conforme esperado).
• Em altura < 300 ou largura < 240, validar layout small.
• Em tamanhos maiores, validar layout completo com botões e sessões.

Comportamento

• Alternar "Always on Top" e confirmar mudança imediata de nível da janela.
• Usar atalho Option + Command + P para iniciar/pausar.
• Confirmar que badge do Dock atualiza 1x por segundo (sem jitter visual).
• Mudar relógio do sistema ou suspender/retomar Mac e validar continuidade correta do timer.

Track Record

• Definir um nome opcional, iniciar timer e finalizar; validar entrada com início/fim e nome no histórico.
• Executar sessão sem nome; validar registro como "Sem nome".
• Clicar no botão de lista (canto superior ao passar mouse) e validar abertura da tela de histórico.
• Validar filtros All, Today, 7d e 30d.
• Buscar por nome/status/tipo e validar filtragem em tempo real.
• Exportar CSV e abrir arquivo para validar colunas e conteúdo.
• Exportar JSON e validar formato com datas ISO8601.
• Fechar/reabrir app e validar que histórico persiste.
• Forçar encerramento com sessão ativa e reabrir app; validar registro Interrupted.
• Usar botão "Clear" e validar remoção de registros.

Confiabilidade

• Menu bar: executar Run Self-Checks e validar retorno sem falhas.
• Verificar criação de arquivos em ~/Library/Application Support/focus-timer/ (session_history_v2.json e active_session_v1.json).
• Verificar log em ~/Library/Caches/focus-timer-telemetry.log após eventos de clock/wake.