1. 작성 목적
본 기록은 CoreERP 백엔드 구조 정비 이후, 실제 ERP 시스템의 핵심이 되는 데이터 구조(ERD)를 확정한 과정을 정리하기 위한 문서이다.
이 단계의 목표는 기능 구현이 아니라, 데이터 무결성을 보장할 수 있는 도메인 구조를 먼저 고정하는 것이었다.
2. ERP 설계 접근 방식
ERP 시스템은 화면 중심이 아니라 데이터 중심으로 설계해야 한다. 특히 재고 관리 시스템에서는 잘못된 구조가 곧 데이터 왜곡으로 이어질 수 있다.
CoreERP는 다음 원칙을 기준으로 ERD를 설계하였다.
- 마스터 데이터와 트랜잭션 데이터 분리
- 재고는 직접 수정하지 않음
- 모든 재고 변동은 이력으로 남김
- FK 관계를 명확히 하여 무결성 유지
3. ERD 구조
아래는 CoreERP 재고 시스템의 전체 관계 구조이다.
CoreERP 재고 및 트랜잭션 구조 ERD
4. 관계 구조 해석
Item 1 ─── N Inventory N ─── 1 Warehouse Inventory 1 ─── N StockTx
품목(Item)과 창고(Warehouse)는 직접 연결되지 않는다. 두 엔티티는 inventory 테이블을 통해 연결된다.
이는 하나의 품목이 여러 창고에 존재할 수 있고, 하나의 창고에는 여러 품목이 존재할 수 있기 때문이다.
또한 모든 재고 변동은 stock_tx 테이블을 통해 기록되며, inventory는 현재 상태를, stock_tx는 변동 이력을 담당한다.
5. 마스터 테이블 설계
5-1. item (품목 마스터)
- item_id (PK)
- item_code (UNIQUE)
- item_name
- category
- unit
- safety_stock
- unit_cost
- created_at / updated_at
item은 재고 시스템의 기준 엔티티이며, 중복 방지를 위해 item_code는 UNIQUE로 설계하였다.
5-2. warehouse (창고 마스터)
- warehouse_id (PK)
- warehouse_code (UNIQUE)
- warehouse_name
- is_active
- created_at / updated_at
창고는 재고 보관 단위이며, 재고는 반드시 품목 + 창고 조합으로 존재하도록 설계하였다.
6. 재고 및 트랜잭션 설계
6-1. inventory (현재 재고)
- inventory_id (PK)
- item_id (FK)
- warehouse_id (FK)
- quantity
- updated_at
inventory는 현재 재고 상태를 나타내는 테이블이다. 재고 수량은 직접 수정하지 않으며, 입고·출고 확정 시에만 변경된다.
6-2. stock_tx (재고 변동 이력)
- stock_tx_id (PK)
- inventory_id (FK)
- tx_type (INBOUND / OUTBOUND)
- quantity
- created_at
stock_tx는 모든 재고 변동을 기록하는 감사 로그(Audit Log) 역할을 한다. 이를 통해 재고 추적, 오류 복구, 통계 확장이 가능해진다.
7. 설계 단계의 의미
이번 단계에서 가장 중요한 것은 기능 구현이 아니라, 재고 무결성 구조를 먼저 고정했다는 점이다.
CoreERP는 단순 CRUD 프로젝트가 아니라, 트랜잭션 중심 시스템으로 설계되었다. 이 ERD는 향후 JPA 엔티티 설계와 비즈니스 로직 구현의 기반이 된다.
8. 다음 단계
ERD 확정 이후, JPA 기반 엔티티 설계 및 Repository 구현 단계로 진입한다.
