fix: 가오픈 동안 서버 게임 시계를 정지한다

정식 오픈 시각을 게임 시계 anchor로 전달하고, API가 실제 진행 상태와 시작 경계를 반환하게 한다. 프론트는 추가 조회 없이 경계에서 자동으로 시계를 시작한다.

app/game-api/src/router/lobby/index.ts

@@ -68,7 +68,10 @@ export const lobbyRouter = router({
             preopenAt: worldState.meta.preopenAt ?? '',
             turntime: worldState.meta.turntime ?? '',
             serverTime: gameTime.now.toISOString(),
+            serverWallTime: gameTime.wallNow.toISOString(),
             clockMode: gameTime.mode ?? 'realtime',
+            clockRunning: gameTime.running,
+            clockStartsAt: gameTime.startsAt?.toISOString() ?? null,
             otherTextInfo: worldState.meta.otherTextInfo ?? '',
             npcMode: worldState.config.npcMode ?? 0,
             defaultStatTotal: asNumber(asRecord(rawConfig.stat).total, 165),

app/game-api/src/services/gameClock.ts

@@ -4,14 +4,25 @@ import type { DatabaseClient } from '../context.js';
 
 export interface CurrentGameTime {
     now: Date;
+    wallNow: Date;
     tick: number | null;
     mode: GameClockMode | null;
+    running: boolean;
+    startsAt: Date | null;
     dateToTick(date: Date): number | null;
 }
 
 export const loadCurrentGameTime = async (db: DatabaseClient, wallNow = new Date()): Promise<CurrentGameTime> => {
     if (!db.worldState) {
-        return { now: wallNow, tick: null, mode: null, dateToTick: () => null };
+        return {
+            now: wallNow,
+            wallNow,
+            tick: null,
+            mode: null,
+            running: true,
+            startsAt: null,
+            dateToTick: () => null,
+        };
     }
     const state = await db.worldState.findFirst({
         orderBy: { id: 'asc' },
@@ -24,7 +35,15 @@ export const loadCurrentGameTime = async (db: DatabaseClient, wallNow = new Date
         },
     });
     if (!state?.clockBaseTime || state.clockTick === null || !state.clockWallAnchor) {
-        return { now: wallNow, tick: null, mode: null, dateToTick: () => null };
+        return {
+            now: wallNow,
+            wallNow,
+            tick: null,
+            mode: null,
+            running: true,
+            startsAt: null,
+            dateToTick: () => null,
+        };
     }
     const mode: GameClockMode = state.clockMode === 'manual' ? 'manual' : 'realtime';
     const storedTick = Number(state.clockTick);
@@ -39,10 +58,14 @@ export const loadCurrentGameTime = async (db: DatabaseClient, wallNow = new Date
         turnSeconds: state.tickSeconds,
     });
     const tick = clock.nowTick(wallNow);
+    const running = mode === 'realtime' && wallNow.getTime() >= state.clockWallAnchor.getTime();
     return {
         now: clock.tickToDate(tick),
+        wallNow,
         tick,
         mode,
+        running,
+        startsAt: mode === 'realtime' && !running ? state.clockWallAnchor : null,
         dateToTick: (date) => clock.dateToTick(date),
     };
 };

app/game-api/test/auctionWorker.test.ts

@@ -57,8 +57,11 @@ describe('auction worker clock-shift race', () => {
         const now = new Date('2026-07-30T12:00:00.000Z');
         const time = {
             now,
+            wallNow: now,
             tick: 36_000_000,
             mode: 'manual' as const,
+            running: false,
+            startsAt: null,
             dateToTick: () => 72_000_000,
         };
         const closeAt = new Date('2099-01-01T00:00:00.000Z');

app/game-api/test/gameClock.test.ts

@@ -0,0 +1,52 @@
+import { describe, expect, it, vi } from 'vitest';
+
+import type { DatabaseClient } from '../src/context.js';
+import { loadCurrentGameTime } from '../src/services/gameClock.js';
+
+const buildDatabase = (mode: 'realtime' | 'manual' = 'realtime'): DatabaseClient =>
+    ({
+        worldState: {
+            findFirst: vi.fn(async () => ({
+                clockBaseTime: new Date('2026-08-21T09:50:00.000Z'),
+                clockTick: 36_000_000n,
+                clockMode: mode,
+                clockWallAnchor: new Date('2026-08-21T11:00:00.000Z'),
+                tickSeconds: 600,
+            })),
+        },
+    }) as unknown as DatabaseClient;
+
+describe('current game time projection', () => {
+    it('holds a realtime clock at its persisted tick until the future wall anchor', async () => {
+        const db = buildDatabase();
+
+        const preopen = await loadCurrentGameTime(db, new Date('2026-08-21T10:30:00.000Z'));
+        expect(preopen).toMatchObject({
+            now: new Date('2026-08-21T10:00:00.000Z'),
+            wallNow: new Date('2026-08-21T10:30:00.000Z'),
+            tick: 36_000_000,
+            mode: 'realtime',
+            running: false,
+            startsAt: new Date('2026-08-21T11:00:00.000Z'),
+        });
+
+        const opened = await loadCurrentGameTime(db, new Date('2026-08-21T11:00:05.000Z'));
+        expect(opened).toMatchObject({
+            now: new Date('2026-08-21T10:00:05.000Z'),
+            tick: 36_300_000,
+            running: true,
+            startsAt: null,
+        });
+    });
+
+    it('keeps a manual clock stopped without scheduling an automatic start', async () => {
+        const result = await loadCurrentGameTime(buildDatabase('manual'), new Date('2026-08-21T12:00:00.000Z'));
+
+        expect(result).toMatchObject({
+            now: new Date('2026-08-21T10:00:00.000Z'),
+            tick: 36_000_000,
+            running: false,
+            startsAt: null,
+        });
+    });
+});

app/game-api/test/lobbyRouter.test.ts

@@ -68,6 +68,32 @@ describe('lobby season state', () => {
 
         expect(result.serverTime).toBe('2026-08-15T02:00:00.000Z');
         expect(result.clockMode).toBe('manual');
+        expect(result.clockRunning).toBe(false);
+        expect(result.clockStartsAt).toBeNull();
+        expect(new Date(result.serverWallTime).getTime()).not.toBeNaN();
+    });
+
+    it('exposes the future realtime wall anchor without advancing the preopen clock', async () => {
+        const wallAnchor = new Date('2099-08-21T11:00:00.000Z');
+        const result = await appRouter
+            .createCaller(
+                buildContext(
+                    {},
+                    {
+                        baseTime: new Date('2026-08-21T09:00:00.000Z'),
+                        tick: 36_000_000n,
+                        mode: 'realtime',
+                        wallAnchor,
+                    }
+                )
+            )
+            .lobby.info();
+
+        expect(result.serverTime).toBe('2026-08-21T10:00:00.000Z');
+        expect(result.clockMode).toBe('realtime');
+        expect(result.clockRunning).toBe(false);
+        expect(result.clockStartsAt).toBe(wallAnchor.toISOString());
+        expect(new Date(result.serverWallTime).getTime()).toBeLessThan(wallAnchor.getTime());
     });
 
     it('preserves zero as the first official game index', async () => {