# InsuWiki AI 노드 자동 연결 — 맥락노트

**버전**: v1.0
**작성일**: 2026-03-22

---

## 1. 결정 근거

### B안 선택 (기존 도구 검증 → 이식)
- A안(바로 구축)은 리스크 높음 — 보험 도메인 AI 환각 시 금소법 위반
- B안은 기존 InsuWiki 인프라(Gemini embeddings, Firestore Vector Search)를 활용하므로 추가 인프라 최소화
- 제이회장님 확정 (2026-03-22)

### AI 백엔드: 아누 서버
- 외부 AI API 직접 사용 금지 — 아누 서버를 통해서만 Claude 호출
- 비용 제어 + 보안 중앙화 + 감사 추적 일원화

### Gemini 임베딩 + Claude 의미 분석 역할 분리
- Claude에 embedding API 없음 (토르 확인) → Gemini 768-dim 유지 필수
- Claude는 의미적 관계 분석/설명에 강점 → Phase 2에서 활용
- 두 AI의 역할이 명확히 다르므로 공존에 문제 없음

### Cloud Function → 아누 REST 직접 호출 (Firestore 이벤트 큐 기각)
- 500문서 미만에서 이벤트 큐는 과잉 설계 (오딘)
- 큐 관리 오버헤드 > 직접 호출 오버헤드
- 확장 전환점: 동시 50+/분 → 그때 큐 전환 검토
- Cloud Function 자체 retry로 재시도 충분

### Phase 0 보안 축소 (전체 보안 프레임워크 → Rules만)
- Phase 1-A는 정적 매칭이라 외부 통신 없음 → 전체 보안 불필요
- 하지만 스키마 오염은 나중에 잡기 어려움 → validation rule은 선행 (불칸)
- 본격 보안(HMAC, rate limit)은 Phase 2 직전에 구축

### 한국어 형태소 분석기 불채택
- Cloud Function에 올리면 패키지 200MB+, 콜드스타트 5초+ (토르)
- 보험 용어는 도메인 특화 → 일반 형태소 분석기 부정확 ("무배당종신보험" 잘못 분리)
- 정규화 테이블(50-100개)로 대체, Phase 1-B 임베딩이 의미적 매칭 자동 해결
- ROI 부적합 판정

### 신뢰도 임계값 95/70
- 미미르 제안, 전원 동의
- 단, 하드코딩 금지 → Firestore config 문서에 외부화
- Phase 1-B에서 50건 실측 후 데이터 기반 조정

---

## 2. 기각된 대안

### A안: 바로 전체 구축
- 리스크: 검증 없이 AI 파이프라인 전체 구축 시 환각 리스크
- 기각 이유: 보험 도메인 특수성 (금소법) 때문에 단계적 검증 필수

### Firestore 이벤트 큐 통신
- 오딘 초기 제안 → 본인이 Cycle 2에서 기각
- 기각 이유: 500문서에서 과잉, 홉 2개 추가, 복잡도 대비 이점 없음

### LLM-only 추천 (임베딩 제거)
- 토르 비관습적 대안
- 장점: 인프라 절반 감소, 구현량 40% 감소
- 기각 이유: 1000문서 초과 시 컨텍스트 한계, 토큰 비용 선형 증가, 확장성 부족

### Phase 1-A만 출시 (AI 단계 전체 포기)
- 로키 DA 권고
- 부분 수용: Go/No-Go 게이트로 반영. Phase 1-A 실측 후 결정.
- 전면 기각 이유: 제이회장님이 AI 자동 연결을 원하시므로, 최소한 검증 시도는 필요

---

## 3. 주의사항

### 금소법 관계 환각 방어 (최우선)
- fact_guard는 수치만 잡음 → 관계 환각은 별도 메커니즘 필요
- Claude 추천 시 "왜 관련되는지" 설명 강제
- 95% 미만 전부 사용자 승인 필수
- AI 링크 status: "pending" → 자동 반영 금지

### 운영 부담 관리
- 제이회장님 1인 운영 — AI 파이프라인 2개(Gemini+Claude)는 부담 가능성
- Phase 1-A 실측 게이트가 이 리스크 방어
- 자동화 최대화, 수동 개입 최소화 설계

### Gemini 모델 의존성
- 768-dim 모델 deprecated 시 벡터 전량 재생성 필요
- content_hash로 stale 감지 가능
- 재생성 비용은 미미 ($0.01 미만 / 500문서)

### HMAC 키 보안
- Cloud Secret Manager 사용
- 90일 자동 로테이션
- 환경변수 하드코딩 금지

---

## 4. 참조 자료

- **InsuWiki 코드**: `/home/jay/projects/insuwiki/`
- **미팅 기록**: `memory/meetings/2026-03-22-insuwiki-ai-auto-linking.md`
- **insurance_terms 컬렉션**: Firestore
- **기존 WikiLink Functions**: `/home/jay/projects/insuwiki/functions/`
- **fact_guard 참조**: `/home/jay/projects/ThreadAuto/fact_guard.py`