README: 운영 주소, 게임 26개, 주요 기능, 빠진 E2E 명령, 운영 서버 업데이트 절차
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
28
README.md
28
README.md
@@ -3,6 +3,26 @@
|
|||||||
광고 없이 가볍고, 링크 하나로 친구·가족과 바로 즐기는 온라인 보드게임 사이트.
|
광고 없이 가볍고, 링크 하나로 친구·가족과 바로 즐기는 온라인 보드게임 사이트.
|
||||||
계획서는 [docs/](docs/README.md)에 있고, 구현은 계획서를 따른다.
|
계획서는 [docs/](docs/README.md)에 있고, 구현은 계획서를 따른다.
|
||||||
|
|
||||||
|
운영 중: https://game.tkrmagid.kr
|
||||||
|
|
||||||
|
## 게임 (26개)
|
||||||
|
| 종류 | 게임 |
|
||||||
|
|---|---|
|
||||||
|
| 2인 수 싸움 | 오목, 오셀로, 체스(체스960 포함), 장기, 바둑, 쿼리도(2·4명) |
|
||||||
|
| 카드·화투 | 원카드, 섯다, 포커, 고스톱, 달무티, 구십구, 바퀴벌레 포커, 뱅! |
|
||||||
|
| 타일·주사위 | 루미큐브, 다빈치 코드, 마작, 요트 다이스, 윷놀이, 라스베가스, 부루마불, 스플렌더 |
|
||||||
|
| 순발력·대화 | 할리갈리, 도블, 그림 맞히기, 마피아 |
|
||||||
|
|
||||||
|
칩·포인트·지폐는 모두 놀이용이다(실제 돈과 무관).
|
||||||
|
|
||||||
|
## 주요 기능
|
||||||
|
- 로그인: 디스코드 또는 게스트(닉네임만). 게스트는 로그아웃하거나 하루 동안 접속하지 않으면 계정이 지워진다.
|
||||||
|
- 방: 방 링크를 보내면 친구가 바로 들어온다. 방 막대에서 링크 복사·채팅·규칙·설정(글자 크기·소리)·나가기를 한 번에 누른다. 게임 중에 나가면 기권으로 처리된다.
|
||||||
|
- 컴퓨터 상대: 실시간·대화 게임(할리갈리, 도블, 그림 맞히기, 마피아)을 뺀 22개 게임.
|
||||||
|
- 처음 하는 사람을 위한 30초 규칙 요약, 게임별 규칙 페이지, 끝난 판 다시 보기, 이름을 누르면 나오는 기록 카드.
|
||||||
|
- 홈 화면에 추가(PWA), 휴대폰(320px부터)·PC, 다크 모드.
|
||||||
|
- 관리자 화면(`/admin`): 게임 규칙 기본값·잠금, 사용자·방 관리, 계정별 기록.
|
||||||
|
|
||||||
## 개발
|
## 개발
|
||||||
```bash
|
```bash
|
||||||
bun install
|
bun install
|
||||||
@@ -24,6 +44,9 @@ bun e2e/admin.e2e.ts # 관리자: 슈퍼어드민 로그인 → 규
|
|||||||
bun e2e/games.e2e.ts [게임id...] # 게임별: 방 만들기 → 친구 입장 → 실제 화면 조작으로 여러 턴(일부는 끝까지)
|
bun e2e/games.e2e.ts [게임id...] # 게임별: 방 만들기 → 친구 입장 → 실제 화면 조작으로 여러 턴(일부는 끝까지)
|
||||||
bun e2e/a11y.e2e.ts # 접근성(axe) 검사
|
bun e2e/a11y.e2e.ts # 접근성(axe) 검사
|
||||||
bun e2e/pwa.e2e.ts # PWA: 매니페스트·아이콘, 서비스 워커, 오프라인 안내, 홈 화면에 추가
|
bun e2e/pwa.e2e.ts # PWA: 매니페스트·아이콘, 서비스 워커, 오프라인 안내, 홈 화면에 추가
|
||||||
|
bun e2e/bots.e2e.ts # 컴퓨터 상대, 방 나가기, 게스트 로그아웃
|
||||||
|
bun e2e/replay.e2e.ts # 다시 보기
|
||||||
|
bun e2e/tutorial.e2e.ts # 처음 하는 사람용 규칙 요약
|
||||||
bun scripts/loadtest.ts --help # 부하·장애 주입 (docs/reports 참고)
|
bun scripts/loadtest.ts --help # 부하·장애 주입 (docs/reports 참고)
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -33,6 +56,11 @@ bun scripts/loadtest.ts --help # 부하·장애 주입 (docs/reports 참고)
|
|||||||
cd deploy && docker compose up -d --build
|
cd deploy && docker compose up -d --build
|
||||||
```
|
```
|
||||||
이미 HTTPS 리버스 프록시가 있는 서버(지금 운영 중인 .5 + NPMplus)에서는 `docker compose -f docker-compose.proxy.yml up -d --build`로 앱만 띄운다.
|
이미 HTTPS 리버스 프록시가 있는 서버(지금 운영 중인 .5 + NPMplus)에서는 `docker compose -f docker-compose.proxy.yml up -d --build`로 앱만 띄운다.
|
||||||
|
운영 서버 업데이트는 `main`에 푸시한 뒤 서버에서:
|
||||||
|
```bash
|
||||||
|
git pull && cd deploy && docker compose -f docker-compose.proxy.yml up -d --build
|
||||||
|
curl -fsS http://localhost:2970/healthz
|
||||||
|
```
|
||||||
자세한 절차는 [docs/11-deployment-ops.md](docs/11-deployment-ops.md).
|
자세한 절차는 [docs/11-deployment-ops.md](docs/11-deployment-ops.md).
|
||||||
|
|
||||||
## 관리자
|
## 관리자
|
||||||
|
|||||||
Reference in New Issue
Block a user