Files
KArtSell.Aegis/docs/Design/kbx-foundation-v60-status-canonical-contract-hardening/docs/ux-telemetry-governance-v16.md
T
kjh2064 3f293d8aa8
deploy / deploy (push) Successful in 1m52s
deploy / notify (push) Successful in 1s
V13-FE-006: consolidate approved UI and contract hardening
2026-08-13 02:41:00 +09:00

37 lines
1.7 KiB
Markdown

# KBX UX Telemetry Governance v16
## 목적
KBX Telemetry는 사용자 감시가 아니라 업무 UX의 마찰·오류·자동화 수준을 측정하기 위한 의미 단위 계측이다.
## 수집 금지
- 고객명, 수취인, 전화번호, 주소
- 주문번호, 품목코드, 바코드 등 실제 업무 식별자
- 검색어/필터 원문
- DOM 전체 클릭 스트림
- AI 질문 전문
## 수집 허용
- ScreenId / ScreenVersion
- semantic event name
- random browser session / task session id
- duration / count
- low-cardinality reason code / command id / work type
## 핵심 지표
1. Manual Intervention Rate = 사람 개입 건수 / 전체 업무대상 건수
2. Task Completion Time P50/P95
3. Semantic Interactions / Task
4. Validation Failure Rate
5. Excel Import Failure Rate
6. Exception Resolution Time P50/P95
7. AI Proposal Acceptance Rate
### Manual Intervention Rate의 주의점
이 수치를 낮추는 것이 목적 자체가 아니다. 위험 업무의 검증을 제거하거나 사용자 확인이 반드시 필요한 의사결정까지 자동화해서 수치를 낮추면 실패다. 업무 오류율·오출고·재고불일치·감사 가능성과 함께 해석한다.
## Browser와 Domain 결과 분리
Browser interaction event는 사용자가 어떤 의미 동작을 수행했는지를 측정한다. 전체 주문 수나 자동처리 건수는 Browser가 알 수 없으므로 `KbxUxBusinessOutcomeRecorder`를 통해 Server/Domain이 집계값만 기록한다. 업무 Entity ID는 저장하지 않는다.
## Retention
Raw semantic event는 90일을 기본으로 한다. 장기 추세는 일/월 단위 집계로 보존하며 실제 보존기간은 조직 정책으로 조정한다.