# 동물약 복약안내문 마스터 템플릿 설계

> 작성일: 2026-03-18
> 목표: 골든패턴 문서를 기반으로 규격화된 복약안내문 구조 설계

---

## 1. 문제점 분석

### 현재 골든패턴 데이터의 한계

| 문제 | 원인 | 해결 방향 |
|------|------|---------|
| 필드 불일치 | 문서마다 포함 정보가 다름 | **필수 필드 규격화** |
| 복약안내용 아님 | 전문가 참고용으로 작성됨 | **보호자용 언어로 재가공** |
| 시각화 부재 | 텍스트 위주 | **구충범위표, 용량표 시각화** |
| 카테고리별 차이 | 구충제 vs NSAIDs 표현 방식 다름 | **카테고리별 템플릿 분리** |

---

## 2. 카테고리별 템플릿 설계

### 2-1. 구충제 (Antiparasitic) 템플릿

**핵심 표현 요소:**
- 🎯 **구충 범위표** (가장 중요!)
- 📅 투약 주기
- ⚖️ 체중별 제품 선택
- ⚠️ 주의사항 + 갭(Gap) 보완 안내

```
┌─────────────────────────────────────────────────────┐
│  [제품 사진]   넥스가드 스펙트라                      │
│               Afoxolaner + Milbemycin Oxime         │
│               [구충제] [경구] [개 전용]              │
├─────────────────────────────────────────────────────┤
│  🎯 구충 범위                                        │
│  ┌────────────────────────────────────────────┐    │
│  │ 벼룩        ✅ │ 심장사상충   ✅ │ 회충 ✅  │    │
│  │ 진드기      ✅ │ 구충        ✅ │ 편충 ✅  │    │
│  │ 모낭충      ✅ │ 조충(촌충)  ❌ │         │    │
│  └────────────────────────────────────────────┘    │
│                                                     │
│  📅 투약 주기: 매월 1회 (연중)                       │
│                                                     │
│  ⚖️ 체중별 선택                                     │
│  XS(2-3.5kg) | S(3.6-7.5kg) | M(7.6-15kg) | ...   │
│                                                     │
│  ⚠️ 주의사항                                        │
│  • 경련/간질 이력 → 수의사 상담 필수                 │
│  • 투약 전 심장사상충 검사 필수                      │
│  • 8주 미만, 2kg 미만 금지                          │
│                                                     │
│  💡 조충 보완: 안텔민 3개월마다 추가                 │
└─────────────────────────────────────────────────────┘
```

### 2-2. 진통소염제 (NSAIDs) 템플릿

**핵심 표현 요소:**
- 📋 적응증 (어디에 쓰는 약인지)
- ⚖️ **체중별 용량표** (가장 중요!)
- 🚫 **절대 금기** (강조)
- 📊 모니터링 필요 안내

```
┌─────────────────────────────────────────────────────┐
│  [제품 사진]   아시카프 츄어블정                     │
│               Carprofen 50mg                        │
│               [진통소염제] [경구] [개 전용]          │
├─────────────────────────────────────────────────────┤
│  📋 적응증                                          │
│  관절염, 수술 후 통증, 근골격계 염증                 │
│                                                     │
│  ⚖️ 용법용량 (4.4mg/kg 1일 1회)                     │
│  ┌────────────────────────────────────────────┐    │
│  │ 체중 5kg   → 0.5정 │ 체중 10kg → 1정      │    │
│  │ 체중 15kg  → 1.5정 │ 체중 20kg → 2정      │    │
│  └────────────────────────────────────────────┘    │
│                                                     │
│  🚫 절대 금기                                       │
│  ┌────────────────────────────────────────────┐    │
│  │ ❌ 고양이 사용 금지 (치명적 독성)           │    │
│  │ ❌ 스테로이드 병용 금지 (위장관 천공)       │    │
│  │ ❌ 다른 NSAIDs 병용 금지                    │    │
│  └────────────────────────────────────────────┘    │
│                                                     │
│  ⚠️ 주의사항                                        │
│  • 위장관 부작용 (구토, 흑색변) 시 즉시 중단        │
│  • 장기 투여 시 3~6개월마다 혈액검사 권장           │
│  • 임신/수유 중 투여 주의                           │
└─────────────────────────────────────────────────────┘
```

