feat(web): refresh the app with Astryx and coral branding
No files matched your search
@@ -0,0 +1,121 @@
|
||||
# 내전 상태와 대회·시리즈·세트 표시 명세
|
||||
|
||||
2026년 11월 10일 · UX/UI 결과 표시 · 후속 구현 제안
|
||||
|
||||
결과 표시 작업은 **대회·시리즈·세트의 결과 범위를 분리**하는 데 집중한다. 전적 화면의 `2:0`은 해당 두 팀의 시리즈에서만 표시한다. 전체 개편은 토큰과 프리미티브를 먼저 적용한다. 경매 상태와 코드 발급 대기는 감사 당시 스테이징에서 관찰한 두 사례로, 현재 운영 흐름의 수정 범위를 정하기 전에 정상 데이터로 확인한다. [UI 우선 검토](../ux-audit-2026-11-10/06-ui-improvement-review.md) · [감사 보고서](../ux-audit-2026-11-10/README.md)
|
||||
|
||||
## 1. 현재 원인과 범위
|
||||
|
||||
1. **구현 대상.** 공식 대회 데이터에는 `seriesId`, `gameSlotId`, `winnerTeamId`가 있다. 통계용 변환에서는 해당 식별 관계가 결과 DTO로 이어지지 않는다. 전적 서비스는 팀 인덱스 쌍으로 결과를 다시 묶고, 대회 카드와 상세는 `seriesResults[0]`, 세트 상세는 팀 인덱스 조합으로 점수를 선택한다. 정상 데이터에서도 서로 다른 두 시리즈가 같은 팀 쌍을 가지면 이 방식으로는 둘을 구별할 수 없다. [공식 계약](../../packages/contracts/src/game.ts#L44) · [통계용 변환](../../apps/api/src/modules/community-stats/match-stats.service.ts#L394) · [재집계](../../apps/api/src/modules/community-stats/community-stats.service.ts#L645) · [세트의 팀 쌍 선택](../../apps/web/src/pages/MatchGameDetailPage.tsx#L234)
|
||||
2. **재현 대기.** 경매 시작 경로는 편성이 끝나기 전에 `Match.status = 'team-built'`를 저장할 수 있다. 홈과 상세의 라벨이 다른 것은 코드로 확인했다. 감사 당시 `test300`의 저장 상태와 경매 스냅샷이 같은 정상 전이를 나타내는지, 중단·복구·정정이 있었는지는 확인하지 못했다. 이 기록을 정상 경매의 회귀 기준으로 쓰지 않는다. [경매 시작](../../apps/api/src/modules/auction/auction.service.ts#L478) · [홈 상태 라벨](../../apps/web/src/pages/HomePage.tsx#L348) · [상세 상태 라벨](../../apps/web/src/pages/MatchDetailPage.tsx#L298)
|
||||
3. **정상일 수 있는 대기 상태.** 대진의 `ready`와 슬롯의 코드 할당은 별도 상태다. 팀 화면에 `발급 대기`가 보였다는 사실만으로 코드 발급 실패나 화면 결함을 판단할 수 없다. 스테이징 당시 할당 예정 시점, 코드 풀, 후속 처리 결과는 확인하지 못했다. [팀 진행 조회](../../apps/api/src/modules/competition/competition-query.service.ts#L107) · [코드 할당 처리](../../apps/api/src/modules/tournament-result/competition-outbox.processor.ts#L208)
|
||||
|
||||
기존 `Match`·경매·`Competition`이 각각 소유하는 상태 전이와 점수 산정은 유지한다. 새 작업은 읽기 계약, 공통 표시 규칙, 상태에 맞는 기존 행동 링크, 조회 상태를 다룬다. 저장 enum, 입찰·팀빌딩·판정 명령, 대진 알고리즘, 신규 모집 정책, 알림 및 전체 디자인 토큰 교체는 별도 변경이다. [기존 Competition 도메인 명세](competition-result-domain.md)
|
||||
|
||||
## 2. 어떤 데이터가 무엇을 결정하는가
|
||||
|
||||
| 질문 | 기준 데이터 | 화면에 주는 값 |
|
||||
| --- | --- | --- |
|
||||
| 모집·팀빌딩·내전 진행 중 어디인가? | `Match.status`와 확정 팀 근거, 해당 내전의 현재 경매 | 공통 내전 단계 및 홈 섹션. 예정 시각은 일정과 정렬에 사용한다. |
|
||||
| 현재 입찰 라운드는 무엇인가? | 현재 경매 lifecycle의 스냅샷·소켓 업데이트 | 입찰 대기/진행/마감 확인/낙찰/유찰. 전송 중·재연결 중은 별도 표시한다. |
|
||||
| 대회와 시리즈의 공식 결과는 무엇인가? | 같은 `Competition` revision의 `projection`·`outcome` | 형식·공식 대회 상태·순위/우승·시리즈 점수·판정. |
|
||||
| 세트는 실제로 끝났는가? 분석을 볼 수 있는가? | 해당 `gameSlotId`와 연결된 공식 `Game`, 현재 revision에 해당하는 통계 상세 | 공식 세트 승패와 분석 가용성을 분리한다. |
|
||||
| 코드가 지금 사용 가능한가? | 기존 팀 진행 API의 해당 슬롯 할당과 만료 | 코드 상태 및 복사 가능 여부. 공개 내전 요약에는 코드를 담지 않는다. |
|
||||
|
||||
표시 상태는 동작 권한이 아니다. 역할·커뮤니티·팀 권한과 제출 가능 여부는 기존 조회·명령의 검증을 사용한다. 버튼 활성화에는 UI 표시 상태에 더해 기존의 권한, 데이터 최신성, 진행 중 요청 조건을 적용한다. 공식 상태와 `Match` 상태가 잠시 다른 동안에는 각각 `공식 결과`와 `내전 상태`의 범위에서 보여 준다. 예를 들어 판정 반영 직후 경기 기록에는 `공식 결과 확정`이 보일 수 있고, 홈은 outbox가 `Match.status`를 갱신한 뒤 종료 기록으로 이동한다. 결과 정정에서도 같은 원칙을 적용한다. [기존 outbox](../../apps/api/src/modules/tournament-result/competition-outbox.processor.ts#L192)
|
||||
|
||||
## 3. 공통 내전 상태 검증과 조건부 설계
|
||||
|
||||
정상 절차로 만든 격리 내전에서 경매 시작 → 입찰 또는 유찰 → 편성 반영을 따라간다. 같은 `matchId`와 경매 lifecycle에서 현재 phase·revision·편성 반영 상태를 기록한 뒤 홈과 상세의 재조회 결과를 대조한다. 코드 흐름은 대진 확정 시각, 슬롯 할당 전후, 후속 처리 결과를 확인한다. `ready` 상태에서 코드 할당 전 대기는 정상 시나리오로 다룬다. 관찰 결과는 다음과 같이 처리한다.
|
||||
|
||||
| 검증 결과 | 구현 범위 |
|
||||
| --- | --- |
|
||||
| 이전 스냅샷이나 오류가 있는 레코드에서만 재현 | 해당 데이터·복구 경로의 문제로 분리한다. 정상 화면용 새 상태 계약은 보류한다. |
|
||||
| 정상 경매에서 편성 전인데 상세가 완료를 표시 | 상세가 이미 조회하는 경매 데이터로 해당 라벨을 바로잡을 수 있는지 먼저 확인한다. 정상 데이터에서 홈까지 의미가 어긋나고 기존 정보로 해결할 수 없는 경우에만 아래 공통 상태 API를 검토한다. |
|
||||
| 대진 확정 뒤 예정대로 코드가 발급됨 | 현재 상태와 흐름을 유지한다. 반복적인 문의나 입장 혼동이 확인될 때만 문구를 개선한다. |
|
||||
| 발급 조건이 충족됐지만 할당이 누락되거나 멈춤 | 슬롯·코드 풀·후속 처리의 원인을 따로 조사한다. 문구 변경만으로 해결된 것으로 보지 않는다. |
|
||||
|
||||
다음 API와 화면 규칙은 홈·상세 공통 상태가 필요하다는 결과가 나올 때 사용할 설계안이다. 홈의 날짜 분류 개선은 실제 진행 내전이 과거 목록에 묻히는 정상 사례를 확인한 뒤 범위를 결정한다.
|
||||
|
||||
목록과 상세를 제공하는 API에 `eventProgress?: { stage: EventStage }`를 추가한다. `status`는 기존 도메인 값 그대로 반환한다. 서버가 한 함수에서 `stage`를 계산하고, 웹은 한 매핑에서 문구·강조도·화면별 진입점을 선택한다. 화면별로 `team-built`를 직접 번역하는 코드를 교체한다.
|
||||
|
||||
아래 표는 위에서부터 우선 적용한다. ‘편성 확정 근거’는 정상 링크된 `competitionId`, 또는 유효한 `teamBuiltAt`과 2개 이상 저장된 팀이다. 현재 경매가 살아 있거나 반영 실패 상태임을 알고 있다면 확정 근거를 먼저 적용하지 않는다. 데이터 불일치는 `team-check`로 표현하고 기존 명령 검증을 유지한다.
|
||||
|
||||
| `EventStage` | 결정 조건 | 화면 기본 문구 | 주요 진입점 |
|
||||
| --- | --- | --- | --- |
|
||||
| `finished` | `Match.status = finished` | 종료 | 경기 일정·결과. 공식 결과가 정정 중이면 공식 상태를 별도 안내. |
|
||||
| `in-progress` | `Match.status = in-progress` | 진행 중 | 대진표·일정. 기존 권한으로 내 팀을 확인할 수 있으면 팀 진행. |
|
||||
| `recruiting` | `recruiting`이고 해당 내전의 현재 경매가 없음을 확인함 | 모집 중 | 내전 상세의 참가 영역. 정원·로그인·기참가 조건은 기존 참가 판단을 사용. |
|
||||
| `auction-preparing` | 현재 경매 `startupCompleted = false` 또는 `waiting` | 경매 준비 중 | 경매 페이지. 시작 처리 중에는 신청·입찰 가능 여부를 추정하지 않음. |
|
||||
| `auction-active` | 현재 경매 `presenting`, `bidding`, `sold`, `passed` | 팀빌딩 중 | 경매 보기. 라운드 문구는 경매 페이지에 추가 표시. |
|
||||
| `team-finalizing` | 현재 경매 `complete`이고 편성 반영이 `pending/processing`, 또는 실패 신호와 확정 근거가 모두 없음 | 팀 편성 반영 중 | 경매 결과 보기. 공식 대진 및 코드 CTA는 실제 준비 상태에 따름. |
|
||||
| `team-check` | 편성 반영 `failed`, 알려진 데이터 불일치, 또는 필요한 조회를 확인하지 못함 | 팀빌딩 상태 확인 필요 | 내전 상세 또는 경매 보기. 운영자에게만 오류·회복 경로를 제공. |
|
||||
| `teams-finalized` | 활성 경매가 없거나 종료됐고 편성 확정 근거가 있음 | 팀 편성 완료 | 대진표가 조회되면 보기. 초기화 대기면 `대진 준비 중` 표시. |
|
||||
|
||||
`team-built`인데 경매·확정 근거가 없거나 구버전 API에 `eventProgress`가 없으면 `팀빌딩 상태 확인 필요`로 표시한다. 조회 실패는 경매 없음과 다르다. `recruiting`과 이미 시작된 경매가 함께 보이면 시작이 확인된 현재 lifecycle만 표시한다. 완료된 취소의 lifecycle은 조회 후보에서 제외한다. 경매 취소가 성공해 Match가 모집 상태로 돌아가면 `모집 중`을 표시하고 이전 경매 상태를 폐기한다. 새 경매 lifecycle과 이전 revision을 같은 타임라인에서 비교하지 않는다. [기존 경매 스냅샷 병합](../../apps/web/src/api/auction-state.ts#L22) · [경매 시작 복구](../../apps/api/src/modules/auction/auction.service.ts#L578)
|
||||
|
||||
### 읽기 경로와 홈 목록
|
||||
|
||||
- 목록에 표시될 ID만 대상으로 경매의 소형 상태를 배치 조회한다. Mongo에서는 현재 경매와 `startupCompleted`, 엔진, lifecycle, revision 및 반영 상태만 읽는다. Redis 경매는 같은 lifecycle이고 오래되지 않은 스냅샷의 phase/반영 상태를 사용할 수 있다. Redis 누락·불일치·오류의 경우 확정 근거가 있는 종료 경매만 보존하고, 확인이 필요한 활성 후보는 `team-check`로 내려준다. 목록 요청은 기존 전체 경매 조회나 재수화 경로를 호출하지 않는다. 사용자 ID, 현재 선수, 채팅, 입찰 금액, 코드가 공통 상태 응답에 들어가지 않는다.
|
||||
- 기존 매치 목록 API에 홈 전용 `view=active|upcoming|history`를 추가한다. `active`는 `team-built/in-progress` 및 `scheduledAt < asOf`인 `recruiting`, `upcoming`은 `scheduledAt >= asOf`인 `recruiting`, `history`는 `finished`다. 홈은 한 번의 갱신에 세 조회가 공유할 ISO `asOf`를 보내고, 서버는 날짜 형식을 검증한 뒤 필터·정렬·페이지를 적용한다. 기존 `status` 및 날짜 필터를 사용하는 호출자는 그대로 동작한다. `view`와 기존 상태·날짜 필터를 한 요청에 섞으면 400으로 응답한다. 날짜는 모집 내전의 목록 위치만 정하며, 예정 시각이 지났다는 이유로 참가 가능 상태를 종료로 바꾸지 않는다.
|
||||
- 홈은 `진행 중인 내전`과 `예정된 내전`, `지난 내전 기록`을 따로 보여 준다. 진행·종료는 `scheduledAt` 최신순, 예정은 가까운 순이며 동일한 시각의 순서는 `_id`로 고정한다. 서버 페이지를 통째로 클라이언트에서 재정렬하지 않는다. 진행 중인 6월 내전은 날짜가 오래돼도 종료 목록에 들어가지 않는다. 각 섹션 오류는 그 섹션에서 복구할 수 있다.
|
||||
- 경매 소켓으로 같은 lifecycle의 단계가 바뀌거나 시작·종료·취소 명령이 확정되면 해당 Match detail 및 목록 query를 갱신한다. `presenting/bidding/sold/passed` 사이의 가격·타이머 틱마다 홈을 다시 요청할 필요는 없다. 오래 열린 홈은 전면 복귀 시 갱신한다. 외부 운영자의 상태 전이는 기존 소켓 또는 제한된 재조회로 반영하며, 기존 목록의 전체 실시간 구독을 추가하지 않는다.
|
||||
|
||||
경매 페이지에서는 `팀빌딩 중` 아래 `입찰 대기`, `입찰 진행 중`, `낙찰`, `유찰 · 다음 선수 대기`를 해당 phase로 표시한다. 화면 타이머가 0초가 되면 기존 마감 가드에 맞춰 `마감 · 서버 결과 확인 중`을 보여 준다. 서버가 확정할 때까지 낙찰이나 유찰을 추정하지 않는다. `연결 중`, `재연결 중`, `입찰 확인 중`은 각각 연결 및 요청 상태로 표시한다.
|
||||
|
||||
## 4. 대회·시리즈·세트 표시 규칙
|
||||
|
||||
| 단위 | 표시 기준 | 예시 |
|
||||
| --- | --- | --- |
|
||||
| 대회 / 내전 | 제목·형식·공식 진행 상태. 더블 엘리미네이션은 공식 완료 후에만 우승팀, 라운드 로빈은 공식 순위 및 공동 1위. `paired-series` 대회에 종합 우승을 만들지 않는다. | `멸망전 · 8팀 더블 엘리미네이션` / `공식 시리즈 6개 확정` / `결승 확정 후 우승팀 ○○` |
|
||||
| 단일 시리즈 요약 | 대회 그래프가 **실제로 시리즈 1개**인 `paired-series`에서만 시리즈 요약을 대회 헤더 아래에 둘 수 있다. 시즌 필터 결과가 한 팀 쌍 또는 시리즈 하나라는 사실은 판단에 사용하지 않는다. | `시리즈 결과 · 나물장수 2:0 원딜미아요` |
|
||||
| 시리즈 | 라운드·시리즈 이름, 두 팀, 형식, 상태. 점수는 `entries`의 A/B 슬롯을 실제 팀 ID에 붙인다. 해당 세트의 블루/레드 진영이 바뀌어도 표의 팀 순서와 시리즈 점수는 유지한다. | `승자조 1라운드 · 1경기 · 3전 2선승` / `나물장수 2:0 원딜미아요` |
|
||||
| 세트 | 시리즈 안 번호인 `ordinal`을 화면에 사용한다. 세트 승패는 해당 공식 Game의 승자·진영으로 표시한다. `displayNumber`는 기존 링크 해석과 필요한 보조 표기에 사용한다. | `승자조 1라운드 · 1경기 · 1세트` / `나물장수 승리 · 블루 · 28:24` |
|
||||
| 레거시 기록 | 공식 연결을 확정할 수 없으면 개별 기록에서 확인 가능한 팀·승패·전역 경기 번호를 표시한다. 상대 조합을 시리즈 ID 또는 우승의 근거로 삼지 않는다. | `과거 기록 · 7경기` / `공식 시리즈 정보 없음` |
|
||||
|
||||
세트의 기본 헤더에는 `2:0`도, 세트 승패를 숫자로 바꾼 `1:0`도 넣지 않는다. 필요하면 별도 `시리즈 최종 2:0` 또는 `시리즈 현재 1:0`을 함께 표시한다. `현재/최종`은 공식 시리즈 상태가 결정한다. 동일 두 팀이 승자조와 결승에서 다시 만나면 별개의 `seriesId`와 세트 목록을 가진다.
|
||||
|
||||
표의 라운드 이름은 설명용 예시다. 화면에서는 기존 공식 대진의 라운드 이름을 공용 함수로 재사용하고 내전 상세, 전적, 팀 진행 사이에서 같은 이름을 쓴다. [기존 팀 진행 명세](team-progress-page-ux-refresh.md)
|
||||
|
||||
| 시리즈/슬롯 상태 | 화면 문구와 점수 |
|
||||
| --- | --- |
|
||||
| `inactive` | 일반 목록에서 숨긴다. 브래킷에서 조건을 보여 줄 때에는 `리셋 결승 · 조건부` 등으로 표시한다. |
|
||||
| `waiting` | `대진 미정` 및 확인된 팀/진출 조건. 점수 없음. |
|
||||
| `ready` | `대진 확정`, 일정이 없으면 `일정 미정`. 코드 할당이 있는 화면은 `코드 발급 대기/사용 가능/만료`를 별도로 표시한다. 점수 없음. |
|
||||
| `in-progress` | `진행 중`. 공식 인정된 게임이 있는 경우에만 `현재 1:0`처럼 점수를 붙인다. |
|
||||
| `completed / played` | `최종 2:0`, 공식 승자 표시. |
|
||||
| `completed / draw` | `무승부`. 실제 경기로 성립한 경우에만 최종 점수 표시. 운영 판정 무승부에는 점수를 만들지 않는다. |
|
||||
| `completed / walkover, forfeit, administrative` | `부전승 / 기권승 / 판정승`과 공식 승자. 점수 대신 결정 문구. 판정 전에 인정된 세트가 있으면 해당 기록은 펼쳐 볼 수 있다. |
|
||||
| `voided` 또는 시리즈 종료 후 사용되지 않은 슬롯 | `무효` 또는 `미진행`을 구별한다. 점수 및 다른 세트로 이어지는 분석 링크 없음. |
|
||||
| 공식 Game 있음 / 통계 상세 없음 | 세트 승패는 그대로 표시하고 `상세 분석 준비 중`을 붙인다. API 요청 실패는 `상세 분석을 불러오지 못했습니다 · 다시 시도`로 구분한다. |
|
||||
|
||||
팀 진행에서 실제 혼동이 확인되면 `대진 확정 · 코드 발급 대기`처럼 대진과 코드 상태를 함께 안내하는 문구를 검토한다. `used` 코드는 사용 완료를 뜻하며 Riot 기록 수집 여부는 별도 데이터다. [팀 진행의 현재 코드 상태](../../apps/web/src/pages/match-team-progress-view.ts#L128)
|
||||
|
||||
## 5. 데이터 계약과 호환성
|
||||
|
||||
- `packages/contracts`에 기존 ID 타입을 재사용해 공개 내전 상태와 공식 전적 표시 계약을 정의한다. 기존 필드에 `eventProgress` 및 선택적 `resultPresentation`을 추가하는 방식으로 이행한다. `resultPresentation`은 `official`, `legacy`, `unavailable`을 구별한다. 과거 API에 새 필드가 없는 경우 웹은 레거시라고 단정하지 않고 기록 단위에서 확인할 수 있는 결과만 보여 준다.
|
||||
- 목록의 공식 요약에는 `competitionId`, `sourceRevision`, `formatType`, `phase`, `teamCount`, 공식 확정 시리즈 수와 해당 형식의 공식 결과 요약을 담는다. 단일 시리즈 예외가 성립하는 경우에만 해당 요약을 포함한다. 공식 카드는 현재 페이지의 대회 ID를 한 번에 조회해 필요한 필드만 결합한다. 필터 날짜의 게임만 다시 센 수치는 `조회 기간 내 기록 N세트`처럼 별도로 표시한다. 필터 결과로 공식 시리즈 최종 점수나 우승이 바뀌지 않는다.
|
||||
- 대회 상세에는 공식 요약과 표시할 `series`, `gameSlots`, 인정 `games`의 최소 필드를 같은 revision에서 제공한다. 팀 이름과 점수는 `teamId`, 세트 분석은 정확한 `gameId`/`gameSlotId`를 사용한다. 통계 상세의 기존 `gameNumber`는 유지하되 응답에 공식 `gameId`, `gameSlotId`, `seriesId`, `ordinal`을 연결한다. 기존 통계 fragment를 연결할 때는 같은 대회·revision과 Riot 증빙 ID가 유일하게 맞는 경우만 사용한다. 레거시 증빙은 명시적인 참조가 일치할 때만 연결한다. 이름·팀 쌍·배열 위치로 연결하지 않는다.
|
||||
- 첫 배포에는 기존 통계 집계 계산을 교체할 필요가 없다. 공식 경기 표시에서 재집계된 `seriesResults`와 `winnerTeamIndex`의 소비를 끊고, 기존 통계 필드는 호환용으로 보존한다. 결과 정정으로 공식 revision이 앞서면 최신 공식 결과를 표시하고 이전 통계 상세를 새 세트 결과처럼 붙이지 않는다. 결과 응답 캐시 버전을 올리고 기존 outbox 무효화와 fragment 재구축을 재사용한다. DB 일괄 마이그레이션 없이 캐시 갱신으로 이행한다. [현행 상세 캐시](../../apps/api/src/modules/community-stats/community-stats.service.ts#L219) · [현행 fragment 최신성 확인](../../apps/api/src/modules/community-stats/community-stats.service.ts#L589)
|
||||
- 기존 두 세트 URL은 유지한다. 공개 대진 `/match/:id/game/:gameNumber`의 기본 복귀는 `/match/:id?tab=games`, 커뮤니티 경로의 기본 복귀는 해당 전적 상세다. 같은 시리즈를 펼치려면 `seriesId`를 포함한 링크를 생성하고 해당 대회 소속인지 검증한다. 전역 번호로 정확히 일치하는 세트만 열며, 없으면 `아직 기록이 없는 세트` 또는 `해당 세트를 찾을 수 없습니다`로 안내한다. 기존 분석이 없는 공식 세트는 공식 대진 정보를 사용해 별도로 판단한다. [정확 번호 선택](../../apps/web/src/lib/internal-match-game-selection.ts)
|
||||
- 커뮤니티 통계의 순위·하이라이트·최근 내전은 각각 `loading / success / error`를 독립 처리한다. `sideWinRate.confirmed?: { sampleSize, blue, red }`를 추가해 승패가 확인된 세트의 수와 그 표본의 승률을 반환한다. 새 분모가 0이면 `— · 표본 없음`, 분모 12에서 블루 승리가 0번이면 `0% · 12세트`다. 기존 승률과 `bluePicks/redPicks`의 계산은 호환용으로 보존한다. 새 분모가 없는 구버전 응답에서는 확인된 표본 수라고 단정하지 않는다. 재조회에 실패했지만 기존 성공 데이터가 있으면 그 값과 갱신 실패를 함께 표시한다. [현행 인사이트 응답](../../apps/api/src/modules/community-stats/community-stats.service.ts#L180)
|
||||
|
||||
## 6. 구현 순서와 완료 조건
|
||||
|
||||
| 작업 | 코드 접점 | 완료 조건 |
|
||||
| --- | --- | --- |
|
||||
| 1. 공식 결과 연결 | `CommunityStatsService`, 공식 Competition 조회, 통계 상세 DTO, 캐시 | 한 대회 안의 동일 팀 재대결이 각각 다른 `seriesId` 및 점수를 보유. 시즌 필터와 결과 정정에서도 공식 점수가 정체성을 유지. 페이지 크기에 비례하는 외부 요청 증가 없음. |
|
||||
| 2. 전적 화면 적용 | `CommunityInternalStatsPage`, `InternalMatchDetailPage`, `MatchGameDetailPage`, 기존 `CompetitionSeriesHistory` | 대회 헤더에서 임의 점수 제거. 시리즈 점수와 세트 승패 구별, 링크 보존과 진입 맥락별 복귀. 표본 없음과 조회 실패는 별도 상태로 표시. |
|
||||
| 병행 검증. 경매·코드 상태 | `HomePage`, `MatchDetailPage`, `AuctionPage`, 팀 진행 표시 유틸 및 각 조회 계약 | 새 내전에서 편성 전후와 슬롯 할당 전후를 확인한다. 정상 절차에서 문제가 재현되는 화면만 수정 범위에 넣는다. |
|
||||
|
||||
전적 화면은 공식 결과 계약을 사용한다. 서버 계약 변경은 응답 필드 추가로 먼저 이행하고, 웹은 필드가 없는 응답에서도 결과 범위를 과장하지 않는 기본 표시를 제공한다. 경매·코드 검증은 공식 결과 작업의 선행 조건이 아니다.
|
||||
|
||||
| 회귀 시나리오 | 기대 화면/동작 |
|
||||
| --- | --- |
|
||||
| 감사의 8팀 대회 | 대회 헤더에 첫 팀 쌍 `0:2`가 보이지 않음. 첫 세트는 나물장수의 해당 세트 승리를, 별도 시리즈 맥락은 해당 시리즈 `2:0`을 보여 줌. [재현 화면](../ux-audit-2026-11-10/evidence/comparison-event-vs-series.jpg) |
|
||||
| 2팀 고정 세트 무승부, 4/8팀 더블 엘리미네이션, 라운드 로빈 공동 1위, 같은 팀 재대결 | 형식에 맞는 종합 결과. 공식 승자/순위만 표시하며 동일 팀 대결을 분리. |
|
||||
| 부전승·기권승·판정승·판정 무승부·리셋 미활성 | 가짜 `0:0` 없음. 인정 세트가 있으면 올바른 세트만 열 수 있음. |
|
||||
| 슬롯 번호가 1, 2, 7로 건너뜀 / 기존 `/game/7` 링크 / 결과 되돌리기 | 보이는 시리즈 내 번호와 전역 URL 번호가 구분됨. 요청 번호와 다른 세트로 이동하지 않음. 정정 직후 이전 분석을 새 결과에 붙이지 않음. |
|
||||
| 통계 요청 일부 실패 / 0세트 / 실제 승률 0% | 다른 섹션은 계속 보이며, 실패·표본 없음·실측 0을 구분. |
|
||||
|
||||
검증은 API 상태 결정과 DTO의 회귀 테스트, 웹의 표시 결정·링크 선택 테스트, 그리고 390px와 데스크톱에서 위 사례를 확인하는 순서로 진행한다. 기존 `match-public.presenter`, `community-stats.service`, `competition-series-history`, `match-team-progress-view`, `internal-match-game-selection`, `auction-state` 테스트를 재사용하고 기존 테스트에 없는 재대결·상태 경합에만 사례를 추가한다. 구현 후 `pnpm --filter web test`, `pnpm --filter web build`와 변경한 API 모듈 테스트를 실행한다. 쓰기가 필요한 재현은 격리된 fixture에서 검증한다.
|
||||
@@ -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 |