Files
joke-app/docs/games/typing.md
EJClaw 943e4be3fd 타자 대결 연습 모드: 한컴 타자연습처럼 짧은글 10문장·단어 20개·긴글 한 편 전체를 제한 시간·점수 없이
- 대결 방식에 "연습" 추가(각자 치기, 라운드 1번, 시계·점수 없음). 긴글은 고른 주제 중 한 편을 처음부터 끝까지(8줄 단락이 아님).
- 줄마다 첫 타부터 시간을 재서 줄 사이에 쉬어도 타수가 안 떨어짐(첫 타 몫 0.15초 앞당김 → 붙여 넣기 막기 그대로).
  줄 최고 타수(best) 기록. 컴퓨터도 연습에서는 첫 타를 바로 보냄.
- 화면: 라운드 대신 걸린 시간, 지금·평균·최고 타수·정확도·진행 %, 끝나면 평균·최고·정확도·틀린 줄, 참가자 옆은 타수.
  설정에서 라운드·제한 시간 숨김, 종목 이름 "연습 종목", 도움말·규칙·요약 카드·docs.
- 테스트: 연습 4개(엔진), 무작위 대국 2가지, 컴퓨터 1가지, 도움말 1개, e2e typingPractice·typingPracticeLong.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-12 17:09:37 +09:00

