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

85 lines
15 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, 기기별). 50이 합성음을 적힌 크기 그대로, 100이 그 2배로 낸다.
- 시간 "무제한": 시간 제한이 있는 모든 게임에 둔다. 무제한이면 마감·시간 초과가 없고, 연결이 끊긴 사람은 방의 유예 시간 뒤 그 사람 몫만 자동 처리한다. 자리 비움 짧은 마감은 그대로. 마피아·라이어는 단계별로 고르고 모두 마치면 넘어간다(마피아 밤은 직업을 숨기려고 생존자 모두 "밤 마치기"). 그림 맞히기 무제한은 출제자가 정답 공개하고 넘긴다. 판 결과 화면 시간은 무제한 대상이 아니다.
- 원카드: 카드 내기와 [원카드!] 외치기는 따로다(자동 외치기 옵션만 예외). 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초 간격), 시작 인사·사람 대화 끼어들기 없음. 수와 어긋난 말(센 베팅에 "쫄" 등)은 수 종류별 내장 한마디로 바꾼다.
## 0-3. 확정된 결정 (2026-10-14)
- 게임 속도: 전체가 빠르다는 요청으로 1배에서도 애니메이션·연출과 컴퓨터 생각 시간을 예전의 1.5배로 늘렸다. 관리자 사이트 설정 "게임 속도 배율"(1/16~16배, 기본 1배)로 둘 다 나눠서 조절하고, 저장하면 열린 방에도 바로 적용한다. 턴 제한 시간·결과 화면 대기 같은 규칙 시간과 반응 경쟁(원카드 외치기, 할리갈리·도블 판정)은 공정성 때문에 배율과 무관하다.
- 루미큐브: 사용자 요청("루미큐브 앱 규칙으로", "드래그해서 화면에 놔두고 합치는 방식, 모두한테 보이게")으로 루미큐브 앱(Rummikub® 공식 앱) 방식을 기본으로 바꿨다. ① 바닥은 칸(20×12) 판이고, 받침대·바닥의 타일을 끌어다 아무 칸에나 놓으며 한 줄에 나란히 붙은 타일이 한 묶음이다(눌러 고르고 빈 칸 누르기도 됨). ② 차례인 사람이 옮기는 바닥은 모두(관전자 포함)에게 바로 보이고, 끄는 중인 타일도 초당 5번 미리 보기로 보인다(받침대에서 아직 안 내려놓은 타일은 뒷면). ③ [되돌리기]는 한 단계가 아니라 차례 시작 상태로 통째로 돌린다(앱의 Undo). ④ 시간이 다 되면 [완료]를 안 누른 배치는 올발라도 처음으로 돌아가고 1장을 가져온다(앱: 리뷰 "your entire turn is reset and you are penalized another tile"). 종이 규칙서의 "미완성 3장"·"자동 완료"는 옵션으로 남김. ⑤ 한 차례 시간에 앱의 30초를 더함(기본 1분 유지). 106장·14장·첫 등록 30점(받침대 타일만)·조커 회수 뒤 같은 차례 재사용·첫 등록 전 조커 회수 불가·풀 소진 뒤 아무도 못 내면 끝·점수 계산은 그대로(종이 규칙서와 같음). 근거: 공식 규칙서 https://rummikub.com/wp-content/uploads/2019/12/2600-English-1.pdf , 앱 설명 https://apps.apple.com/us/app/rummikub/id1015322991 , 앱 리뷰 https://apps.apple.com/us/app/rummikub/id973113361?see-all=reviews&platform=iphone , 앱 사용자 정리 https://game-solver.com/rummikub-2/ (자세히: `games/rummikub.md` §2, §5.6~§5.7, §13).
## 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장 섯다는 2장 한 번에(한게임 안내 "2장을 모두 받은 다음 베팅"), 땡잡이는 3월+7월 아무 패, 동점은 재경기, 다음 선은 승자. 3장 섯다는 2장 받고 공개패 1장 → 1구 베팅 → 1장 더 → 2구 베팅 → 3장 중 2장 고르기 | 1장씩 받기(전통), 나눠 갖기, 시계 방향 선, 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-14) | 루미큐브 앱 방식: 칸 판에 끌어다 놓기, 옮기는 타일 모두에게 보이기, 되돌리기 = 차례 처음으로, 시간 초과는 무조건 되돌리고 1장, 틀린 완료는 알려 주고 계속 | 종이 규칙서(시간 초과 3장·올바른 배치 자동 완료), 옮기는 타일 비공개, 인원수만큼 판, 첫 등록 0·20·50점, 조커 50점 |
| 야단법석 달리기 (2026-10-13) | 4~6명은 선수 4명(경주마다 1명), 2~3명은 8명(둘씩), 경주 4번·1등 3점 2등 1점, 원작 선수 36명 중 24명 | 순한 판·거친 판, 뒤로 갈수록 커지는 점수표 |
| 블랙잭 (2026-10-14) | 카지노 공식: 6벌 슈, 딜러 S17, 블랙잭 3:2, 아무 두 장 더블·DAS 허용, 4손패까지 스플릿(에이스는 한 장만), 서렌더 없음, 인슈어런스 제공, 딜러 A/10 peek, 10판·놀이용 칩 1,000 | 덱 1~8, H17, 배당 6:5·2:1·1:1, 더블 9~11·10~11·없음, 에이스 자유 히트·다시 스플릿, 레이트 서렌더, 5·6카드 찰리, 7-7-7 보너스(3:1), 최후 1인 |
| 젝스님트 (2026-10-15) | 104장 10장씩, 오른쪽 끝에만, 너무 작은 카드는 줄 직접 고르기, 66점에 끝, 나온 카드 표 보이기(사이트 편의) | 인원×10+4장만(섞기/펼쳐 골라 가기 프로), 양쪽 끝 붙이기, 작은 카드 자동, 30주년 팬 카드(짝홀·산 오르기·점프하는 소·숫자 뒤집기), 끝 점수 33~99·라운드 수 |
| 젬블로 (2026-10-15) | 원작 인원별 구역·시작점, 2명은 2색씩, 5명은 장애물 자동, 뒤집기 허용(원작 규칙서에 언급 없음), 동점은 공동 순위 | 2명 3색·듀오, 3명 2색씩, 장애물 직접·없음, 이음선 안 막힘, 뒤집기 금지, 블로커스식 보너스 점수, 팀전, 금색 방해 블록 |
| 티츄 (2026-10-15) | 4인 2:2, 목표 1,000점, 그랜드 티츄, 오른쪽(반시계) 차례, 폭탄은 언제든(모두 패스 뒤 2초 기다림), 소원은 화면이 지키게 함 | 개인전·3인(Threechu)·6인(Tientsin), 목표 300~1,500, 그랜드 끄기, 방향, 폭탄은 내 차례에만, 대회식 소원 패널티, 지난 카드 전부 보기, 파티 모드 |
| 핫스트릭 (2026-10-15) | 경주 3번, 티켓 뽑기, 마지막 경주 티켓 하나 두 배, 9~10명은 원작 9+ 변형(적어 내고 상금 나누기) 자동, 마스코트 그림은 직접 만듦 | 경주 수, 마지막 보너스 방식, 첫 순서, 꼴찌 걸기, 비밀 카드 2장, 버리는 카드 5장, 넘어지기 꼭 넣기, 허들, 상금 크기, 인생 결과 |
| 사건 파일 (2026-10-15) | 원작(디텍티브) 사건 글은 쓰지 않고 이름도 바꿈. 함께 풀기, 반장이 돌아가며 고르기, 하루 8시간, 틀린 답 감점 없음, 컴퓨터 상대 없음 | 사건 고르기, 따로 겨루기, 투표·아무나, 하루 10·6시간, 야근, 돋보기·조언 수, 남은 시간 보너스, 아침 소식, 한 사람만 읽기 |
| 버건디의 성 (2026-10-15) | 2019년 20주년판 규칙, 모두 1번 공국, 성은 가운데 칸, 수도원 2019 수치 | 솔로(1번 공국), 시작 성 고르기, 수도원 2011 수치, 추가 타일·여관·방패 확장. 공국 2~10번·팀전·흰 성·무역로·국경 초소는 자료가 없어 나중에 |
## 게임 그림 출처 (2026-10-13)
실제 그림이 자유 라이선스로 있는 것은 그것을 쓰고(파일 옆 ATTRIBUTION.txt, 규칙 화면 맨 아래 출처 한 줄), 상표 그림(우노·뱅!·스플렌더·도블 등)은 직접 그린다.
| 대상 | 그림 | 라이선스 |
|---|---|---|
| 화투(섯다·고스톱) | Wikimedia Commons 화투 SVG | CC BY-SA 4.0 |
| 체스 기물 | Cburnett (Commons) | CC BY-SA 3.0 (GFDL·BSD·GPL 중 선택) |
| 마작패 | Shizhao 컬러 세트 (Commons) | 퍼블릭 도메인(서풍 CC0), 일부 파일에 GPL 표기도 같이 있음 |
| 트럼프 J·Q·K·조커 | Dmitry Fomin English pattern·Atlas joker (Commons) | CC0 |