# task-1573.1 완료 보고서: 인슈위키 위키 항목 v2 파이프라인 재구축

## SCQA

**S**: task-1557에서 kakao_knowledge v2 파이프라인(Phase 1-3)이 완성되어 다층 LLM 추출, 지식 그래프, 벡터DB 기능이 준비되었다. 기존 wiki_entries.json은 v1 파이프라인으로 추출된 395개 항목(5개 카테고리)이 저장되어 있다.

**C**: v2 파이프라인이 15개+ 카테고리, 인사이트 유형 분류, 지식 그래프 등 고도화된 기능을 제공하나, 기존 데이터가 v1 포맷이어서 v2 기능을 활용할 수 없다.

**Q**: v2 파이프라인으로 원본 카카오톡 txt를 재분석하여 기존 위키 항목을 교체하고, 지식 그래프와 벡터DB를 구축할 수 있는가?

**A**: 원본 32,946줄을 v2 파이프라인으로 재분석하여 645건의 인사이트를 추출했다(v1 대비 63% 증가). 17개 카테고리로 분류되고, 지식 그래프(645노드/134,519엣지)와 벡터DB가 구축되었다. pytest 261건 전체 통과.

## 작업 내용

### Step 0: task-1557 브랜치 merge
- `task/task-1557.1-dev3` 브랜치를 master에 merge 완료
- v2 파이프라인 코드 4,117줄 추가 (knowledge_extractor_v2.py, knowledge_graph.py, vector_store.py 등)

### Step 1: 기존 데이터 백업 및 삭제
- `wiki_entries.json.bak.v1-final` 백업 생성 (446,135 bytes)
- wiki.db는 워크트리에 미존재 (백업 불필요)
- wiki_entries.json을 빈 배열 `[]`로 초기화

### Step 2: v2 파이프라인 실행
- 규칙 기반 추출 (ANTHROPIC_API_KEY 미설정으로 LLM 폴백)
- 입력: 7,328 메시지 / 385명 사용자
- 출력: 645건 인사이트 (wiki_entries_v2.json, 2.2MB)
- 소요 시간: 1초 미만

### Step 3: 결과 검증 및 저장
- wiki_entries_v2.json → wiki_entries.json 복사
- wiki.db import 완료 (645/645건)
- 기존 v1 잔류 데이터 145건 발견 → DELETE 처리 완료

### Step 4: 지식 그래프 + 벡터DB 구축
- 지식 그래프: 645 노드, 134,519 엣지
- 벡터 DB (ChromaDB): 645건 upsert 완료
- 인사이트 마크다운: 645개 파일 생성

### Step 5: 최종 검증
- stats: 645건, 17개 카테고리
- 검색 테스트: "광응고술" → 2건, "고지의무" → 20건 히트
- 유사 검색: "고지의무 위반" → 5건 반환 (distance 0.37~0.40)
- pytest 261건 전체 PASS (84초)

## 정량적 결과

- v1 → v2 항목 수: 395 → 645 (+63%)
- v1 → v2 카테고리: 5 → 17
- v1 → v2 필드 수: 10 → 16 (신규 8개: confidence, key_points, participants, raw_thread, related_topics, summary, tags, type)
- 지식 그래프: 645 nodes / 134,519 edges
- 벡터 DB: 645 vectors (ChromaDB 9.4MB)
- 테스트: 261/261 passed

## 카테고리 분포

- 보상/일반: 312건
- 기타: 109건
- 고지의무: 64건
- 약관해석: 43건
- 의학지식: 27건
- 보상/자동차: 23건
- 상품비교: 19건
- 언더라이팅: 15건
- 손해사정: 11건
- 고객관리: 7건
- 영업노하우: 3건
- 민원처리: 3건
- 법률/판례: 2건
- 디지털/IT: 2건
- GA운영: 2건
- 보상/장기: 2건
- 세금/절세: 1건

