docs(evidencia): a prova em tela do #659 ganha documento, e o script sai da raiz

A branch de QA do #659 trouxe a spec, doze arquivos de evidência e um script de
medição — e deixou o script na RAIZ do repositório.

**O script sai da raiz.** `medir-fachada.mjs` existe porque no dia o daemon do
Docker estava travado: ele mede a fachada contra um `next start` já buildado,
sem banco. É proveniência das medições, não ferramenta do projeto — num
repositório aberto, na raiz, vira arquivo que ninguém sabe para que serve. Foi
para junto da evidência que produziu.

**As imagens ganham o documento que as justifica.** `tests/unit/evidencia-citada.test.ts`
reprova imagem versionada sem citação, e com razão: imagem sem texto não prova
nada, e num projeto aberto todo clone paga o peso dela.

O README diz o que cada captura prova — inclusive a comparação que responde à
condição literal do dono ("desde que não quebre o visual que já existe"): para
quem não enviou logo, posição e tamanho idênticos até a fração de pixel, nos
dois temas. E diz o que elas NÃO provam, a começar pela barra lateral, que é a
superfície principal do #659 e não foi medida em tela.

Um tropeço meu no caminho, pego pela cerca: abreviei nomes (`… / -light.png`),
e ela leu `-light.png` como um arquivo inexistente e deixou três imagens sem
citação. Cada arquivo agora vai pelo nome exato — conferido um a um: 13 de 13.

  evidencia-citada.test.ts -> 46 passed (46)

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017jpi8VAeDpDhcfA3L63et2
This commit is contained in:
Pessoa
2026-09-15 00:23:28 -03:00
co-authored by Claude Opus 5
parent 16838b45bb
commit 5339f75e66
2 changed files with 56 additions and 0 deletions
@@ -0,0 +1,56 @@
# A moldura do logo no tema escuro — prova em tela do PR #659
As imagens e medições desta pasta são o lastro da afirmação feita no PR **#832** (lote 3 da
triagem de 14/set): a moldura clara atrás do logo enviado **resolve o logo que some no tema escuro,
e não mexe em nada de quem não enviou logo** — a condição literal com que o dono do produto aprovou
a mudança (*"desde que não quebre o visual que já existe e está consolidado há meses"*).
Medido por ferramenta (`getComputedStyle`, `getBoundingClientRect`), num build de produção, com o
mesmo script (`medir-fachada.mjs`) aplicado a **dois** builds: o estado **anterior** ao #659 e o
atual. Nada aqui foi medido a olho.
## O que cada arquivo prova
### Com logo enviado — a moldura existe só no tema escuro
- `fachada-com-logo-dark.png` + `fachada-com-logo.json` — no escuro, o contêiner do logo tem
fundo `rgb(255, 255, 255)`, padding `[8, 12, 8, 12]` e sombra: a moldura está pintada e contém o
logo.
- `fachada-com-logo-light.png` — no claro, o mesmo contêiner tem fundo transparente e padding zero:
a moldura é só do tema escuro.
- `ANTES-fachada-com-logo-dark.png`, `ANTES-fachada-com-logo-light.png` e `ANTES-fachada-com-logo.json` — o estado anterior ao #659. No escuro,
o logo azul-marinho fica **quase invisível** sobre o fundo quase-preto: é o defeito que o PR
resolve.
### Sem logo enviado — nada se move, nos dois temas
- `fachada-sem-logo-dark.png`, `fachada-sem-logo-light.png` e `fachada-sem-logo.json` — a marca própria do produto
aparece **sem** moldura: nenhum ancestral da cadeia tem fundo claro.
- `ANTES-fachada-sem-logo-dark.png`, `ANTES-fachada-sem-logo-light.png` e `ANTES-fachada-sem-logo.json` — o mesmo, antes do #659.
A comparação entre `fachada-sem-logo.json` e `ANTES-fachada-sem-logo.json` é a prova da condição do
dono: a posição e o tamanho da marca e do cartão de acesso são **idênticos até a fração de pixel**,
nos dois temas.
**O preço, medido e não escondido:** para quem **tem** logo enviado, o cartão de acesso desce 8 px
no tema escuro — o padding vertical da moldura num bloco centrado. É a troca que o autor declarou no
próprio PR.
## O que estas imagens NÃO provam
- **A barra lateral** — que é a superfície principal do #659 — **não foi medida em tela**. Esta pasta
cobre só a tela de entrada (a fachada). A medição foi feita com o daemon do Docker indisponível,
e a fachada é a única superfície que resolve a marca sem banco; a barra lateral exige sessão.
- A prévia da tela de marca, a camada da **organização** (tudo foi pela camada da instalação), a
barra recolhida, e navegadores além do Chromium.
- Contraste real de pixel: está provado que a moldura foi pintada e contém o logo, não que um logo
específico ficou legível.
## Como refazer
A prova que fica, e que roda no CI, é a spec `tests/e2e/logo-moldura-no-tema-escuro.spec.ts`,
registrada em `SPECS_PARTE_3` do `.github/workflows/e2e.yml`. Ela cobre as três superfícies.
`medir-fachada.mjs` é o script que produziu os JSON desta pasta contra um `next start` já buildado,
**sem banco** — ele existe porque o Docker estava travado no dia. Não é gate e não substitui a spec;
fica aqui como proveniência das medições acima.