# 서포터즈 자동 빌드 워커

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

```
node workers/supporters-build/run.mjs --clinic <id> --url <https://...> [--name 상호] [--deploy] [--build-id <uuid>] [--max-cost-usd 10]
node workers/supporters-build/poll.mjs [--loop 300] [--no-deploy]      # supporter_builds 큐(status=queued)를 집어 run.mjs 실행
```

## 흐름

1. 랜딩 `/discovery` 의 URL 신청(DiscoveryLeadModal) → `discovery_leads` + `supporter_builds`(queued) 행.
2. `poll.mjs` 가 queued 행을 집어(running 으로 조건부 갱신) `run.mjs` 를 돌린다. 단계마다 `supporter_builds` 갱신.
3. 완료되면 `preview_url` 이 기록되고, `/discovery/:id` 또는 `/supporters/:id` 의 "병원 확인 항목" 패널에 미리보기 링크와 입력 폼이 뜬다.
4. 병원이 입력하면 `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`
- `vercel` CLI 로그인 (배포 시). 병원당 프로젝트 `supporters-<id>` 를 만든다
- `templates/supporters-astro/` (supporters 에서 `npm run export:template`)

## 단가

글 생성 상한은 실행당 $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 등)에 기대면 다른 병원에서 못 잡는다 → 제목·본문 키워드 분류를 보강할 것.