# InsuWiki 서비스 피드백 6건 수정 — 제이회장님 직접 검수 결과

## Lv.4 작업

## 배경
InsuWiki Phase 1~3 배포 후 제이회장님이 서비스를 직접 검수하여 6건의 피드백을 주셨다.
버그 수정 + 기능 방향 수정 + UX 개선이 혼합된 중요 작업.

## 피드백 스크린샷 (필수 확인)
- `/home/jay/.cokacdir/workspace/autoset/photo_AQADZA1rG_il2FZ-.jpg` — 문서 상세 (원문 없음, 수집일 없음)
- `/home/jay/.cokacdir/workspace/autoset/photo_AQADZQ1rG_il2FZ-.jpg` — AI 추천 관련 문서 + 용어 매칭 그래프
- `/home/jay/.cokacdir/workspace/autoset/photo_AQADaA1rG_il2FZ-.jpg` — 검토 아이콘(23) + 메인 화면

## 수정 6건

### 1. [버그] 단톡방 원문 사라짐
- 기존: Q/A 아래에 단톡방 대화 원문이 표시되어 사용자가 맥락을 직접 확인 가능
- 현재: Q/A만 남고 원문이 없어짐
- 원인 추정: Phase 2a SourceBadge→TrustBadge 마이그레이션 시 QnaRenderer 또는 DocumentClient에서 원문 표시 부분이 누락
- **수정**: 단톡방 대화 원문 표시 복원
- 참조: `/home/jay/projects/insuwiki/nextapp/src/components/QnaRenderer.tsx`, `/home/jay/projects/insuwiki/nextapp/src/app/docs/[id]/DocumentClient.tsx`

### 2. [버그] 수집일 미표시
- "수집일:" 라벨은 있는데 실제 날짜 값이 비어있음
- 원인 추정: sourceMeta.collectedAt 또는 sourceDate 필드가 렌더링 코드에서 누락
- **수정**: "수집일:" 옆에 실제 수집 날짜 표시
- 참조: DocumentClient.tsx에서 sourceDate/sourceMeta 렌더링 부분 확인

### 3. [기능 수정] AI 추천 관련 문서 + 용어 매칭 분리
**현재 문제**: "AI 추천 관련 문서"라는 제목으로 용어 매칭(수술 100%, 보험설계사 90% 등)이 표시되는데, 클릭하면 존재하지 않는 문서로 이동 (404). 기존에는 실존하는 문서를 링크해서 클릭 시 해당 문서로 이동하는 기능이었음.

**수정 — 2가지 영역으로 분리**:

A. **AI 추천 관련 문서 (기존 기능 복원)**:
   - Firestore documents 컬렉션에서 **실존하는** 유사 위키 카드 Top 5 표시
   - 클릭 시 해당 문서 `/docs/{id}`로 정상 이동
   - 존재하지 않는 문서는 절대 추천하지 않음
   - 유사도 기준: 같은 카테고리 + 키워드 교집합 또는 제목 유사도

B. **AI 용어 감지 (별도 섹션)**:
   - 현재 용어 매칭 진행률 바(100%/90%/70%)와 ✅/✗ 확인 버튼
   - "AI 추천 관련 문서" 영역에서 분리 → 별도 섹션으로 이동
   - 제목 변경: "AI 용어 감지" 또는 "보험 용어 매칭"
   - 사용자 피드백(✅/✗)으로 정교화하는 용도

### 4. [UX 수정] 검토 상태 버튼 매핑
- **현재 문제**: 이미 "발행됨" 상태인 문서에 승인/수정요청/거절 버튼이 표시됨
- **수정**: published 상태 문서에서 승인/수정요청/거절 버튼 완전 제거
- 이 버튼들은 5번 검토 아이콘의 미승인 리스트에서만 표시
- 참조: InlineReviewPanel 또는 ReviewActions 컴포넌트에서 status 조건 분기

### 5. [기능 방향 수정] 검토 아이콘(23) — 대시보드 insight 연동
**현재 구현 (잘못됨)**: 일반 member가 작성한 위키 문서의 승인 대기열

**올바른 기능 방향**:
- **데이터 소스 변경**: member 작성 문서 → **대시보드 인슈위키 탭에서 올린 단톡방 분석 insight(위키 항목)의 미승인 리스트**
- **member 직접 작성 문서**: 승인 불필요, 기존처럼 본인 이름으로 바로 게시
- **검토 대상**: 대시보드에서 텍스트 분석 → 생성된 위키 항목 insight 중 아직 승인/반려 결정 안 된 것만 표시
- **reviewer 승인 시 동작**: 대시보드 "인슈위키 sync" 버튼과 동일 효과 → 바로 인슈위키 서비스의 위키 카드로 적용
- **양방향 연동**: 
  - 인슈위키 앱에서 승인 → 대시보드 인슈위키 탭 상태도 "승인"으로 변경
  - 인슈위키 앱에서 반려 → 대시보드 인슈위키 탭 상태도 "반려"로 변경
  - 대시보드에서 승인 → 인슈위키 앱에서도 반영
- **승인/수정요청/거절 버튼**: 이 미승인 리스트 내에서만 표시 (4번에서 제거한 버튼의 올바른 위치)

**아이콘 UX 개선**:
- 아이콘 옆에 "Review" 또는 검토 필요를 의미하는 영문 텍스트 추가
- 검토 화면 진입 시 **최상단 메뉴바(InsuWiki 로고, Wiki/My/Daily 탭) 절대 유지** — 현재는 사라져서 불편
- "이전으로" 돌아가기 기능 추가

### 6. [UX 수정] 하단 그래프 → 3번과 통합
- 현재 문서 상세 하단에 표시되는 용어 매칭 그래프 → 3번-B "AI 용어 감지" 별도 섹션으로 이동

## 참조 파일
- InsuWiki 앱: `/home/jay/projects/insuwiki/`
- DocumentClient: `/home/jay/projects/insuwiki/nextapp/src/app/docs/[id]/DocumentClient.tsx`
- QnaRenderer: `/home/jay/projects/insuwiki/nextapp/src/components/QnaRenderer.tsx`
- 검토 UI 컴포넌트: `/home/jay/projects/insuwiki/nextapp/src/components/` 하위 Review* 파일
- 대시보드 인슈위키 탭: `/home/jay/workspace/dashboard/server.py` (wiki sync 관련)
- Firestore 타입: `/home/jay/projects/insuwiki/nextapp/src/types/firestore.ts`

## 테스트
1. 문서 상세 → 단톡방 원문 표시 확인
2. 문서 상세 → 수집일 날짜 표시 확인
3. AI 추천 관련 문서 → 실존 문서 Top 5 + 클릭 시 정상 이동
4. AI 용어 감지 → 별도 섹션, 진행률 바 + ✅/✗ 버튼
5. 발행됨 문서 → 승인/수정요청/거절 버튼 미표시
6. 검토 아이콘 → 대시보드 미승인 insight 리스트 표시
7. 검토에서 승인 → 위키 카드 즉시 적용 + 대시보드 상태 연동
8. 검토 화면 → 최상단 메뉴바 유지 + 이전으로 버튼

## 보고서
`/home/jay/workspace/memory/reports/task-{TASK_ID}.md`