feat: add durable release controller and admin deploy modes

docs/architecture/runtime.md

@@ -6,6 +6,8 @@
 | -------------------- | -------------------------------------------------------- | ------------------------------------------- |
 | gateway API          | `app/gateway-api/src/server.ts`                          | 계정, session, profile, admin operation     |
 | gateway orchestrator | `app/gateway-api/src/orchestrator/orchestratorServer.ts` | DB queue, build, PM2 reconciliation         |
+| release controller   | `app/release-controller/src/index.ts`                    | Gateway 전체 릴리스와 controller CLI 전환   |
+| game frontend        | Vite preview                                             | profile별 commit frontend artifact          |
 | game API             | `app/game-api/src/server.ts`                             | profile tRPC, SSE, worker transport         |
 | turn daemon          | `app/game-engine/src/turn/cli.ts`                        | schedule, command, 월간 lifecycle, DB flush |
 | battle worker        | `app/game-api/src/battleSim/worker.ts`                   | 격리된 전투 시뮬레이션                      |
@@ -26,6 +28,7 @@ Gateway API는 다음 저장 경계를 사용합니다.
 - `AppUser`, `SystemSetting`: 계정과 정책
 - `GatewayProfile`: profile, scenario, port, 상태와 build 결과
 - `GatewayOperation`: build/reset/open/close 등 실행 요청과 결과
+- `GatewayReleaseOperation`, `GatewayReleaseState`: Gateway 전체 릴리스 queue와 현재·이전 commit
 - `GatewayRuntimeAction`: profile별 시간 가속·연기 요청, 부분 적용과 최종 결과
 - Redis: gateway session, OAuth 임시 상태, flush channel
 
@@ -34,6 +37,15 @@ Orchestrator는 `GatewayOperation`을 claim하고 source ref를 commit으로
 artifact를 만들며 `Pm2ProcessManager`가 profile process를 조정합니다.
 재시작 시 DB 상태와 process 상태를 reconciliation합니다.
 
+Profile `DEPLOY` operation은 현재 game schema와 시즌 데이터를 유지한 채 선택
+commit의 game API, engine과 profile 전용 frontend artifact를 빌드합니다. 기존
+프로세스를 멈춘 뒤 `prisma migrate deploy`만 실행하고 seed는 호출하지 않습니다.
+새 API·frontend와 모든 worker가 PM2 `online`이고 HTTP readiness가 성공해야
+build commit을 게시합니다. 실패하면 이전 worktree 프로세스를 다시 시작합니다.
+`RESET` operation은 같은 build 경계를 사용한 뒤 현재 시즌 테이블을 seed로
+교체합니다. Seeder의 reset 목록에는 `hall`, `ng_games`, `yearbook_history`,
+과거 장수·국가와 상속·진단 자료가 포함되지 않습니다.
+
 시간 가속·연기는 일반 profile meta log가 아니라 UUID가 있는
 `GatewayRuntimeAction`으로 접수합니다. Profile별 `REQUESTED`/`PARTIAL`은
 DB partial unique index로 한 건만 허용합니다. Turn daemon은 자신의 lease를
@@ -137,6 +149,15 @@ Gateway operation은 source commit, worktree, build artifact와 process를
 연결합니다. `tools/build-scripts/build-server.mjs`는 profile resource 복사만
 담당합니다.
 
+Gateway API·frontend·orchestrator 자신을 Gateway orchestrator가 교체하면
+작업 중인 실행자가 사라질 수 있습니다. 따라서 `app/release-controller`가
+별도 PM2 process로 `GatewayReleaseOperation`을 claim합니다. 선택 worktree의
+`release-manifest.json`에서 controller protocol, component와 gateway/game
+migration head를 확인하고 build와 gateway migration을 마친 뒤 Gateway 세
+process를 전환합니다. HTTP와 PM2 readiness 실패 시 이전 Gateway worktree를
+복구하고 성공한 경우에만 `GatewayReleaseState`의 현재·이전 commit을 바꿉니다.
+Controller 자체 갱신은 별도 CLI process의 `self-upgrade` 명령이 수행합니다.
+
 외부 공개 경로는 `/gateway/`, `/che/`, `/hwe/`입니다. frontend base,
 tRPC, SSE, upload와 direct navigation은 해당 prefix를 유지합니다.
 `/image/*`는 Caddy의 별도 파일 시스템 경로입니다.

docs/e2e-orchestrator-tests.md

@@ -10,6 +10,9 @@ commit worktree, build와 PM2 process를 조정합니다. 검증은 다음 경
   process plan 계산
 - `orchestratorOperations.test.ts`: operation claim, 상태 전이와 오류
 - `adminOperations.test.ts`: 관리자 API와 operation 생성
+- `profileDeployOperation.test.ts`: DB 보존 배포에서 migration은 실행하고 seed는 실행하지 않는 계약
+- `gatewayReleaseRepository.integration.test.ts`: release lease, 단일 active queue와 publish fencing
+- `app/release-controller/test/releaseController.test.ts`: Gateway 세 역할 전환·복구와 controller self-upgrade
 - `workspaceManager.test.ts`: source commit과 worktree
 - `app/gateway-frontend/e2e/server-operations.spec.ts`: 관리자 화면
 - `app/gateway-frontend/e2e/hwe-lifecycle.spec.ts`: reset/build/seed/PM2와
@@ -80,6 +83,7 @@ HTTPS·host·firewall 검증을 구분합니다.
 - operation의 requested/running/succeeded 또는 failed 상태
 - resolved commit과 build workspace
 - `sammo:<profileName>:game-api`, `sammo:<profileName>:turn-daemon` process
+- `sammo:<profileName>:game-frontend`와 API·daemon·worker 전체 process
 - game API와 daemon의 profile name 일치
 - 관리자 capability와 일반 사용자 거부
 - 두 사용자의 서로 분리된 session·장수 소유권