52 lines
3.6 KiB
Markdown
52 lines
3.6 KiB
Markdown
# 개발자 핸드북
|
|
|
|
## 읽기 순서
|
|
|
|
프로그래밍 기초만 안다면 [코드가 처음인 사람을 위한 구조 안내](./first-steps.md)에서
|
|
시작하세요. 화면·서버·저장을 익힌 뒤 아키텍처 개요와 파일 지도로 넘어갑니다.
|
|
|
|
개발 경험이 있다면 [경험자를 위한 시스템 읽기](./system-walkthrough.md) →
|
|
[아키텍처 개요](../architecture/overview.md) → [요청·턴·저장](./request-turn-persistence.md)
|
|
순서가 좋습니다. 이후 아래 표에서 맡은 기능을 고르세요. 런타임 문서는 배포·worker까지
|
|
포함하는 상세 참고서입니다.
|
|
|
|
관리자 감사는 [운영 안내](../play-audit-operations.md)에서 현재 기능을,
|
|
[설계](../design/play-audit.md)에서 요구사항과 배경을 확인합니다.
|
|
|
|
| 작업 | 문서 | 코드 시작점 |
|
|
| --------------------- | --------------------------------------------------------------- | ------------------------------ |
|
|
| 전체 구조 | [아키텍처 개요](../architecture/overview.md) | `app/`, `packages/`, `tools/` |
|
|
| process·worker·daemon | [런타임 아키텍처](../architecture/runtime.md) | app server와 CLI |
|
|
| profile·Gateway 배포 | [릴리스 운영 매뉴얼](../release-operations.md) | Admin GUI와 release-controller |
|
|
| 파일 위치 | [파일 지도](./code-map.md) | router, handler, schema |
|
|
| package 의존 방향 | [패키지와 파일 경계](../architecture/package-boundaries.md) | `packages/*`, `app/*` |
|
|
| 명령·전투·효과 | [도메인과 조립](./domain-and-classes.md) | `packages/logic` |
|
|
| mutation·flush | [요청·턴·저장](./request-turn-persistence.md) | game API, game engine |
|
|
| action module | [행동 모듈 프로토콜](../architecture/action-module-protocol.md) | `actionModules/` |
|
|
| ref 비교 | [차등 검증](../architecture/turn-state-differential-testing.md) | `tools/integration-tests` |
|
|
|
|
[구조 문서 찾아보기](./reference-map.md)에는 시계·재시도·실시간 갱신·측정·운영 자료를
|
|
질문별로 모았습니다. 과거 계획과 현재 계약의 구분도 여기서 확인할 수 있습니다.
|
|
|
|
## 경계
|
|
|
|
- `packages/logic`은 계산과 규칙을 소유합니다.
|
|
- runtime I/O는 logic의 port를 app/infra adapter가 구현해 주입합니다.
|
|
- `app/game-engine`은 clock, queue, AI, 월간 순서, transaction과 flush를
|
|
소유합니다.
|
|
- `app/game-api`는 transport, 인증, input validation과 request acceptance를
|
|
소유합니다.
|
|
- `packages/infra`의 Prisma schema와 migration은 영속 구조의 기준입니다.
|
|
- `resources`는 scenario, map, unit set과 command profile을 구성합니다.
|
|
- actor와 resource owner는 session과 DB에서 서버가 결정합니다.
|
|
- `InputEvent`와 PostgreSQL transaction이 gameplay mutation의 내구성
|
|
경계입니다.
|
|
- Redis와 SSE는 session·worker·fan-out 경로이며 world commit의 대체 저장소가
|
|
아닙니다.
|
|
|
|
기능의 대응이 바뀌면 작업공간 루트 기준
|
|
`docs/ref-core2026-mapping.md`에 entry point,
|
|
호출 순서, 인증, DB mutation, RNG와 오류 경로를 갱신해 주세요.
|
|
공통 작업 규칙과 계약 분류는 제품 저장소 루트의 `AGENTS.md`를 따릅니다.
|
|
이 파일들은 핸드북 사이트 밖의 저장소 문서입니다.
|