ENKO
< 작업 목록으로
HASH: 0x0025...2026.02 - Present

BEATOZ Treasury - Treasury Operations Platform

Treasury Infrastructure

시스템 설명

1인 개발로 진행한 재무 운영 플랫폼 모노레포입니다. 이체, FX, 준비금, 정산, 모니터링 흐름을 대상으로 NestJS API, Next.js Admin/Testbench, Kafka ingress/outbox, 단일 인스턴스 배포 자동화를 함께 구성했습니다.

기술 스택

TypeScriptNestJSNext.jsPrismaPostgreSQLKafkaJSReactDockerAWS
BEATOZ Treasury - Treasury Operations Platform
ROLE: SOLO_DEVELOPERDOMAIN: BLOCKCHAIN
!

문제도전 과제

동기 API와 Kafka 기반 ingress가 함께 존재하는 환경에서 이체, FX, 준비금, 정산 상태가 일관되게 유지되어야 했고, idempotency, DLQ replay, 운영 가시성, 단일 인스턴스 배포 가능성을 동시에 확보해야 했습니다.

✓

해결해결 방식

bank/fx/ledger/reserve/transfer/monitoring/treasury-consumers 모듈을 분리하고, API 경계에서 idempotency와 problem-details 응답을 강제했습니다. Kafka consumer 및 DLQ replay 서비스, settlement reconcile 스케줄러를 구현했고, 운영용 admin/testbench 앱과 PM2/Nginx/Postgres 기반 단일 인스턴스 배포 스크립트를 함께 구성했습니다.

구현 범위

1인 개발로 진행한 재무 운영 플랫폼 모노레포입니다. 이체, FX, 준비금, 정산, 모니터링 흐름을 대상으로 NestJS API, Next.js Admin/Testbench, Kafka ingress/outbox, 단일 인스턴스 배포 자동화를 함께 구성했습니다.

증빙 자료

공개 가능한 증빙 자료가 등록되지 않았습니다.

SYSTEM_COMPONENTS

Treasury API

Core Operations Backend

기술 스택

NestJSPrismaPostgreSQLKafkaJS

하이라이트

  • →Idempotent transfer/FX/reserve APIs
  • →Problem-details error contract
  • →Settlement reconcile flows

Admin Web

Operations Dashboard

기술 스택

Next.jsReactTypeScript

하이라이트

  • →Reserve and monitoring views
  • →Transfer and settlement operations
  • →OpenBanking integration screens

Testbench + Mock Services

Flow Validation

기술 스택

Next.jsNode.jsKafka

하이라이트

  • →Scenario runner UI
  • →Billing/cross-border mock producers
  • →Kafka smoke and DLQ replay verification
기술 상세

개요

  • ▶1인 개발로 진행한 재무 운영 플랫폼 모노레포입니다.
  • ▶이체, FX, 준비금, 정산, 모니터링 흐름을 API/운영 UI/테스트벤치/배포 스크립트까지 하나의 시스템으로 구성했습니다.

핵심 구성

1) Treasury API

  • ▶bank, FX, ledger, reserve, transfer, monitoring, treasury consumer ingress 모듈로 분리된 NestJS API를 구성했습니다.
  • ▶Problem Details 필터와 idempotency interceptor를 적용해 API 경계에서 오류 형식과 재시도 의미를 통일했습니다.
  • ▶정산 상태 추적을 위해 reconcile 엔드포인트와 scheduler hook을 포함했습니다.

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 환경 파일 생성과 기본 데이터 시드를 자동화했습니다.