feat: 애니팜 투약지도서 API 및 마스터 데이터 업데이트

- anipharm_api.py: 동물약 PDF 생성 API 추가
- data/master/*.json: 16종 마스터 데이터 업데이트
- templates: medication_guide_v2, 로고 추가
- docs: AI 매핑 아키텍처, API 스펙 문서
- .gitignore: _dev_scripts/, *.db 제외 추가

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

data/master/tiergard.json

@@ -1,50 +1,393 @@
 {
   "product_id": "MASTER-015",
-  "apc_code": "0231089400001",
+  "apc_code": "0231089420409",
   "name": "티어가드 정",
   "english_name": "TierGard (Tylosin tartrate)",
-  "manufacturer": "국내",
+  "name_meaning": "Tier(동물) + Guard(보호) — 동물 안구·피부 감염 보호",
+  "manufacturer": "(주)이엘티사이언스",
+  "country": "한국",
+  "global_status": "한국 독자 허가 제품 (글로벌 개용 60mg 정제 시판 없음)",
+  "approval_date": "2013-03-20",
+  "approval_number": "159",
   "category": "antibiotic",
   "category_display": "항생제 (마크롤라이드계)",
-  "target_animal": ["개"],
+  "target_animal": [
+    "개"
+  ],
   "administration": "경구 (정제)",
-
-  "indication": "결막염, 눈물 자국(세균성), 농피증 치료",
-  
+  "indication": "포도상구균·연쇄상구균에 의한 결막염, 농피증 치료",
   "mechanism": {
-    "drug_class": "마크롤라이드계 항생제 (16원환)",
-    "action": "세균 50S 리보솜 결합 → 단백 합성 억제",
-    "spectrum": "포도상구균, 연쇄상구균, 마이코플라즈마"
+    "drug_class": "마크롤라이드계 항생제 (16원환 Macrolide)",
+    "action": "세균 50S 리보솜 결합 → 단백 합성 억제 → 정균 작용",
+    "spectrum": {
+      "covered": [
+        "Staphylococcus pseudintermedius",
+        "Staphylococcus aureus",
+        "Streptococcus spp.",
+        "Mycoplasma spp."
+      ],
+      "not_covered": [
+        "Pseudomonas aeruginosa",
+        "E. coli",
+        "Proteus spp.",
+        "진균류"
+      ],
+      "susceptibility_rate": "82.61% (항생제 미노출 S. pseudintermedius, PMID: 20960412)"
+    },
+    "tear_staining_mechanism": {
+      "description": "세균성 분비물 감소 + 마크롤라이드 항염증 효과 복합 작용",
+      "pathway": [
+        "내안각·결막 세균 (S. pseudintermedius, Mycoplasma 등)",
+        "타일로신 → 세균 50S 리보솜 결합 → 단백 합성 억제",
+        "세균 부하 감소",
+        "결막·비루관 주변 만성 염증 감소 + 세균성 분비물 감소",
+        "눈물관 주변 환경 개선",
+        "포르피린 착색 유발 삼출물 감소",
+        "눈물 자국 완화 (수주 이상 소요)"
+      ],
+      "limitation": "이미 착색된 털은 항생제로 탈색 불가 — 새 털이 자라면서 교체됨"
+    },
+    "porphyrin_explanation": {
+      "what": "혈액 속 헤모글로빈의 헴(heme) 합성 과정에서 생성되는 대사산물",
+      "why_staining": "눈물에 과도하게 분비되면 흰 털에 갈색-적갈색 얼룩",
+      "why_darkens": "빛(자외선)에 노출되면 산화되어 색이 짙어짐",
+      "note": "포르피린 자체는 무해하나 미용적으로 문제"
+    }
   },
-
   "dosage": {
-    "standard": "10~20mg/kg 1일 2회",
-    "duration": "4주간",
-    "note": "소형견(말티즈·비숑) 주 사용"
+    "standard": "20mg/kg (타일로신 기준)",
+    "approved_range": "10~20mg/kg (한국 허가사항)",
+    "confirmed_dose": "20mg/kg bid (임상 근거 확정)",
+    "frequency": "1일 2회 (12시간 간격)",
+    "duration": "4주 (한국 허가사항)",
+    "with_food": "권장 (위장관 자극 최소화)",
+    "note": "반감기 54분으로 짧아 1일 2회 투여 필수"
   },
-
   "dosage_table": [
-    {"weight": "2kg", "dose": "40mg", "tablets": "20mg × 2정"},
-    {"weight": "3kg", "dose": "60mg", "tablets": "60mg × 1정"},
-    {"weight": "5kg", "dose": "100mg", "tablets": "60mg × 1.7정"},
-    {"weight": "10kg", "dose": "200mg", "tablets": "200mg × 1정"},
-    {"weight": "15kg", "dose": "300mg", "tablets": "200mg × 1.5정"}
+    {
+      "weight": "2kg",
+      "dose": "40mg",
+      "tablets": "20mg × 2정"
+    },
+    {
+      "weight": "3kg",
+      "dose": "60mg",
+      "tablets": "60mg × 1정",
+      "breed_example": "말티즈·요크셔"
+    },
+    {
+      "weight": "5kg",
+      "dose": "100mg",
+      "tablets": "60mg × 1.5~2정",
+      "breed_example": "푸들·비숑"
+    },
+    {
+      "weight": "6kg",
+      "dose": "120mg",
+      "tablets": "60mg × 2정",
+      "breed_example": "시추·페키니즈"
+    },
+    {
+      "weight": "9kg",
+      "dose": "180mg",
+      "tablets": "60mg × 3정",
+      "breed_example": "코커스패니얼"
+    },
+    {
+      "weight": "10kg",
+      "dose": "200mg",
+      "tablets": "200mg × 1정",
+      "note": "중형견 경계"
+    },
+    {
+      "weight": "15kg",
+      "dose": "300mg",
+      "tablets": "200mg × 1.5정"
+    },
+    {
+      "weight": "20kg",
+      "dose": "400mg",
+      "tablets": "200mg × 2정"
+    }
   ],
-
-  "available_strengths": ["20mg", "60mg", "200mg"],
-
+  "available_strengths": [
+    "20mg",
+    "60mg",
+    "200mg"
+  ],
+  "strength_recommendation": {
+    "small_dog": "60mg 정이 가장 실용적 (3~6kg 소형견)",
+    "medium_large": "10kg 이상은 200mg 정 전환 권장"
+  },
+  "treatment_timeline": {
+    "description": "효과가 나타나는 시기 (눈물자국 기준)",
+    "phases": [
+      {
+        "week": "1~2주",
+        "expected": "결막 충혈·분비물 감소 (세균성인 경우)"
+      },
+      {
+        "week": "2~3주",
+        "expected": "눈물 분비량 감소 시작"
+      },
+      {
+        "week": "4주",
+        "expected": "눈물 자국 색이 옅어지기 시작"
+      },
+      {
+        "week": "4주 이후",
+        "expected": "새 털이 자라면서 착색 털 교체 (트리밍 병행)"
+      }
+    ],
+    "realistic_expectation": "효과를 눈으로 확인하려면 최소 4~8주 소요",
+    "important_note": "이미 착색된 털은 항생제로 탈색되지 않음"
+  },
+  "follow_up_points": {
+    "description": "4주 복용 후 경과 관찰 포인트",
+    "checkpoints": [
+      {
+        "timing": "2주차",
+        "items": [
+          "병변 면적 감소 확인",
+          "눈물 분비량 변화",
+          "새 병변 발생 여부"
+        ]
+      },
+      {
+        "timing": "4주차",
+        "items": [
+          "완치 여부 판단",
+          "추가 연장 필요성 결정",
+          "착색 털 트리밍 권고"
+        ]
+      },
+      {
+        "timing": "치료 완료 후",
+        "items": [
+          "근본 원인(알레르기·구조적) 교정 여부 확인",
+          "재발 모니터링"
+        ]
+      }
+    ],
+    "treatment_failure_signs": [
+      "2주 투여 후 뚜렷한 개선 없음 → 감수성 재검",
+      "반복 재발 (3개월 내) → 원인 감별 + 배양 검사",
+      "MRSP 의심 → 다약제 내성 확인"
+    ]
+  },
+  "relapse_prevention": {
+    "description": "재발 방지 관리법",
+    "daily_care": [
+      {
+        "action": "외안각 세정",
+        "detail": "매일 생리식염수나 안과용 세정제로 내안각(눈물 고이는 부분) 닦기"
+      },
+      {
+        "action": "물 관리",
+        "detail": "정수 또는 생수 사용 (철분 포함 수돗물은 포르피린 착색 악화 가능)"
+      },
+      {
+        "action": "미용 관리",
+        "detail": "착색된 털은 정기적으로 트리밍"
+      }
+    ],
+    "dietary_management": {
+      "principle": "알레르기 원인 제거",
+      "recommendation": "첨가물 없는 단순 식이로 변경 검토"
+    },
+    "root_cause_correction": {
+      "importance": "근본 원인 미교정 시 치료 중단 후 재발 빈번",
+      "causes_to_address": [
+        "비루관 협착",
+        "삼모증",
+        "안검 내번",
+        "알레르기"
+      ],
+      "warning": "마크롤라이드 100일 이상 장기 투여 시 내성균 선택 위험 (PMID: 32109782)"
+    },
+    "relapse_rate": "28.6% (3개월 내, PMID: 7994702)"
+  },
+  "concurrent_treatments": {
+    "description": "병행 시술 안내",
+    "structural_causes": {
+      "conditions": [
+        "비루관 협착·폐쇄",
+        "속눈썹 이상(삼모증)",
+        "안검 내번"
+      ],
+      "treatment": "수의안과 전문 처치/수술 필요",
+      "note": "구조적 원인은 항생제로 해결 불가"
+    },
+    "nasolacrimal_flushing": {
+      "description": "비루관 세척",
+      "purpose": "비루관 협착 예방 및 눈물 배출 개선",
+      "frequency": "수의사가 주기적으로 시행",
+      "when_needed": "비루관 폐쇄 의심 시, 반복적 눈물 과다 시"
+    },
+    "topical_treatments": {
+      "eye_cleaning": "안과용 세정제로 외안부 세정 병행",
+      "note": "전신 항생제 + 국소 관리 병행 시 효과 극대화"
+    }
+  },
+  "tear_staining_info": {
+    "description": "눈물자국(Tear Staining) 상세 정보",
+    "causes_multifactorial": {
+      "bacterial": {
+        "role": "내안각 만성 세균 감염 → 분비물 증가",
+        "tylosin_helps": true
+      },
+      "structural": {
+        "conditions": [
+          "비루관 협착·폐쇄",
+          "삼모증",
+          "안검 내번"
+        ],
+        "tylosin_helps": false,
+        "treatment": "수술/시술 필요"
+      },
+      "allergic": {
+        "conditions": [
+          "음식 알레르기",
+          "환경 알레르기"
+        ],
+        "tylosin_helps": false,
+        "treatment": "원인 제거 필요"
+      },
+      "dietary": {
+        "issue": "포르피린 전구체 함유 식품 과다",
+        "tylosin_helps": false
+      },
+      "breed_predisposition": {
+        "issue": "단두형 안구 돌출, 얕은 안와",
+        "tylosin_helps": false,
+        "note": "해부학적 한계"
+      }
+    },
+    "high_risk_breeds": [
+      {
+        "breed": "말티즈",
+        "reason": "흰 털 + 비루관 저형성 빈번"
+      },
+      {
+        "breed": "비숑 프리제",
+        "reason": "흰 털 + 내안각 삼모증"
+      },
+      {
+        "breed": "토이·미니어처 푸들",
+        "reason": "흰 털 개체에서 두드러짐"
+      },
+      {
+        "breed": "시추",
+        "reason": "안검불완전폐쇄 82%, 삼모증 100%, TBUT 4초"
+      },
+      {
+        "breed": "퍼그·페키니즈·불독",
+        "reason": "단두형 안구 돌출"
+      }
+    ],
+    "key_message": "타일로신은 세균성 원인에만 작용. 구조적·알레르기성 원인 먼저 교정해야 효과 극대화"
+  },
+  "pharmacokinetics": {
+    "t_half": "54분 (IV, 개)",
+    "Vd": "1.7-2.0 L/kg (높음 → 조직 침투 우수)",
+    "primary_excretion": "담즙 (간→장), bile/serum ratio 1,230-3,780",
+    "renal_excretion": "극소량",
+    "accumulation": "없음 (29일, 2년 투여 확인)",
+    "bioavailability_im": "92.6%",
+    "clinical_implication": "반감기 매우 짧아 1일 2회 투여 필수"
+  },
+  "safety": {
+    "NOAEL_dog_2yr": "100 mg/kg/day",
+    "LD50_dog_oral": ">800 mg/kg",
+    "clinical_dose": "40 mg/kg/day (20mg/kg bid)",
+    "safety_margin": "2.5배 (NOAEL/임상용량)",
+    "liver_burden": "주 대사·배설 경로이나 100mg/kg/day까지 중대한 간 손상 없음",
+    "kidney_burden": "신장 배설 극소량 → 부담 매우 낮음",
+    "gi_side_effect": "일과성 위염 3.3% (30마리 중 1마리)",
+    "long_term_risk": "100일 이상 투여 시 마크롤라이드 내성균 선택 위험"
+  },
   "warnings": [
-    "⚠️ 세균성 원인에만 효과 (구조적·알레르기성 X)",
-    "⚠️ 비루관 협착 시 수술/시술 필요",
-    "⚠️ 4주 이상 투여 시 내성균 주의"
+    "⚠️ 세균성 원인에만 효과 (구조적·알레르기성 원인은 별도 처치 필요)",
+    "⚠️ 비루관 협착 시 수술/시술 필요 — 항생제로 해결 불가",
+    "⚠️ 이미 착색된 털은 탈색 불가 — 트리밍으로 제거",
+    "⚠️ 4주 이상 장기 투여 시 내성균 주의",
+    "⚠️ 식사와 함께 투여 (공복 시 위장관 자극 가능)"
+  ],
+  "contraindications": [
+    "❌ 마크롤라이드계 항생제 과민반응·쇼크 병력",
+    "❌ 린코사마이드계 항생제(린코마이신·클린다마이신) 동시 투여",
+    "❌ 다른 마크롤라이드 동시 투여",
+    "❌ 고양이 (개 전용 제품)",
+    "⚠️ 임신·수유 중 암캐 — 수의사 상담 후 결정"
   ],
-
   "clinical_notes": [
-    "눈물 자국: 세균 부하 감소 → 염증 감소 → 완화",
-    "포르피린 착색: 햇빛 노출 시 더 진해짐",
+    "눈물 자국: 세균 부하 감소 → 염증 감소 → 분비물 감소 → 완화",
+    "포르피린 착색: 햇빛 노출 시 더 진해짐 (실내견보다 야외 활동 많은 개에서 더 진함)",
     "구조적 원인 먼저 교정해야 효과 극대화",
-    "흰 털 품종(말티즈, 비숑)에서 눈물 자국 두드러짐"
+    "흰 털 품종(말티즈, 비숑)에서 눈물 자국 두드러짐",
+    "한국 독자 허가 — 글로벌에 개용 60mg 정제 없음"
   ],
-
-  "storage": "실온 보관"
-}
+  "patient_education_qa": [
+    {
+      "q": "왜 눈 밑이 갈색으로 얼룩져 있나요?",
+      "a": "눈물에 포르피린이라는 물질이 포함되어 있어요. 눈물이 흘러넘치면 털에 쌓이고, 빛에 의해 산화되면서 갈색으로 변합니다."
+    },
+    {
+      "q": "티어가드를 먹이면 눈물 자국이 없어지나요?",
+      "a": "이미 생긴 자국은 사라지지 않습니다. 세균성 원인을 억제해서 새로 자라는 털에 자국이 덜 생기게 합니다. 기존 착색 털은 트리밍으로 제거하세요."
+    },
+    {
+      "q": "효과는 언제 나타나나요?",
+      "a": "1~2주: 분비물 감소, 2~4주: 눈물량 감소, 4~8주: 새 털에서 자국 감소. 눈으로 확인하려면 최소 4~8주 소요됩니다."
+    },
+    {
+      "q": "4주 먹였는데 효과가 없어요",
+      "a": "두 가지를 확인하세요: 1) 구조적 원인(비루관 협착, 삼모증) → 수의안과 진찰 필요, 2) 타일로신 내성균 → 세균 배양·감수성 검사"
+    },
+    {
+      "q": "재발을 막으려면 계속 먹여야 하나요?",
+      "a": "근본 원인 미교정 시 재발합니다. 장기 투여(100일+)는 내성 위험이 있어 권장하지 않습니다. 일상 관리(외안각 세정, 물 관리, 트리밍)와 근본 원인 교정이 장기 해결책입니다."
+    },
+    {
+      "q": "간이나 신장에 부담이 큰 약인가요?",
+      "a": "담즙으로 배설되며 신장 부담은 매우 낮습니다. 2년 장기 시험에서 임상 용량의 2.5배까지 중대한 손상 없었습니다. 4주 투여 범위에서 안전합니다."
+    }
+  ],
+  "references": {
+    "korean_approval": "APDB 허가사항 (APC: 0231089400001, 허가번호: 159, 2013-03-20)",
+    "clinical_efficacy": [
+      "Scott et al. 1994 (PMID: 7994702) — 농피증 90.5% 성공률, n=21",
+      "Harvey 1996 (PMID: 8873399) — 표재성 농피증 80%, n=30",
+      "Scott BA et al. 2010 (PMID: 20960412) — In vitro 감수성 82.61%, n=103"
+    ],
+    "pk_safety": [
+      "Weisel et al. 1977 (PMID: 842925) — PK: t½ 54분, Vd 1.7L/kg",
+      "Kim et al. 2011 (PMID: 21068517) — IM 생체이용률 92.6%",
+      "JECFA/WHO 1991 — 개 2년 독성시험, NOAEL 100mg/kg/day"
+    ],
+    "pathogen_data": [
+      "Murphy et al. 1978 (PMID: 624664) — 결막염 원인균 (S. aureus 68%)",
+      "Casemiro et al. 2025 (PMID: 38768284) — 각막염 병원체",
+      "Cooper et al. 1993 (PMID: 8393208) — Mycoplasma 탁월한 활성"
+    ],
+    "resistance_data": [
+      "Kang et al. 2014 (PMID: 24690601) — 한국 MRSP 36%",
+      "Cazer et al. 2020 (PMID: 32109782) — 100일+ 투여 시 내성 증가"
+    ],
+    "tear_staining": [
+      "Sebbag & Sanchez 2023 (PMID: 36585820) — 단두형 안구 증후군 총설"
+    ]
+  },
+  "storage": "실온 보관, 직사광선 피함",
+  "last_updated": "2026-03-19",
+  "version": "2.0",
+  "source_documents": [
+    "tiergard_tylosin_conjunctivitis_tearstain_v3.md",
+    "tiergard_tylosin_pyoderma_v2.md"
+  ],
+  "indication_detail": {
+    "primary": "포도상구균·연쇄상구균에 의한 결막염, 농피증 치료",
+    "secondary": "세균성 눈물자국(tear staining) 완화 보조",
+    "note": "눈물자국 직접 치료 RCT 없음. 세균성 원인 있는 경우 임상적으로 사용됨."
+  }
+}