애널리틱스 대시보드 디자인은(는) 무엇을 하나요?
하나의 제품을 위한 대시보드는 한눈에 하나의 질문에 답해야 합니다: 성장하고 있는가, 그리고 사람들은 어디에서 이탈하는가? 페이지의 모든 것은 이 질문에 답하기 위해 존재하며, 소유자가 그 이유를 파고들 수 있도록 합니다.
이 스킬은 출시된 Mac 앱(웹사이트 → 다운로드 → 설치 → 평가판 → 유료)의 애널리틱스 대시보드를 구축하고 운영하면서, 그리고 소유자가 스크린샷에서 발견한 모든 버그에서 얻은 경험을 바탕으로 만들어졌습니다. 실제 예제는 examples/product-analytics.html에 고정된 샘플 데이터와 함께 제공됩니다.
작업 방법
단계를 순서대로 따르세요. 각 단계는 확인할 수 있는 완료 기준으로 끝납니다.
1. 데이터 계약을 먼저 작성하세요
UI 작성 전에, 페이지에 표시될 모든 숫자와 각 숫자에 대해: 집계할 이벤트, 집계 기간, 고유값 또는 전체값, 시간대, 그리고 비교 대상인 '이전 기간'을 나열하세요. 이를 UI 코드가 아닌 API 응답 형태로 작성하세요. 참조/metrics.md를 참고하세요.
완료 기준 모든 타일, 컬럼 및 차트가 계약에 한 줄씩 포함되어 있으며, '동일한' 숫자를 표시하는 두 곳이 동일한 필드에서 값을 읽습니다.
2. 페이지 레이아웃을 구성하세요
섹션 링크가 있는 사이드바, 새로고침 상태와 기간 전환기가 있는 고정 상단 바, 그리고 여정 순서(개요 → 국가 → 퍼널 → 구매자 → 앱 → 리텐션 → 웹사이트 → 이벤트)에 따른 섹션을 배치하세요. 하나의 콘텐츠 컬럼, 최대 1280px 너비를 사용합니다. 참조/layout.md를 참고하세요.
완료 기준 1440 × 900 해상도에서 스크롤 없이 개요가 첫눈에 보는 질문에 답합니다.
3. 참조에서 컴포넌트를 구축하세요
참조/components.md의 패턴과 참조/snippets.md의 코드를 사용하세요: 가는 선 KPI 행, '이전' 기준선이 있는 델타, 차트 기간의 스파크라인, 단일 차트 위의 밑줄 메트릭 탭(테이블 전환 기능 포함), 정렬된 컬럼에 공유 막대가 있는 정렬 가능한 국가 테이블, 단계별 전환율이 있는 퍼널 막대, 확장 가능한 타임라인이 있는 구매자 행, 명시적인 '보고되지 않음' 슬라이스가 있는 도넛 차트, 등급별 계층이 있는 리텐션 히트맵.
색상은 참조/tokens.md의 토큰에서만 가져옵니다. 밝은 테마와 어두운 테마 모두 필수입니다.
완료 기준 어떤 컴포넌트도 토큰 외부의 색상, 반경 또는 글꼴 크기를 사용하지 않습니다.
4. 정직성 검증
참조/metrics.md를 섹션별로 검토하세요. 일반적인 문제점: 1건 기준의 '−100%', 결제 제공업체보다 지연되는 수익, $0 주문을 고객으로 계산, 일별 고유 방문자의 합계를 고유 방문자로 표시, 보고하지 않은 사람들을 조용히 제외하는 도넛 차트 비율, 사실인 척 표시된 추정치인 '소스'.
완료 기준 모든 숫자가 측정 기간을 명시하고, 모든 추정치는 추정치임을 표시합니다.
5. 프라이버시 검증
사람들이 신뢰하는 제품의 애널리틱스는 불신의 대상이 되어서는 안 됩니다. 참조/privacy.md를 따르세요: 웹사이트에 쿠키 없음, 저장된 IP 없음, 이벤트에 사용자 콘텐츠 없음, 설치별 무작위 ID, 앱 내 옵트아웃, 그리고 일별 솔티드 해시로 연결되고 신원으로 연결되지 않는 여정.
완료 기준 이벤트 스키마를 수정 없이 제품의 프라이버시 정책에 붙여넣을 수 있습니다.
6. 스크린샷 QA
참조/qa.md를 실행하세요: 1440, 1024 및 390px에서 실제 스크린샷, 밝은 테마와 어두운 테마, 모든 기간, 그리고 페이지 외부에서 계산된 숫자와 합계를 확인합니다. 코드가 아닌 그림을 보세요.
완료 기준 모든 스크린샷이 깨끗하고 알려진 합계가 일치합니다.
모든 곳에 적용되는 규칙
- 여정 순서. 섹션은 고객이 이동하는 경로를 따르므로 이탈이 상단에서 하단으로 읽힙니다.
- 숫자당 하나의 기간, 명시. '기간', '오늘', '최근 30일'이 컬럼 아래 또는 타일 힌트에 표시됩니다.
- 동등한 것끼리 비교. 이전 기간은 동일한 길이를 가지며 현재 기간이 시작되는 곳에서 끝납니다.
- 작은 기준에서 과장 금지. 0 → 3은 '신규'이지 '+∞%'가 아닙니다. 1 → 2의 델타는 표시되지만 조용히 표시됩니다.
- 알 수 없음은 구멍이 아닌 행입니다. 알 수 없는 국가, 보고되지 않은 권한, 일치하지 않는 소스는 표시되고, 마지막에 정렬되며, 합계에 포함됩니다.
- 새로고침 상태가 표시됩니다. 헤더에 '업데이트됨 09:00 UTC' 및 '결제 동기화됨 08:57'을 표시하고, 로드 실패 시 빨간 점과 일반 언어 오류를 표시합니다.
- 테이블은 항상 한 번의 클릭 거리에 있습니다. 모든 차트는 '테이블' 토글 뒤에 정확한 일별 값을 제공합니다.
- 키보드 및 스크린 리더. 차트는 포커스를 받고 ← → 키로 포인트를 탐색합니다. 정렬 가능한 헤더는
aria-sort가 있는 버튼이며, 확장 가능한 행은aria-expanded가 있는role="button"입니다. - 의존성 없음. SVG, CSS conic 그라디언트 및
Intl로 모든 차트를 처리합니다. 예제는 단일 HTML 파일입니다.
하우스 스타일
중립 회색, 하나의 파란색 시리즈 색상, 녹색과 빨간색은 좋음과 나쁨에만 사용, 주황색은 브랜드 마크에만 사용합니다. 기본 텍스트 13.5px, KPI 값 24px, 숫자와 제목에는 600 두께, 숫자가 변경될 수 있는 모든 곳에 표 형식 숫자를 사용합니다. 그림자 대신 가는 선. 카드 반경 8px, 컨트롤 6px, 막대 4px. 참조/tokens.md를 참고하세요.
비평 형식
대시보드(코드, URL 또는 스크린샷)를 검토해 달라는 요청을 받으면 다음 순서로 답변하세요:
- 평결 한 문장으로: 첫눈에 보는 질문에 답하는가?
- 일치하지 않는 숫자 — 동일한 메트릭이 두 개의 다른 값을 표시하거나, 합계가 맞지 않거나, 기간이 일치하지 않는 경우. 신뢰를 파괴하므로 가장 먼저 다룹니다.
- 참조/metrics.md의 정직성 문제.
- 참조/privacy.md의 프라이버시 문제.
- 레이아웃 및 컴포넌트 문제, 소유자의 작업 속도를 늦추는 정도로 순위를 매깁니다.
- 잘 작동하는 부분 — 간략하게 언급하되, 재설계에서 손실되지 않도록 명시합니다.
각 문제: 무엇을 보았는지, 왜 오해를 불러일으키거나 속도를 늦추는지, 수정 방법.
참조
| 파일 | 내용 |
|---|---|
| metrics.md | 데이터 계약, 집계 기간, 델타, 수익, 기여도, 퍼널, 코호트 |
| layout.md | 사이드바, 상단 바, 섹션 순서, 그리드, 중단점, 전화 레이아웃 |
| components.md | 페이지의 모든 컴포넌트, 상태 및 접근성 |
| tokens.md | 밝은 테마와 어두운 테마 색상 토큰, 타이포그래피 및 간격 스케일 |
| snippets.md | 델타, 적절한 축 눈금, 버킷, 스파크라인, 도넛, 막대 목록, 히트맵 계층, 복수형 |
| privacy.md | 쿠키 없는 방문, 해시된 네트워크, 설치 ID, 옵트아웃, 절대 수집하지 말아야 할 것 |
| qa.md | 스크린샷 프로토콜, 알려진 합계, 이상 징후 테이블 |
| case-study-typecorrect.md | 이 스킬의 실제 대시보드 사례와 각 규칙이 수정한 버그 |