core2026/docs/developer/index.md

개발자 핸드북

읽기 순서

프로그래밍 기초만 안다면 코드가 처음인 사람을 위한 구조 안내에서 시작하세요. 화면·서버·저장을 익힌 뒤 아키텍처 개요와 파일 지도로 넘어갑니다.

개발 경험이 있다면 경험자를 위한 시스템 읽기 → 아키텍처 개요 → 요청·턴·저장 순서가 좋습니다. 이후 아래 표에서 맡은 기능을 고르세요. 런타임 문서는 배포·worker까지 포함하는 상세 참고서입니다.

관리자 감사는 운영 안내에서 현재 기능을, 설계에서 요구사항과 배경을 확인합니다.

작업	문서	코드 시작점
전체 구조	아키텍처 개요	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를 따릅니다. 이 파일들은 핸드북 사이트 밖의 저장소 문서입니다.