Files
joke-app/docs/games/case-file.md
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

33 KiB
Raw Blame History

사건 파일 (case-file)

마일스톤: 2026-10 새 게임(직접 만든 게임) · 인원: 최소 1 ~ 최대 5명 · 예상 시간: 사건 하나 약 30~60분 · 난이도: 보통(사건마다 쉬움·보통·어려움)

1. 개요

  • 탐정 사무소 팀이 되어 사건 하나를 함께 푸는 협력 추리 게임. 정해진 날짜와 시간 안에서 어떤 단서를 따라갈지 고르고, 고른 단서의 글을 읽고, 마지막에 객관식 수사 보고서를 내서 점수를 받는다. 시간이 모자라 모든 단서를 볼 수는 없다. "무엇을 볼지 고르는 것"이 이 게임의 재미다.
  • 영감: 포털 게임즈의 『디텍티브: 모던 크라임 보드게임』(2018). 시간 예산 안에서 단서 카드를 고르고, 다른 장소로 가면 이동 시간이 들고, 데이터베이스 자료는 시간 없이 보고, 마지막에 문제를 풀어 점수를 받는 진행 방식만 빌렸다. 원작의 사건·인물·글·이름·용어(앤타레스 등)는 하나도 쓰지 않는다. 사건 13개는 모두 이 사이트를 위해 새로 지었다(사건 13은 case-file-cases.md, 413은 case-file-cases/<id>.md). 사건 4~13은 후보 30개 중 점수로 고른 10개다(case-file-candidates.md, 쓰는 법은 case-file-writing-guide.md).
  • 설정으로 켜는 규칙은 다른 추리 게임에서 빌렸다: 셜록 홈즈 컨설팅 디텍티브(적은 단서로 풀수록 높은 점수), 크로니클 오브 크라임(시간이 흐르며 들어오는 소식), 방탈출 게임 EXIT·언락(점수를 내고 쓰는 조언), 머더 미스터리 파티(한 사람만 읽고 말로 전하기). 7절.
  • 인원 근거: 원작이 1~5인. 혼자 해도 똑같이 재미있는 게임이라 1명부터. 6명 이상이면 고르는 차례가 너무 늦게 돌아온다.
  • 우리 사이트의 다른 추리 게임과 다른 점: 클루(clue)는 서로 겨루는 소거 추리, 마피아·라이어는 사람 속이기. 이 게임은 글을 읽고 함께 추리하는 이야기 게임이다.
  • 이름: 『사건 파일』. 다른 후보: 『수사 일지』, 『탐정 수첩』, 『골목 탐정단』.

2. 모드와 옵션

옵션 키 설명 선택지 기본값
caseId 사건 13개(쉬움 4 · 보통 5 · 어려움 4, 목록은 types.ts의 CASE_LIST) / random 아무거나. 방 설정에서는 난이도별로 묶은 고르기 상자, 고른 사건의 한 줄 소개를 아래에 보여 준다 c1
mode 함께 풀기 / 따로 겨루기 coop 함께 풀기(시간·단서 공유) / race 따로 겨루기(각자 수사, 점수 경쟁) coop
decision 다음 단서를 누가 고르나(함께 풀기) rotate 반장이 돌아가며 / vote 다 같이 투표 / free 아무나 먼저 누르기 rotate
timeBudget 하루 수사 시간 relaxed 넉넉하게(하루 10시간) / normal 보통(8시간) / tight 빠듯하게(6시간) normal
overtime 야근 on(하루 2시간까지 더, 1시간마다 피로 1 = −1점) / off on
magnifiers 돋보기(깊이 보기) 개수 0 / 2 / 3 / 5 3
hints 반장님 조언 쓸 수 있는 횟수(1번에 −2점) 0 / 1 / 3 3
timeBonus 남은 시간 보너스 on(남은 2시간마다 +1점, 최대 +5점) / off off
morningNews 아침 소식 on / off on
readMode 단서 글 읽기(함께 풀기, 2명 이상) all 모두 읽기 / reader 고른 사람만 읽고 말로 전하기 all
turnSeconds 다음 단서 고르기 제한 시간 60 / 120 / 180 / 300초 / 무제한 180
reportSeconds 보고서 쓰기 제한 시간 180 / 300 / 600초 / 무제한 600
raceMinutes 따로 겨루기 전체 제한 시간 30 / 45 / 60 / 90분 / 무제한 60
kidSafeChat 고운 말 필터 — 게임 옵션으로 두지 않음(아래 구현 메모). 방 채팅을 그대로 쓰므로 방 설정의 채팅 필터(chatFilter, 욕설 가리기)가 적용된다 – –
  • random은 서버 시드 난수로 세 사건 중 하나. 대기실에는 "어떤 사건인지 시작하면 알아요"로 보인다.
  • 혼자(1명)면 decision·readMode는 의미가 없어서 화면에서 감춘다. race에서는 decision·readMode·turnSeconds가 감춰지고 raceMinutes가 보인다(race가 아니면 raceMinutes를 감춤).
  • 모든 옵션에 .meta({ title, labels })를 붙인다(09 §2). 사건 제목은 옵션 라벨에만 들어간다(정답은 들어가지 않음).

