S08 — 캡스톤: 로트·유통기한 관리와 FEFO
학습 목표
- 의약품·의료소모품 유통의 핵심 요구사항(로트 추적, 유통기한)을 스스로 모델링한다.
- 지금까지 배운 검증·트랜잭션·보고서 패턴을 새 모듈에 적용한다.
1. 왜 로트인가
같은 "KF94 마스크"라도 제조 로트마다 유통기한이 다릅니다. 리콜이 나면 "어떤 로트가 어느 약국에 갔는가"를 즉시 답해야 합니다.
FEFO (First-Expired, First-Out): 유통기한이 가장 빠른 로트부터 출고. 만료된 로트는 절대 출고하지 않습니다(당일까지는 가능).
2. LAB (workspace/erp/lots.py)
| 함수 | 요점 |
|---|---|
receive_lot | 날짜 형식, 양수 수량, 같은 로트면 누적·유통기한 불일치 금지 |
pick_fefo | 유효 로트(qty>0, expiry>=today)를 expiry→lot_no 순으로 할당, 부족하면 아무것도 차감 안 함 |
expiring | today+days 이내(이미 만료 포함) 로트, expired 플래그 |
3. 채점
python academy.py check S08
python academy.py status4. 캡스톤 확장 과제 (최소 1개, 테스트 직접 작성)
현재 lots 는 stock_balances 와 별개의 보조원장입니다. 실무 수준으로 통합해 보세요.
- 입고 통합:
receive_po의 receipts 를{sku: [(lot_no, expiry, qty), ...]}로 확장 → 재고와 로트 동시 입고. - 출고 통합:
ship_so가pick_fefo로 로트를 뽑고,so_lot_picks(so_line_id, lot_no, qty)에 기록. - 리콜 추적:
trace_lot(lot_no)→ 출고된 약국 목록과 수량. - 정합성:
verify_ledger에 "품목·창고별 로트 수량 합 == 현재고" 검사 추가. - 만료 폐기: 만료 로트 폐기 → 재고 출고 + (차)5200 / (대)1300.
테스트는 tests/test_s08_capstone_mine.py 처럼 새 파일로 쓰면 check S08 에 자동 포함됩니다.