---
task_id: task-2232
type: plan
scope: task
created: 2026-04-27
updated: 2026-04-27
status: completed
---

# 계획서: task-2232

**task**: task-2232
**목표**: InsuRo → InsuWiki 소식지 데이터 단방향 push 연계
**승인**: Codex 사전 검증 PASS (2026-04-27)
**근거**: task-2232.md + Codex gate 리뷰 반영

---

## 목표

InsuRo에서 소식지/보험료 PDF 업로드 후, 추출된 텍스트 데이터를 InsuWiki Firestore에 자동 push하고, InsuWiki UI에서 최근 업데이트를 표시한다.

## 범위

### 포함
- Phase 1: InsuWiki 수신 API (POST /api/newsletter-sync)
- Phase 2: InsuRo push 함수 (BackgroundTasks + httpx)
- Phase 3: InsuWiki UI 컴포넌트 (Server Component)
- Phase 4: 빌드 검증 (양쪽 npm run build)

### 제외 (다음 페이즈 이후)
- outbox 테이블 / 재시도 큐 (현재 규모에서 불필요)
- PII 마스킹 (소식지 텍스트는 공개 정보)
- Firestore 클라이언트 SDK 직접 조회 (Server Component에서 admin SDK 사용)

## 위임 계획

- Phase 1 (InsuWiki API): **카르티케야(백엔드)** — TypeScript API Route
- Phase 2 (InsuRo push): **카르티케야(백엔드)** — Python FastAPI
- Phase 3 (InsuWiki UI): **사라스바티(프론트엔드)** — React Server Component
- Phase 4 (빌드/테스트): **하누만(테스터)** — npm run build 양쪽
- Firestore rules: **카르티케야** — firestore.rules 수정

## 검증 기준

- InsuWiki API: `curl -X POST .../api/newsletter-sync -H "x-api-key: test"` → 200/401 확인
- InsuRo build: `cd /home/jay/projects/InsuRo && npm run build` → 성공
- InsuWiki build: `cd /home/jay/projects/insuwiki/nextapp && npm run build` → 성공