Communitygithub.com

money-data

Skill de conception. Afficher les données monétaires et financières de manière correcte et élégante. Couvre les montants, les devises, les deltas, les identifiants de compte, les couleurs gains/pertes par locale, le choix de graphiques (soldes, dépenses, flux de trésorerie, portefeuilles, projections, KPI), les lignes de base, le scrub et l'accessibilité des graphiques, l'état d'avancement et le statut des paiements (virements, cartes, étapes KYC, litiges, objectifs), les listes de transactions, les reçus, les relevés et les tableaux de bord et grilles de données B2B. À utiliser chaque fois que vous concevez, construisez, critiquez ou prototypiez un écran ou un composant.

Qu'est-ce que money-data ?

Ce skill (compétence) est un guide de conception et de développement pour l'affichage correct et élégant des données financières dans toute interface utilisateur, qu'elle soit destinée au grand public ou aux outils B2B denses. Il s'appuie sur les standards de typographie et de visualisation de données appliqués strictement à l'argent, ainsi que sur des pratiques documentées d'entreprises comme Wise, Monzo, Stripe, Coinbase, Robinhood, Apple et IBM Carbon. Le skill fournit des règles précises, des références spécialisées et une checklist de validation pour garantir que chaque montant, delta, graphique, statut de paiement ou élément de tableau de bord est présenté de manière à être compris du premier coup, sans ambiguïté. Il couvre le formatage des montants, les couleurs de gain/perte par locale, le choix des graphiques, l'accessibilité, le masquage des identifiants, la gestion des états (chargement, en attente, échoué, etc.) et bien plus encore, avec des spécifications concrètes et des exemples de code. Il est conçu pour être utilisé avec des plateformes comme Claude Code, Cursor, Codex et tout outil d'IA agent, dans le but d'améliorer la qualité et la cohérence des interfaces financières.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait money-data ?

Comment afficher l'argent pour que les gens le lisent correctement du premier coup. Ces règles s'appliquent aussi bien aux applications grand public qu'aux outils B2B denses. Elles proviennent des standards de typographie et de visualisation de données appliqués strictement à l'argent, ainsi que des pratiques documentées chez Wise, Monzo, Stripe, Coinbase, Robinhood, Apple et IBM Carbon.

