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/actibet.json

@@ -1,58 +1,386 @@
 {
   "product_id": "MASTER-016",
-  "apc_code": "0519-ACTIBET",
+  "apc_code": "9240043910403",
   "name": "액티벳정",
   "english_name": "Actibet (Amoxicillin + Clavulanate)",
   "manufacturer": "홍익메디케어",
   "category": "antibiotic",
   "category_display": "항생제 (β-Lactam)",
-  "target_animal": ["개", "고양이"],
+  "drug_class": "Aminopenicillin + β-Lactamase 억제제",
+  "ema_ameg_category": "D (Prudence) — 1차 선택 가능",
+  "who_classification": "CIA (Critically Important Antimicrobials) - High Priority",
+  "target_animal": [
+    "개",
+    "고양이"
+  ],
   "administration": "경구 (정제)",
-
-  "indication": "광범위 세균 감염 (피부, 호흡기, 요로, 치주)",
-  
+  "composition": {
+    "amoxicillin_mg": 40,
+    "potassium_clavulanate_mg": 10,
+    "ratio": "4:1",
+    "description": "아목시실린 40mg + 클라불란산칼륨 10mg (1정 기준)"
+  },
   "mechanism": {
-    "amoxicillin": "40mg - PBP 결합 → 세포벽 합성 억제 → 살균",
-    "clavulanate": "10mg - β-Lactamase 억제 → 내성균 커버 확장",
-    "ratio": "4:1 (Amoxicillin:Clavulanate)"
+    "amoxicillin": "세균 세포벽 합성 효소(PBP)에 결합 → Peptidoglycan 교차결합 억제 → 세포벽 파괴 → 살균",
+    "clavulanate": "β-Lactamase 효소에 비가역적 결합 → 아목시실린 분해 방지 → 내성균 커버 확장",
+    "killing_type": "살균성(bactericidal), 시간 의존적(time-dependent)",
+    "clinical_implication": "MIC 이상 농도 유지 시간이 효능 결정 → 1일 2회 분할 투여 필수"
+  },
+  "spectrum": {
+    "gram_positive_aerobic": [
+      "Staphylococcus pseudintermedius (MSSP)",
+      "Staphylococcus aureus (MSSA)",
+      "Streptococcus spp.",
+      "Enterococcus faecalis"
+    ],
+    "gram_negative_aerobic": [
+      "Escherichia coli",
+      "Proteus mirabilis",
+      "Klebsiella spp.",
+      "Pasteurella multocida"
+    ],
+    "anaerobes": [
+      "Bacteroides spp.",
+      "Fusobacterium spp.",
+      "Clostridium spp. (일부)"
+    ],
+    "resistant_organisms": [
+      "MRSP (메티실린 내성 S. pseudintermedius)",
+      "MRSA",
+      "Pseudomonas aeruginosa",
+      "Mycoplasma spp.",
+      "Bordetella bronchiseptica (일부)"
+    ]
+  },
+  "indications": {
+    "summary": "광범위 세균 감염 (피부, 요로, 호흡기, 연조직, 구강)",
+    "detailed": [
+      {
+        "name": "피부감염 (농피증)",
+        "description": "표재성 및 심부 세균성 피부감염",
+        "iscaid_position": "전신 항생제 1차 선택 (국소치료 실패 시)"
+      },
+      {
+        "name": "요로감염 (방광염, 신우신염)",
+        "description": "단순 산발성 방광염부터 복잡성 상부 UTI까지",
+        "iscaid_position": "1차 선택"
+      },
+      {
+        "name": "호흡기 감염",
+        "description": "상·하부 호흡기 세균 감염 (폐렴 포함)",
+        "iscaid_position": "대안 1차 (Doxycycline 불가 시)"
+      },
+      {
+        "name": "연조직 감염",
+        "description": "농양, 항문낭염, 교상(물린 상처)",
+        "iscaid_position": "1차 선택"
+      },
+      {
+        "name": "구강/치주 감염",
+        "description": "치주질환, 구강 내 혼합감염",
+        "iscaid_position": "2차 (Clindamycin이 1차)"
+      }
+    ]
   },
-
   "dosage": {
-    "standard": "12.5mg/kg 1일 2회",
-    "formula": "체중 4kg당 1정",
-    "duration": "5~7일 (질환별 상이)"
+    "standard": "12.5mg/kg (복합) 1일 2회 (q12h)",
+    "formula": "체중 4kg당 1정, 12시간 간격",
+    "per_kg": {
+      "amoxicillin": "10mg/kg/회",
+      "clavulanate": "2.5mg/kg/회"
+    }
   },
-
   "dosage_table": [
-    {"weight": "4kg", "tablets": "1정 × 2회"},
-    {"weight": "8kg", "tablets": "2정 × 2회"},
-    {"weight": "12kg", "tablets": "3정 × 2회"},
-    {"weight": "20kg", "tablets": "5정 × 2회"}
+    {
+      "weight": "2kg",
+      "tablets_per_dose": "0.5정",
+      "frequency": "1일 2회",
+      "daily_amoxicillin": "40mg",
+      "daily_clavulanate": "10mg"
+    },
+    {
+      "weight": "4kg",
+      "tablets_per_dose": "1정",
+      "frequency": "1일 2회",
+      "daily_amoxicillin": "80mg",
+      "daily_clavulanate": "20mg"
+    },
+    {
+      "weight": "6kg",
+      "tablets_per_dose": "1.5정",
+      "frequency": "1일 2회",
+      "daily_amoxicillin": "120mg",
+      "daily_clavulanate": "30mg"
+    },
+    {
+      "weight": "8kg",
+      "tablets_per_dose": "2정",
+      "frequency": "1일 2회",
+      "daily_amoxicillin": "160mg",
+      "daily_clavulanate": "40mg"
+    },
+    {
+      "weight": "10kg",
+      "tablets_per_dose": "2.5정",
+      "frequency": "1일 2회",
+      "daily_amoxicillin": "200mg",
+      "daily_clavulanate": "50mg"
+    },
+    {
+      "weight": "12kg",
+      "tablets_per_dose": "3정",
+      "frequency": "1일 2회",
+      "daily_amoxicillin": "240mg",
+      "daily_clavulanate": "60mg"
+    },
+    {
+      "weight": "16kg",
+      "tablets_per_dose": "4정",
+      "frequency": "1일 2회",
+      "daily_amoxicillin": "320mg",
+      "daily_clavulanate": "80mg"
+    },
+    {
+      "weight": "20kg",
+      "tablets_per_dose": "5정",
+      "frequency": "1일 2회",
+      "daily_amoxicillin": "400mg",
+      "daily_clavulanate": "100mg"
+    }
   ],
-
-  "indications_by_disease": {
-    "skin_pyoderma": "5~7일 (표재성) / 3~4주 (심부)",
-    "uti": "7~14일",
-    "respiratory": "7~10일",
-    "dental": "수술 전후 5~7일"
+  "duration_by_indication": [
+    {
+      "indication": "단순 방광염",
+      "duration": "3~5일",
+      "note": "ISCAID 2019 권장. 증상 소실 후에도 완료",
+      "source": "ISCAID UTI Guidelines 2019"
+    },
+    {
+      "indication": "신우신염 (상부 UTI)",
+      "duration": "10~14일",
+      "note": "전신 증상 동반 시. 배양검사 권장",
+      "source": "ISCAID UTI Guidelines 2019"
+    },
+    {
+      "indication": "표재성 농피증",
+      "duration": "2주 + 재평가",
+      "note": "국소치료 실패 시만 전신투여. 임상호전 후 1주 추가",
+      "source": "ISCAID Pyoderma Guidelines 2025"
+    },
+    {
+      "indication": "심부 농피증",
+      "duration": "3주 + 재평가",
+      "note": "배양검사 권장. 증상 소실 후 최소 1주 연장",
+      "source": "ISCAID Pyoderma Guidelines 2025"
+    },
+    {
+      "indication": "상부 호흡기 감염",
+      "duration": "7~10일",
+      "note": "Mycoplasma 의심 시 Doxycycline 선택",
+      "source": "ISCAID Respiratory Guidelines 2017"
+    },
+    {
+      "indication": "하부 호흡기/폐렴 (개)",
+      "duration": "14일",
+      "note": "경증~중등도 폐렴",
+      "source": "ISCAID Respiratory Guidelines 2017"
+    },
+    {
+      "indication": "하부 호흡기/폐렴 (고양이)",
+      "duration": "21일",
+      "note": "고양이는 재발률 높아 장기 투여",
+      "source": "ISCAID Respiratory Guidelines 2017"
+    },
+    {
+      "indication": "연조직 감염/교상",
+      "duration": "5~7일",
+      "note": "Pasteurella + 혐기성균 동시 커버",
+      "source": "ISCAID"
+    },
+    {
+      "indication": "치주/구강 감염",
+      "duration": "5~7일",
+      "note": "수술 전후 예방적 투여 포함",
+      "source": "General practice"
+    }
+  ],
+  "administration_instructions": {
+    "timing": [
+      "1일 2회, 12시간 간격 유지 (예: 아침 8시, 저녁 8시)",
+      "시간 의존적 살균제 → 일정한 간격이 효과에 중요"
+    ],
+    "with_food": {
+      "recommended": true,
+      "reason": "음식과 함께 투여 시 위장관 부작용 감소",
+      "note": "공복 투여도 가능하나 구토/설사 위험 증가"
+    },
+    "completion_importance": {
+      "message": "증상이 나아져도 처방 기간 끝까지 복용 완료",
+      "reason": "불완전 투약 시 남은 세균이 내성을 획득할 위험",
+      "warning": "임의 중단은 항생제 내성 유발의 주요 원인"
+    },
+    "missed_dose": "1회분을 놓쳤을 경우 기억난 즉시 투여. 다음 투약 시간이 가까우면 건너뛰고 다음 회차에 정상 용량 투여 (2배 용량 투여 금지)"
   },
-
+  "side_effects": {
+    "common": [
+      {
+        "symptom": "구토",
+        "frequency": "흔함",
+        "management": "음식과 함께 투여. 지속 시 수의사 상담"
+      },
+      {
+        "symptom": "설사",
+        "frequency": "흔함",
+        "management": "장내균총 교란 가능. 프로바이오틱스 병행 고려 (투약 2시간 간격)"
+      },
+      {
+        "symptom": "식욕 부진",
+        "frequency": "흔함",
+        "management": "대부분 일시적. 지속 시 수의사 상담"
+      }
+    ],
+    "uncommon": [
+      {
+        "symptom": "알레르기 반응 (두드러기, 안면부종, 호흡곤란)",
+        "frequency": "드묾",
+        "management": "즉시 투약 중단 및 응급 처치 필요",
+        "severity": "심각"
+      },
+      {
+        "symptom": "아나필락시스",
+        "frequency": "매우 드묾",
+        "management": "응급 상황. 에피네프린 투여 필요",
+        "severity": "생명 위협"
+      }
+    ],
+    "when_to_stop": [
+      "심한 구토/설사가 지속될 때",
+      "두드러기, 안면 부종, 호흡 곤란 발생 시 (알레르기)",
+      "혈변, 극심한 복통 등 심각한 증상 시"
+    ]
+  },
+  "contraindications": [
+    {
+      "condition": "페니실린 계열 알레르기",
+      "severity": "절대 금기",
+      "note": "과거 페니실린/세팔로스포린 과민반응 이력 있는 경우"
+    },
+    {
+      "condition": "중증 신부전",
+      "severity": "주의 필요",
+      "note": "용량 조절 또는 투여 간격 연장 필요. 수의사 판단"
+    }
+  ],
   "warnings": [
-    "⚠️ 페니실린 알레르기 과거력 확인",
-    "⚠️ 소형견/고양이 정확한 체중 투여",
-    "⚠️ 시간 의존적 살균 → 분할 투여 필수",
-    "⚠️ 장기 투여 시 내성균 모니터링"
+    "⚠️ 페니실린 알레르기 과거력 반드시 확인",
+    "⚠️ 소형견/고양이는 체중에 정확히 비례하여 투여 (과량 주의)",
+    "⚠️ 시간 의존적 살균제 → 1일 2회 분할 투여 필수 (1일 1회 투여 금지)",
+    "⚠️ 사람용 오그멘틴(Augmentin) 임의 투여 금지 (비율/용량 다름)",
+    "⚠️ 장기 투여 시 내성균 발생 모니터링 필요",
+    "⚠️ 치료 실패 시 배양검사 시행 (경험적 재처방 지양)"
   ],
-
-  "clinical_notes": [
-    "EMA AMEG Category D: 1차 선택 가능",
-    "β-Lactamase 생산균까지 커버 (단독 AMX 대비)",
-    "MIC 이상 농도 유지 시간이 핵심 → BID 분할"
-  ],
-
-  "source": {
-    "guidelines": ["ISCAID (수의 피부과)", "AAHA"]
+  "antibiotic_stewardship": {
+    "importance": "항생제 내성은 인수공통 문제. 동물에서의 오남용은 사람에게도 영향",
+    "principles": [
+      "처방된 기간 끝까지 복용 완료 (조기 중단 금지)",
+      "남은 약 보관 후 자가 투약 금지",
+      "증상 재발 시 수의사 재진 (같은 약 임의 복용 금지)",
+      "가능하면 배양검사 후 처방 (특히 재발/치료 실패 시)"
+    ],
+    "resistance_warning": "불완전 투약, 과소/과다 용량, 불필요한 처방은 내성균 선택의 주요 원인",
+    "iscaid_effect": "ISCAID 가이드라인 준수 결과 이탈리아에서 E.coli의 AMX-CLV 내성률이 52.6%→25.6%로 감소 (PMID:41012835)"
   },
-
-  "storage": "25°C 이하, 건조, 차광 보관"
-}
+  "drug_interactions": [
+    {
+      "drug": "Methotrexate",
+      "effect": "Methotrexate 배설 감소 → 독성 증가 가능",
+      "recommendation": "병용 시 모니터링 필요"
+    },
+    {
+      "drug": "Probenecid",
+      "effect": "아목시실린 신장 배설 억제 → 혈중 농도 상승",
+      "recommendation": "용량 조절 고려"
+    },
+    {
+      "drug": "구충제 (일반)",
+      "effect": "대부분 병용 가능",
+      "recommendation": "펜벤다졸, 이버멕틴 등 일반 구충제와 병용 안전"
+    },
+    {
+      "drug": "프로바이오틱스",
+      "effect": "항생제로 인한 장내균총 교란 완화",
+      "recommendation": "병용 가능. 투약 시간 2시간 간격 권장"
+    }
+  ],
+  "susceptibility_data": [
+    {
+      "pathogen": "E. coli (개 UTI)",
+      "susceptibility": "92%",
+      "source": "KuKanich 2020 (PMID:31777977)",
+      "region": "미국 중서부"
+    },
+    {
+      "pathogen": "E. coli (이탈리아, 2019 이후)",
+      "susceptibility": "74.4%",
+      "source": "Tagliasacchi 2025 (PMID:41012835)",
+      "note": "ISCAID 가이드라인 도입 후 내성률 25.6%로 감소"
+    },
+    {
+      "pathogen": "S. pseudintermedius (MSSP, 유럽)",
+      "susceptibility": "≥88.5%",
+      "source": "ComPath 2020 (PMID:32924232)",
+      "note": "피부 분리주"
+    },
+    {
+      "pathogen": "S. pseudintermedius (MRSP)",
+      "susceptibility": "내성 (일반)",
+      "source": "Pirolo 2023 (PMID:37294541)",
+      "note": "Low-level MRSP 일부는 임상 반응"
+    }
+  ],
+  "clinical_notes": [
+    "EMA AMEG Category D: 경험적 처방 허용되는 1차 선택 항생제",
+    "β-Lactamase 생산균까지 커버 (Amoxicillin 단독 대비 스펙트럼 확장)",
+    "시간 의존적 살균 → MIC 이상 농도 유지가 핵심 → BID 분할 필수",
+    "ISCAID 가이드라인이 항생제 내성률 감소에 실질적 효과 입증됨",
+    "치료 실패 시 Category C (Cephalexin 등) → B (Fluoroquinolone) 순으로 상향"
+  ],
+  "pharmacy_counseling": {
+    "key_messages": [
+      "체중 4kg당 1정, 하루 2번 (12시간 간격)",
+      "음식과 함께 드리면 위장 부작용 감소",
+      "증상 나아져도 처방 기간 끝까지 복용 완료 (내성 예방)",
+      "구토/설사 심하거나 알레르기 증상(부종, 호흡곤란) 시 즉시 중단"
+    ],
+    "common_questions": [
+      {
+        "question": "며칠이나 먹여야 하나요?",
+        "answer": "질환에 따라 다릅니다. 방광염 3~5일, 피부감염 2~3주, 호흡기 7~21일. 수의사 처방 기간 준수하세요."
+      },
+      {
+        "question": "증상이 나았는데 계속 먹여야 하나요?",
+        "answer": "네, 반드시요. 증상만 나아지고 세균은 남아있을 수 있습니다. 중간에 끊으면 내성균이 생깁니다."
+      },
+      {
+        "question": "사람용 오그멘틴 줘도 되나요?",
+        "answer": "안 됩니다. 용량과 비율이 다릅니다. 동물 전용 제품만 사용하세요."
+      },
+      {
+        "question": "부작용은 없나요?",
+        "answer": "구토, 설사 같은 위장 증상이 흔합니다. 음식과 함께 주면 줄어듭니다. 알레르기 반응(부종, 호흡곤란)은 드물지만 발생 시 즉시 중단하세요."
+      }
+    ]
+  },
+  "source": {
+    "guidelines": [
+      "ISCAID UTI Guidelines 2019 (PMID:30971357)",
+      "ISCAID Pyoderma Guidelines 2025 (PMID:40338805)",
+      "ISCAID Respiratory Guidelines 2017 (PMC5354050)",
+      "AAHA/AAFP Antimicrobial Stewardship Guidelines 2022"
+    ],
+    "golden_pattern": "actibet_amoxicillin_clavulanate.md (2026-03-02)"
+  },
+  "storage": "25°C 이하, 건조, 차광 보관",
+  "last_updated": "2026-03-19",
+  "indication": "광범위 세균 감염 (피부, 요로, 호흡기, 연조직, 구강)"
+}