# task-1692.1 완료 보고서
> InsuWiki 검토 아이콘 — 대시보드 insight 미승인 리스트 연동 (Lv.4)

## S - Situation
InsuWiki 앱의 검토 아이콘(Review)이 member 작성 문서의 대기열을 보여주고 있었으며, 대시보드 인슈위키 탭에서 생성된 텍스트 분석 insight와는 연동되지 않는 상태였다. 대시보드에는 105개의 wiki_entries가 wiki-statuses.json으로 상태 관리 중이다.

## C - Complication
검토 아이콘이 올바른 데이터(대시보드 insight 미승인 리스트)를 표시하지 않아, reviewer가 insight를 검토/승인하는 워크플로우가 존재하지 않았다. 또한 InsuWiki ↔ 대시보드 간 양방향 상태 연동이 없어 승인 상태가 불일치할 수 있었다.

## Q - Question
검토 아이콘이 대시보드 insight 미승인 리스트를 실시간 표시하고, 승인 시 위키 카드 생성 + 대시보드 상태 자동 동기화를 달성할 수 있는가?

## A - Answer
Firestore documents 컬렉션에 pending insight를 push하고, InsuWiki 검토 큐 쿼리를 `sourceType=dashboard_insight, status=pending`으로 변경하여 실시간 연동 구현. 승인 API가 Firestore 문서 상태 업데이트 + wiki 컬렉션 카드 생성 + 대시보드 API 호출을 원자적으로 수행. pytest 10건 전체 통과, pre-existing pyright 1건(server.py 복잡도) 외 신규 에러 0건.

---

## 변경 사항

### Dashboard (server.py)
- `POST /api/wiki/sync-firestore`: draft 상태 엔트리도 Firestore에 `status: pending`, `sourceType: dashboard_insight`로 push
- draft 엔트리는 `wiki` 컬렉션에는 push하지 않음 (승인 시에만)
- CORS 기본값에 `http://localhost:3000` 추가 (InsuWiki 크로스 오리진 허용)

### InsuWiki 앱
- `types/firestore.ts`: SourceType에 `dashboard_insight`, DocumentStatus에 `pending` 추가, Document 인터페이스에 `insightEntryId`, `originalSourceType` 필드 추가
- `useReviewQueueListener.ts`: 쿼리를 `sourceType==dashboard_insight AND status==pending` ORDER BY `updatedAt DESC`로 변경. ReviewQueueItem에 category, expert, question, answer 필드 추가
- `review/page.tsx`: 인라인 승인/반려 UI로 전면 교체. 아이템 확장 시 질문/답변 표시, 반려 시 comment 입력 textarea 표시
- `api/wiki/insights/[id]/review/route.ts` (신규): 승인 시 Firestore 문서 approved + wiki 컬렉션 카드 생성 + 대시보드 API sync. 반려 시 rejected 상태 + 대시보드 sync. entryId 빈값 검증 포함
- `firestore.indexes.json`: `sourceType + status + updatedAt` 복합 인덱스 추가

---

## 산출물 파일

- `/home/jay/workspace/dashboard/server.py` (수정)
- `/home/jay/projects/insuwiki/.worktrees/task-1692.1-dev1/nextapp/src/types/firestore.ts` (수정)
- `/home/jay/projects/insuwiki/.worktrees/task-1692.1-dev1/nextapp/src/hooks/useReviewQueueListener.ts` (수정)
- `/home/jay/projects/insuwiki/.worktrees/task-1692.1-dev1/nextapp/src/app/review/page.tsx` (수정)
- `/home/jay/projects/insuwiki/.worktrees/task-1692.1-dev1/nextapp/src/app/api/wiki/insights/[id]/review/route.ts` (신규)
- `/home/jay/projects/insuwiki/.worktrees/task-1692.1-dev1/firestore.indexes.json` (수정)
- `/home/jay/projects/insuwiki/.worktrees/task-1692.1-dev1/nextapp/src/hooks/__tests__/useReviewQueueListener.test.ts` (수정)

