kdrug-inventory-system/docs/복합_로트_사용_분석.md

# 복합 로트 사용 기능 구현 분석

## 1. 현재 시스템 구조

### 1.1 좋은 소식 - 이미 지원 가능한 구조
현재 `compound_consumptions` 테이블은 **이미 복합 로트를 지원할 수 있는 구조**입니다:

```sql
compound_consumptions (
    consumption_id INTEGER PRIMARY KEY,
    compound_id INTEGER,
    herb_item_id INTEGER,
    lot_id INTEGER,
    quantity_used REAL,
    unit_cost_per_g REAL,
    cost_amount REAL
)
```

**핵심 포인트:**
- 한 조제(`compound_id`)에서 같은 약재(`herb_item_id`)에 대해 여러 레코드 생성 가능
- 각 레코드는 다른 `lot_id`를 가질 수 있음
- 즉, **DB 구조 변경 없이** 복합 로트 사용 가능

### 1.2 현재 백엔드 로직
`app.py`의 조제 생성 로직을 보면:
```python
# 이미 FIFO 방식으로 여러 로트를 순차 소비하는 로직이 구현되어 있음
for lot in available_lots:
    lot_id = lot[0]
    available = lot[1]
    unit_price = lot[2]

    used = min(remaining_qty, available)

    # 각 로트별로 별도의 소비 레코드 생성
    cursor.execute("""
        INSERT INTO compound_consumptions (compound_id, herb_item_id, lot_id,
                                          quantity_used, unit_cost_per_g, cost_amount)
        VALUES (?, ?, ?, ?, ?, ?)
    """, (compound_id, herb_item_id, lot_id, used, unit_price, cost))
```

**즉, 백엔드는 이미 복합 로트를 지원하고 있습니다!**

## 2. 필요한 개선 사항

### 2.1 프론트엔드 UI/UX 개선
현재 문제는 **프론트엔드에서 복합 로트 선택을 지원하지 않는 것**입니다.

#### 현재 상태:
- 약재별로 "자동 선택" 또는 단일 원산지/로트만 선택 가능
- 수동으로 여러 로트를 조합할 수 없음

#### 개선 방안:
1. **자동 모드 (현재 구현됨)**
   - FIFO 방식으로 자동 할당
   - 재고가 부족하면 다음 로트에서 자동 보충

2. **수동 모드 (구현 필요)**
   - 약재별로 "로트 배분" 버튼 추가
   - 모달 창에서 사용 가능한 로트 목록 표시
   - 각 로트별 사용량 수동 입력
   - 예: 로트A 40g + 로트B 60g = 총 100g

### 2.2 API 개선
현재 API 구조:
```javascript
{
    "herb_item_id": 52,
    "grams_per_cheop": 4.8,
    "origin": "auto",  // 또는 특정 원산지
    "lot_assignments": []  // 현재 미사용
}
```

개선된 API 구조:
```javascript
{
    "herb_item_id": 52,
    "grams_per_cheop": 4.8,
    "origin": "auto" | "manual",
    "lot_assignments": [  // manual일 때 사용
        {"lot_id": 123, "quantity": 40},
        {"lot_id": 124, "quantity": 60}
    ]
}
```

## 3. 구현 방안

### 3.1 최소 변경 방안 (권장)
**DB 스키마 변경 없이** 프론트엔드와 백엔드 로직만 개선:

1. **백엔드 (app.py)**
   - `origin: "manual"`일 때 `lot_assignments` 배열 처리
   - 지정된 로트별로 소비 처리
   - 검증: 총량 일치 확인, 재고 충분 확인

2. **프론트엔드 (app.js)**
   - 로트 배분 모달 추가
   - 사용 가능 로트 목록 표시 (재고, 단가, 원산지 정보)
   - 로트별 사용량 입력 UI
   - 실시간 합계 및 검증

### 3.2 영향도 분석

#### 영향 없는 부분:
- ✅ DB 스키마 (변경 불필요)
- ✅ 재고 관리 로직
- ✅ 원가 계산 로직
- ✅ 입출고 원장
- ✅ 조제 내역 조회

#### 수정 필요한 부분:
- ⚠️ 조제 생성 API (`/api/compounds` POST)
- ⚠️ 프론트엔드 조제 화면
- ⚠️ 로트 가용성 확인 API (수동 모드 지원)

## 4. 구현 우선순위

### Phase 1: 백엔드 지원 (필수)
1. API에서 `lot_assignments` 처리 로직 추가
2. 수동 로트 배분 검증 로직
3. 트랜잭션 안전성 확보

### Phase 2: 프론트엔드 기본 (필수)
1. 로트 배분 모달 UI
2. 수동 입력 폼
3. 실시간 검증 및 피드백

### Phase 3: UX 개선 (선택)
1. 드래그 앤 드롭으로 로트 배분
2. 자동 최적화 제안 (단가 최소화, FIFO 등)
3. 로트 배분 히스토리 저장 및 재사용

## 5. 예상 시나리오

### 시나리오 1: 재고 부족으로 인한 복합 사용
- 감초 100g 필요
- 로트A(한국산): 40g 재고, 20원/g
- 로트B(중국산): 70g 재고, 15원/g
- 수동 배분: 로트A 40g + 로트B 60g

### 시나리오 2: 원가 최적화
- 당귀 100g 필요
- 로트A(구재고): 80g, 10원/g
- 로트B(신재고): 50g, 15원/g
- 원가 최적화: 로트A 80g + 로트B 20g

### 시나리오 3: 품질 균일성
- 인삼 100g 필요
- 같은 원산지의 다른 로트들 조합
- 품질 일관성 유지

## 6. 결론

**좋은 소식: 현재 시스템은 이미 복합 로트를 지원할 수 있는 구조입니다!**

- DB 스키마 변경 불필요
- 백엔드는 일부 로직 추가만 필요
- 주로 프론트엔드 UI/UX 개선이 필요

**구현 난이도: 중간**
- 기존 시스템에 미치는 영향 최소
- 점진적 구현 가능 (자동 모드는 이미 작동 중)
- 수동 모드는 선택적 기능으로 추가 가능