feat(playroom): launch realtime 3D Renju

Author: Extransload

.env.development.example

@@ -1 +1,2 @@
 PUBLIC_COMMENTS_API_URL=http://127.0.0.1:8788
+PUBLIC_RENJU_API_URL=http://127.0.0.1:8787

.github/workflows/deploy.yml

@@ -81,6 +81,7 @@ jobs:
         env:
           PUBLIC_GA_MEASUREMENT_ID: ${{ vars.PUBLIC_GA_MEASUREMENT_ID }}
           PUBLIC_COMMENTS_API_URL: ${{ vars.PUBLIC_COMMENTS_API_URL }}
+          PUBLIC_RENJU_API_URL: ${{ vars.PUBLIC_RENJU_API_URL }}
           PUBLIC_ADMIN_URL: ${{ vars.PUBLIC_ADMIN_URL }}
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3

.gitignore

@@ -9,6 +9,7 @@ playwright-report/
 .vscode/
 .env.development.local
 admin/.dev.vars
+renju/.wrangler/
 
 # Local AI agent instructions and working notes
 AGENTS.md

README.md

@@ -47,6 +47,8 @@ npm ci
 npm run dev
 ```
 
+`npm run dev`는 Astro와 Playroom 실시간 Worker를 함께 실행합니다. Playroom은 로컬 8787 포트를 사용합니다. Astro만 실행하려면 `npm run dev:site`를 사용하세요.
+
 프로덕션 빌드는 Astro 정적 사이트, RSS, sitemap, Pagefind 검색 색인을 모두 `dist/`에 생성합니다.
 
 ```bash
@@ -60,14 +62,15 @@ npm test -- --run
 npm run test:e2e
 ```
 
-## 댓글과 GA4 설정
+## 공개 서비스와 GA4 설정
 
 다음 값은 브라우저에 공개되는 배포 설정이므로 GitHub repository variables에 등록합니다. 소스 코드나 GitHub Secrets에 넣지 않습니다.
 
 | Variable | 용도 |
 | --- | --- |
 | `PUBLIC_GA_MEASUREMENT_ID` | GA4 Measurement ID. 비워 두면 분석 스크립트를 로드하지 않습니다. |
 | `PUBLIC_COMMENTS_API_URL` | 댓글 Worker의 origin. 기본값은 기존 관리자 Worker 주소입니다. |
+| `PUBLIC_RENJU_API_URL` | 실시간 렌주 Worker의 origin. 비워 두면 대국 생성 대신 설정 안내가 표시됩니다. |
 | `PUBLIC_ADMIN_URL` | 별도 관리자 Worker의 HTTPS 주소입니다. 비워 두면 `/admin/` 설정 안내가 표시됩니다. |
 
 ## 관리자 기반

package-lock.json

@@ -4,7 +4,8 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "dev": "astro dev",
+    "dev": "node scripts/dev.mjs",
+    "dev:site": "astro dev",
     "build": "astro build && pagefind --site dist",
     "preview": "astro preview",
     "typecheck": "astro check",
@@ -32,13 +33,15 @@
     "remark-rehype": "^11.1.2",
     "remark-smartypants": "^3.0.3",
     "shiki": "^3.23.0",
+    "three": "^0.186.1",
     "unified": "^11.0.5"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.10",
     "@pagefind/default-ui": "^1.5.2",
     "@playwright/test": "^1.55.0",
     "@types/node": "^24.3.0",
+    "@types/three": "^0.186.0",
     "pagefind": "^1.5.2",
     "parse5": "^7.3.0",
     "prettier": "^3.9.8",

package.json

@@ -0,0 +1,30 @@
+# Playroom Renju Worker
+
+정적 Astro 사이트의 `/playroom/`과 별도로 배포하는 실시간 대국 서버입니다. Cloudflare Durable Object 하나가 방 하나를 맡으며, 착수와 승패를 서버에서 판정하고 WebSocket으로 동기화합니다. 방과 기보는 Durable Object 저장소에 남습니다.
+
+## 로컬 실행
+
+프로젝트 루트에서 다음 명령 하나로 Astro와 Playroom Worker가 함께 실행됩니다. 최초 실행 시 Worker 의존성이 없으면 자동으로 설치합니다.
+
+```bash
+npm run dev
+```
+
+사이트만 실행하려면 다음 명령을 사용합니다. 이 경우 실시간 대국 생성은 동작하지 않습니다.
+
+```bash
+npm run dev:site
+```
+
+## 배포
+
+```bash
+cd renju
+npm ci
+npm run typecheck
+npm run deploy
+```
+
+배포된 Worker의 HTTPS origin을 GitHub repository variable `PUBLIC_RENJU_API_URL`에 설정한 다음 공개 사이트를 다시 빌드합니다. Worker 배포와 Pages 배포는 별개입니다. 공유 링크에는 방 ID만 들어가며 플레이어 토큰은 각 브라우저의 localStorage에 보관합니다. 두 번째 접속자는 참여 버튼을 눌러 백 자리를 확정합니다.
+
+이 대국은 중앙 첫 수와 흑 금수 판정을 사용하는 친선 대국형 렌주입니다. 공식 대회 오프닝 절차인 주형 선택과 색 교환은 제공하지 않습니다. 시간 제한도 현재 적용하지 않습니다.