로컬 개발 환경
저장소의 개발 컨테이너와 패키지 스크립트를 기준으로 시작하세요.
요구 환경
루트 매니페스트는 Node 22.17.1 이상인 22.x, pnpm 10.x를 요구하며 패키지 매니저는 10.32.0으로 고정합니다. 리비전을 바꿀 때는 매니페스트를 다시 확인하세요.
docker compose --profile dev up -d
docker compose exec devcontainer bash워크스페이스 설치는 컨테이너 초기화에서 처리합니다. 공용 빌드와 Prisma 마이그레이션은 호스트가 아닌 개발 컨테이너에서 실행하세요. 호스트의 네이티브 의존성 불일치를 전체 재설치로 복구하지 마세요.
워크스페이스 구성
client/*, server/*, packages/*가 pnpm 워크스페이스입니다. 공용 모듈은 packages/shared-*, Prisma는 packages/database에 있습니다. Gno 소스는 gno/contracts/r, gno/contracts/p에 있습니다.
로컬 접속점
| 서비스 | 호스트 포트 |
|---|---|
| Game | 36036 |
| Docs 개발 | 38083 |
| Bridge | 3020 |
| World | 3003 |
| Communicate | 3030 |
| Internal API | 3010 |
| Admin API / client | 3040 / 5173 |
| PostgreSQL / Redis | 5432 / 6379 |
| Gnoland RPC / Gnoweb | 26657 / 8888 |
서비스 이름과 포트의 기준은 compose.yaml입니다. 로컬 접속점이며 공개 API 보장은 아닙니다. 검증은 각 패키지의 스크립트를 사용하고 설정 이름은 .env.example에서 확인하세요. 인증 정보는 공개하지 마세요.
Docs 실행
pnpm --filter docs dev
pnpm --filter docs build운영 빌드는 정적 페이지, 양쪽 언어의 검색 색인, 호환 경로를 생성합니다. 문서 유지보수를 확인하세요.