feat: enhance auction interactions and player statistics UI
This commit is contained in:
1 parent
6c582ba3cf
commit
be4de61bb7
115 files changed
+13292
-2871
No files matched your search
@@ -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 팀 카드 협소 문제도 남아 있으며 복구를 사용성 개선 완료로 간주하지 않는다.
|
||||
|
||||
## 이번 변경 뒤의 설계 판단
|
||||
|
||||
경매 재배치는 철회했다. 경매 밖의 접기 제거 변경과 별도로 진행된 홈·공통 헤더 작업은 이번 경매 복구에서 변경하지 않았다. 새 배치는 적용하지 않았으며 외부 사례의 장점뿐 아니라 접기, 잘림, 아래로 밀리는 정보 등 가져오지 않을 패턴도 구분해 검토한다.
|
||||
Reference in new issue
Block a user