Claude로 식약처 허가사항 기반 외국인 환자 복약안내문 제작 도구 만들기

너는 약국 약사를 위한 웹 도구를 만드는 개발자야.
외국인 환자에게 줄 "복약안내문"을 만드는 HTML 파일 한 개를 만들어줘.

## 이 도구가 하는 일
약사가 처방된 약의 이름과 환자 언어, 처방 용법만 입력하면
1) 식약처 허가사항을 자동으로 불러오고
2) 허가사항과 처방 용법만 근거로 한국어 복약안내문 초안을 만들고
3) 약사가 한국어판을 확인·수정해서 승인하면
4) 환자 언어로 번역하고
5) 번역본을 다시 한국어로 되돌려(역번역) 한국어판과 나란히 보여주고
6) A4 한 장으로 인쇄할 수 있게 해줘.

## 사용하는 API
### 1. 공공데이터포털 — 식품의약품안전처_의약품 제품 허가정보
- 목록: GET https://apis.data.go.kr/1471000/DrugPrdtPrmsnInfoService07/getDrugPrdtPrmsnInq07
  - 파라미터: serviceKey, type=json, item_name, numOfRows, pageNo
  - 응답 항목: ITEM_SEQ(품목기준코드), ITEM_NAME, ENTP_NAME, SPCLTY_PBLC(전문/일반), CANCEL_NAME(취하구분)
- 상세: GET https://apis.data.go.kr/1471000/DrugPrdtPrmsnInfoService07/getDrugPrdtPrmsnDtlInq06
  - 파라미터: serviceKey, type=json, item_seq
  - 응답 항목: ITEM_NAME, ENTP_NAME, ETC_OTC_CODE, CANCEL_NAME, CHART(성상), MAIN_ITEM_INGR, MAIN_INGR_ENG(주성분 영문명), STORAGE_METHOD,
    EE_DOC_DATA(효능효과), UD_DOC_DATA(용법용량), NB_DOC_DATA(주의사항 일반), PN_DOC_DATA(주의사항 전문)
  - 응답 모양: { "header": {...}, "body": { "totalCount": 1, "items": [ { ...항목 } ] } } — items는 배열이야.
  - 문서 데이터(…_DOC_DATA)는 이런 XML 문자열이야:
    <DOC title="사용상의주의사항" type="NB"><SECTION title=""><ARTICLE title="1. 다음 환자에는 투여하지 말 것."><PARAGRAPH><![CDATA[1) ...]]></PARAGRAPH></ARTICLE></SECTION></DOC>
    DOMParser로 읽어서 ARTICLE 제목과 PARAGRAPH 문장을 순서대로 살린 텍스트로 바꿔. 표(table)가 섞여 있으면 셀을 " | "로 이어.
  - 주의사항은 NB_DOC_DATA를 쓰고, PN_DOC_DATA가 비어 있지 않으면 함께 붙여. 둘 다 비어 있으면 "주의사항 문서 없음"을 약사에게 경고해.
- 인증키는 공공데이터포털의 "일반 인증키(Decoding)" 값을 받는다고 가정하고, 요청할 때 URL 인코딩해서 넣어.

### 2. Gemini API
- GET https://generativelanguage.googleapis.com/v1beta/models 로 모델 목록을 불러와서
  generateContent를 지원하는 모델만 선택 상자 두 개에 보여줘. 일을 두 가지로 나눠 모델을 따로 쓴다:
  - "초안·점검 모델" (한국어판 초안, AI 대조 점검 — 정확도가 중요): 기본값은 목록에서 gemini-3.5-flash → gemini-3.6-flash → gemini-3.7-flash → gemini-3.8-flash 순서로 처음 있는 것
  - "번역 모델" (외국어판, 역번역, 뜻 비교 — 요청이 많음): 기본값은 gemini-3.5-flash-lite → gemini-3.1-flash-lite → 이름에 flash-lite가 들어간 첫 모델
  선택 상자 아래 안내: "무료 등급 기준 Flash는 모델마다 하루 20회, Flash-Lite는 하루 500회 정도예요. 초안은 처방 한 장에 2번(초안·점검)만 Flash를 써요. (한도는 Google이 바꿀 수 있어요)"
  - 초안·점검 모델이 하루 한도(429이고 재시도해도 계속 한도 오류)나 404에 걸리면, 목록의 다음 Flash 모델로 바꿔 다시 시도하고 "○○ 한도가 차서 △△로 바꿨어요"를 보여줘. Flash가 모두 막히면 번역 모델로 쓰되 "정확도가 낮은 모델로 초안을 썼으니 더 꼼꼼히 확인하세요" 경고를 크게 보여줘.
  (gemini-2.5-flash는 신규 사용자에게 제공되지 않아 404가 나니 기본값으로 쓰지 마.)
