core2026/docs/developer/index.md

개발자 핸드북

읽기 순서

신규 관리자 플레이 감사의 확정 범위, 수집·조회 비용과 후속 구현 체크리스트는 프로필별 플레이 감사 설계에 있습니다. 해당 기능은 아직 미구현이며 아래의 현재 구조 설명과 상태를 구분합니다.

작업	문서	코드 시작점
전체 구조	아키텍처 개요	app/, packages/, tools/
process·worker·daemon	런타임 아키텍처	app server와 CLI
profile·Gateway 배포	릴리스 운영 매뉴얼	Admin GUI와 release-controller
파일 위치	파일 지도	router, handler, schema
package 의존 방향	패키지와 파일 경계	packages/*, app/*
명령·전투·효과	도메인과 조립	packages/logic
mutation·flush	요청·턴·저장	game API, game engine
action module	행동 모듈 프로토콜	actionModules/
ref 비교	차등 검증	tools/integration-tests

경계

• 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를 따릅니다. 이 파일들은 핸드북 사이트 밖의 저장소 문서입니다.