money-data은(는) 무엇을 하나요?
사람들이 금액을 한 번에 정확하게 읽을 수 있도록 표시하는 방법입니다. 이 규칙은 소비자 앱과 복잡한 B2B 도구 모두에 적용됩니다. 타이포그래피와 데이터 시각화 표준을 금융에 엄격하게 적용한 결과이며, Wise, Monzo, Stripe, Coinbase, Robinhood, Apple 및 IBM Carbon의 문서화된 사례를 기반으로 합니다.
이 스킬을 critical-core(위험, 감정, 시각 언어) 및 money-flows(돈을 움직이는 액션)와 함께 사용하세요.
이 스킬을 사용하는 방법
- 모든 숫자의 역할을 지정하세요. 잔액, 지불 금액, 델타, 비율, 예측, 참조 중 무엇인가요? 역할이 형식, 정밀도, 색상 및 위치를 결정합니다.
- 필요한 참조를 로드하세요(아래 참조). 코드를 작성하거나 컴포넌트를 지정하기 전에 수행하세요. 정확한 값을 사용하고, 형식을 임의로 변경하지 마세요.
- 상태를 작성하세요. 해피 패스만으로는 부족합니다. 모든 금융 화면에는 로딩, 오래된(구식), 보류 중, 실패, 비어 있음, 숨김 상태가 있습니다.
- 전달하기 전에 체크리스트를 실행하세요.
| 참조 | 로드할 대상 |
|---|---|
references/numbers-and-identifiers.md | 통화 형식, 소수 단위, 반올림, 간결 표기법, 음수, 탭 피겨, 계좌 번호 마스킹, 단위 및 용량 |
references/color-and-gain-loss.md | 로케일별 양수/음수 색상, 색맹 안전 페어, 마크 대비, 의미 토큰 |
references/charts.md | 차트 선택기, 기준선, 시간 범위, 예측 및 불확실성, 스파크라인, 스크러빙, 차트 접근성, 게임화 제한 |
references/progress-and-status.md | 로딩 임계값, 결제 및 송금 상태 맵, 카드, 분쟁 및 KYC 상태, 저축 목표 및 신용 미터 |
references/records-and-dashboards.md | 거래 행, 판매자 정리, 영수증, 명세서, B2B 대시보드, 금융 데이터 그리드, 감사 로그, 조정 |
위 항목에 대한 모든 원본 디자인 토큰은 저장소 루트의 /tokens에 있습니다.
가장 중요한 규칙
각 규칙은 출처 유형을 포함합니다: [REG] 법률 또는 표준, [RES] 발표된 연구, [PRAC] 문서화된 회사 사례, [INF] criticalUX 종합.
- 플랫폼으로 포맷하고, 수동으로 하지 마세요.
Intl.NumberFormat(웹),NumberFormatter/FormatStyle(Apple),NumberFormat/DecimalFormat(Android)을 사용하세요. 기호 위치, 구분 기호 및 각 통화의 소수 단위(JPY는 없음, KWD는 3개)를 처리합니다. [PRAC] - 모든 금액은 통화를 함께 표시합니다. 다중 통화 제품에서는 숫자만 단독으로 표시하지 마세요. 기호가 모호한 경우($만으로는 USD, CAD, AUD, MXN 등을 의미할 수 있음) ISO 코드(USD)를 사용하세요. [INF]
- 변경되거나 열에 있는 숫자에는 탭 피겨를 사용하세요. (
font-variant-numeric: tabular-nums). 비례 피겨는 값이 변동할 때 흔들립니다. [PRAC] - 간결 표기법은 축과 요약 타일에만 사용하세요. 잔액, 지불 금액, 수수료 또는 사용자가 조치를 취할 금액에는 절대 사용하지 마세요. [INF]
- 부분 합계는 총계와 일치하거나, 화면에 반올림이 적용된다고 명시해야 합니다. [INF]
- 양수와 음수는 로케일 또는 설정에 따라 해석되는 의미 토큰이며, 하드코딩된 초록색과 빨간색이 아닙니다. 빨간색은 중국 본토, 일본, 대만 시장에서 상승을 의미합니다. 항상 색상을 부호(+/−) 및 글리프와 함께 사용하세요. [RES/PRAC]
- 차트 마크는 인접 색상 대비 3:1 이상을 유지해야 하며(WCAG 1.4.11), 색상에만 의존하는 의미가 없어야 합니다(WCAG 1.4.1). [REG]
- 막대는 0부터 시작합니다. 선은 그렇지 않을 수 있습니다. 잘린 막대는 차이를 과장합니다. [RES]
- 불확실한 미래에 대해 단일 선을 절대 표시하지 마세요. 저축, 은퇴, 대출 상환 예측 또는 전망은 부채꼴 또는 띠 차트를 사용합니다. 2026년 영란은행 연구(n≈1,600)에 따르면 부채꼴 차트가 기대치와 불확실성을 가장 잘 전달하고, 예측이 빗나간 후 신뢰를 보호하는 데 가장 효과적이었습니다. [RES]
- 모든 차트에는 테이블 보기와 한 줄 요약 헤드라인이 있습니다. 스크러빙에는 키보드 및 스크린 리더 대안이 있습니다. [PRAC]
- 모든 델타의 기준선을 명시하세요. "+2.4% 오늘(어제 종가 대비)". [PRAC]
- 진행 상황은 정직해야 합니다. 백엔드 상태를 타임스탬프가 있는 3~5개의 평이한 단계로 매핑하세요. "보냄"은 "도착함"이 아닙니다. ETA는 추정치로 표시됩니다. 반환된 금액은 별도의 최종 상태가 아닌 상태를 가집니다. [PRAC]
- 탭이 즉시 등록되었음을 보여주세요. "두 번 누르지 마세요" 경고는 실패합니다. 버튼이 비활성화된 즉시 "처리 중" 상태가 작동합니다. [RES]
- 식별자는 기본적으로 마스킹하세요(•••• 4421). 전체 번호는 재인증 후 요청 시에만 공개하세요. [PRAC]
- 보류 중은 레이블이 지정되고 설명되어야 하며, 가용 잔액에 조용히 추가되거나 제거되지 않습니다. [INF]
- 투자, 신용 또는 지출 차트에 보상 메커니즘(거래 시 컨페티, 스크래치 카드 공개, 인기 순위)을 사용하지 마세요. Robinhood는 이와 관련하여 2024년 매사추세츠주에 750만 달러를 지불했습니다. [REG]
빠른 사양
금액 계층 구조. 잔액 또는 결제 화면에서 금액은 가장 큰 텍스트이며, 탭 피겨로 설정되고, 통화와 동일한 시각적 무게 또는 한 단계 가볍게 표시됩니다. 소수 자릿수는 더 작을 수 있지만 대비는 4.5:1보다 낮아서는 안 됩니다.
델타 레이블. +£12.40 (+0.8%) 오늘 → 부호, 절대값, 상대값, 기간. 색상 토큰 + 화살표 글리프 + 부호. 0은 £0.00 (0.0%)로 표시되며 부호가 없고 중립 색상입니다(signDisplay: "exceptZero").
상태 칩. 아이콘 + 단어 + 색상, 색상만으로는 안 됩니다. 사람들이 이해하는 동사를 사용하세요: 보류 중, 지불됨, 실패, 환불됨, 반환됨. 내부 코드(AUTHORISED, SETTLED)는 사용하지 마세요.
전달하기 전에 확인하세요
- 모든 금액이 사용자 로케일 및 통화에 맞게 플랫폼 API로 포맷되었는가?
- 모든 변경되거나 열에 있는 숫자에 탭 피겨가 사용되었는가?
- 조치 가능한 금액에 간결 표기법이 사용되지 않았는가?
- 손익 표시에 의미 토큰 + 부호 + 글리프가 사용되었으며, 색맹 시뮬레이터로 테스트되었는가?
- 막대는 0부터 시작하고, 예측은 띠 차트이며, 기준선이 명시되었는가?
- 각 차트에 헤드라인, 테이블 보기 및 키보드 접근이 제공되는가?
- 모든 상태에 로딩, 보류 중, 실패, 반환, 오래된(구식) 상태가 타임스탬프와 함께 있는가?
- 식별자가 마스킹되었으며, 공개는 의도적인가?
- 모든 금융 화면에서 잔액 숨김(개인 정보 보호) 모드가 작동하는가?
- 텍스트가 금액을 자르지 않고 200%까지 확장되는가?
규제 사항을 출시 제품에 적용하기 전에 각 참조 내의 출처 링크를 읽으세요.