- 무료 등급은 모델마다 1분에 보낼 수 있는 요청 수가 적어(예: 5회). 그래서 Gemini 요청은 반드시 한 번에 하나씩 순서대로 보내고, 요청 사이에 최소 4초를 둬.
  - 429(사용량 한도): 오류 응답 error.details 중 RetryInfo의 retryDelay(예: "5s")만큼 기다린 뒤 자동으로 다시 보내. 기다리는 동안 "무료 사용량 한도 때문에 N초 기다리는 중…"을 초 단위로 보여줘. 3번까지 자동 재시도하고, 그래도 실패하면 오류와 [다시 시도] 버튼.
  - 503(서버 과부하): 10초 → 20초 → 40초 간격으로 자동 재시도(남은 초 표시). 그래도 실패하면 오류와 함께 [다시 시도], [다른 모델 고르기] 버튼.
  - 404·403: 자동 재시도하지 말고 원인과 [다른 모델 고르기]를 보여줘.
- POST https://generativelanguage.googleapis.com/v1beta/models/{모델}:generateContent
  - 헤더 x-goog-api-key 에 키를 넣어. (URL에 키를 넣지 마.)
  - 결과가 표 형태로 필요한 단계는 JSON으로 답하게 하고, 받은 JSON을 검사해서 형식이 틀리면 한 번 다시 요청해.

## 화면 구성과 순서
### ⚙️ 설정 (키가 없으면 펼친 상태로 시작)
이 도구는 사용하는 약사가 **각자 발급받은 키**를 넣어 쓰는 도구야.
- 공공데이터포털 인증키, Gemini API 키 입력칸 (입력값은 ●●● 가림, [보기] 토글)
- 저장 방식 선택:
  - "이번만 사용" (기본값) → 메모리에만 두고 창을 닫으면 사라짐
  - "이 컴퓨터에 저장" → localStorage에 저장. 선택할 때 "공용 컴퓨터에서는 쓰지 마세요" 경고
- [키 지우기] 버튼 → 메모리와 localStorage 모두 삭제
- [키 확인] 버튼 → 두 API를 가볍게 한 번씩 호출해서 ✅/❌와 원인을 보여줘
- 키를 코드에 적어두지 마. 키가 화면 밖(콘솔 로그, 인쇄물, 오류 메시지 URL)에 찍히지 않게 해.
- [🔑 키 발급 방법 보기] 를 누르면 펼쳐지는 안내:
  **공공데이터포털 인증키 (무료)**
  1) https://www.data.go.kr 회원가입·로그인
  2) "식품의약품안전처_의약품 제품 허가정보" 페이지(https://www.data.go.kr/data/15095677/openapi.do)에서 [활용신청] → 활용 목적 작성 → 자동 승인
  3) 마이페이지 → 데이터활용 → 인증키에서 **일반 인증키(Decoding)** 를 복사 (Encoding 키 아님)
  4) 승인 직후에는 키가 작동하기까지 시간이 조금 걸릴 수 있음
  **Gemini API 키 (무료 등급)**
  1) https://aistudio.google.com/apikey 에 Google 계정으로 로그인
  2) [API 키 만들기] → 복사
  3) 결제 계정을 연결하지 않으면 무료 등급으로 사용. 무료 등급은 입력 내용이 Google 서비스 개선에 쓰일 수 있음
  4) 키가 새면 AI Studio에서 바로 삭제하고 새로 만들 것. 키를 메신저·파일로 공유하지 말 것
