- 후보 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>
286 lines
33 KiB
Markdown
286 lines
33 KiB
Markdown
# 사건 파일 (`case-file`)
|
||
|
||
> 마일스톤: 2026-10 새 게임(직접 만든 게임) · 인원: 최소 1 ~ 최대 5명 · 예상 시간: 사건 하나 약 30~60분 · 난이도: 보통(사건마다 쉬움·보통·어려움)
|
||
|
||
## 1. 개요
|
||
- 탐정 사무소 팀이 되어 사건 하나를 함께 푸는 **협력 추리 게임**. 정해진 날짜와 시간 안에서 어떤 단서를 따라갈지 고르고, 고른 단서의 글을 읽고, 마지막에 객관식 **수사 보고서**를 내서 점수를 받는다. 시간이 모자라 모든 단서를 볼 수는 없다. "무엇을 볼지 고르는 것"이 이 게임의 재미다.
|
||
- 영감: 포털 게임즈의 『디텍티브: 모던 크라임 보드게임』(2018). 시간 예산 안에서 단서 카드를 고르고, 다른 장소로 가면 이동 시간이 들고, 데이터베이스 자료는 시간 없이 보고, 마지막에 문제를 풀어 점수를 받는 **진행 방식**만 빌렸다. 원작의 사건·인물·글·이름·용어(앤타레스 등)는 하나도 쓰지 않는다. 사건 13개는 모두 이 사이트를 위해 새로 지었다(사건 1~3은 `case-file-cases.md`, 4~13은 `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절. 사건마다:
|
||
- **의뢰**: 처음에 모두에게 보이는 사건 소개.
|
||
- **구역·장소·이동표**: 사무소 + 3~4개 구역. 같은 구역 안은 이동 0시간, 다른 구역은 1~2시간.
|
||
- **단서** 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)
|
||
```ts
|
||
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), 단서 시간 1~2, 문제 보기 2~6개·정답 범위, 범인 문제 하나, 만점·기준·등급이 문서 표와 같음, 모든 글이 고운 말 필터 통과.
|
||
- [ ] **풀 수 있는지**: 사건마다 적어 둔 "빠듯한 길"(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. 참고 자료
|
||
- 영감(진행 방식만): Detective: A Modern Crime Board Game(Portal Games, 2018, 이그나치 트제비치에크·프셰미스와프 리메르·야쿠프 와포트). BGG 평점 약 7.6, 평가 약 1만 1천 개, 무게 2.74/5, 1~5인, 120~180분. 하루 8:00~16:00 + 야근(스트레스), 장소 이동 1시간, 단서 카드 1~4시간, 데이터베이스는 시간 없이, 마지막 객관식 보고서.
|
||
- https://boardgamegeek.com/boardgame/223321/detective-a-modern-crime-board-game
|
||
- https://ultraboardgames.com/detective-a-modern-crime-board-game/game-rules.php
|
||
- 한국어판 상품: https://www.koreaboardgames.com/product/detail?prdCd=PD2026000389CHGR
|
||
- 사용 후기: https://www.clien.net/service/board/use/16252330
|
||
- 설정 영감: Sherlock Holmes Consulting Detective(1981), Chronicles of Crime(2018), EXIT·Unlock 시리즈, MicroMacro: Crime City(2021 올해의 게임), 머더 미스터리 파티 게임.
|
||
- 사건 글: `case-file-cases.md`. 조사 메모: `groups/grp_discord_joke-app/notes/six-games-20261015/case-file.md`.
|
||
|
||
## 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`를 만든다. 데이터 검사 테스트가 새 사건도 자동으로 검사하고, 문서가 데이터와 다르면 실패한다.
|