core2026/docs/developer/index.md

개발자 핸드북

읽기 순서

작업	문서	코드 시작점
전체 구조	아키텍처 개요	app/, packages/, tools/
process·worker·daemon	런타임 아키텍처	app server와 CLI
파일 위치	파일 지도	router, handler, schema
명령·전투·효과	도메인과 조립	packages/logic
mutation·flush	요청·턴·저장	game API, game engine
action module	행동 모듈 프로토콜	actionModules/
ref 비교	차등 검증	tools/integration-tests

경계

• packages/logic은 계산과 규칙을 소유합니다.
• 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의 ref entry point, 호출 순서, 인증, DB mutation, RNG와 오류 경로를 함께 갱신해 주세요.