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

# 계획서: task-2120

**task**: task-2120
**목표**: Cloudflare Pages 빌드에서 환경변수가 Vite import.meta.env로 반영되도록 vite.config.ts 수정 + .env.production 생성
**승인**: 아누 2026-04-23 "디버깅 완료, 방법 A+B 조합 권장"
**근거**: task-2115에서 .env가 git에서 제거되어 Vite 빌드 시 환경변수 미반영 → fallback URL 하드코딩 문제

---

## 목표

1. vite.config.ts에 `define` 섹션을 추가하여 `process.env.VITE_*` → `import.meta.env.VITE_*` 매핑
2. `.env.production` 파일 생성 (공개 가능한 URL만 포함, 민감정보 제외)
3. `.gitignore`에서 `.env.production` 제외하여 git 추적 가능하게 설정
4. 빌드 후 dist에 `api.insuro.biz` 포함, `aidevserver` 미포함 확인

## 범위

### 포함
- vite.config.ts: define 섹션 추가 (process.env → import.meta.env 매핑)
- .env.production: 프로덕션 공개 URL 설정 파일 생성
- .gitignore: .env.production 제외 패턴 추가

### 제외 (다음 페이즈 이후)
- Cloudflare Pages 대시보드 환경변수 설정 변경
- api.ts fallback URL 변경 (현재 fallback은 개발환경 용도로 유지)

## 위임 계획

- vite.config.ts 수정: **이리스(프론트엔드)** — Vite 빌드 설정 관련
- .env.production + .gitignore: **이리스(프론트엔드)** — 프론트엔드 프로젝트 설정
- 빌드 검증: **아르고스(테스터)** — 빌드 산출물 검증

## 검증 기준

- 빌드 성공: `npm run build` → exit code 0
- API URL 반영: `grep -r "api.insuro.biz" dist/` → 최소 1건
- fallback URL 미포함: `grep -r "aidevserver" dist/` → 0건