---
task_id: task-2111
type: context
scope: task
created: 2026-04-23
updated: 2026-04-23
status: in-progress
---

# 맥락 노트: task-2111

**task**: task-2111

---

## 결정 근거

### .env 수정 방식 선택 (api.ts 직접 수정 vs .env 환경변수)
- .env 환경변수 방식 선택: 배포 환경별 설정 분리 가능
- api.ts 직접 수정 기각: Tailscale 로컬 개발 시에도 fallback이 유용

### 3 Step Why
1st Why: "왜 이 설계가 필요한가?"
→ 외부 사용자가 insuro.biz에서 Tailscale 내부 URL에 접근할 수 없어 네트워크 오류 발생

2nd Why: "왜 .env 환경변수 추가가 최선의 접근인가?"
→ api.ts의 fallback 구조를 유지하면서, 프로덕션에서만 외부 URL을 사용할 수 있음. 로컬 개발 환경에서는 Tailscale URL이 여전히 유용

3rd Why: "왜 .env 수정이 api.ts 직접 하드코딩보다 나은가?"
→ 환경별 설정 분리 원칙 준수. 향후 staging 환경 등 다른 환경 추가 시 유연성 확보. api.ts는 수정 없이 환경변수만으로 동작 변경 가능

## 참조 자료

- 작업 지시서: `/home/jay/workspace/memory/tasks/task-2111.md`
- API 설정: `/home/jay/projects/InsuRo/src/config/api.ts`

## 주의사항

- .env 파일은 git에 포함될 수 있으므로 기존 .gitignore 확인 필요
- Cloudflare Pages 빌드 시 환경변수가 별도로 설정되어 있을 수 있음 → Cloudflare Dashboard 확인 권장