Files
lolympus-tournament-support/design-qa.md
T
dahyeonandClaude Fable 5.2 9064340584 refactor(web): restyle home schedule and results as divided lists
Replace the panel cards on the home page with section lists separated
by horizontal rules, sharing one schedule row layout. Remove the
obsolete home history test and record the design QA notes.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-11 13:48:41 +09:00

109 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Astryx 경매 시안 검증
스테이징 `test300` 경매의 4팀·관전자·유찰 표본을 사용했다. 로컬 Astryx 소스 `86a32152f4`에서 Neutral 테마와 `Card`, `TabList`, `Badge`, `Button`, `StatusDot` 구현을 읽었다. 공식 카탈로그와 동일한 배포 버전 `0.7.11`을 설치했다. [Card 원본](https://astryx.atmeta.com/components/Card) · [Tab List 원본](https://astryx.atmeta.com/components/TabList)
| 상태 | 뷰포트 | 렌더링 증거 |
| --- | --- | --- |
| 공식 Card·Tab List 다크 | 1280 CSS px, 각 1265 × 712 이미지 px | [Card](docs/ux-audit-2026-11-10/evidence/AX-reference-card-dark.jpg) · [Tab List](docs/ux-audit-2026-11-10/evidence/AX-reference-tabs-dark.jpg) |
| 경매 라이트·다크 | 1280 × 900 CSS px, 각 1265 × 889 이미지 px | [라이트](docs/ux-audit-2026-11-10/evidence/AX-preview-1280-light.jpg) · [다크](docs/ux-audit-2026-11-10/evidence/AX-preview-1280-dark.jpg) |
| 경매 모바일 라이트 | 390 × 860 CSS px, 375 × 827 이미지 px | [모바일](docs/ux-audit-2026-11-10/evidence/AX-preview-390-light.jpg) |
두 소스는 DPR 1로 캡처했다. 실제 콘텐츠가 다르므로 카드 경계, 선택 표시와 표면을 비교했다. 전체 이미지는 비율을 유지해 축소했고 왼쪽의 공식 예제는 원본 크기로 잘랐다. [전체 시안과 공식 예제 확대 비교](docs/ux-audit-2026-11-10/evidence/AX-reference-comparison.jpg)
**Findings**
- [P2 · 해결] 첫 렌더에서 경매 운영 영역이 팀 카드보다 길어 오른쪽에 큰 빈 공간이 생겼다. 선수 명단과 채팅을 팀 현황 바로 아래에 배치해 오른쪽 영역이 이어지게 했다. 최종 라이트·다크 캡처에서 팀 카드 다음에 선수 명단이 보인다.
- [P2 · 해결] 최초 스테이징 빌드에 Astryx 공용 CSS와 JS가 포함됐다. 개발용 쿼리가 켜질 때 시안 CSS를 불러오고, Astryx 렌더 분기는 빌드에서 제거되도록 했다. 442kB였던 빌드의 CSS가 149kB로 내려왔고, 개발용 주소를 새로고침해 실제 Astryx 카드가 12px 곡률로 렌더링됨을 다시 확인했다.
**시각·동작 검증**
- Neutral의 바탕·카드·테두리·액션을 라이트와 다크에서 확인했다. 실제 Astryx 탭의 밑줄과 버튼의 채움이 공식 예제와 같은 역할을 한다. 제목은 경매 맥락에 맞춰 확대했고, Figtree와 한글 폴백을 지정했다.
- 카드 상단을 맞추고 로스터의 포지션·낙찰가 열을 추가했다. 실제 Riot 프로필 이미지와 랭크·포지션 아이콘을 유지했다. 표시된 이름과 가격, 빈 로스터와 대기 명단을 실제 데이터로 확인했다.
- 390, 768, 1280 CSS px에서 가로 넘침을 확인했다. 선수 전적은 방향키와 Enter, 명단은 대기·유찰 탭으로 바꿨다. 기존 화면 보기의 라우팅, 다크 전환, 시안 새로고침 후 콘솔을 확인했다.
**Open Questions**
- 표본은 유찰 단계였다. 입찰·낙찰·채팅 전송 같은 쓰기 동작의 재현은 이번 시각 검증 범위 밖이다.
**Implementation Checklist**
- [x] 공식 Neutral과 실제 Astryx 컴포넌트로 로컬 경매 시안을 렌더링했다.
- [x] 데스크톱 라이트·다크와 모바일을 캡처하고 Astryx 공식 예제와 비교했다.
- [x] 웹 테스트 144개, 변경 파일 ESLint, TypeScript 및 스테이징 빌드를 통과했다.
final result: passed
## 홈 진행 중인 일정 — 2026-11-11
사용자가 선택한 메이플 공지 목록의 가로 구분선·제목/보조 정보 위계를 기존 홈에 적용했다. 홈의 진행 중인 일정에만 `section` 변형을 사용하고, 내전 일정 페이지의 카드와 다른 예정 목록은 기존 표현을 유지한다.
### 비교 근거
- 원래 홈 화면: `C:/Users/park/AppData/Local/Temp/codex-clipboard-1849c599-e42e-407f-8823-beaacd76788e.png` (3813 × 1932 이미지 px, 제출 화면의 CSS 크기와 DPR은 알 수 없음).
- 공식 레퍼런스: https://maplestory.nexon.com/Home/Main 및 https://lwres.nexon.com/css/maplestory/index_renew.css?v=4.
- 직접 캡처한 공지 영역: `C:/Users/park/.codex/visualizations/2026/11/11/01a1c8c9-0b58-7e22-960f-520506eb826f/maple-notice-reference.jpg` (430 × 400 이미지 px).
- 구현 증거 폴더: `C:/Users/park/.codex/visualizations/2026/11/11/01a1c8c9-0b58-7e22-960f-520506eb826f/home-schedule/`.
- 전체 비교: 제출 홈 이미지와 `desktop-light.jpg`를 같은 비교 입력으로 열어 히어로, 일정, 최근 결과, 순위의 관계를 확인했다. 원본의 뷰포트가 불명확하므로 전체 화면의 픽셀 일치를 판단하지 않고 기존 요소의 역할과 정렬을 비교했다.
- 집중 비교: 메이플 공지 캡처와 `schedule-light.jpg` (1032 × 325 이미지 px)를 같은 비교 입력으로 열었다. 일정에 필요한 날짜 열과 상태 열, 기존 SUIT 글꼴 및 17px 섹션 제목은 승인된 제품별 적용 차이다.
| 상태 | CSS 뷰포트 | 구현 캡처 | 이미지 px |
| --- | --- | --- | --- |
| 데스크톱 라이트 | 1440 × 1100 | `desktop-light.jpg` | 1425 × 1089 |
| 데스크톱 다크 | 1440 × 1100 | `desktop-dark.jpg` | 1425 × 1089 |
| 모바일 라이트 | 390 × 1100 | `mobile-light.jpg` | 375 × 1058 |
| 모바일 다크 | 390 × 1100 | `mobile-dark.jpg` | 375 × 1058 |
| 좁은 모바일 라이트 | 320 × 1050 | `mobile-320-light.jpg` | 305 × 1001 |
| 태블릿 라이트 | 768 × 1100 | `tablet-light.jpg` | 753 × 1079 |
브라우저의 보고 DPR은 약 1이다. 이미지 치수는 브라우저 캡처가 반환한 실제 파일 크기이며 별도 확대·축소를 적용하지 않았다. 레이아웃 수치는 DOM의 CSS px로 검증했다. 상태는 비로그인, 스테이징의 팀 편성 완료 2개·경매 중 1개·진행 중 1개다. 개발 API가 연결을 거부해 미리보기 전용 Vite 프록시로 스테이징을 조회했다. 저장소의 API 환경 파일은 변경하지 않았다.
### 확인 결과
- 글꼴·정보 위계: 기존 SUIT를 사용한다. 일정명 15px/600, 보조 정보 12–13px, 상태는 텍스트가 있는 외곽선 배지다. 모바일 제목은 전체 행 너비에서 줄바꿈할 수 있다.
- 간격·정렬: 데스크톱 행 높이 약 70.8px, 날짜 열 7.5rem, 좌우 패딩 8px로 최근 결과 목록과 정렬했다. 외곽 테두리·그림자는 없고 가로선만 남았다. 320/390/768/1440px에서 문서 및 일정 행의 가로 넘침이 없었다.
- 색상: 기존 테마 토큰으로 라이트/다크를 모두 확인했다. 보조 글자 대비는 흰 바탕에서 4.91:1, 다크 바탕에서 9.20:1이며 라이트 상태 글자는 진행 중 6.51:1, 경매 중 6.70:1이었다. 이는 측정한 글자색과 기본 배경의 대비로, 전체 접근성 인증을 의미하지 않는다.
- 이미지: 기존 히어로·선수 이미지와 Lucide 아이콘을 유지했다. 일정에 새 이미지 자산은 추가하지 않았다.
- 내용·동작: 실제 제목·일시·참가 인원·상태를 표시했다. Tab 이동 시 다음 일정 링크의 2px 포커스 테두리를 확인했고 Enter로 `test 100` 상세 화면의 제목·대진표가 로드됐다. 전체 일정 링크로 `/inhouse`에 이동해 기존 12px 모서리 카드와 10개 행을 확인했다.
- 최종 화면 콘솔 오류/경고 없음. 미리보기 연결 문제를 해소한 후 캡처한 결과만 채택했다.
- TypeScript, 변경 파일 ESLint, 기존 홈 테스트 4개, 스테이징 빌드, `git diff --check` 통과. 빌드의 기존 대형 청크 경고는 남아 있다.
첫 디자인 비교에서 추가 수정이 필요한 P0/P1/P2 차이는 발견되지 않았다. 모바일은 브라우저 뷰포트로 확인했으며 실제 휴대전화와 모든 데이터 상태를 검사한 것은 아니다. 별도 서버 데이터 변경이나 배포는 수행하지 않았다.
final result: passed
## 내전·멸망전 일정 목록 — 2026-11-11
후속 요청에 따라 승인된 홈 목록 스타일을 두 탭의 진행 중인 일정, 다가오는 일정, 종료된 일정과 결과에 확장했다. 위 홈 검증 당시 유지했던 카드와 결과 표를 공통 목록으로 바꾸고, 날짜·제목·참가 정보·상태 또는 결과의 위계를 통일했다. 모바일 결과는 제목 아래에서 줄바꿈하며 데스크톱에서는 오른쪽에 정렬된다.
### 비교 근거
- 기준: 앞선 홈의 `home-schedule/schedule-light.jpg` (1032 × 325 이미지 px). 새 `inhouse-results-light.jpg`와 같은 비교 입력으로 열어 구분선, 제목과 보조 정보, 간격 및 정렬을 대조했다.
- 변경 전: `archive-schedules/inhouse-before.jpg` (1424 × 1678 이미지 px).
- 증거 폴더: `C:/Users/park/.codex/visualizations/2026/11/11/01a1c8c9-0b58-7e22-960f-520506eb826f/archive-schedules/`.
| 상태 | CSS 뷰포트 | 구현 캡처 | 이미지 px |
| --- | --- | --- | --- |
| 내전 진행 중 · 라이트 | 1440 × 1100 | `inhouse-desktop-light.jpg` | 1440 × 1100 |
| 내전 예정·결과 · 라이트 | 1440 × 1100 | `inhouse-results-light.jpg` | 1425 × 1089 |
| 내전 결과 · 모바일 라이트 | 390 × 1100 | `inhouse-mobile-light.jpg` | 375 × 1058 |
| 내전 결과 · 모바일 다크 | 390 × 1100 | `inhouse-mobile-dark.jpg` | 375 × 1058 |
| 내전 예정 · 모바일 라이트 | 390 × 1100 | `inhouse-upcoming-mobile.jpg` | 375 × 1058 |
| 멸망전 결과 · 모바일 다크 | 390 × 1100 | `tournaments-mobile-dark.jpg` | 390 × 1100 |
| 멸망전 결과 · 데스크톱 라이트 | 1440 × 1100 | `tournaments-desktop-light.jpg` | 1440 × 1100 |
이미지 크기는 브라우저 캡처의 실제 반환 크기이며 별도 확대·축소하지 않았다. 기존 미리보기 전용 Vite 프록시로 실제 스테이징 데이터를 읽었다. 로컬 API 환경 설정과 서버 데이터는 변경하지 않았다.
### 확인 결과
- 내전의 진행 중 19개, 예정 1개, 종료 1,942개 데이터로 세 목록을 확인했다. 점수, 우승팀, 공동 우승팀, 참가 인원과 일시가 유지된다. 표 전용 로딩 UI도 같은 목록 구조로 변경했다.
- 내전·멸망전에서 320/390/768/1440 CSS px의 문서와 일정 행에 가로 넘침이 없었다. 라이트·다크 화면의 제목, 보조 정보, 상태 배지와 결과를 확인했다. 실제 휴대전화 검증은 수행하지 않았다.
- 진행 중 목록과 종료 목록의 페이지를 각각 이동하고, 두 페이지 쿼리가 서로 유지되는 것을 확인했다. 페이지 영역에 구별되는 접근성 이름을 부여했다.
- 멸망전 결과 링크에서 Enter로 실제 상세 화면을 열어 제목이 로드되는 것을 확인했다. 공통 컴포넌트 변경 후 홈 모바일도 다시 열어 진행 중 4개 행과 기존 주변 요소, 가로 넘침 없음을 확인했다.
- 표본의 멸망전은 진행 중·예정 0개, 종료 1개였다. 빈 상태와 실제 결과를 검증했으며, 채워진 진행 중·예정 목록의 공통 컴포넌트는 내전 데이터로 확인했다.
- 두 차례 소스 편집 사이 발생한 일시적인 HMR 오류는 최종 소스에서 해소됐다. 최종 새로고침 이후 관련 화면을 이동하며 수집한 콘솔 오류·경고는 없었다.
- 웹 테스트 162개, TypeScript, 변경 파일 ESLint, 스테이징 빌드 통과. 제거된 4열 표 구조만 검사하던 소스 문자열 테스트는 함께 제거했다. 기존 대형 청크 및 Node 로더 사용 중단 경고는 남아 있다.
첫 비교에서 추가 수정이 필요한 P0/P1/P2 차이는 발견되지 않았다. 배포는 수행하지 않았다.
final result: passed