구현 메모(2026-10-15, 첫 구현에서 정한 것)

  • 채팅: 게임 전용 채팅(ownChat)을 만들지 않고 방 채팅을 그대로 쓴다(PC 오른쪽, 휴대폰 [채팅] 버튼). 그래서 kidSafeChat 대신 방 설정의 채팅 필터가 적용되고, 따로 겨루기에서 채팅을 닫는 기능과 "낸 사람 채팅"은 나중에. 따로 겨루기에서는 화면에 "채팅으로 단서를 알려 주지 말아 주세요(방장이 방 설정에서 채팅을 끌 수 있어요)"를 띄운다.
  • 투표 수: 8.3대로 집계 전에는 누가 투표했는지만 보이고(9절의 "카드 위에 투표 수가 쌓인다"는 따르지 않음), 집계 뒤 "지난 투표" 결과(칸별 표 수)를 보여 준다. 투표는 집계 전까지 바꿀 수 있다.
  • 두 번 누르기: free뿐 아니라 반장·따로 겨루기에서도 단서 고르기·깊이 보기·조언·하루 마치기·보고서 쓰기는 [정말 이걸로 해요]로 한 번 더 확인한다(실수 방지). 투표는 한 번 누르기.
  • 반장 시간: 반장이 행동할 때마다(깊이 보기·조언·하루 마치기 포함) turnSeconds가 다시 시작된다.
  • 자동 하루 마치기: 그날 시간을 조금이라도 쓴 뒤(09:00 이후) 고를 수 있는 단서가 하나도 시간에 맞지 않으면 마친다. 09:00에 고를 단서가 없으면 자동으로 넘기지 않는다(돋보기·조언·보고서를 쓸 수 있게).
  • 마지막 날 [하루 마치기]: 남은 시간을 버리므로 남은 시간 보너스는 0.
  • 자리 비움: free에서 연결이 끊긴 채 유예가 지난 사람은 "자리 비움"이 되고 보고서 동의 인원에서 빠진다(다시 행동하면 풀림). 모두 자리 비움이면 보고서. vote에서 유예가 지난 사람은 그 판 "기권", 투표 마감이 지나면 낸 표만 센다. 따로 겨루기에서 유예가 지난 사람은 자기 수사를 마치고 보고서로(쓰는 중이면 고른 데까지 낸 것으로).
  • 관전자: 함께 풀기는 팀이 보는 것(모두 읽기면 본문 포함, 한 사람만 읽기면 제목만)을, 따로 겨루기는 진행 상황만 본다. 보고서 문제는 끝날 때까지 관전자에게 안 보인다.
  • 메모 저장 키: 보드가 방의 게임 번호를 모르므로 bg:case-file:note:<방 코드>:<게임 시작 시각>(★중요 표시는 star, 의심 정도는 suspect).
  • 팀 답 동점의 "마지막 결정권자": rotate는 보고서 순간의 반장, vote는 마지막으로 실행된 투표의 결정권자, free는 마지막으로 행동한 사람.
  • 결과 화면: 함께 풀기는 모두 같은 순위라 공용 결과 창 제목이 "무승부예요"로 나온다(공용 화면 문제, 요약 줄에 해결 여부가 나옴).
  • 빠듯한 길·근거 단서(10절): evidence는 풀이 괄호 속 단서 가운데, 점검표의 빠듯한 길 안에서 그 문제를 풀 수 있는 최소 묶음으로 정했다. 테스트는 길을 실제 엔진으로 따라가 범인 문제를 포함해 해결 기준 이상을 풀 수 있는지 본다(cases.test.ts).

3. 구성물

