feat: Implement admin router and orchestrator for managing profiles and builds

- Added `adminRouter` for handling profile management, including listing, upserting, and updating statuses.
- Introduced `BuildRunner` interface and `PnpmBuildRunner` class for executing build commands.
- Created `GatewayOrchestrator` to manage profile states, reconcile processes, and handle build queues.
- Implemented `Pm2ProcessManager` for managing processes using PM2.
- Developed `GatewayProfileRepository` for interacting with the database to manage profiles.
- Added utility functions for resolving workspace roots and managing process definitions.
- Included tests for profile reconciliation logic.

app/gateway-api/src/server.ts

@@ -1,4 +1,4 @@
-import fastify from 'fastify';
+import fastify, { type FastifyRequest } from 'fastify';
 import cors from '@fastify/cors';
 import { fastifyTRPCPlugin } from '@trpc/server/adapters/fastify';
 import type { PrismaClient } from '@prisma/client';
@@ -16,8 +16,20 @@ import { KakaoOAuthClient } from './auth/kakaoClient.js';
 import { RedisOAuthSessionStore } from './auth/oauthSessionStore.js';
 import { createPostgresUserRepository } from './auth/postgresUserRepository.js';
 import { RedisGatewaySessionService } from './auth/redisSessionService.js';
+import { createGatewayProfileRepository } from './orchestrator/profileRepository.js';
+import { GatewayOrchestrator } from './orchestrator/gatewayOrchestrator.js';
+import { Pm2ProcessManager } from './orchestrator/pm2ProcessManager.js';
+import { PnpmBuildRunner } from './orchestrator/buildRunner.js';
+import { resolveWorkspaceRoot } from './orchestrator/workspaceRoot.js';
 import { appRouter } from './router.js';
 
+const buildEnvMap = (env: NodeJS.ProcessEnv): Record<string, string> => {
+    const entries = Object.entries(env).filter(
+        (entry): entry is [string, string] => typeof entry[1] === 'string'
+    );
+    return Object.fromEntries(entries);
+};
+
 export const createGatewayApiServer = async () => {
     const config = resolveGatewayApiConfigFromEnv();
     const postgres = createPostgresConnector(resolvePostgresConfigFromEnv());
@@ -45,6 +57,28 @@ export const createGatewayApiServer = async () => {
         config.oauthSessionTtlSeconds
     );
 
+    const profiles = createGatewayProfileRepository(
+        postgres.prisma as PrismaClient
+    );
+    const workspaceRoot = resolveWorkspaceRoot(config.workspaceRootHint);
+    const processManager = new Pm2ProcessManager();
+    const buildRunner = new PnpmBuildRunner();
+    const baseEnv = buildEnvMap(process.env);
+    const orchestrator = new GatewayOrchestrator({
+        repository: profiles,
+        processManager,
+        buildRunner,
+        processConfig: {
+            workspaceRoot,
+            redisKeyPrefix: config.redisKeyPrefix,
+            gameTokenSecret: config.gameTokenSecret,
+            baseEnv,
+        },
+        reconcileIntervalMs: config.orchestratorReconcileIntervalMs,
+        scheduleIntervalMs: config.orchestratorScheduleIntervalMs,
+        buildIntervalMs: config.orchestratorBuildIntervalMs,
+    });
+
     const app = fastify({
         logger: true,
     });
@@ -58,7 +92,7 @@ export const createGatewayApiServer = async () => {
         prefix: config.trpcPath,
         trpcOptions: {
             router: appRouter,
-            createContext: () =>
+            createContext: ({ req }: { req: FastifyRequest }) =>
                 createGatewayApiContext({
                     users,
                     sessions,
@@ -68,6 +102,10 @@ export const createGatewayApiServer = async () => {
                     kakaoClient,
                     oauthSessions,
                     publicBaseUrl: config.publicBaseUrl,
+                    profiles,
+                    orchestrator,
+                    adminToken: config.adminToken,
+                    requestHeaders: req.headers,
                 }),
         },
     });
@@ -76,7 +114,12 @@ export const createGatewayApiServer = async () => {
         ok: true,
     }));
 
+    if (config.orchestratorEnabled) {
+        orchestrator.start();
+    }
+
     app.addHook('onClose', async () => {
+        await orchestrator.stop();
         await redis.disconnect();
         await postgres.disconnect();
     });