Files
joke-app/docs
EJClaw a81f73ef6d 사건 파일: 새 사건 10개(후보 30개 중 점수로 고름)로 사건 13개, 방 설정은 난이도별 고르기 상자 + 한 줄 소개
- 후보 30개와 점수표·고른 까닭(docs/games/case-file-candidates.md), 사건 쓰는 법(case-file-writing-guide.md).
  예스노 탐정·퀴즈 사립탐정·바다거북 수프에서 이상한 첫 장면, 퀴즈 한 방, 관점 바꾸기, 억지 금지(결정적 단서 두 겹)를 빌림
- 새 사건 c4~c13: 사진 속 그 문 앞 / 장날이 아닌 날 / 반짝이는 것만 사라진 집 (쉬움), 여름밤의 오리온 / 돌아온 두부 /
  웬지 익숙한 시 / 건반 하나가 빠진 녹턴 (보통), 눈 그친 뒤의 발자국 / 틀린 답을 맞힌 우승자 / 시계방에서 사라진 7분 (어려움)
- 사건마다 checks/<id>.ts(빠듯한 길·점검표)와 데이터에서 만든 설계 문서(case-file-cases/<id>.md, bun scripts/case-file-doc.ts).
  cases.test.ts가 새 사건 기준·빠듯한 길·문서 일치를 검사
- 정답 모르는 검토자 풀이(빠듯한 길만 / 전체)로 모순·다른 답·이른 노출을 찾아 고침
- CASE_IDS 13개, random은 13개 중 하나, 사건별 무작위 판 테스트, e2e에서 사건 고르기 상자 확인

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 13:29:09 +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.