# task-2865 보고서 — RP 배치2: 웹앱 비교블록4(D) + RP 순서 섹션(B) + 이동 딥링크(A)

- 팀: dev1-team (헤르메스/불칸/이리스/아르고스)
- 레벨: Lv.3 · merge_policy: none (webapp-only, 서버/확장 변경 0)
- base: origin/main `5be61c4` (#140 배치1 포함 — query_condition에 payment_years/maturity_age/product_type 저장)
- 브랜치: `task/task-2865-dev1` · worktree: `/home/jay/projects/InsuRo/.worktrees/task-2865-dev1`

## Situation
배치1(#140)로 상담 레코드에 담보명(실텍스트)·납입기간(payment_years)·상품유형(product_type)이 저장됨. 이제 웹앱 상담이력을 RP(상담사↔고객 대본) 흐름으로 재구성해야 함. 페이지가 세로로 길어져도 OK.

## Complication
- 회장 지정: 매트릭스에 **비교블록 4개**를 누적 스토리(1사최대→최저→2사→3사, 계단식 차액 확대)로 배치. **N년 총액차액이 폰트 최대**(RP 핵심). %는 절대값 큰 쪽(작은 총액 분모), 월차액·총액차액 반올림 정합.
- 제약: webapp-only. 합계·조합은 서버 응답 재사용, 재계산 금지(X년 곱만 웹앱). 기존 매트릭스·삭제·조합 회귀 0.

## Question
"1사 최대/최저"를 어떤 데이터로 산출하는가? (task 문구는 per_insurer max/min)

## Answer (핵심 설계 결정 — 실사 근거)
데이터 계약 실사(서버/확장 소스 file:line 검증) 결과:
- **per_insurer.computed_sum 은 "단일사 총액"으로 부적합** — 차단(미제공)담보를 제외한 부분합이며, validation_status도 완전커버 지표가 아님(`extension/content.js:1722-1723,1754`). → task 문구대로 per_insurer max/min을 쓰면 부정확.
- `single_best.total`(composite 응답) = **완전커버 단일사 최저가**를 서버가 계약상 보장(`server/composite_calculator.py:50-69`) = **1사 최저**.
- **1사 최대(완전커버 단일사 최고가)는 서버가 미제공** → 웹앱이 `analysis_matrix`를 직접 순회(서버 calc_single과 **동일한 완전커버 규칙**: 모든 담보에 premium 있는 보험사만, premiums 키=보험사 code, name 폴백)해 단일사 총액 max/min 산출.
- 이 방식의 min은 single_best.total과 일치(자기정합). 조합(2사/3사)은 dual_best/triple_best.total **그대로 재사용**(재계산 없음, X년 곱만 웹앱).

→ 이 결정으로 "재계산 금지·per_insurer 재사용" 취지(=서버가 계산한 조합/최저가 신뢰)를 지키면서, 서버가 안 주는 1사 최대만 원천 데이터(matrix)로 정확히 도출.

## 구현 (수정/생성 파일)
### 신규
- `src/lib/rpComparison.ts` (불칸) — 순수 계산. `computeSingleInsurerTotals(matrix)`(완전커버 판정), `buildRpComparison({matrix,composite,paymentYears})` → 4블록. 월차액=천단위 반올림, **N년 총액차액=원단위 총차액에서 십만단위 반올림**(월차액 라운딩값×개월 아님 — 정합), %=작은 총액 분모(절대값 큰 쪽), payment_years 없으면 20 가정(assumedDefaultYears).
- `src/lib/__tests__/rpComparison.test.ts` (불칸) — 16 케이스(완전커버 필터/미제공 제외/single_best 일치/20·30년/반올림 정합/% 방향/null 방어/name 폴백).
- `src/components/composite/RpComparisonBlocks.tsx` (이리스) — 4블록 렌더. **N년 총액차액 text-xl~2xl 최대 폰트**, 월차액·% 보조. 누적 스토리 계단식 들여쓰기 + block4(1사최대 vs 3사) 클라이맥스 강조. 중립어("차이") + 근거 문구("현 월보험료×납입기간 기준·비갱신"). available 블록만 렌더.
- `src/components/composite/__tests__/RpComparisonBlocks.test.tsx` (이리스) — 8 케이스(4블록 렌더/가정연도/30년/미가용 블록 생략/폰트 최대 클래스/aria-label).

### 수정
- `src/components/composite/ConsultationHistoryView.tsx` (이리스) — `ConsultationQueryCondition`에 payment_years/maturity_age/product_type 추가. QueryConditionBlock에 상품유형·납입기간 표시(graceful). **RP 순서 세로 섹션화**: ① 고객정보·선택담보 → ② 1·2·3사 통합 매트릭스(현행) → ③ 비교 분석(RP 4블록) → ④ 요약(월합계→N년총액). `highlightRecordId` prop 전파 + 카드에 `id=consultation-record-{id}` + 하이라이트 링.
- `src/pages/CompositeDesign.tsx` (이리스) — `useSearchParams`로 `?record=<id>` 읽어 레코드 로드 후 scrollIntoView + toast 1회 안내. ConsultationHistoryView에 highlightRecordId 전달. (확장 변경 0, 웹앱 라우팅만)

### 정리 (팀장)
- RpComparisonBlocks의 미사용 `coverageNameMap` prop/import 제거(죽은 코드 금지). tsc 재검증 통과.

## 테스트 결과 / L1 스모크테스트
### 회귀검증 (아르고스 — clean /tmp worktree, CI parity, 파일럿 .env 오염 배제)
- BASE(5be61c4): Test Files 62, **Tests 924 passed / 0 failed**
- TASK(task/task-2865-dev1): Test Files 64, **Tests 948 passed / 0 failed** (신규 24 = rpComparison 16 + RpComparisonBlocks 8)
- **회귀 판정: PASS (신규 실패 0)**. 기존 CompositeComboResult/ConsultationHistoryView(삭제버튼)/조합 테스트 base와 동일 통과.
- `npx tsc --noEmit`: **EXIT 0 (클린)**

### L1 스모크테스트 (필수 기록)
- **서버 재시작**: 해당없음(webapp-only, 백엔드 무변경). 대신 프로덕션 빌드로 배포 준비 검증.
- **프로덕션 빌드**: `npm run build` **성공** (✓ built in 11.79s, dist/ + sw.js 생성 — CF Pages 배포 번들 정상).
- **API 응답 확인**: `curl http://127.0.0.1:4788/composite-design?record=123` → **HTTP 200** (vite preview, 프로덕션 dist 서빙).
- **스크린샷**: Playwright 실브라우저 → `/composite-design?record=123` 부팅 **콘솔 에러 0** (auth 게이트로 /login 리다이렉트 정상 — 우리 `?record=` 라우트/신규 import가 번들 크래시 없이 부팅됨 확인). 경로: `memory/reports/task-2865-l1-boot.png`
- **컴포넌트 렌더 증명**: RpComparisonBlocks.test 8건이 실제 컴포넌트를 realistic mock(single/dual/triple)로 jsdom 렌더 → 4블록·총액차액 최대폰트·%/월차액·가정연도 문구 검증(실 DOM 렌더).
- L1 한계: 실 데이터+로그인 세션이 있어야 RP 블록의 실화면 캡처 가능(이 환경 미보유). 대신 프로덕션 빌드+부팅 무크래시+컴포넌트 실렌더 테스트로 대체 검증.

## 발견 이슈 및 해결
1. **task 문구(per_insurer max/min) vs 실측 부정합** — per_insurer는 부분합. → analysis_matrix 직접 순회로 설계 확정(위 Answer). 회장 규칙 취지(재계산 금지=서버 조합/최저가 신뢰) 유지.
2. **미사용 coverageNameMap prop** (lint 6133) — RP 블록은 회사/조합명만 표시, 담보명 불필요 → prop/import 제거.
3. **e2e 2건 실패(composite-design-vpath.spec)** — clean worktree(.env 부재) 환경 이슈. **base 브랜치에서 동일 재현** → pre-existing, task-2865 회귀 아님. vitest 회귀판정과 분리 기록.

## 머지 판단
- **머지 필요**: Yes (순서 B — 머지·CF Pages 배포는 **ANU** 소유. 팀장은 push+PR/.done까지)
- **브랜치**: `task/task-2865-dev1`
- **워크트리 경로**: `/home/jay/projects/InsuRo/.worktrees/task-2865-dev1`
- **머지 의견**: 회귀 0(948/0), tsc 0, 프로덕션 빌드 성공. webapp-only(server/**·extension/** 무변경). 충돌 위험 낮음(신규 파일 2 + composite 3파일 국소 수정). ANU 독립검증·Codex 검토 후 머지 권장.

## 모델 사용 기록
- 불칸(계산 lib+테스트): sonnet (로직 구현)
- 이리스(UI+딥링크+테스트): sonnet (컴포넌트 구현)
- 아르고스(회귀검증): sonnet (판정)
- 데이터 계약 실사: Explore 에이전트
- haiku 미사용(전부 로직/구현/판정 — sonnet 이상 기준 준수)

## 세션 통계
- 총 도구 호출: 0회


## 세션 통계
- 총 도구 호출: 0회