시골약사
831584f752
- 입고장 → 입고 라인 → LOT 생성 프로세스 명시 - inventory_lots 직접 INSERT 금지 규칙 - 재고 계산 모드별 설명 - 데이터베이스 구조 및 흐름도 추가 - 개발 시 주의사항 정리 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
123 lines
3.1 KiB
Markdown
123 lines
3.1 KiB
Markdown
# 한약 재고관리 시스템 - 개발 가이드라인
|
|
|
|
## 📋 테스트 데이터 입력 규칙
|
|
|
|
### 🔴 중요: 입고 테스트 시 필수 준수사항
|
|
|
|
**모든 재고 입고 테스트는 반드시 다음 프로세스를 따라야 합니다:**
|
|
|
|
1. **입고장 생성 (purchase_receipts)**
|
|
- 공급업체, 날짜, 총액 등 기본 정보 등록
|
|
- VAT 포함/미포함 구분
|
|
|
|
2. **입고 라인 생성 (purchase_receipt_lines)**
|
|
- 각 약재별 상세 입고 정보
|
|
- 수량, 단가, 원산지 등 기록
|
|
|
|
3. **재고 LOT 자동 생성 (inventory_lots)**
|
|
- 입고 라인에 따라 자동으로 LOT 생성
|
|
- `receipt_line_id`로 입고장과 연결
|
|
- 재고 추적 및 이력 관리
|
|
|
|
### ❌ 금지사항
|
|
- inventory_lots 테이블에 직접 데이터 INSERT 금지
|
|
- 입고장 없이 재고만 추가하는 것은 테스트 목적 외 금지
|
|
|
|
### ✅ 올바른 예시
|
|
|
|
```python
|
|
# 1. 입고장 생성
|
|
INSERT INTO purchase_receipts (supplier_id, receipt_date, receipt_no, ...)
|
|
VALUES (1, '2024-02-18', 'PR-20240218-001', ...);
|
|
|
|
# 2. 입고 라인 추가
|
|
INSERT INTO purchase_receipt_lines (receipt_id, herb_item_id, quantity_g, ...)
|
|
VALUES (1, 47, 1000, ...);
|
|
|
|
# 3. LOT은 자동 생성되거나 트리거로 처리
|
|
INSERT INTO inventory_lots (receipt_line_id, ...) # receipt_line_id 필수!
|
|
```
|
|
|
|
### 📌 특수 케이스
|
|
|
|
**입고장 없는 재고 테스트가 필요한 경우:**
|
|
- `receipt_line_id = 0` 사용 (입고장 없음 표시)
|
|
- 반드시 테스트 완료 후 삭제 또는 원복
|
|
- 실제 운영 환경에서는 사용 금지
|
|
|
|
---
|
|
|
|
## 🗂️ 데이터베이스 구조
|
|
|
|
### 핵심 테이블 관계
|
|
```
|
|
purchase_receipts (입고장)
|
|
↓
|
|
purchase_receipt_lines (입고 상세)
|
|
↓
|
|
inventory_lots (재고 LOT) - receipt_line_id로 연결
|
|
↓
|
|
compound_consumptions (소비 내역)
|
|
```
|
|
|
|
### 재고 계산 방식
|
|
|
|
1. **전체 재고 (all)**
|
|
- 모든 LOT 포함
|
|
- `receipt_line_id = 0` 포함
|
|
|
|
2. **입고장 기준 (receipt_only)**
|
|
- `receipt_line_id > 0`인 LOT만
|
|
- 정식 입고된 재고만 계산
|
|
|
|
3. **검증된 재고 (verified)**
|
|
- 현재는 입고장 기준과 동일
|
|
- 향후 별도 검증 플래그 추가 예정
|
|
|
|
---
|
|
|
|
## 🔄 재고 흐름
|
|
|
|
```mermaid
|
|
graph LR
|
|
A[입고장 등록] --> B[입고 라인 생성]
|
|
B --> C[LOT 자동 생성]
|
|
C --> D[재고 보유]
|
|
D --> E1[복합제 소비]
|
|
D --> E2[처방 출고]
|
|
D --> E3[재고 보정]
|
|
```
|
|
|
|
---
|
|
|
|
## 💡 개발 시 주의사항
|
|
|
|
1. **재고 자산 계산**
|
|
- 효능 태그 JOIN 시 중복 주의
|
|
- GROUP BY 전에 DISTINCT 사용
|
|
- 태그는 별도 쿼리로 조회 권장
|
|
|
|
2. **LOT 관리**
|
|
- receipt_line_id는 NOT NULL 제약
|
|
- 0 = 입고장 없음 (특수 케이스)
|
|
- NULL 사용 불가
|
|
|
|
3. **단가 처리**
|
|
- 입고 시점 단가 저장
|
|
- 출고 시 LOT의 단가 사용
|
|
- 가중평균 계산 시 주의
|
|
|
|
---
|
|
|
|
## 📝 테스트 체크리스트
|
|
|
|
- [ ] 입고장 생성 확인
|
|
- [ ] 입고 라인과 LOT 연결 확인
|
|
- [ ] 재고 자산 계산 정확성
|
|
- [ ] 소비 후 재고 차감 확인
|
|
- [ ] 재고 보정 처리 확인
|
|
|
|
---
|
|
|
|
*Last Updated: 2024-02-18*
|
|
*작성자: Claude & User* |