피드로 돌아가기
GeekNewsBackend
원문 읽기
핀테크 엔지니어링 핸드북
데이터 무결성과 추적성 보장을 위한 핀테크 원장 설계 원칙
AI 요약
Context
금융 시스템은 단순 CRUD를 넘어 데이터 생성 방지, 손실 방지, 무신뢰 검증이라는 엄격한 제약 조건 하에 동작함. 부동소수점 오차와 동시성 문제로 인한 중복 지출 및 데이터 불일치가 시스템 신뢰도를 결정하는 핵심 병목 지점으로 작용함.
Technical Solution
- 정밀도 손실 방지를 위해 BigDecimal 또는 최소 단위 정수(Satoshi, Wei 등)를 사용한 금액 표현 체계 구축
- 자산의 흐름을 Credit/Debit entry로 기록하여 항상 균형을 유지하는 복식부기(Double-entry Bookkeeping) 구조 설계
- Value/Booking/Settlement Time을 분리하여 거래 발생, 기록, 실제 정산 시점의 시차를 정밀하게 추적
- Event Sourcing 패턴을 통한 Append-only Audit Trail 구축으로 상태 변경 이력의 불변성 및 재생 가능성 확보
- Idempotency Key 도입을 통해 네트워크 재시도 상황에서도 중복 결제 및 지출을 원천 차단하는 멱등성 보장 로직 구현
- Outbox 패턴과 CDC를 활용해 외부 API 및 웹훅 전송의 원자성을 확보하고 데이터 누락 방지
실천 포인트
- 금액 저장 시 IEEE-754 double의 정밀도 한계를 인지하고 문자열이나 정수 타입으로 직렬화하는지 검토 - 잔액(Balance)을 컬럼으로 저장하지 않고 Entry의 합산으로 도출하는 구조인지 확인 - 모든 금융 트랜잭션에 대해 멱등성 키를 정의하고 중복 요청 처리 로직이 포함되었는지 점검 - 정정 거래 시 원본 데이터를 수정하지 않고 상쇄 Entry(Compensating Entry)를 생성하는 불변성 원칙 적용