데이터 무결성 보장을 위한 핀테크 시스템의 고정밀 화폐 처리 설계 패턴

Context

금융 시스템에서 발생하는 부동 소수점 오차와 데이터 누락은 직접적인 금전적 손실로 연결되는 치명적 리스크임. 기존의 일반적인 숫자 처리 방식으로는 정밀도 손실과 데이터 임의 생성을 방지하기 어려운 한계가 존재함.

Technical Solution

• Floating-point 배제 및 Minor-units precision(정수형 최소 단위 저장) 도입을 통한 계산 예측 가능성 확보
• intermediate computation 단계에서 BigDecimal을 활용한 Arbitrary precision 적용으로 연쇄 연산 시 오차 최소화
• JSON 직렬화 시 숫자 타입 대신 String 또는 Integer 사용으로 Edge 단의 IEEE-754 double 변환 리스크 차단
• Rounding 전략을 비즈니스 결정 영역으로 분리하고 Persistence 및 User Interface 접점인 Boundary에서만 최소한으로 수행
• Double-entry bookkeeping 원칙을 적용하여 Cashback 및 Spread 발생 시 모든 잔액 변동을 명시적 계정 간 이동으로 처리
• Outbox 패턴 및 CDC를 활용한 At-least-once delivery 구현으로 결제 정산 후 알림 시스템의 신뢰성 보장