Trace-Hub 기획안 v5.1

Sentry + PostHog 운영 데이터를 해석 가능한 형태로 표준화하는 Next.js 오픈소스 패키지 본 문서는 v5.0 기반으로 Figma 시안 검토 결과 확인된 차트 부족 문제를 반영한 차트 명세 개정본입니다.

0. 변경 이력

버전 주요 변경
v3.0 SaaS 형태, Sentry + PostHog 동시 MVP
v4.0 npm 패키지 형태로 전환, 오픈소스 공개
v4.1 MVP 범위 축소 (Sentry 중심), 지원 범위 명시
v4.2 기능 명세 / API 연동 / 데이터 흐름 / 화면 구성 / 에러 핸들링 / 패키지 설계 전면 상세화
v5.0 [전면 재작성] 인증 레이어 추가, API Route 설계, 설치 플로우 명확화, 해석 엔진 고도화, 급증 판단 신뢰성 개선, capture 래퍼 재설계, 차트 데이터 소스 분리, 환경변수 형식 검증, 성공 지표 개편, Tailwind 격리 전략 확정
v5.1 [차트 명세 전면 개정] Figma 시안 검토 결과 반영. Overview 차트 3종 추가(평균선 오버레이, 기간별 전환, 에러-이벤트 시간축 동기화), Error Details 차트 3종 추가(7일 일별 추이, 시간별 바, 환경 분포), Event Details 차트 고도화(Today/기간별 전환, 이벤트 비교, Peak time 하이라이트, Y축 개별 스케일), 컴포넌트 구조 및 데이터 소스 업데이트

1. 제품 정의

1-1. 한 줄 정의

Next.js 프로젝트에 npm install insighthub 하나로, Sentry 에러 데이터를 해석 가능한 어드민 대시보드로 표준화하는 오픈소스 패키지. PostHog 이벤트 연동은 다음 단계에서 점진적으로 확장.

1-2. 핵심 가치

이 패키지의 핵심 가치는 "완전 자동 생성"이 아니라,

"Sentry/PostHog 운영 데이터를 해석 가능한 형태로 연결하고, 그 표준화된 구조를 패키지로 제공한다"

개발자는 Sentry/PostHog를 붙일 줄 알지만, 그 데이터를 팀 전체가 읽을 수 있는 형태로 만드는 레이어는 매번 직접 만들어야 한다. InsightHub는 그 레이어를 표준화해서 제공한다.

1-3. 지원 범위

할 수 있는 것 ✅