[jsshin2022]

무엇을 했나요?

사이트를 질문 → 답 중심으로 다시 짜고, 이 사이트가 목표대로 쓰이는지 매일 세는 성과 화면을 붙였습니다.

UI/UX

	전	후
홈 길이 (데스크톱 / 모바일)	5,844px / 12,124px	2,792px / 5,013px
홈 순서	과업 카드 → 질문창 → 주제 순위 → 숫자 타일 → 답 → 이슈 → 주제 카드 9개 → 프로젝트 카드 → 참여 안내	질문창 → 이미 나온 답 → 주제·지금 이슈(두 단 목록) → 다음에 할 수 있는 것

• 범위 막대: 결과마다 주 지표의 95% 범위·추정치·0선을 그린 작은 그림. 막대가 0선을 지나면 변화를 말할 수 없다는 것이 한눈에 보입니다. 판단 불가는 회색 점선(진단용). 로고도 같은 모양입니다.
• 결과 한 줄: 작성자의 '한 문장 해석', 없으면 판정을 쉬운 말로. "요약(조건부): 추정치는 +0.01 …" 같은 자동 요약은 '자동 요약 보기'로 접었습니다.
• 결과 화면: 검색이 맨 위, 결과가 없을 때 안내, '판정 읽는 법'
• 메뉴: 분석 결과 · 주제 · 지금 이슈 · 데이터 · 참여 · 성과. 세 가지 참여 방식은 '참여' 화면으로 옮겼습니다.
• 꼭대기 라벨 대신 위치 표시(분석 결과 / 주제), 본문 건너뛰기, 키보드 포커스 표시

성과 측정

• 성과 화면 (impact.html): 목표와 함께 표로
  • 쓰임: 방문, 결과 화면 조회, 결과를 가져간 횟수(인용·링크 복사 + CSV), 질문
  • 외부 검증: 사용자 과업 테스트 n/5, 혼자 찾아 바르게 인용 n/5 ← 1단계 관문
  • 결과의 질: 한 문장 해석 3/6, 교차 재현 0/6, 계획 먼저 커밋 0/6
  • 참여: 참여자 6, 머지된 참여자 PR 12/14, 리뷰를 받고 머지된 PR 0/12, 작업 제안, 스타·포크
  • 주별 흐름 그래프(머지된 PR, 질문·작업 제안, 통계가 켜지면 방문)
  • 측정 못 한 칸은 0이 아니라 측정 전
• scripts/refresh_metrics.py: pages 워크플로에서 GitHub API(PR·리뷰·이슈 종류·사용자 테스트 응답)를 받아 data/cache/metrics.json → api/metrics.json
• track.js: Actions 변수 GOATCOUNTER_CODE가 있을 때만 쿠키 없는 통계(GoatCounter)를 켭니다. '추적 안 함' 설정을 따르고, 꺼져 있으면 외부 스크립트를 아예 불러오지 않습니다.
• docs/ops/metrics.md: 지표 정의, 버튼 이벤트 목록, 켜는 법

메인테이너가 할 일 (방문·버튼 통계를 켜려면)

1. goatcounter.com에서 사이트를 만들고 코드를 정합니다.
2. Settings → Variables → Actions에 GOATCOUNTER_CODE
3. (성과 화면에 숫자 표시) GoatCounter 읽기 토큰을 Secrets → GOATCOUNTER_TOKEN

안 켜도 사이트는 그대로 동작하고, 성과 화면의 GitHub·레포 기반 지표는 바로 채워집니다.

케이스

케이스 폴더 변경 없음.

확인

• pytest 전체 통과 (새: 성과 화면·이벤트 이름 일치·통계 코드 검증, 사용자 테스트 응답 파싱, 주별 집계)
• ruff check, 바꾼 파일 ruff format, Python 3.11 컴파일
• 내부 링크 554개 깨짐 0
• 12개 화면 × 데스크톱·모바일: 가로 넘침 0, 콘솔 오류 0, 대화창 동작
• 통계를 켠 빌드(가짜 수치)로 성과 화면 채워짐 확인

---

Generated by Claude Code