History

Haewon Kam ed8f65030d feat(supporters): 오시는 길 지도·길찾기(VisitMap) 템플릿 반영, 워커 tourism 단계가 factSheet.geo 좌표 기록 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>		2026-09-11 11:38:53 +09:00
..
launchd	feat(supporters): 뉴스룸 워커 단계 + 뉴스 게이트 규칙, launchd 폴러 설치	2026-09-08 14:14:08 +09:00
poll.mjs	feat(supporters): haewon 결정 반영 — 채널 인기 전체 탭 제거, 단가 상한 $10 기본, 큐 폴러(poll.mjs)+launchd, /supporters/:id 페이지, URL 신청→빌드 큐, 수집기 UA·슬래시 수정, 기획 목록 일반화(원진 6편)	2026-09-07 18:54:01 +09:00
README.md	feat(supporters): 회복 일정 플래너를 템플릿·워커에 통합 (/plan·/en/plan), /recovery·/stay 를 /plan 으로 정리	2026-09-11 11:27:59 +09:00
run.mjs	feat(supporters): 오시는 길 지도·길찾기(VisitMap) 템플릿 반영, 워커 tourism 단계가 factSheet.geo 좌표 기록	2026-09-11 11:38:53 +09:00

README.md

서포터즈 자동 빌드 워커

병원 홈페이지 URL 하나로 근거 수집 → 팩트 시트·의료진 초안 → 첫 배치 기획 → 글 생성(GPT-4.1, 게이트·근거 대조) → Astro 빌드·발행 게이트 → Vercel 미리보기(noindex) 까지 돈다. 사람 게이트(의학 검토·게시 승인)는 자동화하지 않는다.

node workers/supporters-build/run.mjs --clinic <id> --url <https://...> [--name 상호] [--logo file.svg] [--youtube 채널] [--deploy] [--build-id <uuid>] [--max-cost-usd 10] [--no-tourism] [--no-recovery]
# 단계: evidence → ocr(이미지 글자) → data → discover(채널 발견·엔티티 검증) → youtube(로고·파비콘·채널 집계) → news(뉴스룸: 네이버 뉴스 + 언론보도 게시판) → images(의료법 기준 이미지) → tourism(주변 안내: /stay·/en/stay 데이터) → recovery(시술 후 관리 안내: 병원 시술 페이지 원문 인용·번역) → inputs → briefs → generate → build → deploy
# 주변 안내만 다시: node workers/supporters-build/run.mjs --clinic <id> --url <https://...> --from tourism --skip-generate
# 시술 후 관리 안내만 다시: node workers/supporters-build/run.mjs --clinic <id> --url <https://...> --from recovery --skip-generate
node workers/supporters-build/poll.mjs [--loop 300] [--no-deploy]      # supporter_builds 큐(status=queued)를 집어 run.mjs 실행

흐름

랜딩 /discovery 의 URL 신청(DiscoveryLeadModal) → discovery_leads + supporter_builds(queued) 행.
poll.mjs 가 queued 행을 집어(running 으로 조건부 갱신) run.mjs 를 돌린다. 단계마다 supporter_builds 갱신.
완료되면 preview_url 이 기록되고, /discovery/:id 또는 /supporters/:id 의 "병원 확인 항목" 패널에 미리보기 링크와 입력 폼이 뜬다.
병원이 입력하면 supporter_inputs 에 쌓인다. 재빌드: run.mjs --from data --from-supabase --deploy --build-id <id> (apply_inputs 가 데이터·frontmatter 에 반영).

실행 위치 (권장)

단계	어디서	haewon 이 할 일
지금 (파일럿, 월 수 건)	haewon 의 Mac 에서 `poll.mjs` 를 launchd 로 5분마다. `launchd/` 폴더의 plist 를 설치하면 된다	설치 명령 한 번. Mac 이 켜져 있어야 돈다
정착 (월 수십 건, 무인)	Trigger.dev 클라우드. `poll.mjs` 와 같은 코드를 태스크로 올린다. 타임아웃 없음, 재시도·로그 내장, 무료 구간(월 1,500 run)이면 충분	가입(GitHub 계정), 프로젝트 만들고 API 키 1개 전달. 코드·배포는 Claude 가 한다

VPS(서버 직접 운영)와 Vercel Functions(최대 800초)는 권하지 않는다. 전자는 관리 부담, 후자는 빌드가 시간 안에 끝나지 않는다.

필요한 것