Combinez ce skill avec critical-core (risque, émotion, langage visuel) et money-flows (les actions qui déplacent l'argent).

Comment utiliser ce skill

  1. Nommez le rôle de chaque nombre. Est-ce un solde, un montant à payer, un delta, un taux, une projection, une référence ? Le rôle détermine le format, la précision, la couleur et la position.
  2. Chargez la référence dont vous avez besoin (ci-dessous) avant d'écrire du code ou de spécifier un composant. Utilisez les valeurs exactes ; n'improvisez pas les formats.
  3. Écrivez les états, pas seulement le chemin heureux. Chaque surface monétaire a des états de chargement, obsolète, en attente, échoué, vide et masqué.
  4. Parcourez la checklist à la fin avant de remettre quoi que ce soit.
RéférenceChargez-la pour
references/numbers-and-identifiers.mdFormatage des devises, unités mineures, arrondi, notation compacte, nombres négatifs, chiffres tabulaires, masquage des numéros de compte, unités et doses
references/color-and-gain-loss.mdCouleur positive/négative par locale, paires adaptées aux daltoniens, contraste pour les marqueurs, tokens sémantiques
references/charts.mdChoix du graphique, lignes de base, plages de temps, projections et incertitude, sparklines, scrub (exploration), accessibilité des graphiques, limites de gamification
references/progress-and-status.mdSeuils de chargement, cartes des états de paiement et de virement, statut des cartes, litiges et KYC, objectifs d'épargne et compteurs de crédit
references/records-and-dashboards.mdLignes de transaction, nettoyage des commerçants, reçus, relevés, tableaux de bord B2B, grilles de données financières, journaux d'audit, rapprochement

Les tokens de conception originaux pour tout ce qui précède se trouvent dans /tokens à la racine du dépôt.

Les règles les plus importantes

Chaque règle porte un type de source : [REG] loi ou norme, [RES] recherche publiée, [PRAC] pratique d'entreprise documentée, [INF] synthèse criticalUX.

  1. Formatez avec la plateforme, jamais à la main. Utilisez Intl.NumberFormat (web), NumberFormatter/FormatStyle (Apple), NumberFormat/DecimalFormat (Android). Ils gèrent la position du symbole, les séparateurs et les unités mineures de chaque devise (JPY n'en a pas, KWD en a trois). [PRAC]
  2. Chaque montant porte sa devise. Pas de chiffres nus dans les produits multi-devises. Utilisez le code ISO (USD) lorsque le symbole est ambigu ($ seul peut signifier USD, CAD, AUD, MXN et d'autres). [INF]
  3. Chiffres tabulaires pour tout nombre qui change ou se trouve dans une colonne (font-variant-numeric: tabular-nums). Les chiffres proportionnels tremblent lorsque les valeurs changent. [PRAC]
  4. Notation compacte uniquement sur les axes et les tuiles de résumé. Jamais sur un solde, un montant de paiement, des frais ou quoi que ce soit sur quoi la personne va agir. [INF]
  5. Les parties totalisent le tout, ou l'écran indique que l'arrondi s'applique. [INF]
  6. Le positif et le négatif sont des tokens sémantiques résolus par locale ou paramètre, pas du vert et du rouge codés en dur. Le rouge signifie hausse en Chine continentale, au Japon et à Taïwan. Associez toujours la couleur à un signe (+/−) et un glyphe. [RES/PRAC]
  7. Les marqueurs de graphique atteignent un contraste de 3:1 par rapport aux couleurs adjacentes (WCAG 1.4.11), et aucune signification ne dépend uniquement de la couleur (WCAG 1.4.1). [REG]
  8. Les barres commencent à zéro. Les courbes peuvent ne pas le faire. Les barres tronquées exagèrent les différences. [RES]
  9. Ne montrez jamais une seule courbe pour un avenir incertain. Les projections d'épargne, de retraite, de remboursement de prêt ou les prévisions utilisent un graphique en éventail ou en bande. Une étude de la Banque d'Angleterre de 2026 (n≈1 600) a montré que les graphiques en éventail transmettaient le mieux les attentes et l'incertitude et protégeaient la confiance après une erreur. [RES]
  10. Chaque graphique a une vue tableau et un résumé en une ligne. Le scrub (exploration) a un équivalent clavier et lecteur d'écran. [PRAC]
  11. Indiquez la ligne de base de chaque delta. « +2,4 % aujourd'hui (depuis la clôture d'hier) ». [PRAC]
  12. La progression est honnête. Associez les états backend à 3 à 5 étapes simples avec des horodatages. « Envoyé » n'est pas « arrivé ». Les ETA sont étiquetées comme des estimations. L'argent retourné a son propre état non final. [PRAC]
  13. Montrez qu'un tap a été enregistré immédiatement. Les avertissements « n'appuyez pas deux fois » échouent ; un état instantané « en cours de traitement » avec le bouton désactivé fonctionne. [RES]
  14. Masquez les identifiants par défaut (•••• 4421), révélez-les à la demande avec une ré-authentification pour les numéros complets. [PRAC]
  15. Le statut « en attente » est étiqueté et expliqué, et jamais ajouté ou retiré silencieusement du solde disponible. [INF]
  16. Pas de mécanismes de récompense sur les graphiques d'investissement, de crédit ou de dépenses (confettis sur les transactions, révélations à gratter, classements de popularité). Robinhood a payé 7,5 millions de dollars au Massachusetts en 2024 pour ces pratiques. [REG]

Spécifications rapides

Hiérarchie des montants. Sur un écran de solde ou de paiement, le montant est le texte le plus grand, en chiffres tabulaires, avec la devise dans le même poids visuel ou un cran plus léger. Les chiffres décimaux peuvent être plus petits mais jamais avec un contraste inférieur à 4,5:1.

Étiquette de delta. +12,40 £ (+0,8 %) aujourd'hui → signe, absolu, relatif, période. Token de couleur + glyphe flèche + signe. Zéro s'affiche comme 0,00 £ (0,0 %) sans signe et avec une couleur neutre (signDisplay: "exceptZero").

Puce de statut. Icône + mot + couleur, jamais la couleur seule. Utilisez des verbes que les gens comprennent : En attente, Payé, Échoué, Remboursé, Retourné. Évitez les codes internes (AUTHORISED, SETTLED).

Avant de remettre, vérifiez

  • Chaque montant formaté par l'API de la plateforme pour la locale de l'utilisateur, avec la devise
  • Chiffres tabulaires sur tous les nombres changeants ou en colonne
  • Pas de notation compacte sur les montants actionnables
  • Gain/perte utilise des tokens sémantiques + signe + glyphe ; testé avec un simulateur de daltonisme
  • Barres à partir de zéro ; projections en bandes ; lignes de base indiquées
  • Chaque graphique a un titre, une vue tableau et un accès clavier
  • Chaque statut a des états de chargement, en attente, échoué, retourné et obsolète avec des horodatages
  • Identifiants masqués ; la révélation est intentionnelle
  • Le mode solde masqué (confidentialité) fonctionne sur chaque surface monétaire
  • Le texte passe à 200 % sans tronquer les montants

Lisez les liens sources dans chaque référence avant de vous appuyer sur un point réglementaire pour un produit en production.

Skills associés