개념 - 분석 이벤트

정의

분석 이벤트는 사용자의 검색, 세그먼트 열람, 리뷰 해결, 학습 카드 조회, 약점 프로필 갱신 같은 행동을 구조화된 이벤트로 기록해 제품 사용과 운영 상태를 관찰할 수 있게 하는 계약입니다.

왜 중요한가

timebooks README는 POST /analytics/events와 최근 이벤트 조회 API를 노출하고, 별도 문서에서는 search_submitted, segment_opened, review_task_resolved, learning_card_viewed, weakness_profile_updated 같은 최소 이벤트 계약을 정의합니다. 이는 관측성이 부가 기능이 아니라 학습 경험과 운영 흐름을 해석하는 기본 계층이라는 뜻입니다.

관련 소스

• 소스 - Timebooks Readme

관련 개념

• 개념 - 리뷰 워크플로
• 엔티티 - Operations Portal
• 엔티티 - Timebooks

열린 질문

• 이벤트 수집은 최소 계약만 유지하면서도, 나중에 배치 전송이나 영속 저장으로 확장될 때 어떤 필드 안정성을 보장해야 하는가?