개발 로드맵¶

전체 구조¶

• 이론 : ERP/회계/프로세스/재고•세무•원가의 핵심 개념 파악
• 실전 : 웹 ERP MVP 개발 → 점진적 고도화
• 최소 산출물 : 도메인 용어집, 프로세스 다이어그램, ERD, 자동분개 규칙, API 스펙, 화면 와이어프레임, 테스트 시나리오, 배포 스트립트
• 개발 스택
  • 프론트엔드 : React.js + shadcn/ui (공통)
  • 백엔드1 : TypeScript/NextJS + Prisma + PostgreSQL + Next.js
  • 백엔드2 : Spring Boot + JPA + PostgreSQL + Next.js

아키텍처 원칙¶

• 단일 정보 출처(SSOT)
  • DB : 스키마 - sql/migrations의 순수 SQL로 관리 (둘다 동일 스키마 사용)
  • API : openapi/openapi.yaml (서버/클라이언트 SDK 자동 생성)
  • 이벤트 : events/*.json (도메인 이벤트 페이로드 스펙)

• 동일한 메인 모듈
  

  auth, core, master(품목/거래처), finance(GL/분개), purchasing, sales, inventory
  

• 동일한 테스트 시나리오
  • 단위(분개 룰), 통합(입고→전표), E2E

로드맵 요약¶

1-4주차 : 이론 기초 + 플랫폼 뼈대 구성¶

• 이론
  • ERP 핵심: 주문→출하/인도→청구→수금(O2C), 요청→발주→입고→정산(P2P)
  • 이중부기와 계정과목, 보조부→총계정원장(GL) 흐름.
  • 한국 로컬 포인트 : 부가가치세(영세/과세/면세), 환율, 회계기간, 월마감
• 실전
  • 프로젝트 템플릿 생성, 모놀리식 모듈 구조(ex. core, auth, master, finance, purchasing, sales, inventory)
  • 공통 레이어
    • 인증/인가(JWT + RBAC), 사용자/조직, 번호체계, 감사로그(Audit), 첨부/코멘트
    • 표준 응답/에러/검증 파이프, OpenAPI 문서화
  • 데이터 모델(핵심)
    • 마스터 : partners, items, warehouses, tax_codes, currencies, exchange_rates, gl_accounts
    • 회계 : gl_journals, gl_journal_lines, fiscal_periods
    • 공통 : attachments, audit_logs, doc_sequences
  • UI 골격
    • 레이아웃, 공통 그리드(저장된 필터/컬럼), 상태배지, Export(CSV/XLSX)
• 주간 산출물
  • 용어집(파트너/품목/전표/세금코드 등)
  • ERD 초안(v0)
  • 와이어프레임(전표 미리보기 패널 포함)
    • 배포 : Docker(Contaner Manager) + Nginx(프록시) + Cl(빌드/테스트)

5-6주차 : 회계 엔진 코어(필수)

• 이론
  • 분개 규칙 : 판매확정, 입고확정, 출고확정, 청구/수금, 매입/지급 시 차/대변 매핑.
  • 환율/다중통화, 세금 분개(매출•매입•부가세)
• 실전
  • 테이블 확정 : gl_accounts, posting_rules, gl_journals, gl_journal_lines
  • 자동분개 엔진(룰 기반) 구현 : 도메인 이벤트→룰 조회→분개 생성→저장
  • 샘플 룰(JSON)
    

    {
      "event": "SALES_CONFIRMED",
      "conditions": { "tax_code": "VAT10", "item_type": "GOODS" },
      "lines": [
        { "side": "DR", "account": "AR", "amount": "net+vat" },
        { "side": "CR", "account": "REV", "amount": "net" },
        { "side": "CR", "account": "VAT_OUT", "amount": "vat" }
      ]
    }
    

  • 의사코드
    

    onEvent(e):
      rule = PostingRules.match(e)
      lines = rule.build(e.payload)  // 금액, 통화, 세금
      Journal.create(headerFrom(e), lines)
    

• 산출물
  • 분개 규칙 표(이벤트별)
  • 전표장/원장 기본 리포트 API

7-9주차 : 구매(P2P) + 재고(수불)¶

• 이론
  • 재고평가 방법 : 가중평균 or FIFO
  • 입고/반품/이동, 창고/로케이션 개념
• 실전
  • 구매요청(PR)→발주(PO)→입고(GR)→매입세금계산서(AP)→지급
  • 테이블 : purchase_requests, purchase_orders, receipts, ap_invoices, payments, inventory_moves, inventory_layers(평가용), grn_lines 등
  • 분개 포인트 예시
    • 입고확정 : 재고자산(차)/매입채무(대)
    • 매입세금계산서 : 매입부가세(차)/매입채무(대)
  • 그리드 UX : 라인 인라인 편집, 단가/세액 자동계산, 상태 전이(초안→승인→확정)
• 산출물
  • 입고 전표 자동생성 E2E 테스트
  • 재고수불 리포트(기간/창고/품목)

10-12주차 : 판매(O2C) + 청구/수금

• 이론
  • 주문/출고/매출/수금 흐름, 출고 시점의 매출원가(COGS) 인식
• 실전
  • 견적→주문→출고→매출세금계산서(AR)→수금
  • 분개 포인트 예시
    • 출고확정 : 매출원가(차)/재고자산(대)
    • 매출확정 : 외상매출금(차)/매출(대)+부가세계수금(대)
  • 리포트 : 매출현황, 미수잔액(고객/기간), 손익 간이표
• 산출물
  • 판매/출고/청구 E2E 시나리오
  • 시산표(월/계정) v1

13-14주차 : 마감/권한/감사+안정화

• 이론
  • 월마감 : 역분개/조정분개, 기간 잠금, 승인 체계
  • 권한 모델 : 문서 단위 보기/작성/승인/역분개
• 실전
  • 마감 작업 배치(Job) + 재무기간 잠금
  • 역분개(Reverse) : 수정 대신 역분개 + 재기표 정책
  • 권한 세분화(엔드포이트/액션 레벨)
  • 대량 데이터 성능(인덱스, 파티셔닝 : 월/회사)
• 산출물
  • 마감 체크리스트, 감사 로그 대시보드, 성능지표(Grafana 권장)

15-16주차 : 운영/배포/데이터•테스트

• 운영
  • Docker 이미지 최적화, 백업/복구 시나리오, 스냅샷 테이블(BI용) 설계
  • 모니터링/알람 : Prometheus(or node_exporter) + Grafana, 구조화 로깅
• 테스트 전략
  • 단위 : 분개빌더, 금액/세액 라운딩
  • 통합 : 입고→전표, 출고→전표, 청구→수금
  • E2E : P2P/O2C 핵심 흐름 10개 시나리오 자동화
• 최종 산추물(캡스톤)
  • 데모 스크립트(5분) : PO 생성→입고→AP전표/지급, SO→출고→AR전표/수금, 시산표 확인
  • 관리자 계정, 3개 역할(Role) 데모, 10만행 샘플로 리포트/성능 확인

---

핵심 설계 체크리스트¶

• ▢ 이벤트 → 자동분개 룰 → 전표 생성 파이프라인이 단방향으로 깔끔한가?
• ▢ 모든 문서에 상태머신과 감사로그가 붙었는가?
• ▢ 전표 미리보기(가상 분개)가 저장 전 확인 가능하게 되어 있는가?
• ▢ 역분개 정책이 코드/화면/권한에서 일관성 있는가?
• ▢ 재고평가(가중평균/FIFO)가 전 과정에서 동일 규칙으로 계산되는가?
• ▢ 한국 VAT, 환율, 기간 잠금이 반영됐는가?