# InsuWiki 출처/신뢰도 체계 설계 + Sync 아키텍처 재설계

## Lv.4 작업 — 5 Cycle Agent Meeting (Opus 모델)

## 배경

### 현재 상태
1. **정보 권위 계층** (RAG spec v2.1, 이미 정의됨):
   - 1순위: 약관 원문 (PDF) — 법적 효력
   - 2순위: 보험사 공식 소식지
   - 3순위: InsuWiki 위키 본문 — 내부 검증 지식
   - 4순위: 유튜브 채널 정보 — 참고만, 단독 인용 금지

2. **카카오 Q&A** — 권위 계층에 미정의. 전문가(이해철 등) 답변 포함하므로 3~4순위 사이
3. **사용자 직접 작성** — 3순위(위키 본문)이지만 검증 여부 구분 없음
4. **Document 타입** — sourceType/reliability 필드 없음
5. **대시보드 Sync** — `wiki` 컬렉션에 저장하지만 앱은 `documents` 컬렉션을 읽음 (불일치)

### 단톡방 목록 (향후 파이프라인 대상)
- "앞서가는 설계사, 스레드 보상스터디" — 이해철 프라임 전문가 운영, 보상/고지의무 전문
- "박준현의 1일1보" — 일일 보험 지식
- "강동훈과 운전자-자보" — 자동차보험/운전자보험 전문
- "보험가득 정보방" — 일반 보험 정보

### 참조 자료 (반드시 읽을 것)
1. RAG spec: `/home/jay/projects/insuwiki/docs/specs/260225-insuwiki-rag-spec-v2.1.md`
2. Document 타입 정의: `/home/jay/projects/insuwiki/nextapp/src/types/firestore.ts` (라인 65~117)
3. InsuranceChunk sourceType: 같은 파일 라인 300
4. YouTube 3-Layer 권위 계층: `/home/jay/projects/insuwiki/docs/plans/260303-youtube-3layer-plan.md`
5. 기능 레지스트리: `/home/jay/workspace/memory/specs/insuwiki/feature-registry.md`
6. 현재 sync 코드: `/home/jay/workspace/dashboard/server.py` 라인 4462~4533
7. 인슈위키 앱 fetchDocuments: `/home/jay/projects/insuwiki/nextapp/src/app/page.tsx` 라인 103~137

## Agent Meeting 설정

### 참석 페르소나 (5명)
1. **데이터 아키텍트** — Firestore 스키마, 컬렉션 설계, 데이터 정합성
2. **도메인 전문가 (보험)** — 보험 정보의 권위 체계, 실무 관점에서 신뢰도 판단 기준
3. **프로덕트 매니저** — 사용자 경험, 출처 표시 UX, 향후 확장성
4. **보안/무결성 담당** — 데이터 무결성, 승인 워크플로우, 오염 방지
5. **레드팀(비판자)** — 오버엔지니어링 방지, 현실적 한계, MVP 범위 설정

### 5 Cycle 의제

**Cycle 1: 권위 계층 확장**
- 카카오 Q&A의 위치는? (단톡방별 차이 고려)
- 사용자 직접 작성 문서의 검증 체계는?
- 향후 추가될 수 있는 출처 유형은? (논문, 판례, 금감원 자료 등)

**Cycle 2: Document 스키마 설계**
- Document 타입에 어떤 필드를 추가할 것인가?
- sourceType 값 목록 확정
- reliability 등급 체계 (몇 단계? 자동 vs 수동?)
- 단톡방 구분 방법 (sourceRef 구조)

**Cycle 3: Sync 아키텍처 재설계**
- `wiki` → `documents` 컬렉션 전환 상세
- 필수 필드 매핑 (wiki_entries.json → Document 타입)
- 기존 documents와의 충돌 방지 (ID 체계)
- 대시보드 승인 → Firestore sync → 인슈위키 표시 전체 플로우

**Cycle 4: 인슈위키 앱 UI 반영**
- 출처/신뢰도 배지 표시 위치와 디자인
- 카테고리(의료/손해/자산/실무)와 출처 카테고리(카카오QA/약관/유튜브) 병존 방식
- 필터링/정렬에 출처 활용 가능한가
- 단톡방별 필터도 필요한가

**Cycle 5: 구현 로드맵**
- Phase 분리 (MVP → 확장)
- 기존 코드 수정 범위 최소화 방안
- 마이그레이션 전략 (기존 documents에 영향 없이)
- 테스트 전략

### 출력물
- 설계서: `/home/jay/workspace/memory/specs/insuwiki/source-authority-design.md`
- 구현 로드맵: Phase별 작업 목록
- 보고서: `/home/jay/workspace/memory/reports/task-1589.md`

## 보고서
`/home/jay/workspace/memory/reports/task-1589.md`에 작성