Communitygithub.com

dados-financeiros

Skill de design. Exibe dados financeiros e monetários de forma correta e atraente. Abrange valores, moedas, deltas, identificadores de conta, cor de ganho/perda por localidade, escolha de gráfico (saldos, gastos, fluxo de caixa, carteiras, projeções, KPIs), linhas de base, interação com gráficos e acessibilidade, progresso e status de pagamento (transferências, cartões, etapas de KYC, disputas, metas), listas de transações, recibos, extratos e painéis de dados financeiros B2B. Use sempre que você projetar, construir, criticar ou prototipar uma tela ou componente.

O que é dados-financeiros?

Este skill fornece um conjunto abrangente de regras e referências para exibir dados financeiros de forma clara e precisa em interfaces de usuário, abrangendo aplicativos de consumo e ferramentas B2B. Baseado em padrões de tipografia e visualização de dados aplicados a finanças, bem como em práticas documentadas de empresas como Wise, Monzo, Stripe, Coinbase, Apple e IBM Carbon, ele garante que valores, moedas, deltas e identificadores sejam formatados e apresentados corretamente. O skill inclui referências detalhadas para formatação de números e identificadores, cores e ganhos/perdas, gráficos, status e progresso, e registros e painéis, além de uma lista de verificação para garantir que todos os casos de estado (carregamento, pendente, falha, etc.) sejam considerados. Suporta qualquer plataforma (web, iOS/iPadOS, Android) e enfatiza o uso de APIs nativas de formatação, tokens semânticos e acessibilidade, como contraste de cores e navegação por teclado.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Sthitapragna-009/Critical_UX/tree/HEAD/skills/money-data

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

  1. 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.
  2. Carregue a referência necessária (abaixo) antes de escrever código ou especificar um componente. Use os valores exatos; não improvise formatos.
  3. Escreva os estados, não apenas o caminho feliz. Cada superfície de dinheiro tem estados de carregamento, desatualizado, pendente, falha, vazio e oculto.
  4. Execute a lista de verificação no final antes de entregar qualquer coisa.
ReferênciaCarregue para
references/numbers-and-identifiers.mdFormataçã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.mdCor positiva/negativa por localidade, pares seguros para daltonismo, contraste para marcas, tokens semânticos
references/charts.mdSeletor 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.mdLimiares 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.mdLinhas 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.

  1. 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]
  2. 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]
  3. 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]
  4. 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]
  5. As partes somam ao total, ou a tela informa que o arredondamento se aplica. [INF]
  6. 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]
  7. 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]
  8. Barras começam em zero. Linhas podem não começar. Barras truncadas exageram diferenças. [RES]
  9. 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]
  10. 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]
  11. Declare a linha de base de cada delta. "+2,4% hoje (desde o fechamento de ontem)". [PRAC]
  12. 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]
  13. 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]
  14. Mascare identificadores por padrão (•••• 4421), revele sob demanda com reautenticação para números completos. [PRAC]
  15. Pendente é rotulado e explicado, e nunca adicionado ou removido silenciosamente do saldo disponível. [INF]
  16. 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.

Habilidades Relacionadas