- Gemini 모델 선택 상자
- 안내 문구: "Gemini 무료 사용량에 입력한 내용은 Google이 서비스 개선에 쓸 수 있어요. 환자 이름·생년월일·연락처 같은 개인정보는 입력하지 마세요."

### 1단계: 처방 입력
- 환자 언어 선택: 영어, 중국어(간체), 베트남어, 러시아어, 몽골어, 태국어, 일본어
- 약 추가 (여러 개 가능). 약마다:
  - 약품명 입력 → [검색] → 허가 목록에서 제품 고르기 (취하·취소된 품목은 빼거나 회색으로)
  - 1회 복용량 (예: 1정, 1방울), 1일 횟수, 복용 시점(식후 30분/식후/식전/식간/공복/취침 전/시점 지정 없음/기타 직접 입력), 복용 일수
- 환자 개인정보 입력칸은 만들지 마.

### 2단계: 허가사항 불러오기
- 고른 제품마다 상세 API로 효능효과·용법용량·주의사항(일반·전문)을 불러와서, 약별로 접었다 펼 수 있는 원문 상자로 보여줘.
- 상단에 제품명·업체명·품목기준코드·전문/일반 구분을 표시해.

### 3단계: 한국어판 초안 (Gemini)
Gemini에게 아래 원칙을 지시해:
- 근거는 "불러온 허가사항 원문"과 "약사가 입력한 처방 용법" 두 가지뿐이다. 이 둘에 없는 내용은 절대 쓰지 않는다.
- 복용법은 허가사항의 일반 용량이 아니라 약사가 입력한 처방 용법을 그대로 쓴다.
- 한 처방의 모든 약을 한 번의 요청으로 묶어 초안을 만든다 (Flash 사용량을 아끼기 위해). 결과 JSON도 약별로 나눠 받는다.
- 환자가 이해하기 쉬운 짧은 문장으로 쓴다. 약마다:
  ① 이 약은 (효능 한 줄)
  ② 이렇게 드세요 (처방 용법 — 이 문장은 Gemini가 쓰지 말고 도구가 입력값으로 직접 만든다.
     제형에 맞는 동사를 써: 제품명·성상에 점안/안약이 있거나 복용량 단위가 "방울"이면 "눈에 넣으세요", 연고·크림·겔·패취·외용·분무·흡입·좌제면 "사용하세요", 그 밖에는 "드세요".
     일수 문장도 같은 동사로("7일 동안 눈에 넣으세요"). 시점이 "시점 지정 없음"이면 시점 문장은 넣지 않는다.
     제목도 제형에 맞춰 "이렇게 드세요" / "이렇게 사용하세요"로 바꾼다.)
  ③ 먹기 전에 약사에게 알려주세요 (허가사항 "다음 환자에는 투여하지 말 것" 중 환자가 스스로 알 수 있는 것 — 예: 이 성분·같은 계열 약에 알레르기가 있었던 경우, 임신·수유 — 최대 2개)
  ④ 꼭 지켜주세요 (복용하는 동안 환자가 스스로 지킬 행동 — 함께 먹으면 안 되는 약·음식·술, 운전, 씹지 말기 등, 최대 3개. 복용량·횟수·시점은 ②에 있으니 절대 반복하지 않는다)
  ⑤ 이런 증상이 있으면 약사·의사에게 알려주세요 (허가사항에 적힌 중대한 이상반응 중 환자가 알아챌 수 있는 것, 최대 3개)
  ⑥ 보관 방법 (근거는 STORAGE_METHOD 값)
