Files

84 lines
12 KiB
Markdown
Raw Permalink 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.
# 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 팀 카드 협소 문제도 남아 있으며 복구를 사용성 개선 완료로 간주하지 않는다.
## 이번 변경 뒤의 설계 판단
경매 재배치는 철회했다. 경매 밖의 접기 제거 변경과 별도로 진행된 홈·공통 헤더 작업은 이번 경매 복구에서 변경하지 않았다. 새 배치는 적용하지 않았으며 외부 사례의 장점뿐 아니라 접기, 잘림, 아래로 밀리는 정보 등 가져오지 않을 패턴도 구분해 검토한다.