---

## 3. 규격화된 JSON 스키마

### 3-1. 공통 필드

```json
{
  "product_id": "필수 - 고유 ID",
  "apc_code": "필수 - APC 코드",
  "name": "필수 - 제품명",
  "english_name": "필수 - 영문명/성분명",
  "manufacturer": "선택 - 제조사",
  "category": "필수 - 카테고리 (antiparasitic/nsaid/antibiotic/...)",
  "target_animal": "필수 - 대상동물 배열",
  "administration": "필수 - 투여경로 (경구/외용/주사)",
  "image_url": "선택 - 제품 이미지",
  
  "indication": "필수 - 적응증 (한 줄 요약)",
  "dosage_summary": "필수 - 용법용량 요약",
  "dosage_table": "조건부 - 체중별 용량표 (NSAIDs용)",
  
  "warnings": "필수 - 주의사항 배열",
  "contraindications": "필수 - 금기사항 배열",
  "side_effects": "선택 - 부작용",
  
  "storage": "선택 - 보관방법",
  "source": "선택 - 출처"
}
```

### 3-2. 구충제 전용 필드

```json
{
  "coverage": {
    "fleas": true,
    "ticks": true,
    "heartworm": true,
    "roundworm": true,
    "hookworm": true,
    "whipworm": true,
    "tapeworm": false,
    "demodex": true,
    "ear_mites": false
  },
  "coverage_gap": "조충 미커버 - Praziquantel 필요",
  "supplement_recommendation": "안텔민 3개월마다",
  "dosing_interval": "매월 1회",
  "weight_products": [
    {"name": "XS", "weight_range": "2-3.5kg", "price": "16000"},
    {"name": "S", "weight_range": "3.6-7.5kg", "price": "17000"}
  ]
}
```

### 3-3. NSAIDs 전용 필드

```json
{
  "dosage_per_kg": "4.4mg/kg",
  "dosage_frequency": "1일 1회 또는 2.2mg/kg 1일 2회",
  "dosage_table": [
    {"weight": "5kg", "dose": "0.5정"},
    {"weight": "10kg", "dose": "1정"},
    {"weight": "15kg", "dose": "1.5정"},
    {"weight": "20kg", "dose": "2정"}
  ],
  "absolute_contraindications": [
    "고양이 사용 금지",
    "스테로이드 병용 금지",
    "다른 NSAIDs 병용 금지"
  ],
  "monitoring_required": true,
  "monitoring_interval": "3~6개월마다 혈액검사"
}
```

---

## 4. 마스터 목업 2종

### 4-1. 넥스가드 스펙트라 (구충제 마스터)

선정 이유:
- 올인원 구충제로 구충범위 시각화 적합
- 조충 갭이 있어 보완 안내 표현 가능
- 체중별 제품 라인업 표현 가능
- FDA 경고 등 주의사항 풍부

### 4-2. 아시카프 (NSAIDs 마스터)

선정 이유:
- 체중별 용량 계산 필요
- 절대 금기 3가지 명확
- 모니터링 안내 필요
- 일반적인 약품 카드 구조 대표

---

## 5. 다음 단계

1. **마스터 JSON 2개 작성** (nexgard_spectra_master.json, asikaff_master.json)
2. **HTML 템플릿 개선** - 카테고리별 레이아웃 분기
3. **PDF 렌더링 테스트**
4. **MCP 연동 기획** - 새 약품 추가 시 규격화된 JSON 생성

---

## 6. 향후 MCP 생성 프롬프트 (예시)

```
동물약 복약안내 JSON 생성

[제품명]: 넥스가드 스펙트라
[카테고리]: antiparasitic

다음 규격에 맞춰 JSON을 생성하세요:
1. coverage: 각 기생충별 커버 여부 (true/false)
2. coverage_gap: 미커버 항목과 보완 방법
3. dosing_interval: 투약 주기
4. weight_products: 체중별 제품 라인업
5. warnings: 보호자용 언어로 주의사항 3~5개
6. contraindications: 금기사항

출력: JSON 형식
```