# InsuRo 증권분석/보장분석 지식화 — 코드맵 + 진행상황 (재개 가이드)

> **목적**: 컨텍스트 리셋 후에도 이 문서 하나로 "어디까지 됐고 어디부터 이어서"를 즉시 파악. 최종 갱신 2026-08-13 KST.
> **단일소스(설계)**: `memory/plans/insuro-policy-analysis_260812/{plan,context-notes,checklist}.md` · taxonomy `memory/project_insuro_cancer_coverage_taxonomy_260812.md`

## 1. 코드맵 (InsuRo repo = Jeon-Jonghyuk/InsuRo, server/)

| 모듈 | 역할 | 태스크 | 상태 |
|---|---|---|---|
| **server/policy_grouping/** | 약관 정독→판별축→taxonomy grouping→학습형 HITL **엔진** (axes·clause_splitter·mapper·hitl·knowledge·pipeline·reading·prompts·cli) | task-2938 | ✅ **PR#208 MERGED** (main ba63045) |
| **server/policy_extract/** | 증권(PDF/JPG) 추출: textlayer(좌표파서)+vision(아누 무학습)+detect+models+grouping_bridge | task-2943 | ✅ **PR#209 MERGED** (main 50d1bc0) |
| **server/policy_normalizer.py** | 담보→대구분 10종 정규화(순서고정) | task-2943 | ✅ MERGED |
| **server/silson/** | 실손 **세대**(1~5세대·노후·유병력자) 지식화: classify(가입일→세대 판별)·knowledge·models·analysis_bridge + migration 018 | task-2947 | 🔄 **finalize 중**(QA합격, 미추적 10파일 커밋+PR 대기) |

## 2. Phase 진행 (plan.md 기준)
- **Phase 0 (스파이크·게이트)**: ✅ 완료 (task-2937). 정독 FULL_PARSER 확정
- **Phase 1a (보장분석 백엔드)**: ✅ **완료·머지** (증권추출+정규화+grouping 연결). 실증권 91담보 추출, recall 73.9%(실손 원문부재 제외 100%)
- **Phase 2 (grouping 엔진+지식DB)**: ✅ 엔진 머지. 실손 세대 지식화 finalize 중. **약관 정독→지식DB 축적(cold start 해소)은 미착수**
- **Phase 1b (보장분석 output UI)**: ❌ 미착수 (강연우 양식 표·프린트·검수 화면)
- **Phase 3 (신규설계 비교)**: ❌ 미착수 (잔여보험료 vs 신규보험료·토글)

## 3. 실증권/자료 (로컬, PII — repo 커밋 금지)
- 강연우 가족 증권: `/home/jay/.cokacdir/workspace/autoset/강연우가족증권/` (현대해상·교보·메리츠·우체국 5건)
- 실손 세대 자료: `/home/jay/.cokacdir/workspace/autoset/실비실손자료/` (5세대비교·변천사·KB총정리 16장)
- OCR 산출: `/home/jay/workspace/teams/dev2/task-2947/ocr/` (A-기준표·B/C-KB총정리)
- 강연우 정답 양식: `강연우(아들) 가입현황 260115.pdf`

## 4. 다음 작업 (우선순위, 재개 시 여기부터)
1. **[진행중] task-2947 실손 지식화 finalize** → PR 나오면 ANU 독립검증+머지. 실손 세대 지식이 Phase 1a 실손 갭 해소
2. **Phase 2 잔여**: 약관 정독→지식DB 축적으로 grouping cold start(현재 전건 설계사 질문 큐) 해소
3. **Phase 1b**: 보장분석 output UI (강연우 양식 표·대구분 순서고정·1~2장 프린트·검수 화면). ⚠️ brainstorming 선행(UX)
4. **Phase 3**: 신규설계 비교 (잔여보험료 vs 신규보험료·선택토글·가입한도 비례재계산)

## 5. 회장 결정/확인 대기
- 실손 갭: 강연우 실손 증권 별도 존재 여부(원문부재 확정, 실손자료 지식화로 세대판별은 해소)
- Phase 1b UI 착수 시점 (Phase 2 잔여와 순서)
- 마이그레이션 018(실손) Supabase 수동 실행(rollout)

## 6. 핵심 원칙 (코드 불변식)
- **정독 원칙**: 키워드 매칭 금지, 약관 조항 전문 정독(법조문처럼)
- **이름매칭 grouping 금지**: 지식DB(정독 축적) 경유. cold start=설계사 질문 큐
- **금소법**: 수치 환각 0, UNKNOWN 정책(억지배분 금지), 계산=결정적 함수
- **아누시스템 vision**: 무학습(stateless), 학습은 지식DB에만