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

# 계획서: task-2123

**task**: task-2123
**목표**: InsuRo API 서버 systemd 서비스에 .env 환경변수 로드 추가
**승인**: 아누 (자동 dispatch)
**근거**: insuro-api.service에 EnvironmentFile 미설정으로 Naver API 키 에러 발생

---

## 목표

systemd로 실행되는 InsuRo API 서버가 .env 파일의 환경변수(NAVER_SEARCHAD_*, NAVER_CLIENT_* 등)를 정상적으로 로드하여 "Naver API 키가 서버에 설정되지 않았습니다" 에러를 해소한다.

## 범위

### 포함
- 방법 B: server/main.py에 python-dotenv 로드 코드 추가
- 방법 A: insuro-api.service에 EnvironmentFile 추가 (보조)
- requirements.txt에 python-dotenv 의존성 추가
- systemd daemon-reload + 서비스 재시작
- API 동작 검증

### 제외 (다음 페이즈 이후)
- Naver API 엔드포인트 로직 변경
- .env 파일 내용 변경

## 위임 계획

- python-dotenv 코드 추가 + systemd 수정 + requirements.txt: **카르티케야(백엔드)** — Sonnet

## 검증 기준

- 서비스 재시작: `systemctl --user restart insuro-api` → active (running) 확인
- 환경변수 로드: `/proc/{PID}/environ`에서 NAVER_* 5개 변수 존재 확인
- API 헬스체크: `curl localhost:8001/api/status` → 200 OK
- 에러 해소: journal 로그에 ImportError/환경변수 에러 0건