사건 데이터 파일(packages/games/src/case-file/cases/c1.ts …). 모양은 case-file-cases.md 0절. 사건마다:

  • 의뢰: 처음에 모두에게 보이는 사건 소개.
  • 구역·장소·이동표: 사무소 + 34개 구역. 같은 구역 안은 이동 0시간, 다른 구역은 12시간.
  • 단서 18~24개: 장소, 제목, 걸리는 시간(1 또는 2시간), 여는 조건, 본문, (일부) 깊이 보기 본문.
  • 자료실: 인물 카드(이름·나이·한 줄). 단서에서 처음 나오면 열리고, 읽는 데 시간이 들지 않는다(원작의 데이터베이스 역할).
  • 아침 소식: 둘째 날부터 아침마다 공짜로 들어오는 짧은 글.
  • 조언 3개(차례대로 더 구체적).
  • 보고서 문제 5~7개(객관식, 문제마다 점수, 첫 문제는 범인), 해결 기준·등급 점수, 풀이.
  • 토큰: 돋보기(옵션 개수), 조언(옵션 횟수). 그림은 이모지·CSS로 직접 그린다.

4. 준비(셋업)

  1. 사건을 정한다(random이면 RNG).
  2. coop: 팀 수사 하나를 만든다. race: 사람마다 수사를 하나씩 만든다(모두 같은 사건).
  3. 수사마다: 1일째 09:00, 위치 사무소, 돋보기·조언은 옵션 개수, 피로 0, 읽은 단서 없음. 처음부터 열린 단서(여는 조건이 빈 것)만 고를 수 있다.
  4. rotate면 첫 반장을 RNG로 뽑는다(그다음은 자리 순서). readMode: reader의 첫 읽는 사람도 반장과 같다.
  5. 의뢰 단계: 모두에게 의뢰 글을 보여 주고, 모두 [수사 시작]을 누르면(또는 60초 뒤) 수사를 시작한다.

5. 진행 규칙

5.1 시간

  • 하루는 09:00에 사무소에서 시작한다. 하루 수사 시간 H = 10·8·6시간(timeBudget). 하루 끝 = 09:00 + H.
  • 단서 하나를 따라가면 이동 시간 + 단서 시간만큼 시계가 간다. 이동 시간 = 지금 구역에서 단서 장소의 구역까지(같은 구역이면 0).
  • 하루 끝을 넘기는 단서는 overtime이 켜져 있을 때만 고를 수 있다. 하루 끝을 넘긴 1시간마다 피로 1(마지막에 −1점). 하루에 넘길 수 있는 시간은 2시간까지.
  • [하루 마치기]: 남은 시간을 버리고 다음 날 09:00 사무소로. 남은 시간이 없거나(야근을 다 썼거나, 야근이 꺼져 있고 남은 시간보다 짧은 단서가 없으면) 자동으로 하루를 마친다.
  • 마지막 날을 마치면 바로 보고서 단계로 간다.
  • 다음 날 아침 소식(morningNews)이 있으면 그날 아침 모두에게 공개한다(시간 안 듦).

5.2 단서 고르기

  • 고를 수 있는 단서 = 열렸고 아직 읽지 않은 단서. 열림: 여는 조건의 단서 중 하나라도 읽었거나, 깊이 보기로 열었으면.
  • 목록에는 단서마다 장소, 제목, "이동 n시간 + 단서 n시간 = 합계", 야근이 필요한지, 고를 수 있는지가 보인다. 본문은 읽기 전엔 서버 밖으로 나가지 않는다(8.3).
  • 단서를 고르면: 시계가 가고, 위치가 그 장소로 바뀌고, 본문이 열린다. 그 본문으로 새로 열리는 단서와 자료실 인물이 생긴다("새 단서 2개가 열렸어요").
  • 한 번 읽은 단서는 다시 고를 수 없다(수사 기록에서 언제든 다시 읽기는 공짜).

누가 고르나(decision, 함께 풀기)

  • rotate 반장이 돌아가며(기본): 지금 반장만 단서 고르기·깊이 보기·조언·하루 마치기·보고서 쓰기를 할 수 있다. 다른 사람은 단서에 추천 표시(누구나, 한 사람당 하나, 모두에게 보임)를 하고 채팅으로 의견을 낸다. 단서를 하나 읽으면 반장이 다음 사람으로 넘어간다(깊이 보기·조언은 안 넘어감).
  • vote 다 같이 투표: 모두가 투표 칸 하나를 고른다. 칸 = 고를 수 있는 단서들 + "돋보기: ○○" + "조언 듣기" + "하루 마치기" + "보고서 쓰기". 나간 사람을 뺀 모두가 투표하면 바로, 아니면 시간이 끝날 때 집계한다. 가장 많은 칸을 실행하고, 동점이면 이번 판의 결정권자(투표가 끝날 때마다 자리 순서로 돌아감)가 고른 칸, 그 사람이 동점 칸을 안 골랐으면 동점 칸 중 목록에서 위에 있는 것. 아무도 투표하지 않으면 아무 일도 하지 않는다(8.5).
  • free 아무나: 누구든 먼저 확정한 사람의 행동이 실행된다. 실수를 막으려고 모든 행동은 [고르기] → [정말 이걸로 해요] 두 번 누르기. 보고서 쓰기만은 모두 동의([보고서 쓰자]를 모두 누름)가 필요하다.

