Decisões
ORG-0025 — Acervo de capturas de tela
- Status: aceita
- Data: 2026-10-18
- Decide: se a stack mantiver acervo, ele sai dos casos E2E e só recebe as telas afetadas por cada change
Contexto
Capturas de tela servem para acompanhar o desenvolvimento, como evidência de pedido ao design system e, para algumas stacks, como acervo para design e manuais. Regerar todas as capturas a cada rodada infla o repositório e esconde o que mudou.
Decisão
- As capturas saem dos casos E2E, em modo
capturar: quatro variantes (desktop e celular, claro e escuro), sem aviso de ambiente. - Uma stack que mantém acervo guarda os PNGs em Git LFS, em
docs/screenshots/<tela>/, e cada change só acrescenta as telas que afeta. - Sem acervo, o mecanismo de captura continua disponível para acompanhar o desenvolvimento, sem versionar nada.
- Manter ou não o acervo é escolha da stack, numa ADR (a ADR-0011 pré-escrita). "Não mantemos" é uma resposta válida.
Alternativas consideradas
| Alternativa | Por que não |
|---|---|
| Acervo obrigatório | Por que não: custo de armazenamento para stacks que não precisam |
| Regerar o acervo inteiro a cada rodada | Por que não: centenas de MB por rodada; o diff não mostra o que mudou |
Consequências
- O diff de uma change mostra só as telas que ela mudou.
- Git LFS vira pré-requisito só para quem mantém acervo.
Mais
O detalhe está na documentação da arquitetura.