Files
lolympus-tournament-support/apps/web/src/design-previews/internal-stats/design-qa.md
T

6.2 KiB
Raw Blame History

내전 전적 코드 시안 — 2026-11-11

범위와 실행

  • URL: http://localhost:5173/design-previews/internal-stats.html
  • React / TypeScript / 기존 Vite 서버, 제품 테마 토큰과 Btn·Chip·AppTheme 재사용.
  • 기존 전적 페이지를 대체하지 않는 독립 HTML 진입점. 제품 라우터와 API를 수정하지 않았다.
  • 2시즌, 8내전, 40선수의 결정적인 예시 데이터. 실제 전적을 가져오거나 수정하지 않는다. 골드 흐름도 예시 타임라인이라고 화면에 표시한다.
  • 원본의 색상과 서체를 유지하면서 이전 UX 검토 제안을 구현한 재설계다. 원본의 픽셀 복제가 목표가 아니다.

제안 반영

검토 항목 구현
요약 때문에 좁아지는 본문 상단 SeasonSummary, 전체 너비 순위표. 시즌 최고/누적/단일 경기 기록의 범위를 각각 표기
세트의 맥락 부족 EventSection → SeriesResultGroup. 양 팀, 라운드, 시리즈 점수, 승리 팀, 개별/전체 세트 번호, 시간, 원본 상태
긴 경기 목록 탐색 데스크톱 날짜 인덱스, 모바일 바로가기, 내전 단위 추가 로드. 표시한 내전의 세트는 모두 공개
순위의 의미 기본값은 참여 경기 수. 중립적인 숫자 순위, 명시적 정렬, 최소 판수와 기준 미달 표기, 기준 충족 필터
모바일 표 순위·이름 고정, 승률·판수 우선, 나머지 지표를 가로 스크롤. 챔피언/상세 지표 삭제 없음
필터와 시즌 시즌·기간·유형·선수/팀/내전 검색, 개별 조건 해제와 초기화. 검색 순위는 원래 순위 유지
포지션 정확성 해당 포지션으로 플레이한 세트만 판수·승률·KDA·GPM·킬 관여·CS/분 재집계
탐색 복귀 URL에 탭과 조건 저장. 개인 전적/내전/세트 분석 왕복 시 스크롤·포커스 복원. returnTo 중첩 제거
개인 및 경기 상세 같은 시즌의 개인 지표와 참가 세트, 근거 경기 링크, 10인 스코어보드, 골드 그래프/팀 비교
실패/부족한 데이터 빈 결과 초기화, 기간 오류, 로딩/조회 오류와 재시도, 원본 없음/수집 중과 공식 결과 분리
접근성 탭 방향키/Home/End, 표 헤더/aria-sort, 고정 열, 포커스 표시, skip link, 상태 알림, 이미지 alt, reduced-motion

이전 조사에서 OpenDota·Lichess의 경기 맥락, Umami·Plausible·Metabase의 범위와 필터, TanStack Table의 정렬·고정 열, Radix·shadcn의 상태와 접근성, Recharts의 데이터 표현, brackets-viewer·react-tournament-brackets의 시리즈 계층을 검토했다. 이 시안은 해당 패턴을 현재 제품의 정보 상시 노출 원칙에 맞춰 구현한다. 라이브러리를 새로 추가하지 않았다. LeagueStats는 비상업 라이선스의 추가 참고 자료이며 코드를 복제하지 않았다.

시각 검수

증거 폴더: C:/Users/park/.codex/visualizations/2026/11/11/01a1c9d5-e028-75a0-8b1b-f70126da1d08/internal-stats-preview/

  • 원본: 같은 상위 폴더의 internal-stats-audit/01-recent.jpg, 02-ranking.jpg, 07-mobile-recent.jpg, 08-mobile-ranking.jpg 및 사용자 첨부 이미지.
  • 구현: 01-desktop-matches.jpg, 02-desktop-ranking.jpg, 03-player-detail.jpg, 04-set-analysis.jpg, 05-mobile-overview.jpg, 06-mobile-ranking.jpg, 07-mobile-matches.jpg, 08-mobile-analysis.jpg, 09-mobile-error.jpg, 10-missing-record.jpg, 11-dark-missing-record.jpg, 12-dark-ranking.jpg.
  • 1440×1050, 390×844 CSS viewport에서 실제 렌더를 확인. 원본의 밀집된 세트 행을 상대·점수가 있는 묶음으로 바꾸고 기존의 흰색/잉크/코랄 위계를 유지했다.
  • 모바일 문서 가로 넘침 없음. 341px 표 컨테이너에서 이름·승률·판수 확인. 가로 스크롤 374px 후에도 이름 열의 x좌표 유지.
  • 경기·선수·세트 화면의 글꼴, 카드 여백, 상태색, 선/표 정렬, 이미지 로딩, 라이트/다크를 확인. 확인한 화면의 깨진 이미지 없음.
  • 발견 후 수정: 날짜 입력 이벤트가 UI와 URL에 반영되도록 onInput 사용, 차트 초기 크기 경고 제거, 한국어 설명 줄바꿈 개선, 시즌 요약 링크의 포지션 필터 제거, 경기 상세에서 시즌 변경 시 해당 시즌 목록으로 이동, 복귀 URL 중첩 제거.
  • 승인된 재설계 범위에서 남은 P0/P1/P2 시각 문제 없음. 모바일 표의 나머지 열은 의도적으로 가로 스크롤한다. 정량 색 대비 감사·모든 브라우저 전수 검증은 수행하지 않았다.

동작 검증

  • 시즌 2: 6내전, 62공식 세트, 54분석 가능 세트, 40선수. 시즌 1: 2내전, 15세트, 20선수로 전환됨.
  • 14시리즈/29세트 내전의 공식 결과가 모두 보이며, 7개의 원본 누락은 분석 지표에서 제외됨.
  • 선수 검색 + 정글 필터 → 개인 전적 → 세트 분석 → 복귀. 필터, 스크롤, 포커스 복원 확인.
  • KDA/승률 정렬, 빈 선수 검색/초기화, 모바일 고정 열, 날짜 바로가기, 키보드 탭 전환 확인.
  • 6월25일 이후 필터 2내전. 역전 날짜의 오류와 초기화, 목록 4→6개 추가 로드 확인.
  • 조회 오류 → 다시 시도 → 같은 목록 복귀. 원본 없음에서 공식 결과만 표시하며 분석표 미생성. 수집 중 상태 재확인 문구 확인.
  • 최종 차트 재진입 후 새 browser error/warn 로그 없음.
  • TypeScript 검사, 대상 ESLint, 데이터 집계/시즌/상대·점수/필터/포지션/판수·정렬/최고 기록 근거를 검증하는 6개 테스트 통과.
  • 독립 HTML을 대상으로 Vite production build 통과. 기존 전체 테마 CSS와 Recharts를 포함하므로 500KB chunk 안내가 있다. 시안 단계에서 분할 로딩 최적화는 적용하지 않았다.

적용 시 필요한 경계

이 결과는 검토 가능한 코드 시안이다. 실제 API의 오류 복구, 원본 가용성/시리즈/포지션별 집계 계약 연결은 제품 적용 단계의 작업이며 이 시안으로 실서버 오류가 해결된 것은 아니다. DDragon 챔피언 이미지에는 네트워크 연결이 필요하다. 배포하지 않았다.

final result: passed