S03 — 재고 수불원장 · 이동평균원가 · 실사조정
학습 목표
- "현재고 = 입출고 이력의 합"이라는 원장 사고방식을 익힌다.
- 이동평균원가를 반올림 오차 없이 구현한다.
- 실사 차이를 재고와 회계에 동시에 반영한다.
1. 이력(moves)과 집계(balances)
stock_moves: 모든 입출고 한 줄 한 줄. 진실의 원천, 추가만 함.stock_balances: (품목, 창고)별 현재 수량·금액. 매번 SUM 하면 느리니 유지하는 캐시.- 둘은 항상 같아야 합니다 → 제공 함수
verify_ledger()가 검사합니다.
2. 이동평균원가와 "금액으로 관리하기"
단가만 저장하면: 100원×3 + 101원×1 → 평균 100.25 → 반올림 100 → 4개 출고 시 400원, 1원 증발. 해법: 수량과 함께 재고금액(value) 을 관리하고, 출고원가 = 금액 × 출고수량 / 현재수량(반올림), 전량 출고 시 남은 금액 전부. → 재고가 0이 되면 금액도 정확히 0. 회계 1300(상품) 잔액과 영원히 일치합니다.
정수 반올림 공식: (a * b + c // 2) // c (a×b/c 를 반올림)
3. 실사조정
창고에서 세어 보니 장부 150개, 실물 148개 → 2개 감모.
재고: post_move(-2) → 출고원가 4,000원
분개: (차) 5200 재고감모손실 4,000 / (대) 1300 상품 4,000잉여(실물이 더 많음)는 현재 평균단가로 입고하고 반대 분개.
4. LAB (workspace/erp/inventory.py)
| 함수 | 요점 |
|---|---|
post_move | 0수량 금지, 입고 단가 필수, 출고 시 창고별 재고 부족 금지, 원가 계산, moves INSERT + balances UPSERT |
on_hand | 창고별 / 전체 합계 |
adjust_stock | 차이 계산 → 이동 + 분개, 0원이면 분개 생략 |
availability_label | 0 이하 → 임시품절 |
UPSERT 힌트:
INSERT INTO stock_balances(item_id, wh_id, qty, value) VALUES (?,?,?,?)
ON CONFLICT(item_id, wh_id) DO UPDATE SET qty = qty + excluded.qty, value = value + excluded.value5. 채점
python academy.py check S036. 심화 과제
- 창고 간 이동
transfer(item, from_wh, to_wh, qty): 출고원가 그대로 입고, 분개 없음(왜?). - 선입선출(FIFO) 원가로 바꾸면 무엇이 달라질까요? 원가층(cost layer) 테이블을 설계해 보세요.