Files
joke-app/docs/13-decisions.md

62 lines
8.5 KiB
Markdown
Raw 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.
# 13. 사용자 결정이 필요한 항목
아래 항목은 사용자 확인이 필요하다. **답이 없으면 "기본안"으로 진행**하고, 나중에 바꿀 수 있게 옵션으로 만들어 둔다.
## 0. 확정된 결정 (2026-10-04)
- 도메인: **game.tkrmagid.kr** 고정. 모든 기능을 완성한 뒤 연결한다.
- 상표명: 친구끼리 쓰는 사이트라 **원래 이름을 그대로 사용**한다.
- 관리자 사이트 추가. 슈퍼어드민은 `SUPERADMIN_DISCORD_IDS`의 디스코드 ID, 어드민은 디스코드 ID로 추가(`14-admin.md`).
- 화면은 **PC 버전 중심**으로 만든다(휴대폰은 접어서 지원).
- 게임 규칙 기본값은 관리자 사이트에서 모두 바꿀 수 있으므로, 3절의 기본안은 "처음 값"이다.
## 0-1. 확정된 결정 (2026-10-06)
- 일반 이름으로 만들었던 게임 4개를 원래 이름으로: 보석 상인 → **스플렌더**, 벽 쌓기 길찾기 → **쿼리도**, 숫자 타일 → **루미큐브**, 주사위 땅따먹기 → **부루마불**.
- 스플렌더 카드 수치: 원작 그대로.
- 구십구: 공식 규칙이 있으면 그것으로, 없으면 알아서. → 코리아보드게임즈 공식 상품 페이지의 규칙 설명 이미지로 맞춤. 공개되지 않은 특수 카드 장수는 각 4장으로 정함(`games/ninety-nine.md` §1).
- 서버: **.5 Docker 호스트**(192.168.10.5:2970), 앞단은 기존 NPMplus(192.168.10.3)가 HTTPS를 맡는다(`11-deployment-ops.md` 7절).
- 디스코드 앱 생성 완료(Client ID `1557009917641105499`). Secret은 서버 `.env`와 호스트 비밀 저장소에만 둔다.
## 0-2. 확정된 결정 (2026-10-13)
- 소리·움직임: 모든 게임. 화면 정보(view) 변화에만 반응해 한 번씩 울리고, 처음 들어올 때·다시 접속·무르기는 조용하다. 승패 소리는 방 화면만 낸다. 숨은 정보는 소리·배너로도 드러내지 않는다. 오디오 파일 없이 합성음만 쓴다. 사이트 음량 0~100(기본 50, 기기별).
- 시간 "무제한": 시간 제한이 있는 모든 게임에 둔다. 무제한이면 마감·시간 초과가 없고, 연결이 끊긴 사람은 방의 유예 시간 뒤 그 사람 몫만 자동 처리한다. 자리 비움 짧은 마감은 그대로. 마피아·라이어는 단계별로 고르고 모두 마치면 넘어간다(마피아 밤은 직업을 숨기려고 생존자 모두 "밤 마치기"). 그림 맞히기 무제한은 출제자가 정답 공개하고 넘긴다. 판 결과 화면 시간은 무제한 대상이 아니다.
- 원카드: 카드 내기와 [원카드!] 외치기는 따로다(자동 외치기 옵션만 예외). 1장 남은 뒤 2초(1~3초 옵션)는 본인만 누를 수 있고, 그 뒤엔 누구나 잡는다. 컴퓨터는 실력별로 늦게 외치고, 남의 깜빡임은 확률로만 알아챈다. "외치면 다른 사람이 1장씩 먹기" 하우스 룰(기본 끔)도 있다.
- 섯다: 한게임 섯다 방식(2장 한 번에 받기 기본, 20/40장, 베팅 규칙 일반/111~444, 땡잡이 3·7 아무 패, 멍텅구리구사 9땡까지, 쿼터 기본 끔, 숫자 키 베팅). 금액은 "원", 모인 돈은 "판돈"(섯다만 예외, 화폐 기호·현금·머니·충전·환전 같은 낱말은 계속 금지, 놀이용 안내 항상 표시). 예전 칩 방은 ×1000으로 옮긴다. 컴퓨터는 남은 패를 CPU로 전부 세어(크면 표본 3,000판) 기댓값으로 고른다. GPU는 쓰지 않는다(경우의 수가 작아 CPU로 정확히 계산됨, 판단 1번 수 ms).
- 화투 그림: Wikimedia Commons "SVG Hwatu"(Marcus Richert·Spenĉjo, CC BY-SA 4.0). 섯다·고스톱 규칙 화면과 `components/cards/hwatu/ATTRIBUTION.txt`에 출처 표시.
- 컴퓨터 채팅: 이름("컴퓨터 1", "컴1", "1번")·이어 말하기면 매번 대답, 모델이 2.5초 넘거나 없으면 내장 대답, 한 사람당 1분 8번까지. 혼잣말은 눈에 띈 수에만(방 40초·컴퓨터 90초 간격), 시작 인사·사람 대화 끼어들기 없음. 수와 어긋난 말(센 베팅에 "쫄" 등)은 수 종류별 내장 한마디로 바꾼다.
## 1. 운영 (진행에 꼭 필요)
| # | 항목 | 기본안 | 필요한 것 |
|---|---|---|---|
| 1 | 서버 위치 | **결정됨(2026-10-06)**: .5 Docker 호스트 + NPMplus | DNS에 `game` 레코드 추가(사용자) |
| 2 | 디스코드 로그인 | **결정됨(2026-10-06)**: 앱 생성, 서버 `.env`에 반영. **관리자 사이트는 디스코드 로그인이 있어야 들어갈 수 있다** | 개발자 포털 OAuth2 → Redirects에 `https://game.tkrmagid.kr/api/auth/discord/callback` 등록 확인 |
## 2. 정책
| # | 항목 | 기본안 |
|---|---|---|
| 4 | 포커·섯다·고스톱 같은 웹보드 게임 | 친구끼리 쓰는 비공개 사이트이므로 별도 연령 확인 없이 일반 게임과 같이 둔다. 칩·점수(섯다는 놀이용 "원")는 방 안에서만 쓰고 충전·환전은 없다. 관리자 사이트에서 게임별로 끌 수 있다 |
| 5 | 스플렌더 카드 수치 | 원작과 같은 수치를 별도 데이터 파일에 둔다(친구끼리 쓰는 사이트라 그대로 사용) |
## 3. 게임 규칙 기본값 (자세한 내용은 각 게임 문서)
| 게임 | 기본안 | 바꿀 수 있는 옵션 |
|---|---|---|
| 오목 | 한국식(흑백 모두 쌍삼 금지, 6목은 승리 아님) | 렌주룰, 자유룰(5목 이상 승 / 정확히 5목) |
| 바둑 | 위치 기준 슈퍼코, 덤 6.5(계가) | 삼패 무승부, 중국식 계가(덤 7.5) |
| 체스 | 3회 반복·50수는 자동 무승부, 수 생성은 자체 구현(perft·chess.js 비교로 검증, chess.js는 테스트 전용) | 엄격한 FIDE 신청 방식, 체스960(첫 줄 무작위) |
| 장기 | 점수 판정·빅장 사용, 같은 국면 4번째 금지 | 동시 비공개 상차림 |
| 포커 | 7포커 베팅은 하프까지, 백스트레이트는 마운틴 다음, 하이로우의 로우는 한게임 방식 | 풀 베팅, 넷마블식 로우, 8탑 제한 |
| 섯다 | 한게임 방식(2026-10-13): 2장 한 번에, 땡잡이는 3월+7월 아무 패, 동점은 재경기, 다음 선은 승자 | 나눠 갖기, 시계 방향 선, 20/40장, 베팅 규칙 111~444, 쿼터, 3장 섯다 |
| 마작 | 반장전, 25000점 시작, 붉은 5 세 장, 쿠이탕 허용 | 동풍전, 3인 산마 |
| 고스톱 | 맞고 7점·고스톱 3점에 고/스톱, 3고부터 2배씩 | 피 0장 피박 인정, 멍박 |
| 윷놀이 | 빽도 사용, 참먹이를 지나야 나감, 윷가락 실제 확률(0.6). 지역 룰 기본: 말 없을 때 빽도는 버림, 낙이어도 모은 결과 유지, 결과는 아무 순서로, 무조건 업기, 늘 지름길 | 50:50 공정 윷, 낙, 지역 룰(2026-10-13): 말 없을 때 빽도 다시 던지기·날윷에 새 말, 낙이면 차례 끝, 던진 순서대로 쓰기, 업을지 고르기, 갈 길 고르기 |
| 원카드 | 2→2장, A→3장, ♠A→5장, 조커 5/7장, 20장이면 파산, 원카드 외치기는 따로 누름(보호 2초) | 색깔 카드 모드, 자동 외치기, 보호 1~3초 |
| 할리갈리 | 마지막 1명 남을 때까지(10분 제한) | 원작 종료 규칙 |
| 그림 맞히기 | 한 턴에 여러 명이 맞힐 수 있음(먼저 맞힐수록 높은 점수) | 한 명만 맞히기 |
| 구십구 | 코리아보드게임즈 공식 규칙(5장씩, 인원별 시작 숫자, 0 카드는 방향 유지·반대 선택). 특수 카드 장수만 추정(각 4장) | 클래식 99 규칙, 목숨(하우스 룰) |
| 사과 게임 (2026-10-12) | 17×10 같은 판을 각자 푸는 경주, 2분, 1~8명(혼자 가능), 합 10이 아니면 그냥 무효(감점 없음) | 1분·3분 |
| 클루 (2026-10-12) | 원작처럼 주사위 2개로 복도 이동, 차례 60초, 카드 보여 주기 20초 | 빠르게(아무 방이나 바로), 30·45·90초 |
| 커넥트 포 (2026-10-12) | 7×6, 한 수 30초(시간 초과 2번까지 자동 두기) | 8×7·9×7, 피셔 시간, 시간패 |
| 도둑잡기 (2026-10-12) | 조커 1장, 짝은 자동으로 버림, 한 번 뽑기 20초 | 10·30·60초 |
| 우노 (2026-10-12) | 공식 규칙(한 판 점수, 와일드 드로우4 도전) | 500점 먼저, 쉬운 드로우4, 드로우 쌓기·낼 때까지 뽑기(하우스 룰) |
| 라이어 게임 (2026-10-12) | 라이어 1명, 설명 1바퀴, 동점은 한 번 더 투표 후 또 동점이면 라이어 승, 정답은 직접 적기 | 주제, 바보 모드, 2바퀴, 목록에서 고르기, 단계별 시간 |
| 야단법석 달리기 (2026-10-13) | 4~6명은 선수 4명(경주마다 1명), 2~3명은 8명(둘씩), 경주 4번·1등 3점 2등 1점, 원작 선수 36명 중 24명 | 순한 판·거친 판, 뒤로 갈수록 커지는 점수표 |