---

## 발견 이슈 및 해결

### 자체 해결 (3건)
1. **entryId 빈값 미검증** — API route에 entryId 빈값 시 400 반환 검증 추가 (`route.ts:59-63`)
2. **reject 시 comment 미전송** — 반려 버튼 클릭 → comment textarea 토글 → 확인 버튼으로 comment 포함 전송 (`page.tsx:270-293`)
3. **테스트 기대값 불일치** — `useReviewQueueListener.test.ts`의 where 기대값을 새 쿼리 조건으로 업데이트

### 범위 외 미해결 (1건)
1. **server.py:1284 pyright 복잡도 경고** — pre-existing 이슈. do_GET 메서드의 전체 복잡도 문제로 본 작업 범위 외. 근본 해결은 do_GET 리팩터링 필요.

---

## 테스트 결과
- pytest: 10 passed, 1 warning (dashboard test_server.py)
- 프론트엔드: worktree에 node_modules 미설치로 TypeScript 타입 검증 제한 (firebase/firestore 모듈 해석 불가). 모든 TS 에러가 pre-existing 모듈 해석 문제.

---

## 머지 판단
- **머지 필요**: Yes
- **브랜치**: task/task-1692.1-dev1
- **워크트리 경로**: /home/jay/projects/insuwiki/.worktrees/task-1692.1-dev1
- **머지 의견**: pytest 10건 전체 통과. Firestore 인덱스 추가로 프로덕션 배포 전 `firebase deploy --only firestore:indexes` 실행 필요. 대시보드 server.py는 워크트리 외부(직접 수정)이므로 별도 배포 관리 필요.

---

## 모델 사용 기록
- 불칸(백엔드): sonnet / server.py sync-firestore 수정 + CORS
- 이리스(프론트엔드): sonnet / 타입, 훅, 페이지, API 라우트, 인덱스 수정
- 이리스(프론트엔드): sonnet / QC 이슈 3건 수정
- 마아트(QC): sonnet / 독립 검증 (3건 이슈 발견)

---

## QC 검증 결과

```json
{
  "task_id": "task-1692.1",
  "overall": "PASS (재검증 후)",
  "checks": {
    "api_health": "SKIP",
    "file_check": "PASS",
    "data_integrity": "PASS",
    "test_runner": "PASS (10 passed, 0 failed)",
    "tdd_check": "WARN (구현 먼저 수정)",
    "pyright_check": "WARN (pre-existing: server.py:1284 complexity)",
    "style_check": "WARN (black formatting)"
  }
}
```

## 세션 통계
- 총 도구 호출: 28회

### 수정 파일 목록
- /home/jay/projects/insuwiki/.worktrees/task-1692.1-dev1/nextapp/src/app/review/page.tsx: 9회 (Edit)
- /home/jay/workspace/dashboard/server.py: 4회 (Edit)
- /home/jay/projects/insuwiki/.worktrees/task-1692.1-dev1/nextapp/src/hooks/useReviewQueueListener.ts: 3회 (Edit)
- /home/jay/projects/insuwiki/.worktrees/task-1692.1-dev1/nextapp/src/types/firestore.ts: 3회 (Edit)
- bash_cmd: 3회 (Bash)
- /home/jay/projects/insuwiki/.worktrees/task-1692.1-dev1/nextapp/src/app/api/wiki/insights/[id]/review/route.ts: 2회 (Edit, Write)
- /home/jay/projects/insuwiki/.worktrees/task-1692.1-dev1/firestore.indexes.json: 1회 (Edit)
- /home/jay/projects/insuwiki/.worktrees/task-1692.1-dev1/nextapp/src/hooks/__tests__/useReviewQueueListener.test.ts: 1회 (Edit)
- /home/jay/workspace/memory/reports/task-1692.1.md: 1회 (Write)
- /home/jay/workspace/memory/tasks/task-1692.1.md: 1회 (dispatch)

### 도구 사용 현황
- Edit: 22회
- Bash: 3회
- Write: 2회
- dispatch: 1회