브루니 키우기: 바랜 섬
개발 환경·인프라 명세서

문서 개요 및 목차

게임 코드를 어디에 두고, 누가(사람·AI·자동 검사) 무엇을 확인하고, 비밀값을 어디에 숨기고, 서버를 어떻게 올리고, 게임·서버·인프라·작업 진행의 「지금 상태」를 무엇으로 관리하는지 정합니다.

저장소 구성

bruni-idle 최상위 폴더

bruni-idle/
  project.godot  export_presets.cfg    ← 키스토어 비밀번호는 넣지 않음(환경변수)
  autoload/  core/  scenes/  ui/  shaders/  assets/  addons/  android/
  data/                ← tools/export_data.py 산출물. 직접 고치지 않음
  tests/unit  tests/golden  tests/save
  tools/               ← export_data.py · validate_data.py · prob_publish.py · bump_version.py
  server/              ← Cloudflare Worker (src/*.ts · migrations/*.sql · wrangler.jsonc)
  design/              ← bruni-world/game-design/data 복사본 (export 입력)
  .github/workflows/   ← ci.yml · android.yml · server.yml · data-sync.yml
  CLAUDE.md            ← 이 저장소에서 일하는 AI 를 위한 규칙 (10장)
  docs/STATE.md        ← 지금 어디까지 했나 한 장 (10장)

브랜치·커밋·버전

자동 검사·빌드 (GitHub Actions)

ci.yml 뼈대

on: { push: { branches: [main] } }
jobs:
  game:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: python3 tools/validate_data.py
      - name: Godot 4.7.2 받기
        run: |   # 공식 빌드 저장소 godotengine/godot-builds 의 4.7.2-stable 리눅스 판
          curl -sSLo g.zip "https://github.com/godotengine/godot-builds/releases/download/4.7.2-stable/Godot_v4.7.2-stable_linux.x86_64.zip"
          unzip -q g.zip && mv Godot_v4.7.2-stable_linux.x86_64 godot
      - run: ./godot --headless --import
      - run: ./godot --headless -s addons/gut/gut_cmdln.gd -gdir=res://tests -gexit
  server:
    runs-on: ubuntu-latest
    defaults: { run: { working-directory: server } }
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npx tsc --noEmit && npx vitest run

비밀값

인프라 구성도

실행 중

만들고 올리는 길

인프라 상태 관리

서버 쪽 「지금 무엇이 어떻게 설정돼 있나」를 대시보드에서 손으로 바꾸지 않고, 전부 저장소의 파일로 둡니다. 파일이 곧 상태입니다.

환경 세 개

게임 상태 관리

게임의 「지금 상태」는 저장 데이터 하나(Save.data, 기술 명세서 12장의 43개 필드)뿐입니다. 화면은 상태를 들고 있지 않고, 보여 주기만 합니다.

서버가 진실인 것

콘텐츠 데이터 상태

작업 진행 상태

「어디까지 했고 다음에 뭘 하나」도 깃에 둡니다. 주인이 다른 컴퓨터로 옮기거나 다른 AI 세션이 이어받아도 같은 곳에서 출발하게 합니다.

새 컴퓨터 세팅

맥 기준입니다. 위에서부터 순서대로 하면 개발·빌드·서버 배포까지 됩니다.

# 1. 기본 도구
xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install git gh node python@3.12

# 2. 깃허브 로그인 + 저장소 받기
gh auth login && gh auth setup-git
git clone https://github.com/<계정>/bruni-world ~/dev/hey
git clone https://github.com/<계정>/bruni-idle   ~/dev/bruni-idle

# 3. Godot 4.7.2
brew install --cask godot          # 버전 확인: Godot --version → 4.7.2.stable

# 4. Android 빌드 도구
brew install openjdk@17
brew install --cask android-commandlinetools
sdkmanager "platform-tools" "platforms;android-36" "build-tools;«Godot 4.7 문서 기준 버전»"
#   Godot 편집기 → 편집기 설정 → 내보내기 → Android: SDK 경로·Java 경로 지정
#   프로젝트 → Android 빌드 템플릿 설치 (android/ 폴더 — 이미 깃에 있으면 생략)

# 5. iOS (출시 단계에서)
#   App Store 에서 Xcode 26 설치 → sudo xcode-select -s /Applications/Xcode.app

# 6. 서버
cd ~/dev/bruni-idle/server && npm ci
npx wrangler login                 # 게임 전용 Cloudflare 계정으로
npx wrangler dev                   # 로컬 서버 + 로컬 D1

# 7. 키스토어 (빌드할 기기만) — 백업에서 복원, 경로는 환경변수로
export GODOT_ANDROID_KEYSTORE_RELEASE_PATH=~/secure/bruni-upload.jks

# 8. 깊게 시키기 스킬
ln -sfn ~/dev/hey/.claude/skills/deep ~/.claude/skills/deep

비용·한도

첫날 세팅 순서