animal-medication-api/docs/MASTER_TEMPLATE_DESIGN.md

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

작성일: 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. 공통 필드

{
  "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. 구충제 전용 필드

{
  "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 전용 필드

{
  "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 형식