ERP

h1. 개발 로드맵

h2. 전체 구조

* 이론 : ERP/회계/프로세스/재고•세무•원가의 핵심 개념 파악

* 실전 : 웹 ERP(모놀리식) MVP 개발 → 점진적 고도화

* 최소 산출물 : 도메인 용어집, 프로세스 다이어그램, ERD, 자동분개 규칙, API 스펙, 화면 와이어프레임, 테스트 시나리오, 배포 스트립트

* 개발 스택

** 프론트엔드 : React.js + shadcn/ui (공통)

** 백엔드1 : TypeScript/NextJS + Prisma + PostgreSQL + Next.js

** 백엔드2 : Spring Boot + JPA + PostgreSQL + Next.js 

h2. 아키텍처 원칙

* 단일 정보 출처(SSOT)

** DB : 스키마 - sql/migrations의 순수 SQL(표준 Postgres)로 관리 (둘다 동일 스키마 사용)

** API : openapi/openapi.yaml (서버/클라이언트 SDK 자동 생성)

** 이벤트 : events/*.json (도메인 이벤트 페이로드 스펙)

* 동일한 메인 모듈

<pre>

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

</pre>

* 동일한 테스트 시나리오

** 단위(분개 룰), 통합(입고→전표), E2E(발주→입고→청구/지급, 주문→출고→청구/수금)

h2. 로드맵 요약

* 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)

<pre>

{

  "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" }

  ]

}

</pre>

*** 의사코드

<pre>

onEvent(e):

  rule = PostingRules.match(e)

  lines = rule.build(e.payload)  // 금액, 통화, 세금

  Journal.create(headerFrom(e), lines)

</pre>

** 산출물

*** 분개 규칙 표(이벤트별)

*** 전표장/원장 기본 리포트 API

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

** 이론

*** 재고평가 방법 : 가중평균 or FIFO(MVP는 한 가지로 고정)

*** 입고/반품/이동, 창고/로케이션 개념

** 실전

*** 구매요청(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만행 샘플로 리포트/성능 확인

-----------------------

h2. 핵심 설계 체크리스트

* ▢ 이벤트 → 자동분개 룰 → 전표 생성 파이프라인이 단방향으로 깔끔한가?

* ▢ 모든 문서에 상태머신과 감사로그가 붙었는가?

* ▢ 전표 미리보기(가상 분개)가 저장 전 확인 가능하게 되어 있는가?

* ▢ 역분개 정책이 코드/화면/권한에서 일관성 있는가?

* ▢ 재고평가(가중평균/FIFO)가 전 과정에서 동일 규칙으로 계산되는가?

* ▢ 한국 VAT, 환율, 기간 잠금이 반영됐는가?