WMS
Tables (16)
allocation
- id — BIGINT — Primary key — NOT NULL
- delivery_order_item_id — BIGINT — Foreign key → delivery_order_item.id — NOT NULL — 출고지시 품목
- stock_id — BIGINT — Foreign key → stock.id — NOT NULL — 할당된 재고 행 (로케이션·소비기한은 stock 조인)
- allocated_qty — INT — NOT NULL — 할당수량
- pick_seq — INT — 피킹 순번 (피킹 시작 시 로케이션 코드 순으로 부여)
- picked_qty — INT — 피킹수량 (입력 전 NULL)
- short_qty — INT — NOT NULL — 결품수량 (2차)
- short_reason — VARCHAR(30) — 결품사유 (2차)
- status — VARCHAR(20) — NOT NULL — WAITING 대기 / PICKED 완료 / SHORT 결품 / CANCELED 취소
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시
delivery_order
- id — BIGINT — Primary key — NOT NULL
- do_no — VARCHAR(30) — NOT NULL — 출고지시번호 DO-20260919-001
- status — VARCHAR(20) — NOT NULL — CREATED / ALLOCATED / PICKING / PICKED / SHIPPED / CANCELED
- allocated_at — DATETIME — 할당 일시
- shipped_at — DATETIME — 출고확정 일시
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시
delivery_order_item
- id — BIGINT — Primary key — NOT NULL
- delivery_order_id — BIGINT — Foreign key → delivery_order.id — NOT NULL — 출고지시
- product_id — BIGINT — Foreign key → product.id — NOT NULL — 품목
- required_qty — INT — NOT NULL — 총 소요량 (묶인 주문들의 합)
- allocated_qty — INT — NOT NULL — 할당수량
- shipped_qty — INT — NOT NULL — 출고수량
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시
inspection
- id — BIGINT — Primary key — NOT NULL
- purchase_order_item_id — BIGINT — Foreign key → purchase_order_item.id — NOT NULL — 발주 품목
- expiry_date — DATE — NOT NULL — 소비기한 (관리 안 하는 품목은 9999-12-31)
- good_qty — INT — NOT NULL — 정상수량
- reject_qty — INT — NOT NULL — 불량수량
- reject_reason — VARCHAR(20) — DAMAGED 파손 / EXPIRY_SHORT 소비기한 부족
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시
location
- id — BIGINT — Primary key — NOT NULL
- zone_id — BIGINT — Foreign key → zone.id — NOT NULL — 구역
- location_code — VARCHAR(20) — NOT NULL — 로케이션코드 A-01-03-2 (구역-통로-베이-단). 1칸 = 표준 팔레트 1장 자리
- aisle — INT — NOT NULL — 통로 1~4
- bay — INT — NOT NULL — 베이 1~10
- shelf_level — INT — NOT NULL — 단 1~3 (1=바닥)
- is_active — CHAR(1) — NOT NULL — 사용여부
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시
order_item
- id — BIGINT — Primary key — NOT NULL
- order_id — BIGINT — Foreign key → orders.id — NOT NULL — 주문
- product_id — BIGINT — Foreign key → product.id — NOT NULL — 품목
- qty — INT — NOT NULL — 주문수량
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시
orders
- id — BIGINT — Primary key — NOT NULL
- order_no — VARCHAR(30) — NOT NULL — 주문번호 ORD-20260919-001
- ship_to_name — VARCHAR(100) — NOT NULL — 배송지명 (받는 곳)
- ship_to_address — VARCHAR(200) — NOT NULL — 배송지 주소
- ship_to_phone — VARCHAR(20) — 배송지 연락처
- requested_date — DATE — NOT NULL — 출고요청일
- status — VARCHAR(20) — NOT NULL — RECEIVED / ASSIGNED / SHIPPED / CANCELED
- delivery_order_id — BIGINT — Foreign key → delivery_order.id — 묶인 출고지시. 접수 상태면 NULL
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시
product
- id — BIGINT — Primary key — NOT NULL
- product_code — VARCHAR(20) — NOT NULL — 품목코드 SKU-10001
- product_name — VARCHAR(100) — NOT NULL — 품목명
- spec — VARCHAR(50) — 규격 500ml×20
- unit — VARCHAR(10) — NOT NULL — 재고 단위 EA / BOX
- is_expiry_managed — CHAR(1) — NOT NULL — 소비기한 관리 여부. N이면 소비기한을 9999-12-31로 저장
- min_ship_days — INT — NOT NULL — 출고허용 잔여일. 소비기한까지 이 일수보다 적게 남은 재고는 할당하지 않음
- pallet_qty — INT — NOT NULL — 팔레트 1장(= 로케이션 1칸)에 올릴 수 있는 최대 수량
- safety_stock — INT — NOT NULL — 안전재고 (2차)
- is_active — CHAR(1) — NOT NULL — 사용여부
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시
purchase_order
- id — BIGINT — Primary key — NOT NULL
- po_no — VARCHAR(30) — NOT NULL — 발주번호 PO-20260919-001
- supplier_name — VARCHAR(100) — NOT NULL — 공급처명 (거래처 테이블 없이 텍스트)
- expected_date — DATE — NOT NULL — 입고예정일
- status — VARCHAR(20) — NOT NULL — REGISTERED / INSPECTING / PUTAWAY / COMPLETED / CANCELED
- remark — VARCHAR(200) — 비고
- completed_at — DATETIME — 입고확정 일시
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시
purchase_order_item
- id — BIGINT — Primary key — NOT NULL
- purchase_order_id — BIGINT — Foreign key → purchase_order.id — NOT NULL — 발주
- product_id — BIGINT — Foreign key → product.id — NOT NULL — 품목
- expected_qty — INT — NOT NULL — 예정수량
- variance_reason — VARCHAR(20) — 차이사유 NOT_ARRIVED / WRONG_ITEM / ETC (검수 합계 < 예정일 때 필수)
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시
putaway
- id — BIGINT — Primary key — NOT NULL
- inspection_id — BIGINT — Foreign key → inspection.id — NOT NULL — 검수 결과
- location_id — BIGINT — Foreign key → location.id — NOT NULL — 적치 로케이션
- qty — INT — NOT NULL — 적치수량
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시
stock
- id — BIGINT — Primary key — NOT NULL
- product_id — BIGINT — Foreign key → product.id — NOT NULL — 품목
- location_id — BIGINT — Foreign key → location.id — NOT NULL — 로케이션
- expiry_date — DATE — NOT NULL — 소비기한
- on_hand_qty — INT — NOT NULL — 실물재고
- allocated_qty — INT — NOT NULL — 선점재고
- available_qty — INT — NOT NULL — 가용재고 (생성 컬럼, 직접 쓰지 않음)
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시
stock_history
- id — BIGINT — Primary key — NOT NULL
- stock_id — BIGINT — Foreign key → stock.id — NOT NULL — 재고 행
- product_id — BIGINT — NOT NULL — 품목 (복사값)
- location_id — BIGINT — NOT NULL — 로케이션 (복사값)
- expiry_date — DATE — NOT NULL — 소비기한 (복사값)
- tx_type — VARCHAR(20) — NOT NULL — INBOUND / ALLOCATE / DEALLOCATE / SHORTAGE / OUTBOUND / ADJUST
- on_hand_delta — INT — NOT NULL — 실물 증감
- allocated_delta — INT — NOT NULL — 선점 증감
- on_hand_after — INT — NOT NULL — 변경 후 실물
- allocated_after — INT — NOT NULL — 변경 후 선점
- ref_type — VARCHAR(20) — NOT NULL — PURCHASE_ORDER / DELIVERY_ORDER / ADJUSTMENT
- ref_id — BIGINT — 근거 문서 id (조정은 NULL)
- reason — VARCHAR(200) — 사유 (조정·결품 필수)
- created_by — VARCHAR(50) — 처리자
- created_at — DATETIME — NOT NULL — 발생일시
users
- id — BIGINT — Primary key — NOT NULL
- username — VARCHAR(50) — NOT NULL — 로그인 아이디
- password — VARCHAR(100) — NOT NULL — BCrypt 해시
- name — VARCHAR(50) — NOT NULL — 이름
- role — VARCHAR(20) — NOT NULL — ADMIN 관리자 / WORKER 작업자
- is_active — CHAR(1) — NOT NULL — 사용여부
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시
warehouse
- id — BIGINT — Primary key — NOT NULL
- warehouse_code — VARCHAR(10) — NOT NULL — 창고코드 WH-01
- warehouse_name — VARCHAR(50) — NOT NULL — 창고명
- address — VARCHAR(200) — 주소
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시
zone
- id — BIGINT — Primary key — NOT NULL
- warehouse_id — BIGINT — Foreign key → warehouse.id — NOT NULL — 창고
- zone_code — VARCHAR(10) — NOT NULL — 구역코드 A / B / C
- zone_name — VARCHAR(50) — NOT NULL — 구역명 (권장 용도일 뿐, 적치를 제한하지 않음)
- created_at — DATETIME — NOT NULL — 생성일시
- updated_at — DATETIME — NOT NULL — 수정일시