Files
joke-app/docs
EJClaw b81b4f60be 화면 정리: 한눈에 들어오게 (홈 게임 타일·종류 탭, 방 안 상단 막대 한 줄, 대기실·결과·설정 간소화)
"한 화면에 정보가 너무 많아 한눈에 들어오지 않는다" 피드백. NN/g 점진적 공개, 토스 "한 화면 한 가지",
BGA 화면 지침, Hick의 법칙을 참고해 docs/07 §1에 원칙 8번으로 정리하고 화면에 적용했다.

- 홈·게임 목록: 게임 카드를 아이콘·이름·"2명 · 5~15분" 타일로 줄이고(설명·난이도는 게임 소개에만),
  휴대폰 3열. [전체][판·주사위][카드·패][여럿이 파티] 탭. 휴대폰 홈 세로 길이 약 1/4.
  휴대폰에서 [방 만들기]는 한 줄, [코드로 참여]·[컴퓨터와 연습]은 나란히.
- 방 안: 사이트 상단 메뉴를 숨기고 방 막대 한 줄만(--site-h 변수, 방 안에서는 0).
- 대기실: 초대 카드는 빈자리가 있을 때만, 버튼은 [링크 복사][공유하기/초대글 복사] 두 개
  (QR은 빈자리 칸 "+ 빈자리 · 📷 QR로 초대"). PC 대기실의 규칙 전문 카드와 "바꾸면 바로 적용돼요" 제거.
  게스트 경고는 시작 버튼 아래 한 줄로.
- 채팅 빠른 반응은 한 줄(넘치면 옆으로).
- 결과 창: 진한 버튼은 [한 판 더] 하나, [판 보기][▶ 다시 보기]는 한 줄.
- 설정(/me): 항목 이름과 선택지를 한 줄에.
- E2E: 다시 보기 링크 이름, 컴퓨터 상대의 "게임 중 홈으로"는 앱 안 이동으로.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-09 00:16:10 +09:00
..

온라인 보드게임 사이트 계획서

광고 없이 가볍고, 링크 하나로 친구·가족과 바로 즐기는 한국형 온라인 보드게임 사이트. 구현은 이 문서들을 기준으로 하며, 결정이 바뀌면 문서를 먼저 고친다.

공통 문서

문서 내용
00-overview.md 목표, 원칙(안정성·실시간·쉬움·가벼움), 범위, 성공 기준
01-research.md BGA 분석, 한국 인기 보드게임 조사, UI/UX 조사, 출처
02-architecture.md 기술 선택, 전체 구조, 저장소 구조, 처리 흐름
03-realtime-protocol.md WebSocket 메시지, 순서 보장, 재접속, 타이머, 제한
04-stability-security.md 저장·복구, 장애 격리, 숨김 정보·공정성, 사행성·상표, 웹 보안
05-accounts-auth.md 게스트·디스코드 로그인, 닉네임, 세션, 계정 페이지
06-lobby-rooms.md 방 만들기/참여, 코드·링크·QR·공유, 대기실, 한 판 더
07-ui-ux.md 디자인 원칙, 색·글자 토큰, 화면 틀, 컴포넌트, 접근성, 성능 예산
08-data-model.md SQLite 스키마, 쓰기 시점, 정리, 개인정보
09-game-engine.md 게임 모듈 인터페이스, 결정적 난수, GameRunner, 공통 유틸, 공통 테스트
10-testing.md 테스트 종류, 핵심 시나리오, 부하 기준, 수동 점검표
11-deployment-ops.md Docker/Caddy 배포, 환경 변수, 백업, 감시, 결정 필요 항목
12-roadmap.md 마일스톤 M0~M9와 완료 기준
13-decisions.md 사용자 결정 항목(확정/대기)
14-admin.md 관리자 사이트: 권한(슈퍼어드민/어드민), 게임·사이트 설정, 사용자 관리, 기록

게임 문서

games/README.md — 전체 게임 목록, 우선순위, 제외 이유, 상표 표시 방침. 게임별 문서는 games/<id>.md, 형식은 games/_TEMPLATE.md.