5.3 깊이 보기(돋보기)

  • 읽은 단서 중 깊이 보기가 있는 단서는 [🔍 깊이 보기]가 생긴다. 돋보기 1개를 쓰면 숨은 한 문단이 열린다(시간 안 듦). 읽고 나서 나중에 써도 된다.
  • 깊이 보기에는 정답에 도움이 되는 증거가 있지만, 정답에 꼭 필요하지는 않다(돋보기 0개 옵션으로도 모든 문제를 풀 수 있게 사건을 쓴다 — 데이터 검사 10절).
  • 깊이 보기가 있는 단서인지는 읽기 전에도 표시한다(🔍). 원작의 "더 깊이 파기"와 같은 고민(어디에 쓸까)을 준다.

5.4 조언

  • [반장님 조언 듣기]: 사건의 조언을 1번부터 차례대로 하나 공개한다. 쓸 때마다 −2점. hints 횟수까지(사건마다 조언은 3개).

5.5 단서 글 읽기(readMode, 함께 풀기·2명 이상)

  • all: 읽으면 모두에게 본문이 열린다.
  • reader 한 사람만 읽기: 그 단서를 고른 사람(rotate는 반장, vote는 그 판 결정권자, free는 누른 사람)에게만 본문이 보이고, 다른 사람에게는 "○○님이 읽고 있어요"와 제목만 보인다. 읽은 사람이 채팅으로 전해 준다. 보고서 단계가 되면 모두에게 모든 본문이 열린다(못 들은 사람도 마지막엔 확인할 수 있게). 깊이 보기도 쓴 사람만 본다.

5.6 보고서

  • 언제든 [보고서 쓰기](5.2의 권한대로)로 수사를 끝낼 수 있다. 마지막 날이 끝나면 자동으로 보고서 단계.
  • 보고서 단계에서 처음으로 문제가 공개된다(원작처럼 문제를 미리 보면 어디를 볼지 너무 쉽게 안다). 단서 고르기는 더 못 하지만 수사 기록·자료실·채팅은 그대로.
  • 각자 모든 문제에 답을 고르고 [보고서 내기]. 낸 뒤에는 고칠 수 없다. 누가 냈는지만 보이고 무엇을 골랐는지는 끝날 때 공개.
  • 함께 풀기의 팀 답: 문제마다 가장 많이 고른 보기. 동점이면 동점 보기 중 마지막 반장(vote·free는 마지막 결정권자)이 고른 것, 그 사람이 동점 보기를 안 골랐으면 자리 순서로 먼저인 사람이 고른 것. 모두 비우면 오답.
  • 모두 내거나 reportSeconds가 끝나면 채점한다. 시간이 끝날 때 안 낸 사람은 고른 데까지만 낸 것으로 본다.

5.7 따로 겨루기(race)

  • 사람마다 자기 시간·위치·돋보기·조언·읽은 단서가 따로 있다. 차례가 없다. 각자 자기 속도로 단서를 고르고 하루를 마치고 보고서를 낸다(decision·readMode 무시).
  • 다른 사람에 대해서는 "몇 일째 몇 시, 읽은 단서 수, 보고서 냈는지"만 보인다. 무엇을 읽었는지는 안 보인다.
  • 게임 채팅은 닫는다(정보를 나눌 수 없게). 보고서를 낸 사람끼리만 "낸 사람 채팅"을 쓸 수 있다.
  • raceMinutes가 끝나면 아직 수사 중인 사람은 바로 보고서 단계(남은 reportSeconds)로 간다. 모두 내면 끝.
  • 셜록 홈즈 컨설팅 디텍티브처럼 "적은 시간으로 맞힌 사람"이 이기도록, race에서는 동점이면 남은 시간이 많은 사람이 앞선다.

6. 승패와 점수 계산

점수 = 맞힌 문제 점수 합 − 피로 − 조언 쓴 횟수 × 2 + 남은 시간 보너스
남은 시간 보너스(timeBonus on) = min(5, floor(남은 시간 / 2))
남은 시간 = 보고서를 쓰기로 한 순간 그날 남은 시간 + 남은 날 수 × H   (야근 중이면 그날 남은 시간 0)
  • 해결: 범인 문제(culprit)를 맞히고, 점수 ≥ 사건의 해결 기준. 등급: S(사건의 S 점수 이상) / A / B(해결 기준 이상) / 미해결.
