Economic · 경제 / Treasury Infrastructure
BEATOZ Treasury - Treasury Operations Platform
1인 개발로 진행한 재무 운영 플랫폼 모노레포입니다. 이체, FX, 준비금, 정산, 모니터링 흐름을 대상으로 NestJS API, Next.js Admin/Testbench, Kafka ingress/outbox, 단일 인스턴스 배포 자동화를 함께 구성했고, CPG를 포함한 통합 dev pilot의 재무 운영 도메인 역할을 맡았습니다.
- 역할
- 1인 개발 · 아키텍처, 구현, 운영 도구
- 기간
- 2026.02 - Present
- 맥락
- Beatoz Labs
1인 개발로 진행한 재무 운영 플랫폼 모노레포입니다. 이체, FX, 준비금, 정산, 모니터링 흐름을 대상으로 NestJS API, Next.js Admin/Testbench, Kafka ingress/outbox, 단일 인스턴스 배포 자동화를 함께 구성했고, CPG를 포함한 통합 dev pilot의 재무 운영 도메인 역할을 맡았습니다.
무엇이 시스템을 어렵게 만들었는가.
동기 API와 Kafka 기반 ingress가 함께 존재하는 환경에서 이체, FX, 준비금, 정산 상태가 일관되게 유지되어야 했고, idempotency, DLQ replay, 운영 가시성, 단일 인스턴스 배포 가능성을 동시에 확보해야 했습니다. 동시에 CPG 및 인접 컴플라이언스/운영 서비스가 호출할 수 있는 안정적인 인터페이스도 필요했습니다.
어떤 경계와 흐름으로 답했는가.
bank/fx/ledger/reserve/transfer/monitoring/treasury-consumers 모듈을 분리하고, API 경계에서 idempotency와 problem-details 응답을 강제했습니다. Kafka consumer 및 DLQ replay 서비스, settlement reconcile 스케줄러를 구현했고, 운영용 admin/testbench 앱을 구성했습니다. 또한 CPG와 인접 서비스가 연결할 수 있는 도메인 인터페이스 및 ingress 흐름을 제공하고, 중앙 AWS 기반 dev pilot 배포 레이어와 맞는 단일 인스턴스 배포 스크립트까지 함께 정리했습니다.
시스템을 통과하는 책임의 경로.
Treasury API
Core Operations Backend
Responsibilities
- — Idempotent transfer/FX/reserve APIs
- — Problem-details error contract
- — Settlement reconcile flows
Admin Web
Operations Dashboard
Responsibilities
- — Reserve and monitoring views
- — Transfer and settlement operations
- — OpenBanking integration screens
Testbench + Mock Services
Flow Validation
Responsibilities
- — Scenario runner UI
- — Billing/cross-border mock producers
- — Kafka smoke and DLQ replay verification
개요
- 1인 개발로 진행한 재무 운영 플랫폼 모노레포입니다.
- 이체, FX, 준비금, 정산, 모니터링 흐름을 API/운영 UI/테스트벤치/배포 스크립트까지 하나의 시스템으로 구성했습니다.
- CPG 및 인접 서비스와 함께 운영되는 Beatoz 통합 dev pilot에서 재무 운영 코어 역할을 맡도록 설계했습니다.
핵심 구성
1) Treasury API
- bank, FX, ledger, reserve, transfer, monitoring, treasury consumer ingress 모듈로 분리된 NestJS API를 구성했습니다.
- Problem Details 필터와 idempotency interceptor를 적용해 API 경계에서 오류 형식과 재시도 의미를 통일했습니다.
- 정산 상태 추적을 위해 reconcile 엔드포인트와 scheduler hook을 포함했습니다.
- CPG 및 인접 컴플라이언스/운영 서비스가 연결할 수 있는 도메인 인터페이스를 포함했습니다.
2) Kafka Ingress & Replay
- billing / cross-border ingress 이벤트(transfer, reserve movement, FX execution)를 수신합니다.
- DLQ publish, replay status/recent, worker lock coordination, replay trigger를 포함한 운영 복구 흐름을 구현했습니다.
- Kafka ingress, outbox transaction, DLQ replay를 검증하는 smoke 스크립트를 구성했습니다.
3) Admin + Testbench
- monitoring, reserve, FX, transfer, settlement, operations 화면을 포함한 Next.js admin 앱을 구성했습니다.
- 시나리오 실행, 로그 확인, 이력 export를 위한 Next.js testbench 앱을 구성했습니다.
- mock billing / mock cross-border 서비스로 consumer 기반 흐름을 검증할 수 있게 했습니다.
4) 배포/운영 자동화
- Postgres, PM2, Nginx를 묶은 단일 인스턴스 AWS 배포 스크립트를 구성했습니다.
- API/Admin/Testbench 환경 파일 생성과 기본 데이터 시드를 자동화했습니다.
- 중앙 dev pilot 배포 컨트롤러와 맞는 런타임 형태로 정리했습니다.