Author Guide

콘텐츠 추가 가이드

새 약물이나 제품을 추가할 때는 제품 설명, 종별 특이성, FAQ를 같은 구조로 쌓습니다. 나중에 Astro + Starlight로 옮겨도 이 구조를 그대로 frontmatter와 MDX로 옮길 수 있습니다.

현재 HTML 위키에 추가하는 법

  1. 제품 추가scripts/build_animal_meds_wiki.mjs의 products 배열에 제품 객체를 하나 추가합니다.
  2. FAQ 연결commonFaqs의 appliesTo에 제품 slug를 넣으면 제품 페이지에 자동으로 붙습니다.
  3. 빌드node scripts/build_animal_meds_wiki.mjs를 실행하면 HTML이 다시 생성됩니다.
  4. 배포npx wrangler pages deploy animal-meds-wiki --project-name animal-meds-wiki --branch main로 Cloudflare Pages에 올립니다.

향후 Astro/Starlight frontmatter 초안

---
title: 이버멕틴
drug_class: [항기생충제, macrocyclic lactone]
mechanism: glutamate-gated chloride channel 관련 신경전달 억제
species_safety:
  dog: 주의
  cat: 제품별 확인
  horse: 제형별 확인
key_species_difference: 일부 견종의 MDR1 변이가 macrocyclic lactone 독성 위험과 관련
human_pharmacology_anchor: 사람에서는 항기생충제로 제한적 사용되지만, 반려동물에서는 심장사상충 예방 맥락이 중요
related_drugs: [셀라멕틴, 목시덱틴, 밀베마이신]
product_examples: [하트세이버, 하트세이버츄어블]
pharmacist_scope:
  can_answer: [투여 간격, 체중대 확인, 누락 시 기본 원칙]
  refer_to_vet: [장기 누락, 증상 동반, 심장사상충 감염 의심, 신경계 이상]
faq_tags: [심장사상충, MDR1, 체중대, 누락]
---

왜 이 구조인가

제품 페이지를 먼저 두는 이유는 약국 현장의 질문이 제품명으로 들어오기 때문입니다. 대신 각 제품 안에서 종별 특이성, 약효군 총론, FAQ로 빠져나가게 만들어 단순 제품 암기에서 수의약물치료학 학습으로 확장합니다.

처음부터 외부 DB를 붙이지 않는 이유는 비개발자가 유지하기 어렵기 때문입니다. 지금은 한 파일의 구조화 데이터로 운영하고, 콘텐츠가 충분히 쌓이면 Astro content collections로 옮기는 것이 더 단순합니다.