사건 만점 해결 기준 A S
c1 28 16 21 26
c2 30 18 23 27
c3 34 22 26 31
c4 31 18 23 28
c5 32 19 24 29
c6 30 18 23 27
c7 33 20 25 30
c8 33 20 25 30
c9 30 18 23 27
c10 32 19 24 29
c11 34 21 26 31
c12 34 21 26 31
c13 35 21 26 31
  • 예: c2를 보통 시간으로 풀어 q1·q2·q3·q4(25점)를 맞히고, 야근 1시간(피로 1), 조언 1번 → 25 − 1 − 2 = 22점, 해결 B.
  • 점수가 0보다 작으면 0으로 쓴다.
  • 함께 풀기 결과: 모두 같은 순위 하나(ranking: [[모두]]). 해결이든 아니든 함께 이기고 함께 진다. scoreText: "팀 22점 · B 해결". 결과 화면에는 각자 낸 답의 점수도 재미로 보여 준다("○○님 답이었다면 26점"). 이건 순위에 들어가지 않는다.
  • 따로 겨루기 결과: 자기 점수 순. 동점이면 남은 시간이 많은 쪽, 그래도 같으면 공동. scoreText: "24점 · A".
  • summary 예: "사건 해결! 팀 22점(B). 범인은 문지혜였어요." / "미해결… 팀 12점. 범인은 강민재였어요."
  • 끝나면 모두에게 정답·풀이·못 본 단서 전부(본문·깊이 보기 포함)를 공개한다. "놓친 단서 보기"가 마무리의 재미.

7. 지역 룰 / 하우스 룰 (옵션으로 켜고 끄기)

옵션 무엇 영감
timeBudget 하루 10·8·6시간. 쉬움/어려움 조절 디텍티브(원작은 하루 8시간 + 야근)
overtime 하루 2시간까지 더 일하고 시간당 −1점 디텍티브의 야근·스트레스
magnifiers 깊이 보기 토큰 수 디텍티브의 기술 토큰("더 깊이 파기")
hints 점수를 내고 쓰는 조언 EXIT·언락 방탈출 게임의 힌트 카드
timeBonus 남은 시간만큼 보너스 셜록 홈즈 컨설팅 디텍티브(홈즈보다 적은 단서로 풀면 높은 점수)
morningNews 아침마다 들어오는 소식 크로니클 오브 크라임·디텍티브의 시간에 따라 바뀌는 사건
readMode: reader 한 사람만 읽고 말로 전하기 머더 미스터리 파티(각자 다른 정보를 쥐고 말로 나눔)
decision 반장 돌아가며 / 투표 / 아무나 온라인용으로 새로 만듦(원작은 식탁에서 말로 정함)
mode: race 같은 사건을 각자 풀어 점수 경쟁 셜록 홈즈 컨설팅 디텍티브의 경쟁 규칙

일부러 뺀 것: 원작의 인터넷 검색 과제(바깥 사이트에 의존), 권한 토큰·보고서 쓰기 행동, 탐정마다 다른 특수 능력(사건마다 균형을 잡기 어려움), 여러 사건이 이어지는 캠페인, 틀린 답 감점(원작은 −1점, 가족용으로 뺌), 단서 본문 음성 읽기.

8. 엔진 설계

8.1 상태(State)

interface CaseFileState {
  options: CaseFileOptions;
  caseId: 'c1' | 'c2' | 'c3';                  // random은 setup에서 정해짐
  players: { id: PlayerId; left: boolean }[];
  phase: 'briefing' | 'investigate' | 'report' | 'ended';
  briefingReady: PlayerId[];
  investigations: Record<string, Investigation>; // coop: 'team' 하나, race: 플레이어 id마다
  decider: number;                              // rotate 반장 / vote·free 결정권자(자리 번호)
  ballot: Record<PlayerId, Choice> | null;      // vote 모드
  pins: Record<PlayerId, string | null>;        // 추천 표시
  reportAgree: PlayerId[];                      // free 모드 보고서 동의
  answers: Record<PlayerId, Record<string, number>>;
  submitted: PlayerId[];
  chat: { n: number; from: PlayerId; text: string; at: number; channel: 'team' | 'done' }[];
  deadlineAt: number | null; raceEndsAt: number | null;
  idle: Record<PlayerId, number>;               // 연속 시간 초과
  seq: number;
  final: CaseFileFinal | null;
}
interface Investigation {
  day: number; hour: number;                    // hour: 9 + 쓴 시간(야근이면 하루 끝을 넘김)
  zone: string; place: string;
  visited: { lead: string; by: PlayerId; day: number; at: number; travel: number }[];
  deep: { lead: string; by: PlayerId }[];
  opened: string[];                             // 깊이 보기로 열린 단서
  magnifiers: number; hintsUsed: number; fatigue: number;
  newsSeen: number[];                           // 공개된 아침 소식(날짜)
  reportAt: { day: number; hour: number } | null; // 남은 시간 계산용
}
type Choice = { type: 'lead'; lead: string } | { type: 'deep'; lead: string } | { type: 'hint' } | { type: 'endDay' } | { type: 'report' };
  • 상태에는 사건 데이터를 넣지 않는다(id만). 본문·정답은 엔진 모듈이 사건 파일에서 읽는다. 저장 크기가 작고, 사건 글을 고쳐도 판 상태가 깨지지 않는다(글 고침은 stateVersion을 올려 다시 보기만 막는다).
  • 열린 단서·남은 시간·고를 수 있는지는 상태에서 매번 계산한다(저장하지 않음).