- ③④⑤⑥의 문장마다 근거가 된 허가사항 원문 문장을 원문 그대로 함께 돌려준다 (약사 확인용, 인쇄에는 안 나옴). 원문에서 그대로 찾을 수 없는 문장은 ⚠로 표시한다.
- 쉬운 말 규칙 (근거 문장만 원문 그대로이고, 안내문 문장은 반드시 일상어로):
  - 중학생도 바로 이해하는 말로 쓴다. 허가사항 용어를 그대로 옮기지 않는다.
    구체적인 약·증상 예시 문장은 넣지 마 (모델이 원문에 없어도 베껴 씀). 대신 아래 "형식 틀"만 줘:
    - 원문 "○○한 환자에게는 투여하지 말 것" → "○○한 적이 있다면 약사에게 알려주세요"
    - 원문 "○○와 병용하지 않는다" → "이 약을 드시는 동안 ○○를 함께 드시지 마세요"
    - 원문 "○○가 나타나면 투여를 중지할 것" → "○○가 생기면 약을 멈추고 약사·의사에게 알려주세요"
    - 원문 "○○에 주의할 것" → "○○에 주의하세요"
    그리고 "원문 용어를 같은 뜻의 일상어로 바꾸되, 원문에 없는 증상·약·행동은 한 단어도 더하지 말 것", "이상반응 빈도 설명(가장 흔한 이상반응은 ○○입니다)이 아니라 환자가 할 행동 문장으로 쓸 것"이라고 지시해.
  - ⑤에는 환자가 몸으로 느끼거나 눈으로 볼 수 있는 증상만. 병 이름·분류명·검사로만 아는 것(백혈구 감소, 간 수치, "소화기계 이상반응")은 쓰지 않는다.
  - ① 효능은 25자 이내로 "무엇을 치료·완화하는 약"인지만. 적응증을 나열하지 않는다.
  - 모든 문장은 45자 이내, 존댓말(~하세요/~입니다). "~한다", "~안된다" 같은 문어체 금지.
  - 원문의 강도와 조건을 바꾸지 않는다. 원문이 "상의하라"면 "상의하세요"이지 "하지 마세요"가 아니다. 원문의 조건(예: "이 약에 의한", "매일 세 잔 이상")을 빼거나 넓히지 않는다.
  - ④에는 보관 방법, "권장 용량을 넘기지 마세요"처럼 ②·⑥과 겹치는 내용을 넣지 않는다.
- 우선순위 규칙 (칸 수가 모자라면 이 순서로 고른다):
  1) 허가사항 "경고" 항목 중 환자가 알아채거나 행동할 수 있는 것
  2) 함께 먹으면 안 되는 약·음식과 그 시간 간격 — 원문의 숫자와 방향(전/후, 이내/이상)을 그대로 쓴다. 원문이 "이 약 투여 후 N시간 이내에는 병용하지 않는다"면 "이 약을 먹고 N시간 안에는 ○○를 먹지 마세요"이고, "N시간 전에 드세요" 같은 새 지시로 바꾸지 않는다.
  3) 검사·시술 전에 알려야 하는 것 (예: 조영제를 쓰는 검사)
  4) 복용 중 스스로 확인할 증상과 중단해야 하는 경우 (원문에 "중단"이 있으면 "중단하고 알려주세요"까지 쓴다)
  5) 운전·술·씹지 말기·용기 입구가 닿지 않게 하기 같은 사용 행동
- ⑤는 최대 3개로 한다.
- 성분 영문명은 Gemini에게 묻지 말고 MAIN_INGR_ENG 값을 그대로 쓴다. 값이 없으면 비워 두고 "성분 영문명 없음"을 약사에게 표시한다.
- 결과는 JSON으로.
화면에는 약마다 한국어 문장을 고칠 수 있는 입력칸으로 보여주고, 각 문장 옆에 "근거 보기"로 원문 문장을 펼칠 수 있게 해.
맨 아래에 고정 문구 "이 복약안내문은 한국 허가사항 기준으로 작성되었습니다."를 항상 넣고, 이 문구는 지울 수 없게 해.
초안이 나오면 [🔎 AI 대조 점검]을 자동으로 한 번 실행해 (Gemini 별도 요청, 초안·점검 모델 사용, 한 처방을 한 번에):
- 각 문장과 그 근거 원문을 짝지어 주고, 문장이 원문과 비교해 ① 강도가 바뀜(권고↔금지) ② 조건·대상이 빠지거나 넓어짐 ③ 시간·순서·방향이 바뀜 ④ 원문에 없는 증상·약·행동이 더해짐 중 하나라도 있으면 그 종류와 이유를 짧게 돌려받아.
- 문제가 있는 문장 옆에 🟠 표시와 이유를 보여주고, 약사가 고치면 그 문장만 다시 점검할 수 있게 해.
- 이 점검도 AI라서 틀릴 수 있다는 안내를 함께 보여줘.
[✅ 약사 확인 완료] 버튼을 눌러야 다음 단계로 넘어가. Gemini가 작성·점검 중일 때는 이 버튼을 비활성화해.

