OFFSIDE — 풀타임: 휘슬이 울릴 때까지
고3 축구선수의 한 생을 살아보는 브라우저 커리어 게임.
훈련을 고르고, 이벤트마다 선택하고, 이적·병역·국가대표를 거쳐 은퇴까지.
플레이: offside-lab.com · 릴리즈 기록: Releases
게임 개요
- 고교 3학년에서 시작해 은퇴할 때까지 시즌 단위(프리시즌·전반기·후반기)로 진행한다.
훈련, 선택형 텍스트 이벤트, 이적 시장, 병역(상무·특례), 국가대표(A매치·월드컵·
아시안게임·올림픽)가 커리어를 바꾼다.
- 리그는 고교·대학·K3·K리그2·K리그1부터 J1리그·MLS·에레디비시·리그 1·분데스리가·
세리에 A·라리가·프리미어리그까지 13개. 구단은 가상 이름을 쓴다(구단명은 유저가
직접 바꿔 쓸 수 있다).
- 선수는 34개 세부 능력치를 갖고, 육각형 레이더와 포지션별 OVR로 요약해 보여 준다.
- 은퇴한 커리어는 명예의 전당(공개 순위)에 오른다. 공지·업데이트 게시판에는 댓글을 달 수 있다.
구조
게임은 전부 브라우저에서 돈다. 서버는 게임을 시뮬레이션하지 않고, 기록 보관과
공유 기능만 맡는다.
| 위치 | 내용 |
|---|
apps/web | Svelte 5 SPA (Vite). 화면은 src/ui/*, 게임 로직은 packages/game. 세이브는 localStorage. Cloudflare Workers Static Assets로 배포 |
apps/api | Hono on Cloudflare Workers + D1(Drizzle). 익명 프로필·Google 로그인·복구 코드, 커리어·시즌 요약 적재, 명예의 전당, 공지·업데이트 게시판과 댓글, 구단명 커스텀, 서버 밸런스 설정, 운영 도구 |
packages/game | 게임 엔진(순수 TS, 시드 RNG를 세이브에 저장). 웹·앱·시뮬레이터가 함께 쓴다(ADR-014) |
packages/contracts | API 요청·응답 Zod 스키마와 밸런스 스펙(@offside/contracts/balance) |
tooling/fulltime-sim | 헤드리스 밸런스 시뮬레이터. packages/game을 그대로 import해 대량 커리어를 돌리고 밸런스 기준선(reference/random.json)과 비교한다 |
tooling/scripts | 의존 방향 검사, 운영 배포 보조 스크립트 등 |
docs/ | adr/(아키텍처 결정), tracking/(보드·결정 로그), operations/(런북), archive/offside/(원작 문서, 참고용) |
pnpm workspaces + Turborepo 모노레포. Node ≥ 22.13, TypeScript strict.
개발
pnpm install
pnpm db:migrate # 로컬 D1 마이그레이션 (apps/api)
pnpm dev # web(vite) + api(wrangler dev)
pnpm lint && pnpm lint:deps && pnpm format:check && pnpm typecheck && pnpm test && pnpm build # 머지 전 검증 체인
pnpm --filter @offside/web e2e # Playwright e2e
pnpm --filter @offside/fulltime-sim sim 20000 random <tag> # 밸런스 시뮬레이션
pnpm --filter @offside/fulltime-sim check-parity <tag> # 밸런스 기준선(reference/random.json) 비교
배포와 릴리즈
- PR → CI(
ci.yml, self-hosted runner) → squash 머지 → main push가 staging에 배포된다.
- 운영은 수동 워크플로
deploy-production.yml로 배포한다.
preflight(읽기 전용)로 확인한 뒤 같은 SHA로 deploy를 실행한다.
- 운영 배포가 성공하면 릴리즈 태그
vYYYY.MM.DD.N(KST 날짜 + 그날 순번)과 GitHub 릴리즈가
자동으로 만들어진다. 릴리즈 노트는 직전 릴리즈 이후 머지된 PR 목록이다.
- 절차와 점검 항목:
docs/operations/production-release.md.
작업 규칙
자세한 규칙은 CLAUDE.md와 AGENTS.md에 있다. 요점:
- 세이브 포맷을 바꾸면 기존
localStorage 세이브를 읽는 마이그레이션을 함께 낸다.
- 밸런스에 영향을 주는 변경은
tooling/fulltime-sim으로 전후를 비교한다. 운영 중 조정할
수치는 코드 대신 운영 도구의 서버 밸런스 설정으로 바꾼다.
- 백엔드는 필요할 때만 부른다(엣지 캐시·웹 메모·세션 지연 조회).
- 작업 ID는
T-<Phase>-<번호>, 브랜치·PR 제목도 이 ID로 시작한다.
원작 OFFSIDE 아카이브
2026-09-24 Phase 9에서 원작 OFFSIDE(React + TanStack SPA, Web Worker 결정론 시뮬레이터,
콘텐츠 팩, 서버 체크포인트 동기화)를 지금의 확률·이벤트 기반 게임 풀타임으로 전면
교체했다(ADR-013). 원작 문서는
docs/archive/offside/에, 원작의 마지막 main 커밋은
offside-final 태그에 남아 있다.
라이선스
All Rights Reserved — 오픈소스가 아니다. 자세한 내용은 LICENSE.
