O que dados-financeiros faz?
Como exibir dinheiro para que as pessoas o leiam corretamente na primeira vez. Estas regras se aplicam tanto a aplicativos de consumo quanto a ferramentas B2B densas. Elas vêm de padrões de tipografia e visualização de dados aplicados estritamente a finanças, além de práticas documentadas na Wise, Monzo, Stripe, Coinbase, Robinhood, Apple e IBM Carbon.
Combine este skill com critical-core (risco, emoção, linguagem visual) e money-flows (as ações que movimentam dinheiro).
Como usar este skill
- Nomeie a função de cada número. É um saldo, um valor a pagar, um delta, uma taxa, uma projeção, uma referência? A função decide o formato, a precisão, a cor e a posição.
- Carregue a referência necessária (abaixo) antes de escrever código ou especificar um componente. Use os valores exatos; não improvise formatos.
- Escreva os estados, não apenas o caminho feliz. Cada superfície de dinheiro tem estados de carregamento, desatualizado, pendente, falha, vazio e oculto.
- Execute a lista de verificação no final antes de entregar qualquer coisa.
| Referência | Carregue para |
|---|---|
references/numbers-and-identifiers.md | Formatação de moeda, unidades menores, arredondamento, notação compacta, números negativos, figuras tabulares, mascaramento de números de conta, unidades e doses |
references/color-and-gain-loss.md | Cor positiva/negativa por localidade, pares seguros para daltonismo, contraste para marcas, tokens semânticos |
references/charts.md | Seletor de gráfico, linhas de base, intervalos de tempo, projeções e incerteza, sparklines, interação com gráfico, acessibilidade de gráfico, limites de gamificação |
references/progress-and-status.md | Limiares de carregamento, mapas de estado de pagamento e transferência, status de cartão, disputa e KYC, metas de poupança e medidores de crédito |
references/records-and-dashboards.md | Linhas de transação, limpeza de comerciante, recibos, extratos, painéis B2B, grades de dados financeiros, logs de auditoria, reconciliação |
Os tokens de design originais para tudo isso estão em /tokens na raiz do repositório.
As regras que mais importam
Cada regra carrega um tipo de fonte: [REG] lei ou padrão, [RES] pesquisa publicada, [PRAC] prática documentada da empresa, [INF] síntese da CriticalUX.
- Formate com a plataforma, nunca manualmente. Use
Intl.NumberFormat(web),NumberFormatter/FormatStyle(Apple),NumberFormat/DecimalFormat(Android). Eles lidam com a posição do símbolo, separadores e as unidades menores de cada moeda (JPY não tem, KWD tem três). [PRAC] - Todo valor carrega sua moeda. Sem números nus em produtos multimoeda. Use o código ISO (USD) quando o símbolo for ambíguo ($ sozinho pode significar USD, CAD, AUD, MXN e outros). [INF]
- Figuras tabulares para qualquer número que mude ou fique em uma coluna (
font-variant-numeric: tabular-nums). Figuras proporcionais tremem conforme os valores mudam. [PRAC] - Notação compacta apenas em eixos e blocos de resumo. Nunca em um saldo, valor de pagamento, taxa ou qualquer coisa sobre a qual a pessoa agirá. [INF]
- As partes somam ao total, ou a tela informa que o arredondamento se aplica. [INF]
- Positivo e negativo são tokens semânticos resolvidos pela localidade ou configuração, não verde e vermelho codificados. Vermelho significa subiu nos mercados da China continental, Japão e Taiwan. Sempre acompanhe a cor com um sinal (+/−) e um glifo. [RES/PRAC]
- As marcas do gráfico atingem contraste de 3:1 com as cores adjacentes (WCAG 1.4.11), e nenhum significado depende apenas da cor (WCAG 1.4.1). [REG]
- Barras começam em zero. Linhas podem não começar. Barras truncadas exageram diferenças. [RES]
- Nunca mostre uma única linha para um futuro incerto. Projeções de poupança, aposentadoria, pagamento de empréstimos ou previsões usam um gráfico de leque ou banda. Um estudo de 2026 do Banco da Inglaterra (n≈1.600) descobriu que gráficos de leque transmitiam expectativa e incerteza melhor e protegiam a confiança após um erro. [RES]
- Todo gráfico tem uma visualização em tabela e um resumo de uma linha. A interação tem um equivalente de teclado e leitor de tela. [PRAC]
- Declare a linha de base de cada delta. "+2,4% hoje (desde o fechamento de ontem)". [PRAC]
- O progresso é honesto. Mapeie os estados do backend para 3–5 estágios simples com carimbos de data/hora. "Enviado" não é "chegou". As ETAs são rotuladas como estimativas. O dinheiro devolvido tem seu próprio estado não final. [PRAC]
- Mostre que um toque foi registrado imediatamente. Avisos de "não pressione duas vezes" falham; um estado instantâneo de "processando" com o botão desabilitado funciona. [RES]
- Mascare identificadores por padrão (•••• 4421), revele sob demanda com reautenticação para números completos. [PRAC]
- Pendente é rotulado e explicado, e nunca adicionado ou removido silenciosamente do saldo disponível. [INF]
- Nenhuma mecânica de recompensa em gráficos de investimento, crédito ou gastos (confetes em negociações, revelações de raspadinha, rankings de popularidade). A Robinhood pagou $7,5 milhões a Massachusetts em 2024 por essas práticas. [REG]
Especificações rápidas
Hierarquia de valor. Em uma tela de saldo ou pagamento, o valor é o texto maior, definido em figuras tabulares, com a moeda no mesmo peso visual ou um tom mais claro. Os dígitos decimais podem ser menores, mas nunca com contraste inferior a 4,5:1.
Rótulo de delta. +£12,40 (+0,8%) hoje → sinal, valor absoluto, valor relativo, período. Token de cor + glifo de seta + sinal. Zero mostra como £0,00 (0,0%) sem sinal e cor neutra (signDisplay: "exceptZero").
Chip de status. Ícone + palavra + cor, nunca apenas cor. Use verbos que as pessoas entendam: Pendente, Pago, Falhou, Reembolsado, Devolvido. Evite códigos internos (AUTORIZADO, LIQUIDADO).
Antes de entregar, verifique
- Todo valor formatado pela API da plataforma para a localidade do usuário, com moeda
- Figuras tabulares em todos os números variáveis ou em colunas
- Nenhuma notação compacta em valores acionáveis
- Ganho/perda usa tokens semânticos + sinal + glifo; testado com um simulador de daltonismo
- Barras a partir de zero; projeções como bandas; linhas de base declaradas
- Cada gráfico tem um título, uma visualização em tabela e acesso por teclado
- Todo status tem estados de carregamento, pendente, falha, devolvido e desatualizado com carimbos de data/hora
- Identificadores mascarados; revelação é deliberada
- Modo de saldo oculto (privacidade) funciona em todas as superfícies de dinheiro
- O texto escala para 200% sem truncar valores
Leia os links de origem dentro de cada referência antes de confiar em um ponto regulatório para um produto em produção.