feat: enhance auction interactions and player statistics UI

This commit is contained in:
dahyeon committed 2026-11-11 20:06:22 +09:00
1 parent 6c582ba3cf
commit be4de61bb7
115 files changed
+13292 -2871

No files matched your search

+83
View File
@@ -0,0 +1,83 @@
# LOLYMPUS: 정보가 처음부터 보이는 UI
2026-11-11 KST. 사용자의 명시적 요구에 따라 펼치기/접기 UX를 제품 기본 패턴에서 제외한다. 기존 UX 감사 문서의 Disclosure 권장과 4·8팀 명단 접기 제안을 이 문서가 대체한다.
> **2026-11-11 후속 결정: 경매 재설계 철회 및 기존 배치 복구.** 사용자는 아래 기록의 4열 재설계를 거부했다. 팀 영역의 과도한 면적, 오른쪽으로 밀린 현재 선수, 긴 대기 목록이 유찰을 밀어내는 흐름을 해결하지 못했다. 경매는 변경 전의 작은 팀 카드·대기/유찰 탭·내전/솔로 전적 탭 배치로 복구했다. 아래 ‘이번 반영’ 중 경매 재배치 설명은 과거 시도 기록이며 현재 구현이나 승인된 설계가 아니다. 접기 UX 금지와 도입 경로 조사 결과만 계속 유효하다. 외부 오픈소스 검토에서 도출한 후속 제안은 미적용 상태다.
## 무엇이 잘못됐는가
경매에서는 다른 팀의 잔여 포인트와 전체 명단, 현재 선수의 전적, 대기·유찰과 채팅을 반복해서 비교한다. 필수 판단 정보를 접으면 매번 열고 닫아야 하고, 선수 교체 시 전적이 다시 닫혀 맥락을 잃는다. 단순히 첫 화면의 높이를 줄이는 것은 이 흐름을 개선하지 않는다.
사용자가 첨부한 `▶ 선수 전적 보기`의 삼각형은 라이브러리 SVG가 아니다. `<details>` 안의 `<summary>`가 `display: list-item`으로 렌더링되면서 브라우저가 붙이는 기본 disclosure marker다. 기본 marker를 가리고 ChevronDown을 얹어도 동작은 같은 아코디언이다.
### 확인한 도입 경로
1. `3c60081ece6045c0f0cc241a5770b5bdd55a0dc7` (2026-07-13): `CompetitionSeriesHistory`의 시리즈 결과에 `<details>`가 도입됐다. 이번에 조사한 관련 파일들의 이력에서 확인한 이른 사용 사례다. 저장소 전체 최초라고 단정하지 않는다.
2. `38a89b53` (2026-11-10): `AuctionPage`의 전적 영역을 `<details><summary>선수 전적 보기</summary>`로 감싸고 `historyPlayerId` / `isHistoryOpen`으로 조회까지 차단했다. 입찰 기록도 같은 커밋에서 접는 구조로 바뀌었다. 해당 문구에 대한 `git log -S`와 실제 패치를 확인했다.
3. 같은 기존 설계 검토의 `03-design-system.md` P19가 Disclosure를 프리미티브로, C16이 4/8팀별 접기를 제안했다. C13/C21에도 세트 펼치기와 카드 확장 제안이 남아 있었다. 이 문서는 권장으로 재사용하지 않도록 정정했다.
4. 직전 경매 레이아웃 작업에서 팀 전체 명단과 경매 운영에도 접기 구조를 추가했다. 이는 이번 사용자 요구에 맞지 않아 제거했다.
Astryx `Card`/`Button`은 표면과 버튼을 제공하지만, 해당 삼각형과 열림 상태는 페이지에 직접 작성된 네이티브 HTML에서 발생했다. 따라서 라이브러리를 바꾸거나 아이콘만 지우는 것으로 해결되지 않는다.
## 레퍼런스를 어떻게 적용하는가
[메이플스토리 홈](https://maplestory.nexon.com/Home/Main)을 브라우저에서 열고 상단, 공지·로그인·업데이트, 아래 서비스 구획과 직업 구획을 확인했다. CSS 링크와 DOM의 computed style을 직접 읽었다. 참조한 스타일시트는 `frontCommon.css?v=2`, `index_renew.css?v=4`다.
| 실제 관찰 | LOLYMPUS에서 사용할 원리 |
| --- | --- |
| 공지·업데이트·로그인 정보가 나란히 노출되고 제목이 구획을 설명한다. | 제목과 내용이 항상 붙어 있는 독립 구역으로 나눈다. |
| `.commonTitle`은 22px, 본문 계열은 16px, 색은 `rgb(69,71,87)`이며 PretendardVariable을 사용한다. | 우리 글꼴은 유지하되 제목·본문·수치의 크기 역할을 명확하게 나눈다. 경매 제목 26px, 구역 18px, 선수명 20px, 수치 20–28px. |
| 공지의 `.notice`는 외곽 카드 테두리가 없고, 제목·본문·행 구분으로 구조를 드러낸다. | 반복 데이터는 카드 안에 카드를 겹치지 않고 정렬된 행과 얇은 구분선을 사용한다. |
| 히어로는 큰 둥근 이미지 면, 정보 목록은 차분한 표면이다. | 데이터 패널에 히어로 장식을 복제하지 않는다. 프로필·상태·실행 버튼만 필요한 만큼 강조한다. |
| ‘자세히 보기’와 공지의 +는 목적지가 있는 링크이며 본문을 접는 summary가 아니다. | 전체 분석은 명확한 상세 페이지 링크로 제공하고 현재 판단에 필요한 값은 이미 보여준다. |
| 슬라이드와 직업 분류는 범주/항목 전환이다. 홈 DOM에서 `<details>`는 0개였다. | 범주 선택과 내용 접기를 구분한다. 필터·세트/시즌 선택은 유지하고 핵심 데이터 접기는 사용하지 않는다. |
| 좁은 브라우저에서는 메이플 홈에 가로 스크롤이 생겼다. | 참조의 고정 너비를 그대로 복사하지 않고 우리 모바일은 단일 흐름으로 재배치한다. |
브라우저가 보여준 값을 기록했으며 사이트 전체가 아코디언을 사용하지 않는다고 주장하지 않는다. 외부 사이트의 이미지·CSS·브랜드를 제품에 복제하지 않았다.
## 사용자 흐름을 다시 정의한다
| 흐름 | 진입 시 보여야 할 정보 | 행동과 이동 | 이번 반영 |
| --- | --- | --- | --- |
| 홈 → 내전/멸망전 탐색 | 다음 일정, 모집/진행/완료, 정원, 결과 | 일정/대회 링크와 신청 버튼 | 현재 별도로 수정된 홈은 유지. 경매 변경을 공통 헤더나 홈에 덮어쓰지 않음. |
| 모집 → 신청/팀 편성 | 일정·규칙·참여자·현재 신청 상태 | 신청/취소, 팀 편성 시작 | 기존 권한·확인·서버 동작 유지. 정보 숨김을 도입하지 않음. |
| 경매 관전자 | 현재 선수·상태·전적, 전체 팀원·가격, 대기/유찰, 채팅 | 선수/경기 상세 링크, 구역 스크롤 | 4개 구역을 동시에 노출. 내전과 솔로 전적을 처음부터 렌더링. |
| 경매 팀장 | 관전자 정보 + 내 잔액·입찰 한도·보존액·현재가·남은 시간 | 금액 입력/증액 → 입찰 → 최고가/거절/마감 확인 | 기존 입찰 검증과 실시간 로직 유지. 조작과 타이머를 선수 영역 상단에 유지. |
| 경매 운영자 | 현재 단계와 다음 작업, 진행 기록 | 입찰 열기/낙찰/유찰/다음 선수, 취소·되돌리기 확인 | 다음 작업을 상단 운영 줄에 노출. 기록은 하단에 상시 표시. 위험한 실행의 확인창은 유지. |
| 대진 → 팀 경기 현황 | 라운드·대결·결과, 다음 상대, 모든 세트 코드 | 경기/팀으로 이동, 유효한 코드 복사 | 모바일 라운드, 이전 경기, 다른 세트 코드, 시리즈 세부 결과를 상시 표시. |
| 전적 → 경기 분석 | 날짜·대회 결과·각 세트 결과·분석 링크 | 검색/시즌/유형 필터 → 분석 페이지 → 원래 목록 복귀 | 내전별 세트를 펼침 없이 그리드에 표시. 시리즈 앵커와 backTo 유지. |
| 선수 → 개인 전적 | 티어 추이·전적·스코어보드·표본 | 시즌/큐/챔피언 필터, 분석 범주 전환, 다음 기록 조회 | 티어 그래프와 경기 상세를 기본 표시. 별도 펼침 버튼과 expanded state 제거. |
| 순위 → 선수 비교 | 순위·승률·KDA·GPM·킬관여·CS | 검색/정렬 → 선수 전적 | 상세 지표 토글 제거. 수치 열을 모두 유지하고 좁은 화면에서는 표 영역을 가로 스크롤. |
| 운영 → 대회/코드/과거 기록 관리 | 대상·현재 값·입력 형식·작업 영향 | 입력 → 검증 → 명시적 실행 → 결과/오류 확인 | 모바일 대회 관리, 코드 일괄 등록, 멤버 수집 기간 폼을 기본 표시. |
| 로그인/권한/빈 결과/오류 | 현재 문제, 복귀나 재시도 방법 | 로그인/다시 시도/다른 화면 | 이번 수정은 접기 제거와 경매 배치에 한정. 인증 프로토콜·권한·등록 쓰기 동작은 변경하지 않음. |
라우트 구성과 접기 관련 컴포넌트를 소스로 검토하고 주요 흐름별 노출 기준을 정리했다. 모든 인증/신청/운영 쓰기 흐름을 실제 서버에서 실행한 전수 E2E 감사는 아니다. 검증한 화면과 범위는 `design-qa.md`의 이번 항목에 구분한다.
## Primitive 계약
| 단위 | 기준 |
| --- | --- |
| Section / Heading | 제목과 내용이 기본 노출된다. 정적인 헤더에 손가락 커서·회전 화살표·open 상태 스타일을 두지 않는다. |
| Card / Panel | 비교 대상의 경계가 필요할 때만 외곽선을 쓴다. 내용량을 줄이기 위해 카드를 접지 않는다. |
| List / Table | 이름·역할·가격·상태의 열을 정렬한다. 긴 이름은 줄바꿈한다. 2차원 비교 표만 가로 스크롤을 허용한다. |
| Scroll region | 명확한 이름과 키보드 초점을 제공한다. 패널 안에 다시 접기나 중첩 스크롤을 추가하지 않는다. 모바일은 문서 흐름을 우선한다. |
| Link / Anchor | ‘내전 기록 전체’, ‘상세 분석’, ‘팀 현황’처럼 목적지를 드러낸다. 클릭 후 새 정보가 나타나는 접기 버튼과 혼용하지 않는다. |
| Button | 상태를 바꾸는 동사와 진행 중/실패 상태를 표시한다. 한 영역의 주 실행만 강하게 강조한다. |
| Tabs / Filter / Select | 큐·시즌·분석 종류 등 실제 범주 선택에 사용한다. 필수 정보를 감추기 위한 대용 아코디언으로 쓰지 않는다. |
| Pagination | 아직 조회하지 않은 다음 레코드를 불러오는 용도로 사용한다. 이미 표시한 본문을 다시 접지 않는다. |
| Dialog | 취소·삭제·공식 결과 변경 등의 확인이나 독립적인 입력 작업에 사용한다. 전적·명단을 읽기 위한 문으로 쓰지 않는다. |
| Tooltip | 보조 설명만 담는다. 가격·상태·선수 이름 같은 필수 정보의 유일한 표시 수단이 되지 않게 한다. |
| Badge / Icon | 상태·티어·포지션을 보조한다. 색 외에 텍스트도 제공한다. 삼각형/Chevron은 본문 확장의 신호로 사용하지 않는다. |
| Loading / Empty / Error | 로딩, 기록 없음, 조회 실패를 구분한다. 접힌 패널로 오류나 로딩을 감추지 않는다. |
`apps/web/eslint.config.js`는 JSX `<details>`와 `<summary>`를 금지한다. 커스텀 아코디언도 이 제품 규칙에 위배되며 코드 리뷰에서 확인한다. select/combobox 같은 선택 컨트롤의 정당한 접근성 속성을 무차별로 제거하지 않는다.
## 경매 배치 — 기존 계약 철회
앞서 제안한 4열 비율, 1720px에서 팀 카드 3열, 좁은 화면에서 팀 명단을 아래로 보내는 배치는 승인 기준으로 사용하지 않는다. ‘DOM에 정보가 있다’, ‘가로 넘침이 없다’, ‘큰 화면에 들어온다’만으로 경매 흐름이 적절하다고 판단한 것이 오류였다.
현재는 복구한 구형 배치가 기준선이다. 후속 설계는 현재 선수 확인 → 내 팀 구성·잔액과 상대 팀 비교 → 입찰 → 결과 확인 → 다음 선수의 실제 판단 순서를 먼저 검증해야 한다. 긴 대기 목록 때문에 유찰 제목이 사라지지 않는지, 8팀 비교가 현재 대상과 입찰 조작을 밀어내지 않는지 검증하기 전에는 새 배치 규격을 확정하지 않는다. 복구한 구형 배치의 1280px 팀 카드 협소 문제도 남아 있으며 복구를 사용성 개선 완료로 간주하지 않는다.
## 이번 변경 뒤의 설계 판단
경매 재배치는 철회했다. 경매 밖의 접기 제거 변경과 별도로 진행된 홈·공통 헤더 작업은 이번 경매 복구에서 변경하지 않았다. 새 배치는 적용하지 않았으며 외부 사례의 장점뿐 아니라 접기, 잘림, 아래로 밀리는 정보 등 가져오지 않을 패턴도 구분해 검토한다.
@@ -1,5 +1,7 @@
# 07. 심미성 중심의 UI 개선 검토
> 2026-11-11 갱신: 아래 내용은 당시 검토 기록이다. 경매의 접기·요약 중심 배치와 보조 영역을 아래로 미루는 제안은 현재 기준으로 사용하지 않는다. 후속 4열 재설계도 사용자가 거부하여 기존 경매 배치로 복구했다. [정보 상시 표시 설계](../specs/information-visible-ui.md)의 철회 공지를 우선 확인한다. 접기 금지 외의 새 경매 배치 계약은 아직 확정하지 않았다.
추천 방향은 **e스포츠 중계 화면의 선명한 위계와 차분한 데이터 패널**이다. 홈에는 다음 내전, 경매에는 현재 선수와 팀, 경기 분석에는 경기 요약과 흐름이 첫인상을 결정하도록 한다. LOLYMPUS의 각진 형태와 코랄은 살릴 만하다. 화면마다 가장 중요한 정보에만 강한 색·큰 글자·뚜렷한 표면을 주고, 주변 요소의 테두리와 채도를 낮추면 제품의 인상이 선명해진다.
로컬 스테이징에서 홈, 경매, 시리즈 일정, 경기 분석, 커뮤니티 전적을 다시 캡처했다. 경매와 경기 분석은 라이트·다크를 비교했다. 경매에서 본 유찰과 전적 지표의 값은 레이아웃을 볼 수 있는 표본으로만 사용했다. 캡처의 회색 마스크는 로컬 개발 인증 패널이 있던 영역이다.
@@ -0,0 +1,228 @@
# 경매 중 선수 상세 전적 UX 검토
검토일: 2026-11-11 (Asia/Seoul). 범위: 경매의 프로필 진입점, 상세 조회 흐름, 컴포넌트 구성, 전적 정보 배치. 상태: **설계 제안 — 제품 코드 구현 전**.
경매 화면 안에서 상세 전적을 확인하는 방향을 권한다. 넓은 화면의 기본 형태는 **경매 조작을 유지하는 비모달 선수 상세 패널**이고, 좁은 화면은 **현재 경매 상태와 복귀 버튼을 고정한 전체 화면 시트**가 적합하다. 프로필 클릭의 목적은 현재 입찰 판단에 필요한 정보를 잠깐 확인하는 것이다. 전적 조회를 독립적인 페이지 이동으로 처리하면 판단에 필요한 경매 맥락이 사라진다.
이는 관찰한 화면·코드와 비교 프로젝트에서 도출한 설계 판단이다. 실제 팀장의 입찰 성공률이나 조회 시간을 측정한 사용자 실험 결과는 아니다.
## 1. 관찰한 현재 흐름
사용자가 제공한 화면과 현재 실행 중인 로컬 앱을 확인했다. 아래 화면은 이번 검토에서 직접 캡처하고 저장된 파일을 다시 열어 확인했다. 입찰, 다음 선수, 취소, 되돌리기, 전적 갱신 등 데이터 변경 동작은 실행하지 않았다.
1. **경매 화면**: 대기·유찰 명단, 팀 카드, 현재 선수의 간략 전적, 채팅이 함께 있다. 정보의 종류를 구분하는 현재 구조는 유용하다. 다만 약 1265px 폭의 이번 캡처에서는 팀 카드가 심하게 좁아진다. 패널 추가 시 기존 네 열을 그대로 압축하면 문제가 커진다.
![01 경매 화면](F:/source/lolympus-tournament-support/docs/ux-audit-2026-11-11-auction-inspector/evidence/01-auction.png)
2. **대기 선수 프로필 클릭**: `/users/:userId/history`로 이동하고 상단 활성 메뉴가 ‘전적’으로 바뀐다. 경매·채팅·입찰 상태가 화면에서 사라진다. 기본 선택은 ‘소환사의 협곡 / 전체’여서 경매에서 보던 내전 맥락도 이어지지 않는다.
![02 프로필 클릭 후 전적 페이지](F:/source/lolympus-tournament-support/docs/ux-audit-2026-11-11-auction-inspector/evidence/02-history-navigation.png)
3. **내전 탭 선택 후 상세 확인**: 스코어보드, 라인전, 룬/빌드 등 재사용할 만한 정보가 이미 있다. 하지만 현재 `RecentMatchCard`는 상세를 항상 렌더링한다. 넓은 페이지용 경기 카드 전체를 좁은 패널에 넣으면 한 경기가 대부분의 높이를 차지한다.
![03 내전 스코어보드](F:/source/lolympus-tournament-support/docs/ux-audit-2026-11-11-auction-inspector/evidence/03-internal-match-detail.png)
4. **‘이전 화면’으로 복귀**: 경매 연결 중 메시지를 거쳐 경매 화면으로 돌아왔다. 복귀 경로는 제공되지만, 경매를 계속 보면서 전적을 읽는 흐름은 아니다.
![04 경매 복귀](F:/source/lolympus-tournament-support/docs/ux-audit-2026-11-11-auction-inspector/evidence/04-auction-return.png)
### 코드에서 확인한 근거
| 위치 | 확인한 동작 | 설계에 미치는 영향 |
| --- | --- | --- |
| [AuctionPage.tsx:921](F:/source/lolympus-tournament-support/apps/web/src/pages/AuctionPage.tsx:921), 938 부근 | 빈 기록 CTA와 ‘자세히’는 `queueGroup=internal`을 붙인 전적 링크 | 빈 상태를 포함해 동일한 상세 진입 규칙 적용 |
| [AuctionPage.tsx:1140](F:/source/lolympus-tournament-support/apps/web/src/pages/AuctionPage.tsx:1140), 1176 부근 | 팀장·팀원은 기본 전적 페이지로 이동 | 소유 팀에 관계없이 같은 조회 패널 사용 |
| [AuctionPage.tsx:1351](F:/source/lolympus-tournament-support/apps/web/src/pages/AuctionPage.tsx:1351), 1364 부근 | 현재 선수 이미지·이름도 기본 전적 페이지로 이동 | 선택 중인 내전/솔로랭크 맥락 전달 |
| [AuctionPage.tsx:2801](F:/source/lolympus-tournament-support/apps/web/src/pages/AuctionPage.tsx:2801) | `PoolListItem` 전체가 전적 링크 | 대기·유찰 목록 모두 동일한 패널 진입점 |
| [useAuctionSocket.ts:674](F:/source/lolympus-tournament-support/apps/web/src/api/useAuctionSocket.ts:674) | effect cleanup에서 리스너 제거 및 socket disconnect | 상세 열기·닫기로 경매 페이지를 unmount하지 않기 |
| [UserHistoryPage.tsx:1050](F:/source/lolympus-tournament-support/apps/web/src/pages/UserHistoryPage.tsx:1050) | route params/search params에 연결된 페이지. 기본 큐는 `summoners-rift`, rank는 `all` | 페이지를 통째로 삽입하기보다 콘텐츠와 route 상태 분리 |
| [UserHistoryPage.tsx:910](F:/source/lolympus-tournament-support/apps/web/src/pages/UserHistoryPage.tsx:910) | 경기별 스코어보드가 항상 표시됨 | 패널 전용 요약 행과 펼치기 필요 |
### 우선 해결할 문제
- **높음 — 실시간 작업 맥락 단절**: 선수 조회 중 현재 가격·남은 시간·다른 팀 상황을 볼 수 없다. 코드상 연결 수명도 경매 페이지에 묶여 있다. 서버 경매가 멈춘다는 뜻은 아니다.
- **높음 — 진입점별 기본 전적 불일치**: 프로필은 협곡 전체, ‘자세히’는 내전이다. 동일한 선수 확인 의도에 다른 초기 화면이 열린다.
- **중간 — 기록 없음과 0%의 혼동**: 첨부 화면과 01에서 0게임을 승률 0%, KDA 0으로 표시한다. 기록 부재가 낮은 실력으로 해석될 수 있다. ‘내전 기록 없음’과 수치 `—`가 적절하다.
- **중간 — 좁은 화면의 폭 부족**: 01의 팀 카드 압축이 관찰됐다. 상세 패널은 남은 경매 영역의 최소 폭과 함께 설계해야 한다.
- **중간 — 전적 상세의 과도한 초기 밀도**: 03 및 코드에서 확인한 전체 펼침을 그대로 가져오면 선수 여러 명을 빠르게 살피기 어렵다.
- **접근성 확인 사항**: 현재 선수 이미지 링크는 코드에 별도 접근 가능한 이름이 없고 이미지 alt도 비어 있다. 단일 프로필 버튼으로 묶거나 ‘OOO 상세 전적 보기’ 이름을 제공해야 한다. 새 패널의 포커스·키보드 동작은 아래 기준으로 별도 검증한다.
## 2. 확인한 오픈소스 12개
앱 5개와 컴포넌트 프로젝트 7개를 별도로 확인했다. 앱 소스·공식 프로젝트 문서와 컴포넌트의 공식 API/예제를 근거로 삼았다. 12개 앱을 모두 설치하거나 로그인해 실제 사용자 흐름 전체를 테스트했다는 의미는 아니다. 같은 프로젝트의 Sheet와 Drawer는 한 개로 계산했다.
| # | 프로젝트와 확인한 원문 | 실제 확인한 패턴 | LOLYMPUS에 적용할 판단 |
| --- | --- | --- | --- |
| 1 | [Plane — IssueView 소스](https://github.com/makeplane/plane/blob/ea63ca8ab6f2c887c70ebbf166b78783600cf14e/apps/web/components/issues/peek-overview/view.tsx) | 기본 `side-peek`, modal/full-screen 변형, Escape와 원래 항목으로 포커스 복귀 | 목록에서 상세를 연속 탐색하고 닫으면 같은 위치로 복귀. 여러 표시 모드를 사용자 설정으로 전부 노출할 필요는 없음 |
| 2 | [Twenty — Layout 공식 문서](https://github.com/twentyhq/twenty/blob/main/packages/twenty-docs/getting-started/core-concepts/layout.mdx) | 레코드 클릭 시 오른쪽 패널, 명시적인 Open으로 전체 레코드 이동 | 프로필 클릭은 빠른 조회, ‘전체 전적 새 탭’은 별도 행동으로 구분 |
| 3 | [Supabase Studio — RowEditor 소스](https://github.com/supabase/supabase/blob/5c8a7caf779fdecbfc2d5643038489558d41b68f/apps/studio/components/interfaces/TableGridEditor/SidePanelEditor/RowEditor/RowEditor.tsx) | 공통 SidePanel에 header/content/customFooter를 합성 | 패널 껍데기와 전적 콘텐츠 분리. 데이터 편집용 중첩 패널 구조까지 가져올 필요는 없음 |
| 4 | [OpenDota — 경기 목록 컬럼 소스](https://github.com/odota/web/blob/82ddb5c328851be387eab27055526a10518906ec/src/components/Player/Pages/Matches/playerMatchesColumns.tsx), [목록 소스](https://github.com/odota/web/blob/82ddb5c328851be387eab27055526a10518906ec/src/components/Player/Pages/Matches/Matches.tsx) | 영웅·결과·모드·시간·K/D/A·아이템 컬럼 및 페이지 단위 조회 | 비교하기 쉬운 일정한 경기 행 사용. PC용 전체 표의 컬럼 수를 그대로 복제하지 않음 |
| 5 | [Lichess — UserShow.mini 소스](https://github.com/lichess-org/lila/blob/6d22d7c76aeb88b1b5c07773a8eda87a35c12c7d/modules/user/src/main/ui/UserShow.scala) | 작은 사용자 표현에 이름·레이팅·경기 수·관련 동작 제공 | 선수 식별과 규모를 먼저 제시. 상세 전적의 유일한 진입 수단을 hover로 만들지는 않음 |
| 6 | [Radix Primitives — Dialog](https://www.radix-ui.com/primitives/docs/components/dialog) | modal/non-modal 구분, Title/Description, Escape, 포커스 관련 제어 | 비모달 패널과 모바일 모달의 접근성 의미를 분리 |
| 7 | [Base UI — Drawer](https://base-ui.com/react/components/drawer#non-modal) | `modal={false}`와 `disablePointerDismissal`, detached trigger | 다른 선수 클릭 시 같은 패널 교체. 경매 영역을 클릭했다는 이유로 패널이 닫히지 않게 설계 |
| 8 | [React Aria — Modal](https://react-aria.adobe.com/Modal) | 외부 조작 차단을 명시한 모달, Dialog 합성, visual viewport 지원 | 좁은 화면에서는 명확한 모달로 처리하고 내부에 현재 경매 상태와 복귀 버튼 제공 |
| 9 | [Mantine — Drawer](https://mantine.dev/core/drawer/) | 위치·스크롤·초기 포커스·닫힌 뒤 포커스 복귀 설정 | 긴 전적의 본문 스크롤과 고정 헤더 분리. 배경을 흐리지 않는 것만으로 비모달이 되지는 않음 |
| 10 | [Ant Design — Drawer](https://ant.design/components/drawer/) | 목록 객체 미리보기, 헤더 추가 동작, resize 및 mask/focus 옵션 | 전적을 경매의 보조 작업으로 취급. 재조절 핸들과 중첩 Drawer는 첫 버전에 불필요 |
| 11 | [Headless UI — Dialog](https://headlessui.com/react/dialog) | 외부를 inert로 만들고 내부에 포커스 제한 | 기본 Dialog를 데스크톱 상세에 적용하면 입찰도 차단됨. 모바일처럼 의도적으로 차단할 때 참고 |
| 12 | [shadcn/ui — Sheet](https://ui.shadcn.com/docs/components/base/sheet), [Drawer](https://ui.shadcn.com/docs/components/base/drawer) | header/body/footer 합성, 방향 설정, 현재 Base UI 기반 Drawer 안내 | 패널 해부 구조 참고. 기존 디자인 시스템에 새 UI 키트를 통째로 더할 이유는 없음 |
공개 저장소의 라이선스도 확인했다. Plane/Lichess는 AGPL 계열, OpenDota와 Radix/Base UI/Mantine/Ant Design/Headless UI/shadcn은 MIT, Supabase와 React Spectrum/Aria는 Apache-2.0으로 표시된다. Twenty는 [라이선스 원문](https://github.com/twentyhq/twenty/blob/main/LICENSE)에 AGPL 본체·일부 MIT 패키지·별도 Enterprise 파일을 구분한다. 이 검토는 UX 패턴을 비교한 것이며 다른 프로젝트 코드를 복사하지 않았다.
비교에서 얻은 핵심은 **목록을 유지하는 상세 조회**, **짧은 첫 화면**, **필요한 정보의 단계적 확장**, **명시적인 전체 페이지 진입**이다. 이 패턴을 실시간 경매에 적용할 때는 현재 입찰 대상을 계속 식별할 수 있어야 한다.
## 3. 표시 방식 결정
| 방식 | 장점 | 경매에서의 제약 | 판단 |
| --- | --- | --- | --- |
| 같은 탭의 전적 페이지 | 넓은 공간, 기존 페이지 재사용 | 경매가 사라지고 복귀·재연결 필요 | 기본 동작에서 제외 |
| 새 탭만 사용 | 원래 경매 유지 | 탭 전환을 반복해야 하며 경매를 동시에 보기 어려움 | 보조 행동으로 제공 |
| 중앙 모달 | 같은 route에서 열고 닫기 쉬움 | 포커스와 배경 조작 차단, 입찰 화면 가림 | 좁은 화면 대안 |
| 툴팁/Popover | 빠른 간략 조회 | 경기 목록·필터·표를 담기에는 작음 | 짧은 정보에 한정 |
| 비모달 측면 패널 | 경매와 전적을 함께 읽고 조작 | 폭을 확보하는 레이아웃 작업 필요 | 넓은 화면 기본안 |
### 넓은 화면
- 상세 영역은 **560–640px를 초기 설계값**으로 삼는다. 경매 작업 영역이 최소 약 760px 확보되는 경우에만 나란히 표시한다. 간격·좌우 여백을 합쳐 대략 1440px 전후가 분기 후보이며 실제 렌더링 검증으로 확정한다.
- 현재의 네 열 위에 다섯 번째 열을 추가하지 않는다. 패널을 열면 왼쪽을 경매 작업 영역으로 재배치한다. 위쪽에는 현재 경매 선수·입찰가·남은 시간·입찰 조작을 계속 표시하고, 그 아래에 선수 목록과 팀 구성을 둔다.
- 현재 카드의 긴 전적 부분은 상세 패널과 중복되지 않게 접을 수 있다. **현재 선수의 식별·입찰 조작 부분까지 상세 조회 대상으로 바꾸면 안 된다.**
- 채팅은 작업 영역의 접이식 영역으로 옮길 수 있다. 작성 초안·메시지 수신을 유지하고 접힌 동안 새 메시지 수를 표시한다. 채팅을 핵심 제어 위에 겹치게 하지 않는다.
- 상세 본문만 독립 스크롤한다. 경매 타이머·입찰 입력은 상세 스크롤에 따라 사라지지 않는다.
- 패널 외부 클릭으로 닫지 않는다. 팀·목록·입찰을 계속 클릭할 수 있어야 한다. 닫기 버튼과 Escape로 닫는다.
### 좁은 화면·모바일
- 반쯤 열린 작은 바텀시트보다 전적을 읽을 수 있는 전체 화면 시트를 권한다. 헤더에는 조회 선수, 하단에는 현재 경매 선수·금액·시간과 ‘경매로 돌아가기’를 고정한다.
- 이 상태에서는 배경을 실제 모달로 처리한다. 배경의 입찰 버튼을 보이지 않는 상태로 조작하게 만들지 않는다. 입찰하려면 복귀 버튼 한 번으로 원래 입력 상태로 돌아온다.
- 경매 연결과 상태 갱신은 계속 유지한다. 다른 선수로 경매가 넘어가면 고정 상태 영역에서 알려 주되 읽던 선수 전적을 자동으로 바꾸지 않는다.
- 이 방식은 같은 화면에서 이탈 없이 복귀할 수 있지만, 작은 화면에서 상세 조회와 입찰을 동시에 수행하는 제약 자체를 없애지는 못한다.
## 4. 제안하는 flow
```mermaid
flowchart LR
A[경매 화면] -->|선수 이름·이미지·전적 상세| B[같은 경매 안에서 선수 상세 열기]
B --> C[내전 기본 · 현재 탭 맥락 유지]
C --> D[요약과 주력 챔피언 확인]
D --> E[최근 경기 행 펼치기]
E --> F[스코어보드 · 라인전 · 룬과 빌드]
B -->|다른 선수 선택| B
B -->|닫기 · Escape · 뒤로가기| A
B -->|명시적 전체 전적 새 탭| G[독립 전적 페이지]
```
1. 대기/유찰 목록, 팀장/팀원, 현재 선수의 이름·이미지·‘전적 상세’를 동일한 진입 함수로 연결한다. 최초 기본은 내전이다. 현재 선수 카드의 솔로랭크 탭에서 열면 솔로랭크를 전달한다.
2. 선택한 선수의 식별 정보와 패널 틀을 즉시 표시하고, 데이터 영역에 로딩 상태를 표시한다. 이전 선수의 숫자를 새 이름 아래 잠깐 표시하지 않는다.
3. 다른 선수 클릭은 패널 한 개의 대상을 바꾼다. 패널을 중첩하지 않는다. 내전/솔로랭크와 시즌 선택은 유지하되 선수 고유 챔피언 필터·펼친 경기·본문 스크롤은 초기화한다.
4. 같은 선수를 다시 열 때는 해당 세션의 필터·스크롤을 복원한다. 패널 내부의 ‘이전 조회 선수’는 최근 조회 순서를 뜻하며 경매 순서를 조작하지 않는다. 이 탐색 기능은 후속 단계여도 된다.
5. 경기 행의 펼치기 버튼으로 같은 패널 안에서 상세를 확인한다. 기본은 모두 접힘이고 첫 버전은 동시에 한 경기만 펼친다. 접을 때 해당 행의 위치를 유지한다.
6. 닫기/Escape/브라우저 뒤로가기로 경매에 복귀한다. 원래 진입점으로 포커스를 돌려주고, 그 선수가 명단에서 없어졌다면 명단 제목 등 안정적인 지점으로 이동한다.
7. ‘전체 전적 새 탭’은 사용자가 명시적으로 선택하는 링크로 제공한다. 현재 큐와 시즌을 전달한다. 일반 프로필 클릭으로 새 탭이 자동으로 쌓이게 하지는 않는다.
### 실시간 경매와 조회 대상의 구분
- `currentAuctionPlayerId`와 `inspectedUserId`는 별도 상태다. A를 읽는 중 B 경매가 시작돼도 상세는 A를 유지한다.
- 경매 제어에는 항상 **‘현재 경매: B’**, 패널 헤더에는 **‘조회 중: A’**를 표시한다. 색상만으로 둘을 구분하지 않는다.
- 패널에는 입찰 버튼을 복제하지 않는다. 입찰 대상과 명령 처리는 기존 경매 제어가 소유한다.
- 라운드 변경은 ‘B 선수 경매가 시작됐습니다 · 현재 선수 보기’와 같은 알림으로 전달한다. 자동 패널 교체나 자동 스크롤은 하지 않는다.
- 소켓 재연결 중에는 전적 캐시를 계속 읽을 수 있다. 입찰 가능 여부는 기존 경매 연결·권한 조건을 그대로 따른다.
### URL과 뒤로가기
경매 route를 유지하고 `inspectUser`, `inspectQueue`처럼 전적 전용 파라미터를 둔다. 기존 경매 쿼리는 보존한다. 처음 열 때만 history entry를 추가하고 선수·필터 변경은 replace하여, 뒤로가기 한 번이 패널 닫기로 작동하게 한다. 직접 들어온 상세 URL은 이전 페이지로 무조건 이동시키지 말고 inspector 파라미터만 지운다. 새로고침 후에도 동일 선수를 열 수 있게 하되 경매 종료/접근 불가 처리는 기존 route 정책을 따른다.
## 5. 상세 전적 레이아웃
첫 화면에서 답해야 할 질문은 ‘누구인가’, ‘우리 팀에 맞는 포지션인가’, ‘최근 내전에서 어떤가’, ‘어떤 챔피언을 하는가’다. 상세 분석은 그 아래에 둔다.
| 순서 | 영역 / 구성 | 표시와 행동 |
| --- | --- | --- |
| 고정 상단 | 선수 식별 | 아이콘, 닉네임#태그, 현재/최고 솔로 티어, 신청 주·부 포지션, 대기/유찰/소속 팀, 닫기, 전체 전적 새 탭 |
| 고정 탭 | `내전 / 솔로랭크` | 경매에서 필요한 두 모드를 우선 노출. ARAM/URF/아레나는 전체 전적 페이지에서 탐색 |
| 본문 시작 | 범위와 최신성 | ‘이번 시즌 · 최근 실제 N경기’, 시즌 선택, 저장/갱신 시각. 요약과 챔피언 통계의 서로 다른 집계 범위를 각각 표기 |
| 요약 | 승패·승률 / KDA / 실플레이 포지션 | 3개 묶음. KDA 아래 평균 K/D/A. 신청 포지션과 실제 플레이 비율을 다른 라벨로 구분 |
| 챔피언 | 상위 3개 간결한 행 | 아이콘+이름, 경기 수, 승률, KDA. 클릭하면 그 챔피언 경기로 필터, 선택된 필터와 해제 버튼 표시 |
| 목록 | 최근 경기 10개와 더 보기 | 결과, 챔피언, 포지션, K/D/A, 시간·날짜를 고정된 순서로 배치. 화면 높이에 따라 처음 약 3–5행이 보이도록 조정 |
| 펼친 경기 | 해당 경기의 상세 | 스코어보드 기본, 필요 시 라인전·룬/빌드. 선수를 강조하고 상대 포지션을 빠르게 비교 |
| 좁은 화면 고정 하단 | 현재 경매 상태 | 현재 입찰 대상·최고가·남은 시간·경매 복귀 버튼. 조회 대상의 낙찰 동작처럼 보이지 않게 분리 |
### 경기 행
주 행은 `승/패/다시하기 → 챔피언·포지션 → K/D/A → 경기 시각·길이 → 펼치기` 순서다. 보조 행에는 킬 관여·CS/분·시야처럼 비교에 필요한 작은 수치를 둘 수 있다. 아이템 전체·룬·팀원 열 명은 펼친 영역에서 확인한다. 승패는 문구와 시각 표시를 함께 쓰고 색만으로 구분하지 않는다.
폭 560–640px의 상세에서는 넓은 페이지용 스코어보드의 모든 열을 유지하지 않는다. 기본 열은 선수/챔피언, KDA, 피해량, CS이고, 아이템·룬·세부 와드는 행 아래 또는 별도 분석 탭으로 내려 보낸다. 두 팀은 세로로 배치하고 조회 선수를 표시한다. 넓은 상세 탐색이 필요하면 전체 전적 새 탭을 사용한다.
### 데이터 의미와 빈 상태
- **기록 0건**: 승률/KDA는 `—`, ‘이번 시즌 저장된 내전 기록이 없습니다’, ‘솔로랭크 보기’ 제공. 0%로 표시하지 않는다.
- **적은 표본**: ‘최근 3경기’처럼 실제 경기 수를 표시한다. 3경기 승률과 수십 경기 승률을 같은 확신으로 보이게 하지 않는다. 표본이 적다고 임의 실력 등급을 만들지 않는다.
- **필터 결과 0건**: 전체 기록 없음과 구분하고 ‘필터 해제’를 제공한다.
- **조회 실패**: 오류와 ‘다시 시도’를 패널 안에 표시한다. 실패를 기록 없음으로 변환하지 않는다.
- **갱신 중/이전 데이터 존재**: 같은 선수의 기존 값을 유지하고 갱신 중임을 알린다. 첫 로딩과 구분한다. 선수 변경 시 이전 선수 데이터는 유지하지 않는다.
- **티어/내전 데이터 범위**: 현재·최고 티어는 솔로랭크 정보라는 점을 명확히 하고 내전 승률과 같은 집계로 보이지 않게 한다. 확인 가능한 최고 티어의 기간을 함께 설명한다.
- **라인전 분석 미수집**: 스코어보드는 제공하고 ‘분석 데이터 없음’을 해당 탭 안에 표시한다. 전체 경기 카드가 오류로 바뀌지 않게 한다.
- **내전 갱신과 Riot 갱신**: 내부 기록 재조회와 솔로랭크 갱신 요청의 차이를 유지한다. 패널을 열었다는 이유로 외부 수집을 자동 요청하지 않는다.
## 6. 컴포넌트와 기존 코드 활용
현재 설치된 `@astryxdesign/core@0.7.11`의 [Drawer 소스](F:/source/lolympus-tournament-support/apps/web/node_modules/@astryxdesign/core/src/Drawer/Drawer.tsx:300)에서 `isOpen`, `onOpenChange`, `width`, `label`, `hasScrim`, `purpose`를 확인했다. `hasScrim={false}`는 비모달 popover를 사용하며 외부 조작을 허용한다. 기본값인 `true`는 모달로 처리한다. [Dialog](F:/source/lolympus-tournament-support/apps/web/node_modules/@astryxdesign/core/src/Dialog/Dialog.tsx:126)는 fullscreen 변형을 제공한다.
**우선 Astryx와 기존 색·여백·타입·아이콘을 사용한다.** 비교한 7개 컴포넌트 라이브러리를 설치하자는 제안이 아니다. Astryx Drawer 자체는 화면 위에 겹치는 방식이며 경매 영역의 폭을 자동 확보하지 않는다. 페이지 레이아웃에서 패널 너비를 예약하거나, 넓은 화면은 일반 aside와 공통 본문을 조합해야 한다. 배경을 조작할 수 있는 것과 입찰 버튼이 가려지지 않는 것은 별개의 조건이다.
| 제안 컴포넌트 | 책임 | 기존 코드와 연결 |
| --- | --- | --- |
| `AuctionPlayerHistoryTrigger` | 선수 클릭 의미, 접근 가능한 이름, 진입 큐 전달 | PoolListItem, TeamPanel, PlayerProfileDetails의 진입점 통합 |
| `AuctionPlayerHistoryController` | 조회 대상, open/close, URL, 포커스 복귀 | AuctionPage 수명 안에서 유지; 소켓이나 입찰 명령을 소유하지 않음 |
| `PlayerHistorySurface` | 비모달/전체 화면 전환, 고정 헤더·본문 스크롤 | Astryx Drawer/Dialog 또는 docked aside |
| `PlayerHistoryContent` | 선수·큐·필터에 따른 조회와 렌더링 | standalone 페이지와 패널이 공유할 route 비의존 본문 |
| `PlayerIdentityHeader` | 선수 식별·티어·포지션·소속 | 기존 avatar/rank/position 표현 재사용 |
| `HistorySummary` / `ChampionPoolSummary` | 집계 범위·표본 수·주력 챔피언 | 기존 내전 응답과 요약 표시 재사용 |
| `CompactMatchRow` / `MatchDetailContent` | 접힌 경기, 펼친 상세, 지연 로딩 | RecentMatchCard의 데이터 표시와 MatchDetailTabs를 분리 |
| `AuctionContextBar` | 좁은 화면의 현재 경매 상태·복귀 | 동일 소켓 상태를 읽기 전용으로 표시 |
기존 [useUserInternalHistory](F:/source/lolympus-tournament-support/apps/web/src/api/hooks.ts:837)는 선수·커뮤니티·시즌·챔피언·포지션별 캐시 키와 10개 단위 더 보기를 제공한다. 응답에 `summary`, `championStats`, `matches`, `nextCursor`, `lastFetchedAt`이 있으므로 기본 상세 조회를 위해 새 집계 API가 필요하다는 근거는 없다. 솔로랭크는 기존 profile/summary/recentMatches/championStats 조회를 활성 탭에서만 사용한다. 추가 지표는 API가 실제 제공하는지 확인하고 포함한다.
기존 페이지 안의 하위 컴포넌트는 바로 import 가능한 공용 컴포넌트가 아니다. 추출 후 독립 페이지의 출력이 유지되는지 확인해야 한다. `UserHistoryPage`를 iframe으로 삽입하거나 route params를 속여 렌더링하는 방법은 사용하지 않는다.
### 데이터와 성능 원칙
- 경매 소켓·카운트다운·입찰 입력·채팅 초안은 패널을 열고 닫아도 유지한다.
- 기존 React Query 캐시 키를 공용으로 사용한다. 동일 데이터를 위한 별도 패널 전용 캐시를 만들지 않는다.
- 닫힌 패널은 불필요한 전적 조회를 시작하지 않는다. 펼치지 않은 경기의 분석 데이터를 미리 모두 가져오지 않는다.
- 필요한 경우 프로필에 포커스가 머물 때 제한된 prefetch를 검토한다. 전체 대기 선수의 모든 경기 자동 수집은 하지 않는다.
- 경매 초 단위 갱신 때문에 전적 표 전체가 다시 그려지지 않도록 상태 구독 범위를 나눈다.
- 빠르게 A→B를 조회했을 때 A의 늦은 응답이 B의 화면에 표시되지 않게 선수 ID 기반으로 데이터를 연결한다.
- API 실패/지연은 패널 내부에 한정한다. 경매의 연결 상태나 명령 처리 상태와 합치지 않는다.
## 7. 검증 기준과 구현 순서
### 첫 구현 범위
1. 일관된 프로필 진입점과 같은 경매 route의 상세 surface. 내전 기본, 솔로랭크 맥락 전달, 명시적 전체 전적 새 탭.
2. 식별·요약·상위 챔피언·최근 10경기·한 경기 펼치기. 0건/실패/갱신 중 구분.
3. 경매 영역 폭 확보와 모바일 전체 화면 시트. 현재 경매와 조회 선수 분리.
4. 포커스 복귀, 뒤로가기, 캐시 공유 및 경매 상태 유지 확인.
두 선수 동시 비교, 자유로운 패널 크기 조절, 상세 안의 다른 플레이어 연쇄 탐색, 개인 평가 메모 등은 기본 흐름이 검증된 뒤 검토한다.
### 필수 시나리오
- 대기/유찰/팀장/팀원/현재 프로필/자세히/빈 상태 CTA 각각에서 페이지 이탈 없이 올바른 선수가 열린다.
- A 전적 조회 중 B 라운드로 바뀌어도 조회 내용은 A이며 입찰 대상은 B로 명확히 표시된다.
- 패널 open/close/선수 교체가 경매 socket disconnect/reconnect를 유발하지 않는다.
- 닫은 뒤 입찰 입력·선택 역할·명단 탭·스크롤·채팅 초안이 유지된다.
- 넓은 화면에서 키보드와 포인터 모두 입찰 영역에 접근할 수 있다. 입찰 영역이 Drawer 뒤에 가려지지 않는다.
- 모바일은 모달 제목·포커스 제한·닫기·복귀가 작동한다. 닫힌 뒤 원래 항목 또는 안정적인 대체 위치로 포커스가 돌아온다.
- Escape는 현재 포커스가 있는 가장 안쪽 메뉴부터 닫는다. 채팅 등 다른 작업 영역에서 입력 중인 키를 상세 패널이 불필요하게 가로채지 않는다.
- 탭은 이름과 연결된 패널을 갖고, 경기 펼치기는 `aria-expanded`를 제공한다. 초 단위 타이머를 매초 live region으로 읽지 않는다.
- 0건·적은 표본·실패·재연결·늦은 응답·반복 open/close·브라우저 Back/Forward·직접 URL 진입을 확인한다.
- 1920/1440/1280/768/390px와 확대 화면에서 팀 이름·입찰·닫기·복귀가 잘리지 않는지 확인한다. 이는 앞으로 수행할 검증 기준이며 이번에 모두 테스트한 것은 아니다.
### 결과를 판단할 지표
상세를 열고 경매로 복귀하는 시간, 선수 여러 명을 연속 확인하는 데 걸리는 동작 수, 상세 조회 때문에 발생한 경매 route 이탈, 조회 중 경매 대상 오인 여부를 비교한다. 실제 팀장에게 ‘후보 두 명의 주력 챔피언을 확인하고 현재 입찰 대상으로 복귀’ 과제를 주는 것이 적절하다. 목표값은 기존 측정 없이 임의로 성과 수치로 제시하지 않는다.
## 8. 증거의 한계
실제 앱에서 재현한 것은 프로필 클릭 → 전적 이동 → 내전 상세 → 경매 복귀다. 관찰 당시 경매는 유찰 후 다음 선수를 기다리는 상태였으므로 활성 카운트다운 중의 입찰, 경쟁 입찰, 라운드 변경을 직접 발생시키지 않았다. 소켓 해제는 코드로 확인했고 재연결 화면은 복귀 과정에서 관찰했다. 경매 서버에서 이벤트가 유실되었다고 판정한 것은 아니다.
이번 제안의 반응형 수치와 정보 우선순위는 설계 가설이다. 새 패널의 키보드·스크린리더·모바일 터치·실시간 경합은 구현 후 검증해야 한다. 대비율 측정이나 전체 WCAG 준수 판정은 수행하지 않았다. 기존 작업 트리의 변경은 유지했고 이 검토에서는 문서와 화면 증거만 추가했다.
Binary file not shown.

After

Width:  |  Height:  |  Size: 352 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 62 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 55 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 103 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 61 KiB