feat(web): refresh the app with Astryx and coral branding
No files matched your search
@@ -0,0 +1,21 @@
|
||||
# 06. 토큰·프리미티브·컴포넌트·기능 우선 검토
|
||||
|
||||
이 문서는 조작과 접근성 검토를 보관한다. 현재 먼저 진행할 시각 개선의 범위는 [심미성 중심 검토](07-visual-design-review.md)에 있다.
|
||||
|
||||
기준은 `f649490`의 현재 웹 소스와 기존 브라우저 감사다. 먼저 **액션과 링크의 대비, 경기 분석 탭의 키보드 동작, 경매 확인창의 포커스**를 개선한다. 이 세 항목은 참가·경매·코드 발급 상태를 해석하거나 전적 API를 바꾸지 않고 검증할 수 있다. 실제 화면에서 재현한 사례와 코드에서 발견한 위험을 아래에서 구분했다. [기존 디자인 시스템 감사](03-design-system.md)
|
||||
|
||||
| 순서 | 영역 | 현재 증거 | 변경 후보와 통과 조건 |
|
||||
| --- | --- | --- | --- |
|
||||
| 1 | 디자인 토큰 | 이전 브라우저 계측값의 sRGB 근사치로 라이트 코랄 링크/흰 표면은 약 3.27:1, 코랄 버튼/밝은 글자는 약 3.08:1이다. 다크 기본 primary 버튼 조합도 약 4.14:1이었다. 실제 배경 합성과 상호작용 상태는 적용 후 측정해야 한다. | `action` 버튼 전경·배경, `link` 전경, `focus` 링을 독립 토큰으로 정의한다. 홈의 전적 링크, 경기 분석의 선택 탭·포커스, 개인 전적의 갱신 버튼에 먼저 적용한다. 라이트·다크에서 일반 크기 글자 4.5:1, 기능을 식별하는 경계·선택 표시 3:1을 해당 표면에서 확인한다. 선택과 포커스는 서로 구분된다. [CSS](../../apps/web/src/index.css#L103) · [갱신 버튼](../../apps/web/src/pages/UserHistoryPage.tsx#L1363) · [WCAG 2.2](https://www.w3.org/TR/WCAG22/#contrast-minimum) |
|
||||
| 2 | `Tabs` 프리미티브 | 내전 상세에서는 좌우·Home/End 키와 `tabIndex` 이동이 구현돼 있다. 경기 분석 탭에서는 브라우저에서 방향키가 동작하지 않았고 버튼 3개가 모두 Tab 순서에 들어갔다. | 내전 상세의 키보드 패턴을 기준으로 분석 탭을 고친다. 탭 그룹에는 한 번의 Tab으로 진입하고 좌우·Home/End로 이동한다. 선택 탭과 패널을 연결한다. 내전 상세의 sticky 위치, URL 및 스크롤 보정은 해당 화면에 둔다. 경매 탭은 분석 탭 검증 후 적용 여부를 결정한다. [내전 상세 탭](../../apps/web/src/components/competition/MatchDetailTabBar.tsx#L46) · [분석 탭](../../apps/web/src/components/InternalGameAnalysisTabs.tsx#L954) · [WAI-ARIA Tabs](https://www.w3.org/WAI/ARIA/apg/patterns/tabs/) |
|
||||
| 3 | `Dialog` 프리미티브 | 기존 브라우저 감사에서 경매 취소창을 Escape로 닫은 뒤 포커스가 트리거로 돌아가지 않았다. 취소·되돌리기·참여자 추가는 각각 모달 컨테이너를 구현한다. | 경매 취소·되돌리기부터 초기 포커스, 모달 안의 Tab 이동, Escape, 닫힌 뒤 포커스 복귀를 검증한다. 진행 중 요청이 있을 때 닫기 동작을 일관되게 한다. 키보드만으로 열기·확인 입력·닫기까지 수행할 수 있다. 같은 동작이 안정되면 참여자 추가에 재사용한다. [경매 모달](../../apps/web/src/pages/AuctionPage.tsx#L2466) · [참여자 모달](../../apps/web/src/pages/MatchDetailPage.tsx#L751) · [WAI-ARIA Dialog](https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/) |
|
||||
| 4 | 세트 선택 컴포넌트·기능 | 390px 화면에서 약 300px 영역에 세트 링크 2,048px가 들어갔다. 현재 링크는 색으로만 구분하고 `aria-current`를 제공하지 않는다. | 현재 세트와 이전·다음, 전체 목록 열기를 좁은 화면에서 우선 제공한다. 기존 게임 링크와 선택 규칙을 사용한다. 예를 들어 기록이 1·2·7이면 2의 다음은 존재하는 7이다. 현재 링크는 `aria-current="page"`와 눈에 보이는 선택 표시를 갖는다. [세트 선택 코드](../../apps/web/src/pages/MatchGameDetailPage.tsx#L1505) · [390px 캡처](evidence/L26-mobile-game.jpg) |
|
||||
| 5 | 통계 상태 컴포넌트·기능 | 인사이트 미응답을 `?? 0`으로 렌더하고, 순위 응답이 없으면 빈 배열을 넘긴다. 스테이징 값의 정상 여부와 무관하게 로딩·실패·빈 데이터가 같은 표현을 공유하는 분기가 있다. | 최근 내전·선수 순위·하이라이트에 각자의 `불러오는 중`, `조회 실패`, `이 조건에 기록 없음`, `표본 부족`을 제공한다. 실제 0%는 유효한 분모가 확인될 때만 표시한다. 다른 섹션을 유지하며 실패한 영역만 다시 요청한다. 첫 작업은 현재 query 상태로 할 수 있는 분리부터 적용한다. 승패 유효 분모가 추가로 필요하면 통계 계약에서 확인한다. [현재 코드](../../apps/web/src/pages/CommunityInternalStatsPage.tsx#L349) |
|
||||
| 6 | `Tooltip`·`Popover`, 아이템 및 랭크 | 아이템은 hover/focus에서 설명을 띄우지만 명시적인 터치·Escape 처리 경로가 없다. 아이템마다 Tab으로 들어가고 랭크는 별도의 `data-tip`을 사용한다. 터치와 키보드의 실제 영향은 확인 대상이다. | 빌드 패널에서 아이템 이름과 필수 정보를 터치·키보드로 열고 Escape로 닫을 수 있게 한다. 여러 아이템이 있는 표에서 Tab 이동이 과도하게 늘어나는지도 확인한다. 스타일만 비슷한 랭크 배지를 즉시 같은 동작으로 묶을 필요는 없다. [아이템 동작](../../apps/web/src/components/ItemTooltip.tsx#L159) · [랭크 배지](../../apps/web/src/components/RankBadge.tsx#L44) |
|
||||
| 7 | 채팅 입력 기능 | 코드에서 Shift 없는 Enter를 바로 전송하고 한글 조합 여부를 확인하는 조건이 없다. 메시지 개수가 바뀔 때 항상 맨 아래로 스크롤한다. 실제 브라우저·IME 조합은 미검증이다. | 한글 조합을 확정하는 Enter는 전송하지 않고, 일반 Enter와 Shift+Enter의 기존 의미를 유지한다. 이전 채팅을 읽을 때 새 메시지가 도착해도 위치를 보존한다. 실제 한국어 IME 및 테스트용 연결에서 확인한다. [채팅 구현](../../apps/web/src/pages/AuctionPage.tsx#L2787) |
|
||||
|
||||
토큰 도입 범위는 증거가 있는 용도부터 잡는다. 코랄·바이올렛·골드·시안의 원색과 대진표의 의미 팔레트는 계속 쓸 수 있다. 기존 `primary`를 한 번에 바꾸면 `.competition-series-history`의 코랄 강조와 다크 테마 계약까지 같이 바뀐다. 따라서 액션·링크의 사용처를 옮기고, 전체 알파 호환 클래스 정리, radius 전역 규칙, 타이포·간격·표면 정리는 영향을 확인하면서 뒤에 진행한다. `design-tokens.test.ts`는 원색과 CSS 매핑을 확인하므로 실제 대비 검증과 역할이 다르다. [CSS](../../apps/web/src/index.css#L81) · [기존 토큰 테스트](../../apps/web/test/design-tokens.test.ts)
|
||||
|
||||
공통 컴포넌트는 확인된 사용처에서 시작한다. `Button` 전면 교체 없이 액션·링크 스타일과 초점 기준을 먼저 맞출 수 있다. `Field`는 관리자 검색·티어 선택처럼 라벨과 오류 연결이 필요한 실제 사용처에서 설계한다. `Badge`는 경기 결과, 팀, 티어가 같은 색 의미를 공유하지 않도록 역할별로 나눈다. 터치 44px 목표는 주요 **조작 요소**에 적용하며 티어 배지 같은 읽기 전용 정보의 시각 크기와 구분한다. 기존 팀 코드 복사에는 44px급 높이와 라이브 피드백이 있어 동작을 재사용할 근거가 있다. [기존 복사 버튼](../../apps/web/src/components/competition/TeamTournamentCodes.tsx#L168)
|
||||
|
||||
첫 구현은 **액션·링크 대비와 경기 분석 Tabs**다. 같은 경기 분석 화면에서 라이트·다크, 390px와 데스크톱, 마우스·Tab·방향키를 함께 확인할 수 있다. 확인창은 입력·취소·대기·포커스 복귀 검증이 달라 다음 변경으로 검토한다. 세트 선택과 통계 상태는 이어지는 화면 내부 기능 작업이다. [결과 표시 명세](../specs/match-status-and-result-presentation.md)는 공식 데이터 연결이 필요한 별도 작업으로 보관한다. 경매 상태와 코드 발급 대기는 정상 데이터로 재현되기 전까지 관찰 항목이다.
|
||||
@@ -0,0 +1,65 @@
|
||||
# 07. 심미성 중심의 UI 개선 검토
|
||||
|
||||
추천 방향은 **e스포츠 중계 화면의 선명한 위계와 차분한 데이터 패널**이다. 홈에는 다음 내전, 경매에는 현재 선수와 팀, 경기 분석에는 경기 요약과 흐름이 첫인상을 결정하도록 한다. LOLYMPUS의 각진 형태와 코랄은 살릴 만하다. 화면마다 가장 중요한 정보에만 강한 색·큰 글자·뚜렷한 표면을 주고, 주변 요소의 테두리와 채도를 낮추면 제품의 인상이 선명해진다.
|
||||
|
||||
로컬 스테이징에서 홈, 경매, 시리즈 일정, 경기 분석, 커뮤니티 전적을 다시 캡처했다. 경매와 경기 분석은 라이트·다크를 비교했다. 경매에서 본 유찰과 전적 지표의 값은 레이아웃을 볼 수 있는 표본으로만 사용했다. 캡처의 회색 마스크는 로컬 개발 인증 패널이 있던 영역이다.
|
||||
|
||||
## 가장 큰 시각적 문제
|
||||
|
||||
| 화면 | 현재 인상과 원인 | 시각적 개선 방향 |
|
||||
| --- | --- | --- |
|
||||
| 경매 | 1280 CSS px에서 4열 너비가 **260 / 149 / 440 / 320px**였다. 149px 영역을 팀 카드 두 개가 나눠 카드 하나가 약 **66px**가 됐다. 팀장 이름은 한 글자씩 줄바꿈되고 포인트는 옆 칸을 침범한다. 대기 목록과 채팅이 차지한 면적에 비해 팀 정보의 존재감이 작다. | 팀 카드의 최소 너비를 먼저 확보한다. 좁은 데스크톱에서는 현재 선수와 팀을 두 주 영역으로 두고 대기 목록과 채팅을 하단에 배치한다. 넓은 화면에서만 보조 열을 펼친다. 팀 이름과 포인트를 같은 줄에 정렬하고, 팀장과 로스터는 한 단계 아래에 둔다. [1280px 캡처](evidence/V11-auction-team-width.jpg) · [다크 경매](evidence/V07-auction-dark.jpg) · [현재 그리드](../../apps/web/src/pages/AuctionPage.tsx#L2253) |
|
||||
| 홈 | 다음 내전, 예정 없음, 지난 기록이 비슷한 얇은 테두리와 배경을 사용한다. 다음 내전 카드는 제목 옆 상태, 노란 정원 배지, 보라 버튼, 코랄 전적 링크가 동시에 눈을 끈다. 빈 예정 상자는 카드 높이에 가까운 공간을 쓴다. | 다음 내전만 배경 톤과 제목 크기를 확실히 달리한다. 날짜·맵·인원을 하나의 메타데이터 행으로 묶고, 상태 배지는 낮은 채도를 쓴다. 빈 예정 영역은 작은 안내 행으로 줄여 카드 사이에 크고 빈 사각형이 남지 않게 한다. [홈](evidence/V01-home-light.jpg) |
|
||||
| 대회 상세·시리즈 일정 | 제목, 탭, 날짜 그룹, 경기 행의 시작점이 여러 박스에 나뉘고 두 팀 사이 점수가 넓은 공백 속에 놓인다. 일정 그룹과 경기 행이 비슷한 시각 무게를 가진다. | 날짜는 짧은 구획 제목으로, 경기 행은 `시간·라운드 / 대결과 점수 / 상세`의 정렬된 표로 처리한다. 승리 팀은 무게를 더하고 점수는 고정 숫자 폭으로 맞춘다. 카드 전체를 겹쳐 감싸는 선 대신 행 구분선을 쓴다. [시리즈 일정](evidence/V04-series-light.jpg) |
|
||||
| 경기 분석 | 헤더와 세트 선택, 밴, 오브젝트, 골드 비교가 작은 상자와 선으로 이어진다. 라이트에서 코랄인 선택 강조가 다크에서 보라로 바뀌고, 진영 색·팀 이름 색·승리 강조가 같은 시야 안에서 경쟁한다. | 헤더의 대표 결과와 두 팀 이름을 한 덩어리로 묶고, 세트 선택은 낮은 무게의 한 줄로 구성한다. 오브젝트는 하나의 띠에 나란히 놓는다. 경기 흐름 그래프에는 면적을 더 주고 격자선과 사건 점의 무게를 줄인다. 팀 식별·진영·선택 색은 위치와 역할을 나눠 쓴다. [라이트 경기](evidence/V05-game-light.jpg) · [다크 경기](evidence/V06-game-dark.jpg) |
|
||||
| 커뮤니티 전적 | 하이라이트 카드 다섯 개가 모두 같은 비중을 차지한다. 최근 내전 카드의 오른쪽에 큰 로스터가 들어가며, 세로 가운데 정렬 때문에 제목 위에 큰 공백이 생겼다. | 대회 제목과 시간은 항상 카드 위에 정렬한다. 하이라이트는 값이 있는 항목 중심으로 한 줄의 지표 띠에 모으고, 로스터는 소규모 아바타 묶음과 팀 수로 압축한다. 전체 로스터는 현재 상세 화면에서 볼 수 있다. [커뮤니티 전적](evidence/V08-records-light.jpg) · [카드 배치](../../apps/web/src/pages/CommunityInternalStatsPage.tsx#L84) |
|
||||
|
||||

|
||||
|
||||
## 디자인 토큰 후보
|
||||
|
||||
아래 수치는 시안을 잡기 위한 시작값이다. 최종 팔레트와 크기는 홈·경매·경기 분석을 실제로 그린 뒤 결정한다.
|
||||
|
||||
| 토큰 | 권장 방향 |
|
||||
| --- | --- |
|
||||
| 브랜드·선택 | 코랄을 현재 상태, 활성 탭, 주 액션처럼 시선을 모으는 위치에 쓴다. 라이트와 다크는 서로 다른 색조를 쓰더라도 코랄의 역할은 같다. 바이올렛은 장식 또는 한정된 강조에 둔다. 골드는 우승이나 최고 기록처럼 드문 곳에 남긴다. |
|
||||
| 팀·진영 | 팀 카드는 중립 표면을 공유하고 얇은 옆선 또는 팀 이름 표시에만 팀 색을 준다. 블루·레드는 실제 게임 진영과 그래프의 방향을 설명할 때 쓴다. 팀 번호와 로고·아바타로도 팀을 알아볼 수 있게 한다. |
|
||||
| 표면 | **바탕 / 데이터 패널 / 현재 집중 패널** 세 단계로 먼저 제한한다. 라이트는 뉴트럴 바탕과 흰 패널, 다크는 짙은 잉크색 바탕과 한 단계 밝은 패널. 화면의 층위는 색조와 간격을 먼저 쓰고, 그림자는 팝업과 떠 있는 조작 영역에 제한한다. |
|
||||
| 글자 | Asta Sans를 유지하고 역할의 차이를 키운다. 페이지 제목은 `28–32px`, 섹션 `18–20px`, 본문 `14–15px`, 메타 `12px`부터 비교한다. 현재가·남은 시간·스코어는 `28–36px`의 고정 폭 숫자를 써서 이름과 작은 배지보다 먼저 보이게 한다. |
|
||||
| 공간 | `4 / 8 / 12 / 16 / 24 / 32px`를 기본 단위로 사용한다. 표 행은 촘촘하게, 섹션 사이와 대표 정보 주변은 넉넉하게 둔다. 경매의 현재 선수 카드와 홈의 다음 내전에 같은 패널 패딩을 적용할 수 있다. |
|
||||
| 모서리·선 | 대진과 데이터 표는 각진 인상을 유지한다. 카드·입력·메뉴에는 `4–8px` 범위를 시험하고, 아바타는 형태에 맞게 따로 정한다. 전역 `border-radius: 0 !important`를 옮길 때는 대표 화면부터 시각 차이를 확인한다. 패널 외곽선과 표의 행 구분선은 무게를 달리한다. [현재 스타일](../../apps/web/src/index.css#L182) |
|
||||
|
||||
## 프리미티브와 컴포넌트의 모양
|
||||
|
||||
| 단위 | 제안 |
|
||||
| --- | --- |
|
||||
| 버튼·링크·탭 | 한 화면의 주요 액션만 채운 버튼으로 둔다. 보조 액션은 얇은 외곽선이나 텍스트 버튼으로 표현한다. 선택 탭은 일관된 밑줄과 낮은 채도의 배경을 쓴다. 페이지마다 다른 보라·코랄 버튼이 주 행동을 두고 경쟁하는 경우를 먼저 줄인다. |
|
||||
| 배지·칩 | 상태, 티어, 포지션, 맵을 같은 모양과 채도로 강조하지 않는다. 상태는 연한 바탕과 한 단어, 티어는 작은 정사각 표식, 포지션은 아이콘과 텍스트, 맵은 메타 문구로 표현한다. 여러 색 배지가 한 줄을 덮는 곳부터 정리한다. |
|
||||
| 카드·구분선 | 카드의 **대표 정보 / 보조 정보 / 조작** 위치를 고정한다. 패널 안에 카드가 또 들어갈 때는 내부 카드에 동일한 외곽선을 반복하지 않고 여백이나 구분선을 사용한다. |
|
||||
| 아바타·이미지 | 아이템·룬·챔피언·프로필이 시각적으로 같은 우선순위를 가지지 않게 한다. 현재 선수나 대표 챔피언 이미지는 크게, 명단 아이콘은 같은 크기로 작게, 누락 이미지는 중립 자리표시자로 둔다. |
|
||||
| 표·점수·차트 | 숫자 열을 정렬하고 구획 제목과 경기 행의 무게를 분리한다. 점수는 팀 이름과 가깝게 두고, 그래프는 하나의 대표선과 옅은 격자에서 시작한다. 같은 색이 ‘선택’과 ‘승리’를 동시에 뜻하는 배치는 피한다. |
|
||||
|
||||
경매 카드의 폭 기준은 **180–200px를 시안 출발점**으로 삼을 수 있다. 두 열이면 팀 영역에 약 `372–412px`가 필요하다. 현재 4열의 보조 패널을 유지한 채 폰트만 줄이면 한글 이름과 숫자의 충돌이 남는다. 넓은 데스크톱, 1280px 전후, 390px에서 4팀과 8팀·긴 팀명·빈 로스터를 나란히 비교해 언제 열을 줄일지 정한다.
|
||||
|
||||
## 레퍼런스에서 가져올 시각 원리
|
||||
|
||||
- **OP.GG:** 프로필 아이콘과 이름을 먼저 읽고, 그 아래에서 랭크·탭·전적을 고른다. LOLYMPUS 경매도 현재 선수의 이름·포지션·현재가를 가장 큰 시각 단위로 만들고 전적 지표를 그 아래에 붙일 수 있다. [OP.GG 프로필](https://op.gg/lol/summoners/kr/Hide%20on%20bush-KR1) · [캡처](evidence/V09-opgg-profile.jpg)
|
||||
- **Mobalytics:** 짙은 셸, 선수 프로필 패널, 데이터 패널의 표면 차이가 각 구역을 나눈다. LOLYMPUS에서는 경기 분석의 대표 헤더에만 가장 큰 시각 대비를 두고 표·룬·타임라인은 차분한 패널을 공유하는 방식이 맞다. [Mobalytics 프로필](https://mobalytics.gg/lol/profile/kr/hide%20on%20bush-kr1/overview) · [캡처](evidence/V10-mobalytics-profile.jpg)
|
||||
- One UI의 차분한 표면과 작은 영역의 강한 강조, SEED의 색·공간·곡률 역할 구분은 위 화면의 인상을 토큰으로 옮길 때 참고할 수 있다. [One UI 색상](https://developer.samsung.com/one-ui/color/system.html) · [SEED Foundations](https://seed-design.io/foundations)
|
||||
|
||||
첫 시안은 **경매 화면의 비례와 팀 카드 → 공통 표면·타이포·버튼 → 홈과 경기 분석에 적용** 순서가 적합하다. 경매는 카드 최소 폭, 선수 헤더, 숫자와 배지, 패널 밀도를 한 화면에서 비교할 수 있고, 홈과 경기 분석에 옮겼을 때 같은 제품으로 보이는지 확인할 수 있다.
|
||||
|
||||
## 실제 소스로 만든 Astryx 경매 시안
|
||||
|
||||
`pnpm run start:web:staging` 실행 후 [경매 시안 열기](http://localhost:5173/match/6af19299357ca736af8a5767/auction?auctionPreview=1). 기존 경매 주소에서 `?auctionPreview=1`을 켜면 로컬 개발 서버에서 시안을 볼 수 있다. `기존 화면 보기`를 누르면 같은 데이터로 기존 화면을 비교할 수 있다.
|
||||
|
||||
현재 경매 시안은 Astryx의 공식 Neutral 테마와 실제 `Card`, `TabList`, `Tab`, `Badge`, `StatusDot`, `Button` 컴포넌트를 사용한다. [Astryx 컴포넌트 카탈로그](https://astryx.atmeta.com/components)
|
||||
|
||||
| 단위 | 시안에서 결정한 기준 |
|
||||
| --- | --- |
|
||||
| 디자인 토큰 | Neutral의 바탕·표면·테두리·대비색과 상태 역할을 사용한다. 시안에 Figtree를 연결하고 한글에는 기존 앱 글꼴을 폴백으로 둔다. |
|
||||
| 프리미티브 | 패널 곡률은 Neutral의 12px이고, 선택 탭은 밑줄로 표시한다. 배지와 연결 점은 상태 역할을 따른다. |
|
||||
| 컴포넌트 | 선수 카드에는 전적을, 팀 카드에는 팀원·포지션·낙찰가 열을 넣었다. 운영과 채팅에 Astryx 버튼을 연결했다. |
|
||||
| 화면 | 920px부터 현재 선수와 팀 현황을 `1 : 1.2`로 배치한다. 팀 카드는 480px부터 두 열이며, 선수 명단과 채팅은 팀 현황 아래에 둔다. |
|
||||
|
||||
[Astryx 원본과 비교](evidence/AX-reference-comparison.jpg) · [라이트](evidence/AX-preview-1280-light.jpg) · [다크](evidence/AX-preview-1280-dark.jpg) · [모바일](evidence/AX-preview-390-light.jpg) · [검증 기록](../../design-qa.md)
|
||||
@@ -0,0 +1,46 @@
|
||||
# LOLYMPUS UX/UI 전수 감사
|
||||
|
||||
2026년 11월 10일 KST · 기준 커밋 `f649490cd270aba9e165533c04cb5e277424b6d4`
|
||||
|
||||
개편은 **색·표면·타이포·여백과 카드 구성**부터 진행한다. 경매의 화면 비례와 팀 카드가 첫 시안 대상이다. [심미성 중심 검토](07-visual-design-review.md)
|
||||
|
||||
결과 표시에서는 8팀 대회 전적 헤더에 한 시리즈의 `0:2`가 대회 점수처럼 보이고, 바로 아래 첫 경기는 다른 두 팀의 경기였다. 첫 시리즈 요약을 대회 헤더에 넣는 코드도 확인했다. [전적 상세](evidence/L05-internal-match.jpg)
|
||||
|
||||
경매에서 `팀빌딩 완료`와 `유찰`이 함께 보인 사례, 팀 진행에서 코드가 `발급 대기`였던 사례는 스테이징 관찰이다. 당시 데이터의 정상 전이와 발급 예정 시점은 확인하지 못했다. 두 사례는 정상 데이터에서 재현한 뒤 수정 여부를 정한다. [내전 상세](evidence/L02-match.jpg) · [경매](evidence/L03-auction.jpg) · [코드 상태](evidence/L14-team-state.jpg)
|
||||
|
||||

|
||||
|
||||
| 문서 | 확인할 내용 |
|
||||
| --- | --- |
|
||||
| [01. 사용자 흐름과 개선 항목](01-user-flows.md) | 방문자, 참가자, 팀장, 관전자, 운영자, 카카오톡 사용자의 과업별 현재 상태, 세부 문제와 완료 기준 |
|
||||
| [02. 비교 서비스 조사](02-reference-comparison.md) | OP.GG·LOL.PS·포로지지·Blitz·Tracker·Mobalytics를 기능별로 대조하고, 대회 운영은 Toornament와 Riot 공개 자료로 보완 |
|
||||
| [03. 디자인 토큰·프리미티브·컴포넌트](03-design-system.md) | 실제 대비와 컴포넌트 인벤토리, One UI·SEED·GitHub 오픈소스 비교, 상태와 접근성 계약 |
|
||||
| [04. 개편 순서와 검증 기준](04-delivery-and-validation.md) | 영향과 선행 작업에 따른 우선순위, 테스트 데이터, 릴리스 기준, 후속 검증 계획 |
|
||||
| [05. 커버리지와 현재 구현 색인](05-coverage.md) | 17개 라우트별 관찰 상태, 미검증 분기, CSS 변수 매핑, 기존 웹 테스트 범위 |
|
||||
| [06. UI 개선 우선 검토](06-ui-improvement-review.md) | 토큰·프리미티브·컴포넌트·기능의 첫 적용 대상과 검증 기준 |
|
||||
| [07. 심미성 중심 검토](07-visual-design-review.md) | 현재 화면의 인상, 경매 너비 실측, 화면별 디자인 토큰·카드·표의 시각 개선 방향 |
|
||||
|
||||
## 검증 범위
|
||||
|
||||
- `pnpm run start:web:staging`으로 실행한 로컬 웹과 스테이징 API를 사용했다. `App.tsx`에 선언된 17개 라우트 모두 브라우저에서 열고, 동적 화면은 실제 예시 내전을 골라 확인했다. 17개에는 경유 화면인 `/auth/callback`과 두 개의 정책 화면도 포함된다. 별도로 존재하지 않는 URL과 잘못된 내전 링크를 비교했다. [라우트](../../apps/web/src/App.tsx#L136)
|
||||
- 비로그인 탐색과 브라우저에 설정돼 있던 스테이징 운영자 컨텍스트의 읽기 화면을 구분했다. 기본 데스크톱, 390px 모바일, 1440px 대진표, 320px 관리 화면 일부를 봤다. 라이트와 다크 토큰을 브라우저에서 읽었고 내전·게임 탭의 방향키, 경매 취소 확인창의 Escape와 포커스 복귀를 비교했다.
|
||||
- 접근 근거는 **브라우저**(화면·DOM·조작), **코드**(분기·데이터 계약), **제안**(개편 방향)으로 나눴다. 서버 집계와 스냅샷에 따른 수치는 해당 시점의 관찰이다. 정적 인벤토리는 `apps/web/src`의 추적 파일 91개를 기준으로 했다. 24개 컴포넌트 경로에는 렌더링 파일 외에 모델·레이아웃 유틸리티도 들어 있다.
|
||||
- 당시 스테이징 목록의 `recruiting` 조회는 0건이었다. 모집 신청·정원 경합, 실제 로그인 완료, 카카오톡 왕복, 입찰·낙찰·동시 접속, 사용 가능한 코드 복사, 경기 결과 판정·취소·재수집, 코드 업로드·백필은 코드와 읽기 화면을 확인했고 최종 동작은 격리된 데이터로 검증해야 한다. 브라우저에서 확인한 경매는 유찰 상태였다. 스크린리더 발화, 실기기 터치, 완전한 WCAG 적합성 검증도 별도 범위다.
|
||||
- 화면 자료에서 일부 스테이징 개발 인증 패널을 가리고, 코드 풀은 목록의 실제 코드가 들어가지 않도록 상단만 남겼다. 개발 패널로 인한 가림은 스테이징 로컬 환경에서 관찰했다. 제품 배포판의 가림 문제로 분류하지 않았다. 외부 캡처의 광고와 팝업은 확인 당시 웹 환경에서 보인 상태다.
|
||||
- 분류한 항목은 흐름·기능 54개, 토큰 20개, 프리미티브 28개, 컴포넌트 26개다. 현재 관찰과 개편 제안을 포함한다. `pnpm --filter web test` 기준 기존 테스트 144개가 통과했다. 테스트는 모델과 일부 UI 계약의 기준선이며 전체 사용자 흐름을 대체하지 않는다.
|
||||
|
||||
## 화면별 판정
|
||||
|
||||
| 단계 | 판정 | 화면 근거 |
|
||||
| --- | --- | --- |
|
||||
| 1. 홈 → 내전 찾기 | 과거 검색이 어렵다. 날짜 기준 분류가 실제 운영에서 활성 내전 탐색을 방해하는지는 정상 사례로 확인한다. | [홈](evidence/L01-home.jpg) · [390px 홈](evidence/L24-mobile-home.jpg) |
|
||||
| 2. 내전 상세 → 신청·계정 연결 | 핵심 전환 재검증 필요. 모집 표본이 없으며 비로그인·미등록·마감 분기는 코드로 분석했다. | [내전 상세](evidence/L02-match.jpg) · [안내](evidence/L37-match-info.jpg) · [로그인](evidence/L16-login.jpg) |
|
||||
| 3. 팀빌딩 → 경매 | 정상 흐름의 상태 표시 재현 대기. 모바일 정보 배치와 취소창 포커스 복귀는 별도 관찰이다. | [경매](evidence/L03-auction.jpg) · [모바일](evidence/L27-mobile-auction.jpg) · [취소 확인](evidence/L31-auction-cancel.jpg) |
|
||||
| 4. 대회 → 대진·순위·일정·팀 | 공식 대진과 일정 탭이 동작한다. 라운드 이름과 내 팀 중심 탐색을 개선할 여지가 있다. | [더블 엘리미네이션](evidence/L28-wide-bracket.jpg) · [라운드 로빈](evidence/L21-round-robin.jpg) · [일정](evidence/L10-series.jpg) · [팀](evidence/L11-teams.jpg) |
|
||||
| 5. 팀 선택 → 다음 경기·코드 | 대진 준비와 코드 발급 대기가 함께 표시됐다. 이 조합은 정상일 수 있으며 발급 실패나 사용자 혼동은 확인하지 못했다. | [팀 선택](evidence/L13-team-progress.jpg) · [발급 대기](evidence/L14-team-state.jpg) · [모바일](evidence/L15-mobile-team.jpg) |
|
||||
| 6. 내전 전적 → 대회 결과 | 개선 우선. 커뮤니티 집계 상태와 대회·시리즈·세트 점수의 범위를 분리해야 한다. | [커뮤니티 전적](evidence/L04-leaderboard.jpg) · [대회 전적](evidence/L05-internal-match.jpg) |
|
||||
| 7. 세트 → 타임라인·스코어보드·라인전·빌드 | 분석 데이터가 풍부하다. 모바일 세트 선택, 키보드 탭, 비교 시점 표기가 발목을 잡는다. | [요약·타임라인](evidence/L06-game-scoreboard.jpg) · [라인전](evidence/L07-game-lane.jpg) · [빌드](evidence/L08-game-build.jpg) · [390px 세트](evidence/L26-mobile-game.jpg) · [공개 세트 링크](evidence/L43-public-game.jpg) |
|
||||
| 8. 선수 → 개인 전적 | 큐와 시즌 변경이 가능하다. 검색 진입과 갱신 기준, 빈 결과의 의미를 개선해야 한다. | [내전 개인 전적](evidence/L22-user-profile.jpg) · [협곡 전적](evidence/L23-user-solo.jpg) |
|
||||
| 9. 운영자 → 개설·판정·수집·코드·이관 | 주요 화면과 권한 실패를 확인했다. 실행 전 범위·영향 미리보기와 작업 완료 후 회복 경로가 필요하다. | [관리 목록](evidence/L17-admin-matches.jpg) · [개설](evidence/L32-admin-create.jpg) · [공식 판정](evidence/L12-competition-ops.jpg) · [코드](evidence/L18-admin-codes.jpg) · [백필](evidence/L19-admin-import.jpg) · [과거 내전](evidence/L20-admin-legacy.jpg) · [권한 없음](evidence/L42-admin-denied.jpg) |
|
||||
| 10. 경유·실패·보조 화면 | 잘못된 내전에는 안내가 있다. 미등록 경로는 헤더와 푸터 사이가 비어 있고, 직접 들어간 콜백은 인증 결과에 대한 설명이 없다. | [미등록 경로](evidence/L36-not-found.jpg) · [잘못된 내전](evidence/L40-missing-match.jpg) · [콜백](evidence/L33-callback.jpg) · [약관](evidence/L34-terms.jpg) · [개인정보처리방침](evidence/L35-privacy.jpg) |
|
||||
| 11. 카카오톡 → 등록·신청·취소·이관 | 서버 명령과 오류 분기를 확인했다. 실제 채팅에서 보내고 받는 흐름은 검증 대기다. | [명령 파서](../../apps/api/src/modules/dakao/parsers/command.parser.ts#L44) |
|
||||
|
After Width: | Height: | Size: 87 KiB |
|
After Width: | Height: | Size: 81 KiB |
|
After Width: | Height: | Size: 62 KiB |
|
After Width: | Height: | Size: 61 KiB |
|
After Width: | Height: | Size: 72 KiB |
|
After Width: | Height: | Size: 29 KiB |
|
After Width: | Height: | Size: 26 KiB |
|
After Width: | Height: | Size: 46 KiB |
|
After Width: | Height: | Size: 56 KiB |
|
After Width: | Height: | Size: 68 KiB |
|
After Width: | Height: | Size: 28 KiB |
|
After Width: | Height: | Size: 77 KiB |
|
After Width: | Height: | Size: 30 KiB |
|
After Width: | Height: | Size: 68 KiB |
|
After Width: | Height: | Size: 70 KiB |
|
After Width: | Height: | Size: 72 KiB |
|
After Width: | Height: | Size: 29 KiB |
|
After Width: | Height: | Size: 36 KiB |
|
After Width: | Height: | Size: 71 KiB |
|
After Width: | Height: | Size: 32 KiB |
|
After Width: | Height: | Size: 60 KiB |
|
After Width: | Height: | Size: 31 KiB |
|
After Width: | Height: | Size: 75 KiB |
|
After Width: | Height: | Size: 105 KiB |
|
After Width: | Height: | Size: 121 KiB |
|
After Width: | Height: | Size: 95 KiB |
|
After Width: | Height: | Size: 111 KiB |
|
After Width: | Height: | Size: 126 KiB |
|
After Width: | Height: | Size: 79 KiB |
|
After Width: | Height: | Size: 77 KiB |
|
After Width: | Height: | Size: 89 KiB |
|
After Width: | Height: | Size: 69 KiB |
|
After Width: | Height: | Size: 64 KiB |
|
After Width: | Height: | Size: 73 KiB |
|
After Width: | Height: | Size: 40 KiB |
|
After Width: | Height: | Size: 44 KiB |
|
After Width: | Height: | Size: 119 KiB |
|
After Width: | Height: | Size: 37 KiB |
|
After Width: | Height: | Size: 74 KiB |
|
After Width: | Height: | Size: 55 KiB |
|
After Width: | Height: | Size: 76 KiB |
|
After Width: | Height: | Size: 87 KiB |
|
After Width: | Height: | Size: 88 KiB |
|
After Width: | Height: | Size: 32 KiB |
|
After Width: | Height: | Size: 43 KiB |
|
After Width: | Height: | Size: 38 KiB |
|
After Width: | Height: | Size: 34 KiB |
|
After Width: | Height: | Size: 105 KiB |
|
After Width: | Height: | Size: 78 KiB |
|
After Width: | Height: | Size: 61 KiB |
|
After Width: | Height: | Size: 63 KiB |
|
After Width: | Height: | Size: 38 KiB |
|
After Width: | Height: | Size: 56 KiB |
|
After Width: | Height: | Size: 58 KiB |
|
After Width: | Height: | Size: 37 KiB |
|
After Width: | Height: | Size: 102 KiB |
|
After Width: | Height: | Size: 84 KiB |
|
After Width: | Height: | Size: 70 KiB |
|
After Width: | Height: | Size: 40 KiB |
|
After Width: | Height: | Size: 29 KiB |
|
After Width: | Height: | Size: 95 KiB |
|
After Width: | Height: | Size: 77 KiB |
|
After Width: | Height: | Size: 84 KiB |
|
After Width: | Height: | Size: 114 KiB |
|
After Width: | Height: | Size: 85 KiB |
|
After Width: | Height: | Size: 60 KiB |
|
After Width: | Height: | Size: 119 KiB |
|
After Width: | Height: | Size: 104 KiB |
|
After Width: | Height: | Size: 79 KiB |
|
After Width: | Height: | Size: 45 KiB |
|
After Width: | Height: | Size: 57 KiB |
|
After Width: | Height: | Size: 31 KiB |
|
After Width: | Height: | Size: 96 KiB |
|
After Width: | Height: | Size: 62 KiB |
|
After Width: | Height: | Size: 37 KiB |
|
After Width: | Height: | Size: 100 KiB |
|
After Width: | Height: | Size: 121 KiB |
|
After Width: | Height: | Size: 77 KiB |
|
After Width: | Height: | Size: 111 KiB |
|
After Width: | Height: | Size: 94 KiB |
|
After Width: | Height: | Size: 55 KiB |
|
After Width: | Height: | Size: 87 KiB |
|
After Width: | Height: | Size: 80 KiB |
|
After Width: | Height: | Size: 60 KiB |
|
After Width: | Height: | Size: 78 KiB |
|
After Width: | Height: | Size: 79 KiB |
|
After Width: | Height: | Size: 86 KiB |
|
After Width: | Height: | Size: 68 KiB |
|
After Width: | Height: | Size: 65 KiB |
|
After Width: | Height: | Size: 74 KiB |
|
After Width: | Height: | Size: 55 KiB |
|
After Width: | Height: | Size: 46 KiB |