.env: VITE_SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY, OPENAI_API_KEY, YOUTUBE_API_KEY, NAVER_CLIENT_ID/NAVER_CLIENT_SECRET(뉴스룸, 주변 안내의 주소→좌표), TOUR_API_KEY/TOUR_API_BASE(주변 안내, 한국관광공사 TourAPI. 없으면 tourism 단계를 건너뛰고 페이지는 확인 대기로 발행)
python3 (tourism 단계가 scripts/fetch_medical_tourism.py 를 부른다. certifi 가 있으면 SSL 인증서 검증에 쓴다)
vercel CLI 로그인 (배포 시). 병원당 프로젝트 supporters-<id> 를 만든다
templates/supporters-astro/ (supporters 에서 npm run export:template)

주변 안내 (tourism 단계)

/stay(국문)·/en/stay(영문)의 식사·숙박·휴식·관광·문화·쇼핑·축제 목록은 병원 좌표를 기준으로 한국관광공사 TourAPI 에서 모은다. 기준 좌표는 팩트 시트 주소(address.full)와 상호를 네이버 지역검색에 넣어 결과의 도로명·번지가 같을 때만 받는다. 주소만으로는 지역검색 결과가 없으므로 상호가 필요하다.

좌표를 못 정하면 스크립트는 종료 코드 1 로 멈추고, 워커는 status.json 의 해당 단계를 warning 으로 적고 빌드를 계속한다. 페이지는 템플릿의 빈 데이터로 "확인 대기"를 그린다.
meta.origin.coordSource 에 좌표 출처와 날짜가 남는다(예: 네이버 지역검색 '뷰성형외과의원' (...) 2026-09-10).
결과 요약은 status.json 의 report.tourism 에 있다(기준 좌표, 언어별 장소·축제 수).
네이버 이미지 검색 폴백은 제3자 저작물이다. 공개 배포 빌드는 --no-naver-images 를 붙인다.
수동 실행: python3 scripts/fetch_medical_tourism.py --clinic <id> --name "<상호>" --address "<주소>" --label "<상호> (<도로명>)" --out-en <site>/src/data/medicalTourism.json --out-ko <site>/src/data/medicalTourismKo.json

시술 후 관리 안내 (recovery 단계)

/stay·/en/stay 의 "하루 동선" 아래 "시술 후 관리 안내" 블록. scripts/collect_recovery.mjs 가 근거 페이지(type procedure·aftercare·precautions, OCR 텍스트 포함)의 문장 중 시점 표현과 행동·주의 표현이 함께 있는 것만 고른다. 효과·홍보 문장, 병원 연락처 문장, 수술 전 준비 문장, 표 칸이 뒤섞인 OCR 문장, 발행 게이트 규칙(금칙어·효과 보장·금액·운영자 어휘)에 걸리는 문장은 뺀다. 페이지당 최대 5문장, 최대 30페이지.

영문은 OPENAI_API_KEY 로 gpt-4.1-mini 배치 번역(temperature 0, 상한 $0.5). 번역문의 숫자가 원문과 다르면 그 문장은 영문을 비우고(enFailed) 영문 화면에 한글 원문 + "Korean" 표시로 나간다. 같은 문장은 <site>/src/data/recoveryNotes.cache.json 에서 다시 쓴다.
결과 <site>/src/data/recoveryNotes.json. items 가 비면 페이지는 블록을 그리지 않는다. 요약은 status.json 의 report.recovery.
병원 확정 안내문(site.recoveryStagesKo/En)과 역할이 다르다. 확정값은 "병원 안내" 문단, 이 블록은 출처 링크·확인일이 붙은 원문 인용이다. 확정값이 없으면 "확인 대기" 문단은 그대로 남는다.
발행 게이트의 홈페이지 40자 일치 검사(§3-11)는 이 인용 블록(#recovery-quote)만 빼고 본다. 금칙어·운영자 어휘 검사는 인용 블록에도 적용된다.

단가

글 생성 상한은 실행당 $10 (--max-cost-usd, haewon 결정 2026-09-07). 실측: 편당 $0.05~0.19, 첫 배치 5~6편이면 $0.3~1.

두 번째 병원에서 배운 것 (원진성형외과, 2026-09-07)

비브라우저 User-Agent 를 403 으로 막는다 → 브라우저 UA + 식별 문자열.
경로 끝 슬래시를 붙이면 404 (뷰성형외과는 반대로 슬래시로 301) → 슬래시를 강제하지 않고 404 면 반대 형태 재시도.
페이지 유형 분류가 URL 경로 어휘(system/precautions 등)에 기대면 다른 병원에서 못 잡는다 → 제목·본문 키워드 분류를 보강할 것.