업적 Fingerprint 안정화

이어받기 스냅샷

상태

진행 중. fingerprint 기반 진단과 수동 작업 목록 노출은 구현됐고, 실제 브라우저 검증과 추가 진단은 남아 있습니다.

브랜치

feat/achievement

현재 HEAD

77771bd - feat(achievements): surface title fingerprint worklist

갱신일

2026-05-13

목표

업적 카드의 시각적 grouping을 안정화하되, visual fingerprint를 최종 업적 identity로 승격하지 않습니다. 입력 흐름은 신뢰 가능한 제목과 처리 가능한 미해결 제목 후보를 중심으로 수렴해야 합니다.

포함 범위

• 업적 Workbench에 title fingerprint 진단 지표를 읽기 전용으로 노출.
• title fingerprint OCR queue 실험은 로컬 플래그 뒤에 유지.
• 신뢰 가능한 title fingerprint가 부족한 그룹을 evidence와 함께 수동 작업 목록으로 표시.
• 서로 다른 title fingerprint가 한 그룹으로 합쳐지는 위험을 fingerprint 단위 분리로 완화.

제외 범위 / 위험 분리

• title fingerprint를 최종 업적 식별자로 승격하지 않습니다.
• queue dedupe 기본값은 브라우저 측정으로 title 입력 coverage가 보존된다는 점을 확인하기 전까지 승격하지 않습니다.
• 미해결 title 후보를 자동 확정하지 않습니다.

결정

• 최종 identity는 OCR/manual title 기반으로 유지합니다.
• icon fingerprint와 title fingerprint는 grouping 및 진단 신호로만 사용합니다.
• 준비 상태는 confirmed title과 actionable unresolved 후보가 page target을 설명하는지로 판단합니다.

검증

• npm run type-check 통과.
• npm run test 통과: 241 passed, 5 skipped.
• npm run lint 통과.
• npm run build 통과.
• no-hover 브라우저 검증과 더 깊은 title fingerprint 진단은 남아 있습니다.

관련 파일

• src/app/(achievements)/achievements/AchievementOcrWorkbench.tsx
• src/app/(achievements)/achievements/AchievementOcrWorkbench.test.ts
• src/domains/achievements/achievementCardCollector.ts
• src/domains/achievements/achievementInputSnapshot.ts
• todo.html local work board

다음 작업

1. no-hover 브라우저 검증으로 page target, title fingerprint, reliable title count, unresolved title count, page shortfall을 비교합니다.
2. 가벼운 worklist evidence가 부족하면 더 깊은 title fingerprint OCR 진단을 추가합니다.
3. duplicate 압력이 줄어들면서 title 입력 coverage가 유지된다는 측정이 나온 뒤에만 queue dedupe 기본값 승격을 검토합니다.