ADR-013 — Design Direction v1.0 “Noite de Holofote”

• Status: Accepted
• Data: 2026-07-22
• Decisores: Product & Engineering
• Substitui: parte visual de ADR-005; a decisão de marca e seus assets permanecem válidos

Contexto

A identidade anterior era utilizável, porém os tokens e implementações existentes eram light-first, não incluíam Bebas Neue como fonte oficial de impacto e não definiam um catálogo único de componentes, telas e cards. Os novos artefatos de design consolidam uma direção dark-first para mobile, web e distribuição social.

Decisão

Adotar Design Direction v1.0 Noite de Holofote:

1. tema escuro é o padrão; Editorial Terrão é alternativa equivalente, selecionável e persistida pelo usuário;
2. componentes consomem os tokens semânticos background, surface, surface-alt, text, text-muted, border, primary, accent, success e danger, com os valores por tema de SPEC-UX-TOKENS-001;
3. primary é #EA580C nos dois temas; #FB923C permanece no asset/wordmark oficial;
4. Bebas Neue é exclusiva de placares, números de stats e títulos de impacto; Inter cobre toda a interface restante;
5. páginas públicas e cards de time/torcida podem herdar a cor da entidade no hero, com contraste seguro; o escudo e a entidade têm precedência visual sobre a plataforma;
6. status de validação/provisoriedade permanece junto do placar ou ranking que qualifica;
7. cards são orientados a eventos públicos canônicos, exportáveis em PNG, nos formatos visuais story 1080×1920 e feed 1080×1080; toda rota pública fornece og:image 1200×630;
8. assinatura RaizFC e URL pública são obrigatórias em todo card/OG do MVP;
9. loading, empty e erro seguem o capítulo 13 do Book: skeleton isomórfico, vazio explicativo com ação, falha parcial com retry e erro documental;
10. protótipos definem direção visual, não alteram regras de domínio, contratos, privacidade ou permissões por conta própria.

Referências canônicas

• design/RaizFC Book.dc.html — fundamentos, 13 capítulos e catálogo de componentes;
• design/RaizFC Prototipo.dc.html — protótipo mobile de 16 telas;
• design/RaizFC Web.dc.html — protótipo web de 7 telas;
• design/RaizFC Cards.dc.html — catálogo de 10 cards e regras de geração;
• assets/new_brand/ — brand kit oficial;
• SPEC-UX-VISUAL-001, SPEC-UX-TOKENS-001, SPEC-UX-COMPONENTS-001, SPEC-UX-SHARE-VISUAL-001 e SPEC-UX-STATES-001 — tradução normativa para implementação.

Quando os HTMLs divergirem de domínio, contrato, privacidade ou autoridade, o domínio ganha e a apresentação se adapta. Divergência funcional exige evolução SDD própria antes de código.

Relação com decisões anteriores

• ADR-005 continua como registro da origem da marca; SPEC-BRAND-001 v2.1 e assets/new_brand/ encerram sua fase provisória. Sua direção visual light-first/paleta anterior deixa de orientar a UI.
• ADR-009 continua válido ao tratar cards como growth loop; este ADR define a expressão visual v2.
• ADR-010 continua exigindo Execution Pack por implementação.

Consequências

• tokens v0.1 e componentes que dependem deles precisam de migração coordenada, sem manter duas APIs visuais permanentes;
• web, mobile e renderers de cards precisam carregar Inter/Bebas Neue e compartilhar tokens semânticos;
• telas MVP já entregues passam por migração visual e paridade com protótipos, preservando domínio e comportamento;
• IS/EP-MVP-12.3 permanece concluído; cards v2 entram em novo IS/EP dependente para preservar histórico;
• contraste, tema persistido, focus, reduced motion, long content e screenshots dark/light passam a fazer parte da validação;
• rotas públicas exigem pipeline de og:image e estratégia de cache/invalidação;
• placar em andamento e OG por rota exigem evolução de domínio/contratos antes da implementação do MVP caso não caibam na modelagem existente;
• aniversários de jogador/time/torcida e marcos de campanha ficam em IS-POST-12.1: são sugestões privadas, nunca publicação automática, e exigem aprovação explícita no preview. O registro inicial de marcos contém 5 vitórias validadas na campanha, 100º jogo validado e entrada no top 3 de qualquer ranking canônico, com regras configuráveis/versionadas.
• a integração de fontes ocorre nos dois apps visuais existentes, web e mobile; o serviço API não carrega fontes e renderers reutilizam assets/tokens sem constituir um terceiro app.
• IS-BETA-01.6 fica deprecado porque o brand kit oficial já entrega os assets originalmente previstos para a etapa v0.2.

Divergências conhecidas

• SPEC-DOMAIN-MATCH-001 define auto-validação após 72h em partidas elegíveis. A decisão foi confirmada em 2026-07-22: 72h permanece canônico e a UI usa esse valor.
• O mesmo domínio declara tempo real confiável fora do MVP. O card de placar em andamento só pode existir com snapshot público canônico e updatedAt, sem simular lance a lance.
• SPEC-DOMAIN-SHARE-001 inclui vertical 1080×1350. A decisão foi confirmada em 2026-07-22: ele continua como quarto output compatível; feed mapeia square, e og:image é tratado como pipeline de rota.