ERP-node/db/migrations/RUN_063_064_MIGRATION.md

마이그레이션 063-064: 재고 관리 테이블 생성

목적

재고 현황 관리 및 입출고 이력 추적을 위한 테이블 생성

테이블 타입관리 UI와 동일한 방식으로 생성됩니다.

생성되는 테이블

테이블명	설명	용도
inventory_stock	재고 현황	품목+로트별 현재 재고 상태
inventory_history	재고 이력	입출고 트랜잭션 기록

---

테이블 타입관리 UI 방식 특징

1. 기본 컬럼 자동 포함: id, created_date, updated_date, writer, company_code
2. 데이터 타입 통일: 날짜는 TIMESTAMP, 나머지는 VARCHAR(500)
3. 메타데이터 등록:
   • table_labels: 테이블 정보
   • column_labels: 컬럼 정보 (라벨, input_type, detail_settings)
   • table_type_columns: 회사별 컬럼 타입 정보

---

테이블 구조

1. inventory_stock (재고 현황)

컬럼명	타입	input_type	설명
id	VARCHAR(500)	text	PK (자동생성)
created_date	TIMESTAMP	date	생성일시
updated_date	TIMESTAMP	date	수정일시
writer	VARCHAR(500)	text	작성자
company_code	VARCHAR(500)	text	회사코드
item_code	VARCHAR(500)	text	품목코드
lot_number	VARCHAR(500)	text	로트번호
warehouse_id	VARCHAR(500)	entity	창고 (FK → warehouse_info)
location_code	VARCHAR(500)	text	위치코드
current_qty	VARCHAR(500)	number	현재고량
safety_qty	VARCHAR(500)	number	안전재고
last_in_date	TIMESTAMP	date	최종입고일
last_out_date	TIMESTAMP	date	최종출고일

2. inventory_history (재고 이력)

컬럼명	타입	input_type	설명
id	VARCHAR(500)	text	PK (자동생성)
created_date	TIMESTAMP	date	생성일시
updated_date	TIMESTAMP	date	수정일시
writer	VARCHAR(500)	text	작성자
company_code	VARCHAR(500)	text	회사코드
stock_id	VARCHAR(500)	text	재고ID (FK)
item_code	VARCHAR(500)	text	품목코드
lot_number	VARCHAR(500)	text	로트번호
transaction_type	VARCHAR(500)	code	구분 (IN/OUT)
transaction_date	TIMESTAMP	date	일자
quantity	VARCHAR(500)	number	수량
balance_qty	VARCHAR(500)	number	재고량
manager_id	VARCHAR(500)	text	담당자ID
manager_name	VARCHAR(500)	text	담당자명
remark	VARCHAR(500)	text	비고
reference_type	VARCHAR(500)	text	참조문서유형
reference_id	VARCHAR(500)	text	참조문서ID
reference_number	VARCHAR(500)	text	참조문서번호

---

실행 방법

Docker 환경 (권장)

# 재고 현황 테이블
docker exec -i erp-node-db-1 psql -U postgres -d ilshin < db/migrations/063_create_inventory_stock.sql

# 재고 이력 테이블
docker exec -i erp-node-db-1 psql -U postgres -d ilshin < db/migrations/064_create_inventory_history.sql

로컬 PostgreSQL

psql -U postgres -d ilshin -f db/migrations/063_create_inventory_stock.sql
psql -U postgres -d ilshin -f db/migrations/064_create_inventory_history.sql

pgAdmin / DBeaver

1. 각 SQL 파일 열기
2. 전체 내용 복사
3. SQL 쿼리 창에 붙여넣기
4. 실행 (F5 또는 Execute)

---

검증 방법

1. 테이블 생성 확인

SELECT table_name 
FROM information_schema.tables 
WHERE table_name IN ('inventory_stock', 'inventory_history');

2. 메타데이터 등록 확인

-- table_labels
SELECT * FROM table_labels WHERE table_name IN ('inventory_stock', 'inventory_history');

-- column_labels
SELECT table_name, column_name, column_label, input_type, display_order 
FROM column_labels 
WHERE table_name IN ('inventory_stock', 'inventory_history') 
ORDER BY table_name, display_order;

-- table_type_columns
SELECT table_name, column_name, company_code, input_type, display_order 
FROM table_type_columns 
WHERE table_name IN ('inventory_stock', 'inventory_history') 
ORDER BY table_name, display_order;

3. 샘플 데이터 확인

-- 재고 현황
SELECT * FROM inventory_stock WHERE company_code = 'WACE';

-- 재고 이력
SELECT * FROM inventory_history WHERE company_code = 'WACE' ORDER BY transaction_date;

---

화면에서 사용할 조회 쿼리 예시

재고 현황 그리드 (좌측)

SELECT 
    s.item_code,
    i.item_name,
    i.size as specification,
    i.unit,
    s.lot_number,
    w.warehouse_name,
    s.location_code,
    s.current_qty::numeric as current_qty,
    s.safety_qty::numeric as safety_qty,
    CASE 
        WHEN s.current_qty::numeric < s.safety_qty::numeric THEN '부족'
        WHEN s.current_qty::numeric > s.safety_qty::numeric * 2 THEN '과다'
        ELSE '정상'
    END AS stock_status,
    s.last_in_date,
    s.last_out_date
FROM inventory_stock s
LEFT JOIN item_info i ON s.item_code = i.item_number AND s.company_code = i.company_code
LEFT JOIN warehouse_info w ON s.warehouse_id = w.id
WHERE s.company_code = 'WACE'
ORDER BY s.item_code, s.lot_number;

재고 이력 패널 (우측)

SELECT 
    h.transaction_type,
    h.transaction_date,
    h.quantity,
    h.balance_qty,
    h.manager_name,
    h.remark
FROM inventory_history h
WHERE h.item_code = 'A001' 
  AND h.lot_number = 'LOT-2024-001'
  AND h.company_code = 'WACE'
ORDER BY h.transaction_date DESC, h.created_date DESC;

---

데이터 흐름

[입고 발생]
    │
    ├─→ inventory_history에 INSERT (+수량, 잔량)
    │
    └─→ inventory_stock에 UPDATE (current_qty 증가, last_in_date 갱신)

[출고 발생]
    │
    ├─→ inventory_history에 INSERT (-수량, 잔량)
    │
    └─→ inventory_stock에 UPDATE (current_qty 감소, last_out_date 갱신)

---

롤백 방법 (문제 발생 시)

-- 테이블 삭제
DROP TABLE IF EXISTS inventory_history;
DROP TABLE IF EXISTS inventory_stock;

-- 메타데이터 삭제
DELETE FROM column_labels WHERE table_name IN ('inventory_stock', 'inventory_history');
DELETE FROM table_labels WHERE table_name IN ('inventory_stock', 'inventory_history');
DELETE FROM table_type_columns WHERE table_name IN ('inventory_stock', 'inventory_history');

---

관련 테이블 (마스터 데이터)

테이블	역할	연결 컬럼
item_info	품목 마스터	item_number
warehouse_info	창고 마스터	id
warehouse_location	위치 마스터	location_code

---

작성일: 2025-12-09
영향 범위: 재고 관리 시스템
생성 방식: 테이블 타입관리 UI와 동일