8.2 액션

type payload 누가 / 언제 검증 조건
ready – 모두, briefing 아직 안 누름
pick lead investigate, 5.2 권한(race는 자기 수사) 열렸고 안 읽음, 시간 되는지(야근 포함), 보고서 전
deep lead 권한자 읽은 단서, 깊이 보기 있음, 아직 안 씀, 돋보기 ≥ 1
hint – 권한자 남은 조언 횟수 ≥ 1, 사건 조언 남음
endDay – 권한자 investigate
report – 권한자(free는 동의 표시) investigate
vote choice vote 모드, 나간 사람 아님 choice가 지금 할 수 있는 행동
pin lead | null 함께 풀기, 누구나 고를 수 있는 단서
answer q, choice report, 아직 안 냄 문제·보기 범위
submit – report, 아직 안 냄 –
chat text 함께 풀기: 모두 / race: 낸 사람끼리 200자, 고운 말
timeout – 서버 마감 지남
leave – 서버(나감) –
  • timeout·leave는 actionSchema에 넣지 않는다(서버만 만든다, 09 §2).

8.3 공개/비공개 정보 (view)

  • 사건 데이터는 서버 전용: cases/*.ts는 엔진(packages/games/src/case-file/index.ts)만 가져온다. 웹은 import type만 쓴다. 웹 빌드 결과물에 사건 본문이 없는지 테스트한다(10절, 본문마다 넣은 확인용 문장 조각을 빌드 파일에서 검색).
  • view에 들어가는 것: 의뢰, 구역·장소·이동표, 열린 단서 목록(id·제목·장소·시간·🔍 여부·추천 표시), 읽은 단서의 본문(readMode: reader면 읽은 사람에게만, 보고서 단계부터 모두), 쓴 깊이 보기 본문, 공개된 아침 소식·조언, 열린 인물 카드, 시계·돋보기·조언·피로, 투표 현황(누가 투표했는지는 보이고 무엇을 골랐는지는 집계 때), 보고서 단계면 문제와 보기(정답 없이), 내 답.
  • view에 없는 것: 안 읽은 단서의 본문·깊이 보기, 안 연 단서의 제목, 정답·점수 배분 중 정답·풀이, 남의 답(끝나기 전), race에서 남의 읽은 단서.
  • 문제 점수(몇 점짜리인지)는 보고서 단계에 보여 준다. 정답 번호는 final에만.
  • 끝난 뒤(final): 정답, 풀이, 팀 답·각자 답과 점수, 모든 단서 본문.
  • secretsOf(state, p): p가 아직 볼 수 없는 단서 본문·깊이 보기 본문 각각의 확인 문장 조각 + (끝나기 전) 풀이 첫 문장과 정답 보기 글. 공통 유출 검사기가 view JSON에서 이것을 찾는다.

8.4 랜덤 요소

random 사건 고르기, 첫 반장(첫 결정권자). 그 밖에는 난수가 없다(같은 사건, 같은 선택이면 같은 결과).

8.5 타이머·시간 초과·연결 끊김 시 자동 행동

  • 의뢰 단계 60초(고정). 끝나면 수사 시작.
  • rotate: 반장에게 turnSeconds. 시간이 지나면 반장만 다음 사람에게 넘긴다(시계는 그대로, 단서 안 고름). 한 사람이 3번 연속 넘기면 그 사람 차례는 건너뛴다(다시 행동하면 풀림). 모두가 3번 연속이면 보고서 단계로 간다(아무도 안 하는 판이 끝나지 않는 일을 막음).
  • vote: 투표 시간 turnSeconds. 끝나면 투표한 것만 집계. 아무도 안 했으면 아무 일 없이 다음 투표(결정권자는 넘어감), 3번 연속이면 보고서 단계로.
  • free: 마감이 없다. 모두 연결이 끊긴 채 방의 유예 시간이 지나면 보고서 단계로.
  • turnSeconds 무제한: 마감이 없고, 연결이 끊긴 채 유예 시간이 지난 반장만 위처럼 넘긴다.
  • 보고서: reportSeconds가 끝나면 안 낸 사람은 고른 데까지 낸 것으로. 무제한이면 연결이 끊긴 채 유예 시간이 지난 사람만.
  • race: 각자 마감 없음. raceMinutes가 끝나면 모두 보고서 단계, 그다음 reportSeconds.
  • 나가기(onLeave): 함께 풀기는 그 사람을 반장 차례·투표·동의 인원에서 뺀다. 반장이었으면 다음 사람. 남은 사람이 0이면 abandoned. 따로 겨루기는 그 사람이 꼴찌(0점).
  • onTimeout은 늘 합법 행동(timeout)을 돌려준다.

8.6 종료 조건과 결과(GameResult)

  • 모두(나간 사람 빼고) 보고서를 냈거나 보고서 시간이 끝남 → 채점(6절) → ended. reason: 'normal'.
  • 모두 나감 → abandoned.

8.7 컴퓨터 상대

넣지 않는다. 글을 읽고 추리하는 게임이라 컴퓨터가 고르는 단서·답은 재미가 없고(정답을 알면 알려 주는 셈, 모르면 아무렇게나), 혼자서도 완전히 즐길 수 있다(1명부터). 연습 방은 "혼자 하기". 봇 테스트(bots.test.ts) 목록에서 빠진다. 나중에 원하면 "조수 탐정"(추천 표시만 하는 컴퓨터)을 검토한다.

9. UI/UX

  • PC 배치: 위 막대(사건 제목, "1일째 13:00 / 17:00까지", 날짜 점, 🔍 돋보기 n, 💡 조언 n, 😪 피로 n, 지금 반장/투표 남은 시간). 왼쪽: 지도(구역 카드, 지금 위치에 탐정 말, 구역 사이에 이동 시간). 가운데: 단서 목록(장소별로 묶음, 카드마다 제목·"이동 1 + 1시간"·🔍·추천한 사람 얼굴, 못 고르면 흐리게+까닭 "시간이 모자라요"). 오른쪽: 탭 [수사 기록] [자료실] [메모] [채팅].
  • 단서 읽기: 고르면 가운데에 본문 카드가 크게 펼쳐진다(종이 서류 느낌, 장소·시각 도장). 아래에 "새로 열린 단서: …", [🔍 깊이 보기(돋보기 1개)].
  • 수사 기록: 읽은 단서를 시간 순서로(1일째 10:00 달빛제과 — 오순자 할머니 이야기). 누르면 다시 읽기. ★중요 표시(나만, 기기에 저장).
  • 자료실: 인물 카드(이름·나이·한 줄, 처음 나온 단서로 가기). 장소 카드.
  • 메모: 자유 글(기기에만, localStorage 키 bg:case-file:note:<방 코드>:<게임 번호>). 인물마다 의심 정도(흰색·노랑·빨강) 표시.
  • 보고서 화면: 문제마다 보기 버튼, 몇 점짜리인지, 다른 사람이 냈는지. 수사 기록을 옆에서 볼 수 있다. [보고서 내기]는 두 번 눌러 확정.
  • 결과: 등급 도장 애니메이션(S/A/B/미해결), 문제마다 팀 답·정답·각자 답, 풀이, [놓친 단서 보기].
  • 휴대폰(320px~): 위 막대는 한 줄로 접혀 붙어 있고(시각·🔍·💡), 아래 탭 [단서] [기록] [자료] [채팅]. 본문 카드는 전체 화면 시트. 단서 카드는 한 줄 두 칸이 아니라 한 칸씩. 글자 크기 최소 16px(긴 글을 읽으니까), 줄 간격 넉넉하게.
  • 반장 표시: "지금 반장: ○○님 · 2:31". 반장이 아닌 사람은 단서 카드에서 [추천]만 누를 수 있다. 투표 모드는 카드 위에 투표 수가 쌓인다.
  • 채팅은 게임 자체 채팅(ownChat, 고운 말 필터). 방 채팅·빠른 반응은 게임 중 닫힘. 따로 겨루기에서는 채팅이 닫혀 있다는 안내.
  • 접근성: 모든 카드·탭이 버튼, 본문은 실제 글(그림 아님), 스크린리더에 "새 단서 2개가 열렸어요"를 aria-live로. 다크 모드는 공통 색 변수. 동작 줄이기 설정이면 도장·카드 펼침 애니메이션 없음.
  • 초보자 도움말: 30초 요약 카드 3장("시간 안에 단서를 골라요 / 다른 동네로 가면 이동 시간이 들어요 / 마지막에 보고서 문제를 풀어요"), [?]에 옵션별 설명.

10. 테스트 체크리스트

  • 사건 데이터 검사(사건마다): 단서 id 겹치지 않음, 여는 조건·깊이 보기가 여는 단서가 모두 있는 id, 모든 단서가 처음 단서에서 닿음, 장소·구역·이동표가 맞음(대칭, 같은 구역 0), 단서 시간 12, 문제 보기 26개·정답 범위, 범인 문제 하나, 만점·기준·등급이 문서 표와 같음, 모든 글이 고운 말 필터 통과.
  • 풀 수 있는지: 사건마다 적어 둔 "빠듯한 길"(cases 문서 점검표)을 돋보기 0개·조언 0개·야근 끔으로 실제 엔진에서 따라가 시간이 모자라지 않음. 그 길에서 읽은 글에 정답 근거 문장이 모두 있음(사건 파일에 문제마다 evidence: 단서 id[]를 두고 그 단서들이 길 안에 있는지 확인).
  • 시간: 이동 시간, 같은 구역 0, 하루 끝, 야근 2시간 한도·피로, 야근 끔이면 넘는 단서 못 고름, 자동 하루 마치기, 마지막 날 → 보고서, 아침 소식 날짜.
  • 단서: 열림 규칙(OR), 깊이 보기로 열림, 다시 고르기 금지, 돋보기 개수, 조언 차례·감점.
  • 결정 방식: rotate 반장만·반장 넘김·추천 표시, vote 집계·동점·결정권자 돌기·아무도 안 함, free 두 번 누르기·보고서 모두 동의.
  • 읽기: reader면 읽은 사람만 본문, 보고서 단계에서 모두에게 열림.
  • 보고서: 문제는 보고서 단계에서만 view에 나옴, 팀 답 다수결·동점 처리, 점수 계산(피로·조언·남은 시간 보너스·0 아래), 범인 틀리면 미해결, 등급.
  • 따로 겨루기: 수사가 서로 섞이지 않음, 남의 읽은 단서 안 보임, 채팅 닫힘/낸 사람 채팅, 전체 시간, 동점 → 남은 시간.
  • 시간 초과·나가기: 반장 넘김, 3번 연속 건너뛰기, 모두 자리 비움 → 보고서, 보고서 시간 초과, 반장이 나감, 모두 나감.
  • 비밀: 무작위 수백 판(1~5명, 옵션 조합)에서 매 단계 view JSON에 secretsOf 문장 조각이 없음. 정답 보기 글·풀이는 끝나기 전 어떤 view에도 없음.
  • 웹 빌드에 사건 글 없음: apps/web 빌드 결과물에서 사건 본문 확인 문장 조각을 찾지 못함.
  • 엔진 공통: 무작위 대국(legalActions), JSON 왕복, 결정성, 상한 안에 끝남, onTimeout 합법.
  • 도움말(help.test.ts), E2E(PC 1 + 휴대폰 2: 의뢰 → 반장 돌기 → 단서 읽기 → 깊이 보기 → 하루 마치기 → 보고서 → 결과, reader 비밀 유지, 따로 겨루기 한 판).

11. 참고 자료

12. 메모 (상표·법적 주의 등)

  • 게임 진행 방식(시간 예산, 단서 고르기, 객관식 보고서)은 저작권 대상이 아니지만, 원작의 사건·글·인물·그림·이름은 저작물이라 쓰지 않는다. 이름도 '디텍티브'가 아닌 『사건 파일』, 원작의 기관·데이터베이스 이름(앤타레스 등)도 쓰지 않는다. 우리 쪽 이름: 해오름 탐정사무소, 자료실, 돋보기, 반장님 조언.
  • 사건 13개는 모두 새로 지은 이야기. 실제 사람·가게·상표와 관계없다. 동네 이름(망원동·성산동·북촌·인사동·이천·판교)은 배경으로만 쓰고, 가게·학교·화랑 이름은 지어낸 것이다.
  • 가족·친구용 사이트라 사건은 다치거나 죽는 일이 없는 도난·바꿔치기로만 만든다. 새 사건도 같은 기준(10절 데이터 검사의 고운 말 필터 + 사람이 읽고 확인).
  • 새 사건 추가: case-file-writing-guide.md대로 cases/<id>.ts + checks/<id>.ts를 쓰고 bun scripts/case-file-doc.ts <id>로 case-file-cases/<id>.md를 만든다. 데이터 검사 테스트가 새 사건도 자동으로 검사하고, 문서가 데이터와 다르면 실패한다.