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

1.7 KiB

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일을 기본으로 한다. 장기 추세는 일/월 단위 집계로 보존하며 실제 보존기간은 조직 정책으로 조정한다.