피드로 돌아가기
I Built Sổ Lãi, a Practical Profit Tracker for Vietnamese Online Shops
Dev.toDev.to
Backend

Local-first 아키텍처 기반의 베트남 이커머스 맞춤형 수익 분석 엔진 구현

I Built Sổ Lãi, a Practical Profit Tracker for Vietnamese Online Shops

klauski242026년 5월 28일4beginner

Context

기존의 일반적인 대시보드 형태는 실제 판매자의 데이터 입력 워크플로우를 반영하지 못하는 한계 존재. 플랫폼별로 분산된 매출, 광고비, 배송비 등의 데이터를 통합하여 실제 순이익을 산출하는 실무 중심의 계산 모델 필요.

Technical Solution

  • 클라우드 비용 및 API 의존성을 제거한 Node.js 및 JSON Storage 기반의 Local-first 아키텍처 설계
  • Shopee, TikTok Shop 등 다양한 채널의 데이터를 수용하는 CSV Import 엔드포인트 및 매핑 로직 구현
  • 상품 단가, 마켓플레이스 수수료, 광고비, COD(착불금) 상태를 연산하는 Order-level Profit 계산 엔진 구축
  • 데이터 모델을 shop, products, orders, adCosts의 4가지 핵심 엔티티로 제한하여 시스템 복잡도 제어
  • 분석 결과를 외부 문서화할 수 있는 Markdown 및 CSV 리포트 Export 기능 구현
  • 사용자 경험 최적화를 위해 영어 기반 범용 UI를 베트남 판매자 특화 UI/UX로 리팩토링

- 실무 도구 설계 시 단순 시각화보다 '실제 데이터 입력 경로(Data Entry Path)' 확보를 우선할 것 - 초기 MVP 단계에서는 복잡한 DB 대신 JSON 기반 Local Storage로 빠르게 검증하고 스케일업할 것 - 도메인 특화 데이터(COD, 플랫폼 수수료 등)를 반영한 정밀한 계산 로직을 데이터 모델의 중심에 배치할 것

원문 읽기