---
task_id: task-2111
type: plan
scope: task
created: 2026-04-23
updated: 2026-04-23
status: completed
---

# 계획서: task-2111

**task**: task-2111
**목표**: InsuRo 프론트엔드 API URL을 Tailscale 내부 URL에서 api.insuro.biz로 변경하여 외부 접근 시 네트워크 오류 해결
**승인**: 아누 2026-04-23 "아누 디버깅 완료, 근본 원인 확인됨"
**근거**: task-2111.md (아누 디버깅 결과)

---

## 목표

- `.env`에 `VITE_INSURO_API_URL=https://api.insuro.biz` 추가
- `npm run build` 성공
- insuro.biz에서 API 호출 시 네트워크 오류 없음

## 범위

### 포함
- `.env` 파일에 VITE_INSURO_API_URL 환경변수 추가
- server/main.py CORS allow_origins에 insuro.biz 추가
- VITE_API_URL 사용처를 INSURO_API_BASE로 통일 (3개 파일)
- 빌드 및 배포 (git push → Cloudflare Pages 자동 배포)

### 제외 (다음 페이즈 이후)
- Cloudflare Tunnel 설정 변경 (이미 정상 작동 확인됨)
- 백엔드 API 서버 재시작 (아누 판단 필요)
- .env 민감정보 분리 (.gitignore 추가 등 — 별도 작업 권장)

## 위임 계획

- .env 수정 + API URL 통일: **이리스(프론트)** — 프론트엔드 설정 변경
- CORS 수정: **불칸(백엔드)** — 서버 설정 변경

## 검증 기준

- API 접근: `curl -s https://api.insuro.biz/api/status` → `{"status":"ok"}`
- 빌드: `npm run build` → exit code 0
- .env 확인: `grep VITE_INSURO_API_URL .env` → https://api.insuro.biz
- 빌드 결과: `grep "api.insuro.biz" dist/` → 포함됨