---
task_id: task-2313
type: plan
scope: task
created: 2026-04-29
updated: 2026-04-29
status: completed
---

# 계획서: task-2313

**task**: task-2313
**목표**: 이미지 편집기에 서버 측 고급 AI 배경 제거(rembg) + 워터마크 삭제(simple-lama-inpainting) 엔드포인트 추가 및 프론트에서 프리미엄 버전으로 분기 처리
**승인**: 제이회장님
**근거**: Codex 사전 검증 완료 (리스크 7건 → 설계에 반영)

---

## 목표

1. 서버에 `/api/insuro/image/remove-bg` (rembg BiRefNet) 엔드포인트 추가
2. 서버에 `/api/insuro/image/remove-watermark` (simple-lama-inpainting) 엔드포인트 추가
3. PLAN_FEATURE_MAP에 `ai_image_premium: 프로` 추가
4. 프론트 planFeatureMap.ts에 `aiImagePremium` 항목 추가
5. 기존 AI 도구(ai-background, ai-watermark)에서 플랜별 분기: 프로 이상 → 서버 API, 그 외 → 기존 브라우저 처리
6. npm run build 성공, 서버 재시작 성공

## 범위

### 포함
- 서버: image_ai.py 신규 모듈 (배경 제거/워터마크 삭제)
- 서버: main.py에 라우터 등록 + PLAN_FEATURE_MAP 추가
- 서버: requirements.txt에 rembg, simple-lama-inpainting 추가
- 프론트: planFeatureMap.ts에 aiImagePremium 추가
- 프론트: PlanUpgradeDialog.tsx에 featureLabel 추가
- 프론트: useImageAI.ts에 서버 API 호출 분기 로직 추가
- 프론트: AIPanel.tsx에 "AI 고급" 배지/분기 UI 추가

### 제외 (다음 페이즈 이후)
- rembg 모델 프리로드 스크립트 (Phase 3은 스킵 — 첫 요청 시 자동 다운로드)
- IOPaint 복잡 설치 (simple-lama-inpainting으로 대체)
- 별도 "고급 AI" 버튼 추가 (기존 버튼에서 플랜별 분기)

## 위임 계획

- Phase 1 (서버): **카르티케야(백엔드)** — image_ai.py 모듈 생성, main.py 라우터 등록, requirements.txt 수정
- Phase 2 (프론트): **사라스바티(프론트엔드)** — planFeatureMap.ts, PlanUpgradeDialog.tsx, useImageAI.ts, AIPanel.tsx 수정
- Phase 3 (테스트): **하누만(테스터)** — test_plan_feature_parameterize.py에 ai_image_premium 케이스 추가

## 검증 기준

- 서버: `python3 -c "from image_ai import router"` → import 성공
- 서버: `grep "ai_image_premium" server/main.py` → 1건 이상
- 프론트: `grep "aiImagePremium" src/config/planFeatureMap.ts` → 1건
- 빌드: `npm run build` → exit 0
- 테스트: `pytest server/tests/test_plan_feature_parameterize.py` → PASS