## 인사이트 유형 분포

- qa: 428건
- case_analysis: 82건
- regulation_interpretation: 61건
- practical_tip: 29건
- regulation_change: 27건
- warning: 13건
- expert_opinion: 5건

## 발견 이슈 및 해결

### 자체 해결 (3건)
1. **__pycache__ 파일로 merge 실패** — git stash + checkout으로 정리 후 merge 성공
2. **wiki.db에 v1 데이터 145건 잔류** — wiki_store.py의 _DEFAULT_DB_PATH가 메인 프로젝트 절대경로로 하드코딩되어 워크트리가 아닌 메인 DB에 import됨. DELETE FROM wiki_entries WHERE id LIKE 'kakao-%' + FTS rebuild로 해결
3. **중복 title 24건 (7종)** — 공지/템플릿 메시지 반복 등장. 내용(answer)은 서로 달라 실제 별개 항목. 현재 영향 없으므로 후속 정제 시 필터링 권장

### 범위 외 미해결 (2건)
1. **confidence 값 전체 "medium" 고정** — LLM 미사용(ANTHROPIC_API_KEY 미설정)으로 규칙 기반 폴백 시 수치화 미적용. API 키 설정 후 --use-llm으로 재실행 시 해결
2. **wiki_store.py 하드코딩 경로** — `_DEFAULT_DB_PATH`가 `/home/jay/projects/insuwiki/data/wiki.db`로 절대경로 하드코딩. 워크트리 환경에서 의도와 다른 DB에 접근. 별도 리팩토링 태스크 필요

## 산출물 파일

- `/home/jay/projects/insuwiki/.worktrees/task-1573.1-dev1/scripts/kakao_knowledge/wiki_entries.json`
- `/home/jay/projects/insuwiki/.worktrees/task-1573.1-dev1/scripts/kakao_knowledge/wiki_entries_v2.json`
- `/home/jay/projects/insuwiki/.worktrees/task-1573.1-dev1/scripts/kakao_knowledge/wiki_entries.json.bak.v1-final`

## 머지 판단
- **머지 필요**: Yes
- **브랜치**: task/task-1573.1-dev1
- **워크트리 경로**: /home/jay/projects/insuwiki/.worktrees/task-1573.1-dev1
- **머지 의견**: pytest 261건 전체 통과. v2 데이터 645건 정상 생성/검증 완료. 충돌 가능성 낮음 (wiki_entries.json만 변경). merge 권장.

## 모델 사용 기록

- 팀원: 불칸(백엔드) / 작업 내용: Step 1-2 백업+파이프라인 실행 / 사용 모델: sonnet / 정당성: -
- 팀원: 아르고스(테스터) / 작업 내용: Step 3 결과 검증 / 사용 모델: sonnet / 정당성: -
- 팀원: 불칸(백엔드) / 작업 내용: Step 3-5 저장+그래프구축+최종검증 / 사용 모델: sonnet / 정당성: -

## 셀프 QC

- [x] 1. 이 변경이 다른 파일에 영향을 미치는가? → wiki_entries.json만 변경. data/ 하위 생성 파일은 git 미추적.
- [x] 2. 엣지 케이스: 빈 title/answer 0건. 중복 title 24건은 내용 상이하여 유효.
- [x] 3. 작업 지시와 정확히 일치: Step 0-5 전체 수행 완료. (단, --use-llm은 API 키 부재로 규칙 기반 폴백)
- [x] 4. 에러 처리: 파이프라인 에러 없음. wiki.db 잔류 데이터 발견 즉시 정리.
- [x] 5. 테스트: 261건 전체 통과.
- [x] 6. 발견 이슈 3건 자체 해결, 2건 범위 외 명시.
- [x] 7. 코드 아키텍처: 기존 코드 수정 없음, 데이터만 변경.
- [x] 8. 인터페이스 변경 없음.
- [x] 9. 이미지/배너 작업 없음.