feat: 마스터 템플릿 설계 + 넥스가드/아시카프 마스터 JSON
This commit is contained in:
청춘약국
221
docs/MASTER_TEMPLATE_DESIGN.md
Normal file
221
docs/MASTER_TEMPLATE_DESIGN.md
Normal file
@@ -0,0 +1,221 @@
|
||||
# 동물약 복약안내문 마스터 템플릿 설계
|
||||
|
||||
> 작성일: 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 형식
|
||||
```
|
||||
Reference in New Issue
Block a user