### 4단계: 외국어판 (Gemini)
- 약사가 승인한 한국어판만 선택한 언어로 번역해. 숫자·용량·횟수·일수는 절대 바꾸지 않게 지시해.
- 번역 요청에 복용 시점 용어집을 함께 줘. 식후 30분 = 식사를 마치고 30분 뒤 / 식후 = 식사를 마친 뒤 / 식전 = 식사하기 전 / 식간 = 식사와 식사 사이(식사 중이 아님) / 공복 = 빈속 / 취침 전 = 잠자기 전. 각 언어에서 뜻이 헷갈리지 않는 표현을 쓰게 하고, 특히 식간을 "식사 중"으로 읽히는 말로 옮기지 않게 해.
- "먹는 동안", "~하는 경우에만" 같은 기간·조건 표현을 빼거나 바꾸지 않게 지시해.
- 약 이름은 제품명 그대로 두고, 괄호로 성분 영문명을 붙여.
- 고정 문구는 번역문과 한국어 원문을 함께 넣어.

### 5단계: 역번역 검수 (Gemini, 별도 요청)
- 한국어판은 보여주지 말고 외국어판만 주고 한국어로 번역하게 해.
- 한국어판과 역번역을 문장 단위로 좌우 나란히 보여줘.
- 두 문장에 들어 있는 숫자가 다르면 빨간색으로 표시해.
- 숫자 검사와 별도로 [🔎 뜻 비교]를 자동 실행해 (Gemini 별도 요청): 한국어판 문장과 역번역 문장을 짝지어 주고, 조건·기간·대상·부정·강도·시간 방향이 달라진 짝을 이유와 함께 돌려받아 🟠로 표시해. 이 비교도 AI라 틀릴 수 있다고 안내해.
- 약사가 문장을 고치면 4단계부터 다시 할 수 있게 [다시 번역] 버튼을 둬.

### 6단계: A4 인쇄
- 인쇄용 화면: 환자 언어 본문이 크게, 각 문장 아래에 한국어가 작게. 약마다 칸을 나눠.
- 약이 여러 개면 한 장에 다 들어가지 않을 수 있어. 먼저 글자를 줄여 한 장에 맞춰 보고, 너무 작아지면(본문 9pt 미만) 약 사이에서 쪽을 나눠 2장으로 인쇄해. 2장을 넘으면 경고해.
- 맨 아래 고정 문구(번역문 + 한국어), 작성일, "약사 확인 후 제공" 표시.
- @page A4, 여백 12mm.
- [인쇄] 버튼은 window.print().

## 오류 처리
- API 오류는 한국어로 원인과 해결 방법을 보여줘:
  인증키 오류 / 활용신청 안 된 API / 호출량 초과 / 검색 결과 없음 / 네트워크 오류(파일을 내려받아 열었는지 확인하라는 안내 포함)
- Gemini가 형식에 맞지 않는 답을 주면 한 번 다시 요청하고, 그래도 안 되면 오류를 보여줘.

## 만들 때 지킬 것
- 외부 라이브러리 없이 HTML·CSS·JavaScript만으로 파일 한 개.
- 약국 카운터에서 쓰기 편하게 글자는 크게, 버튼은 분명하게. 지금 몇 단계인지 위에 표시해.
- 이 파일은 내려받아 브라우저에서 열어 쓸 거야. (Claude 미리보기 안에서는 외부 API 호출이 막혀서 조회가 안 된다는 안내를 첫 화면 설정 상자에 적어줘.)