103 lines
10 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.
# 타자 대결 (`typing`)
> 사이트에서 직접 만든 게임(2026-11-12 사용자 요청). 한컴 타자연습의 타수·정확도 개념에 여러 명 대결 방식을 더했다.
## 1. 개요
- 1~8명(서바이벌은 2명부터), 컴퓨터 상대 가능. 한 판 3~10분.
- 모두에게 같은 글이 나오고, 입력 칸에 그대로 친 뒤 Enter. 맞은 글자는 초록, 틀린 글자는 빨강, 조합 중인 글자는 파랑 밑줄.
## 2. 모드와 옵션
| 옵션 | 값 (기본값 굵게) |
|---|---|
| 언어 | **한국어**, 영어 |
| 대결 방식 | **가장 먼저 입력**, 서바이벌, 타수 비교, 정확도 대결, 타임어택, 연습 |
| 대결 종목 | 단어, **짧은글**, 긴글 |
| 주제 | 여러 개 고르기, 비우면 **전체**(언어·종목에 맞는 주제만 쓰임) |
| 라운드 | 1~10 (**3**) |
| 서바이벌 탈락 조건 | **틀렸을 때**, 문장별, 시간별, 시간 초과 |
| 목숨(틀렸을 때) | 1~5 (**3**) |
| 탈락 간격(시간별) | 10·**15**·20·30초 |
| 제한 시간 | **자동(글 길이)**, 10초~5분, 무제한 — 가장 먼저 입력·서바이벌은 한 문제, 타수 비교·정확도 대결은 한 라운드 |
| 타임어택 시간 | 30초·**1분**·1분 30초·2분 |
## 3. 구성물 (글 묶음, `packages/games/src/typing/texts.ts`)
- 한국어 단어: 과일, 동물, 채소, 나라, 음식, 직업, 스포츠, 사자성어
- 한국어 짧은글: 속담, 명언, 잰말놀이, 일상 문장
- 한국어 긴글: 애국가, 별 헤는 밤·서시(윤동주), 진달래꽃·산유화(김소월), 님의 침묵(한용운), 훈민정음 서문(현대어 풀이), 흥부와 놀부·해님 달님·토끼와 거북(사이트에서 다시 씀)
- 영어 단어: Fruits, Animals, Colors, Countries, Food, Jobs, Sports
- 영어 짧은글: Proverbs, Famous quotes, Tongue twisters, Pangrams
- 영어 긴글: Gettysburg Address, The Road Not Taken, Sonnet 18, Daffodils, Twinkle Twinkle Little Star, US Constitution Preamble, The Tortoise and the Hare
- 시는 위키문헌 원문과 대조해 현대 맞춤법으로 적었다. 일반 자판으로 칠 수 있는 글자만(한자·둥근 따옴표·줄표 없음, 테스트로 확인).
## 4. 준비
- 단어·짧은글: 고른 주제의 항목을 모두 섞은 덱 하나(시드 RNG). 라운드마다 덱에서 차례로 뽑는다(가장 먼저 입력: 단어 10개·짧은글 5문장, 타수 비교·정확도 대결: 단어 15개·짧은글 3문장). 덱을 다 쓰면 다시 섞는다.
- 긴글: 주제 순서를 섞고 라운드마다 다음 주제의 다음 단락(8줄 안팎, 남는 2줄 이하는 앞 단락에 붙임)을 친다. 긴 줄은 띄어쓰기에서 나눈다(한국어 34자, 영어 52자).
- 서바이벌·타임어택은 글이 끝없이 돈다.
- 연습(2026-11-12 사용자 요청, 한컴 타자연습의 짧은글·긴글 연습처럼): 라운드 1번, 제한 시간·점수 없음(라운드·제한 시간 옵션은 안 씀). 단어 20개·짧은글 10문장, 긴글은 고른 주제 중 한 편을 처음부터 끝까지.
- 라운드마다 3초 카운트다운. 그동안 첫 글은 숨긴다.
## 5. 진행 규칙
- **함께 치기**(가장 먼저 입력, 서바이벌 중 시간별 아닌 것): 모두 같은 문제를 동시에 친다. 문제가 정해지면 1.5초 쉬고 다음 문제가 열린다.
- 가장 먼저 입력: 먼저 정확하게 친 사람 1점. 틀리면 고쳐서 다시. 시간이 끝나면 아무도 점수 없음.
- 서바이벌 틀렸을 때: 틀린 Enter·시간 초과마다 목숨 −1, 0이면 탈락. 살아 있는 사람이 모두 치면 다음 문제.
- 서바이벌 문장별: 남은 사람 중 마지막 한 사람이 남으면 그 사람 탈락. 시간 안에 못 친 사람도 탈락.
- 서바이벌 시간 초과: 시간 안에 못 친 사람 모두 탈락.
- **각자 치기**(타수 비교, 정확도 대결, 타임어택, 서바이벌 시간별, 연습): 각자 한 줄 치고 Enter → 다음 줄. 틀린 채로 넘어가도 되고 그만큼 정확도·타수가 깎인다.
- 서바이벌 시간별: 정해진 간격마다 그때까지 친 타 수(지금 줄 포함)가 가장 적은 사람(같으면 함께) 탈락.
- 연습: 줄마다 첫 타(첫 진행)부터 시간을 잰다(줄 사이에 쉬어도 타수가 안 떨어짐). 첫 타의 시간 몫으로 0.15초 앞당겨 시작하고, 그래서 붙여 넣기 막기도 다른 방식과 같다. 줄마다 타수의 최고값(`best`)을 둔다. 모두 다 치면 끝(여럿이면 각자 속도로).
- 서바이벌은 문제마다 제한 시간이 0.9배씩 줄고(무제한은 자동으로 친다), 아주 빠른 사람(900타)이 치는 시간 + 1초 아래로는 줄지 않는다. 그래서 라운드가 반드시 끝난다.
- 남은 사람이 모두 한꺼번에 탈락하게 되면 아무도 탈락하지 않는다(목숨은 1개로).
- 붙여 넣기 막기: 화면에서 붙여 넣기·끌어 놓기를 막고, 서버는 2,400타/분 + 0.15초보다 빠른 Enter를 거절하며 진행 막대도 그 속도 이상 앞서지 않는다.
## 6. 승패와 점수 계산
- 타수 = 1분에 친 자판 수(두벌식: 겹모음·겹받침 2타, 쌍자음 1타, 영어는 글자 수). 각자 치기는 줄의 타 수 × 정확도, 함께 치기는 맞게 친 문제(못 친 문제는 맞게 친 데까지).
- 정확도 = 1 − 편집 거리 / 긴 쪽 글자 수.
- 라운드 점수: 가장 먼저 입력은 문제마다 1점, 나머지는 라운드 1등(같으면 모두) 1점 — 타수 비교는 타수, 정확도 대결은 정확도(같으면 타수), 타임어택은 친 타 수, 서바이벌은 끝까지 남은 사람.
- 최종: 점수 → 평균 타수 → 평균 정확도 순. 나간 사람은 맨 뒤.
- 연습: 점수 없음, 순위는 평균 타수 → 정확도. `scoreText` = "평균 N타 · 정확도 N%".
## 7. 하우스 룰
- 없음(위 옵션으로 조절).
## 8. 엔진 설계
### 8.1 상태
`phase`(countdown·playing·roundEnd·ended), `round`, `items`·`itemTopic`·`cycle`, 함께 치기의 `cur`·`curAt`·`curOpen`·`curEndsAt`·`last`, 시간별 `nextCutAt`, 각자의 라운드 기록 `rs`(idx·prog·done·keys·ms·정확도 합·wrong·lives·alive·place), 누적 `totals`, 라운드 결과 `rounds`, 덱 `deck`·`deckAt`, 긴글 `longOrder`·`longAt`.
### 8.2 액션
`progress { item, text }`(stream: 서버는 이벤트만 전달, 보기를 다시 보내지 않음), `submit { item, text }`, 시스템 `tick`·`leave`. 초당 15번 제한.
### 8.3 공개/비공개 정보
다른 사람이 친 글은 보내지 않고 진행 비율만. 카운트다운과 문제 사이 쉬는 동안 다음 글은 숨김.
### 8.4 랜덤 요소
덱 섞기, 긴글 주제 순서.
### 8.5 타이머·연결 끊김
`realtime`. 시계가 있는 단계(카운트다운, 쉬는 시간, 문제·라운드 시간, 시간별 간격)는 그 시각에만 끝나고 끊긴 사람 때문에 당겨지지 않는다. 시계가 없는 단계(무제한)는 기다리는 사람만 시간 초과 대상이라, 끊긴 사람은 방의 유예 시간 뒤 한 번만 처리된다(각자 치기: 친 데까지로 멈춤).
### 8.6 종료와 결과
마지막 라운드가 끝나거나 한 명만 남으면(나머지가 나감) 끝. `scoreText` = "N문제/N승 · 평균 N타 · 정확도 N%".
## 9. UI/UX
- 위: 라운드·방식·몇 번째·남은 사람·시계. 가운데 카드: 주제, 칠 글(글자별 색, 커서 밑줄), 긴글은 단락 전체와 지금 줄, 각자 치기는 다음 두 줄 미리 보기, 입력 칸 + [입력].
- 한글 조합 중 Enter는 조합이 끝난 뒤 보낸다(IME가 Enter를 두 번 보내는 것도 거름). 붙여 넣기·끌어 놓기 막음, 자동 완성·맞춤법 끔.
- 한/영이 반대로 쳐지면 경고. 지금 타수·라운드 타수·정확도·틀린 횟수 표시.
- 아래: 모두의 진행 막대(stream으로 실시간), 목숨 하트, 탈락·다 침 표시. 문제가 정해지면 "OO님이 먼저 쳤어요! 352타"/"OO님 탈락!" 띠. 라운드 끝 표(순위·친 문제·타수·정확도), 6초 뒤 다음 라운드.
- 연습: 라운드 표시 대신 걸린 시간(⏱), 아래에 지금·평균·최고 타수, 정확도, 진행 %. 끝나면 평균·최고 타수, 정확도, 틀린 줄. 참가자 막대 옆은 점수 대신 타수.
- 소리: 자판 딸깍, 맞음, 틀림 삐, 먼저 침 팡파르, 탈락, 3·2·1, 마지막 5초.
### 9.1 설정 화면
언어·방식(서바이벌이면 탈락 조건·목숨·간격)·종목·주제(전체 또는 여러 개)·라운드 1~10·제한 시간/타임어택 시간. 방식마다 한 줄 설명.
## 10. 테스트 체크리스트
- keys.test: 두벌식 타 수, 조합 중 글자, 정확도·편집 거리, 글 묶음 글자 검사·줄 나누기.
- typing.test: 옵션·주제, 가장 먼저 입력(쉬는 시간, 늦은 답, 붙여 넣기, 시간 초과, 라운드·최종), 서바이벌 4가지와 모두 탈락 방지·줄어드는 시계, 타수 비교·정확도 대결·타임어택·무제한, 나가기, 무작위 대국 10가지 설정(누출 없음).
- typing.test 연습: 10문장·시계 없음·점수 없음, 첫 타부터 시간·최고 타수·붙여 넣기 막기, 긴글 한 편 전체, 여럿이 각자.
- e2e typingPractice(짧은글, 3초 쉬어도 타수 유지)·typingPracticeLong(애국가 16줄 전체).
- bot.test: 10가지 설정(연습은 컴퓨터끼리만) × (사람 1 + 컴퓨터 / 컴퓨터만) 거절 0, 레벨별 타수.
- typing.room.test: 진행 stream, 연습 방, 끊긴 사람.
- 웹 help.test: 도움말, 글자 표시.
## 11. 참고 자료
- 한컴 타자연습(타수·정확도 개념), 위키문헌(애국가·윤동주·김소월·한용운 원문).
## 12. 메모
- 시·노래는 저작권이 끝난 것만(저자 사후 70년 경과, 애국가). 동화는 직접 다시 썼다.
## 13. 컴퓨터 상대
- `LIVE_BOT_STRATEGIES.typing`: 자기 화면만 보고 자기 시계로 친다. 레벨 1~60에 따라 한국어 120~620타(영어 100~500), 읽는 시간 0.9~0.35초, 오타 확률(글이 길수록 높음). 함께 치기에서는 틀린 Enter 뒤 고쳐서 다시, 각자 치기에서는 오타를 둔 채 넘어간다. 진행은 0.35~0.65초마다 보낸다.