feat: 실행 중 게임 옵션 변경을 지원

Gateway 관리 화면에서 현재 기수의 장수 생성 제한, 유저 자동턴, 턴 간격을 내구성 action으로 변경한다.

턴 간격 변경은 논리 tick과 현재 게임 시각을 보존하며 DB와 Redis의 tick 기반 시각을 재투영하고 기존 로그 timestamp는 유지한다.
This commit is contained in:
2026-08-17 16:05:07 +00:00
parent 50e7d894e4
commit ca6823d409
26 changed files with 1680 additions and 115 deletions
@@ -348,7 +348,7 @@ export class TurnDaemonLifecycle {
return; return;
} }
if (result.type === 'shiftSchedule' && result.ok) { if ((result.type === 'shiftSchedule' || result.type === 'updateRuntimeSettings') && result.ok) {
this.status.lastTurnTime = result.lastTurnTime; this.status.lastTurnTime = result.lastTurnTime;
this.status.checkpoint = result.checkpoint; this.status.checkpoint = result.checkpoint;
await this.stateStore.saveCheckpoint(result.checkpoint); await this.stateStore.saveCheckpoint(result.checkpoint);
@@ -368,6 +368,30 @@ const zShiftSchedule = z.object({
.refine((value) => value !== 0), .refine((value) => value !== 0),
}); });
const zRuntimeAutorunOption = z.enum(['develop', 'warp', 'recruit', 'recruit_high', 'train', 'battle', 'chief']);
const zUpdateRuntimeSettings = z.object({
type: z.literal('updateRuntimeSettings'),
actionId: z.string().uuid(),
settings: z
.object({
turnTermMinutes: z
.number()
.int()
.refine((value) => [1, 2, 5, 10, 20, 30, 60, 120].includes(value))
.optional(),
blockGeneralCreate: z.union([z.literal(0), z.literal(1), z.literal(2)]).optional(),
autorunUser: z
.object({
limitMinutes: z.number().int().min(1).max(43200),
options: z.array(zRuntimeAutorunOption).min(1),
})
.nullable()
.optional(),
})
.refine((settings) => Object.values(settings).some((value) => value !== undefined)),
});
const normalizeAuctionFinalize: CommandNormalizer<'auctionFinalize'> = (envelope) => { const normalizeAuctionFinalize: CommandNormalizer<'auctionFinalize'> = (envelope) => {
const command = parseWith(zAuctionFinalize, envelope.command); const command = parseWith(zAuctionFinalize, envelope.command);
if (!command) { if (!command) {
@@ -660,6 +684,14 @@ const normalizeShiftSchedule: CommandNormalizer<'shiftSchedule'> = (envelope) =>
return { ...command, requestId: envelope.requestId }; return { ...command, requestId: envelope.requestId };
}; };
const normalizeUpdateRuntimeSettings: CommandNormalizer<'updateRuntimeSettings'> = (envelope) => {
const command = parseWith(zUpdateRuntimeSettings, envelope.command);
if (!command) {
return null;
}
return { ...command, requestId: envelope.requestId };
};
const normalizers: CommandNormalizerMap = { const normalizers: CommandNormalizerMap = {
auctionFinalize: normalizeAuctionFinalize, auctionFinalize: normalizeAuctionFinalize,
auctionOpen: normalizeAuctionOpen, auctionOpen: normalizeAuctionOpen,
@@ -699,6 +731,7 @@ const normalizers: CommandNormalizerMap = {
resume: normalizeResume, resume: normalizeResume,
shutdown: normalizeShutdown, shutdown: normalizeShutdown,
shiftSchedule: normalizeShiftSchedule, shiftSchedule: normalizeShiftSchedule,
updateRuntimeSettings: normalizeUpdateRuntimeSettings,
}; };
export const normalizeTurnDaemonCommand = (envelope: TurnDaemonCommandEnvelope): TurnDaemonCommand | null => { export const normalizeTurnDaemonCommand = (envelope: TurnDaemonCommandEnvelope): TurnDaemonCommand | null => {
+3 -6
View File
@@ -149,7 +149,7 @@ export const createWorldReadModelSignature = (world: InMemoryTurnWorld): string
currentYear: state.currentYear, currentYear: state.currentYear,
currentMonth: state.currentMonth, currentMonth: state.currentMonth,
tickSeconds: state.tickSeconds, tickSeconds: state.tickSeconds,
config: world.getScenarioConfig(), config: world.getWorldConfig(),
meta: projectWorldMeta(state.meta), meta: projectWorldMeta(state.meta),
}); });
}; };
@@ -438,11 +438,7 @@ export const createReadModelChangeJournal = (changes: RealtimeReadModelChanges):
if (changes.worldChanged) { if (changes.worldChanged) {
journal.mark('world.content').mark('map.world'); journal.mark('world.content').mark('map.world');
} }
if ( if (changes.mapChanged || (changes.mapCityIds ?? []).length > 0 || (changes.mapNationIds ?? []).length > 0) {
changes.mapChanged ||
(changes.mapCityIds ?? []).length > 0 ||
(changes.mapNationIds ?? []).length > 0
) {
journal.mark('map.world'); journal.mark('map.world');
} }
if ((changes.frontStatusGeneralIds ?? []).length > 0 || changes.frontStatusChanged) { if ((changes.frontStatusGeneralIds ?? []).length > 0 || changes.frontStatusChanged) {
@@ -1119,6 +1115,7 @@ export const createDatabaseTurnHooks = async (
clockMode: state.clockMode ?? 'manual', clockMode: state.clockMode ?? 'manual',
clockWallAnchor: state.clockWallAnchor ?? state.lastTurnTime, clockWallAnchor: state.clockWallAnchor ?? state.lastTurnTime,
lastTurnTick: BigInt(state.lastTurnTick ?? world.dateToGameTick(state.lastTurnTime)), lastTurnTick: BigInt(state.lastTurnTick ?? world.dateToGameTick(state.lastTurnTime)),
config: asJson(world.getWorldConfig()),
meta: asJson(state.meta), meta: asJson(state.meta),
}; };
const persist = async ( const persist = async (
@@ -15,6 +15,7 @@ export interface GatewayAdminActionRecord {
handledAt?: string | null; handledAt?: string | null;
handler?: string | null; handler?: string | null;
detail?: string | null; detail?: string | null;
payload?: Record<string, unknown>;
install?: { install?: {
scenarioId?: number; scenarioId?: number;
turnTermMinutes?: number; turnTermMinutes?: number;
@@ -103,6 +104,7 @@ export const createGatewayAdminActionConsumer = async (
handledAt: action.handledAt?.toISOString() ?? null, handledAt: action.handledAt?.toISOString() ?? null,
handler: action.handler, handler: action.handler,
detail: action.detail, detail: action.detail,
payload: normalizeMeta(action.payload),
}; };
let result: GatewayAdminActionResult; let result: GatewayAdminActionResult;
try { try {
@@ -33,13 +33,13 @@ const isWorldUnited = (world: InMemoryTurnWorld): boolean => {
export class InMemoryTurnProcessor implements TurnProcessor { export class InMemoryTurnProcessor implements TurnProcessor {
// 인메모리 월드로 턴을 실행하고 월/연 갱신까지 처리한다. // 인메모리 월드로 턴을 실행하고 월/연 갱신까지 처리한다.
private readonly world: InMemoryTurnWorld; private readonly world: InMemoryTurnWorld;
private readonly tickMinutes: number; private readonly tickMinutesOverride?: number;
private readonly beforeExecuteGeneral?: (general: TurnGeneral) => Promise<void>; private readonly beforeExecuteGeneral?: (general: TurnGeneral) => Promise<void>;
private readonly afterExecuteGeneral?: (general: TurnGeneral, result: TurnGeneralExecutionResult) => Promise<void>; private readonly afterExecuteGeneral?: (general: TurnGeneral, result: TurnGeneralExecutionResult) => Promise<void>;
constructor(world: InMemoryTurnWorld, options: InMemoryTurnProcessorOptions = {}) { constructor(world: InMemoryTurnWorld, options: InMemoryTurnProcessorOptions = {}) {
this.world = world; this.world = world;
this.tickMinutes = resolveTickMinutes(world, options.tickMinutes); this.tickMinutesOverride = options.tickMinutes;
this.beforeExecuteGeneral = options.beforeExecuteGeneral; this.beforeExecuteGeneral = options.beforeExecuteGeneral;
this.afterExecuteGeneral = options.afterExecuteGeneral; this.afterExecuteGeneral = options.afterExecuteGeneral;
} }
@@ -53,6 +53,7 @@ export class InMemoryTurnProcessor implements TurnProcessor {
this.world.updateWorldMeta({ this.world.updateWorldMeta({
refreshLimit: calculateAccessRefreshLimit(this.world.getState().tickSeconds), refreshLimit: calculateAccessRefreshLimit(this.world.getState().tickSeconds),
}); });
const tickMinutes = resolveTickMinutes(this.world, this.tickMinutesOverride);
let processedGenerals = 0; let processedGenerals = 0;
let processedTurns = 0; let processedTurns = 0;
@@ -61,7 +62,7 @@ export class InMemoryTurnProcessor implements TurnProcessor {
let nextCheckpoint: TurnCheckpoint | undefined = undefined; let nextCheckpoint: TurnCheckpoint | undefined = undefined;
const previousLastTurnTime = this.world.getState().lastTurnTime; const previousLastTurnTime = this.world.getState().lastTurnTime;
const firstTickTime = getNextTickTime(previousLastTurnTime, this.tickMinutes); const firstTickTime = getNextTickTime(previousLastTurnTime, tickMinutes);
// Ref processes `turntime < monthlyBoundary` before the monthly turn. A // Ref processes `turntime < monthlyBoundary` before the monthly turn. A
// general exactly on the boundary therefore runs only after that month // general exactly on the boundary therefore runs only after that month
// has advanced, on the daemon's following pass. // has advanced, on the daemon's following pass.
@@ -114,7 +115,7 @@ export class InMemoryTurnProcessor implements TurnProcessor {
} }
if (!partial) { if (!partial) {
let nextTickTime = getNextTickTime(this.world.getState().lastTurnTime, this.tickMinutes); let nextTickTime = getNextTickTime(this.world.getState().lastTurnTime, tickMinutes);
while (!isWorldUnited(this.world) && nextTickTime.getTime() <= targetTime.getTime()) { while (!isWorldUnited(this.world) && nextTickTime.getTime() <= targetTime.getTime()) {
if (processedTurns >= budget.catchUpCap || isBudgetExpired()) { if (processedTurns >= budget.catchUpCap || isBudgetExpired()) {
partial = true; partial = true;
@@ -125,7 +126,7 @@ export class InMemoryTurnProcessor implements TurnProcessor {
if (isWorldUnited(this.world)) { if (isWorldUnited(this.world)) {
break; break;
} }
nextTickTime = getNextTickTime(this.world.getState().lastTurnTime, this.tickMinutes); nextTickTime = getNextTickTime(this.world.getState().lastTurnTime, tickMinutes);
} }
} }
+96 -18
View File
@@ -145,6 +145,7 @@ export interface TurnWorldChanges {
export interface InMemoryTurnWorldStateSnapshot { export interface InMemoryTurnWorldStateSnapshot {
schedule: TurnSchedule; schedule: TurnSchedule;
state: TurnWorldState; state: TurnWorldState;
worldConfig: Record<string, unknown>;
checkpoint?: TurnCheckpoint; checkpoint?: TurnCheckpoint;
generals: Array<[number, TurnGeneral]>; generals: Array<[number, TurnGeneral]>;
cities: Array<[number, City]>; cities: Array<[number, City]>;
@@ -181,6 +182,7 @@ export interface InMemoryTurnWorldStateSnapshot {
export interface InMemoryTurnWorldInspection { export interface InMemoryTurnWorldInspection {
state: TurnWorldState; state: TurnWorldState;
worldConfig: Record<string, unknown>;
checkpoint?: TurnCheckpoint; checkpoint?: TurnCheckpoint;
generals: TurnGeneral[]; generals: TurnGeneral[];
cities: City[]; cities: City[];
@@ -447,6 +449,7 @@ export class InMemoryTurnWorld {
private readonly pendingYearbookSnapshots: PendingYearbookSnapshot[] = []; private readonly pendingYearbookSnapshots: PendingYearbookSnapshot[] = [];
private readonly pendingUnificationFinalizations: PendingUnificationFinalization[] = []; private readonly pendingUnificationFinalizations: PendingUnificationFinalization[] = [];
private readonly scenarioConfig: ScenarioConfig; private readonly scenarioConfig: ScenarioConfig;
private readonly worldConfig: Record<string, unknown>;
private readonly unitSet?: UnitSetDefinition; private readonly unitSet?: UnitSetDefinition;
private checkpoint?: TurnCheckpoint; private checkpoint?: TurnCheckpoint;
private state: TurnWorldState; private state: TurnWorldState;
@@ -483,6 +486,10 @@ export class InMemoryTurnWorld {
meta: { ...state.meta, lastTurnTime: lastTurnTime.toISOString() }, meta: { ...state.meta, lastTurnTime: lastTurnTime.toISOString() },
}; };
this.scenarioConfig = snapshot.scenarioConfig; this.scenarioConfig = snapshot.scenarioConfig;
// Runtime callbacks created before the world keep the original object
// reference. Mutate this object in place so a live settings action is
// observed by monthly handlers without restarting the daemon.
this.worldConfig = snapshot.worldConfig ?? {};
this.unitSet = snapshot.unitSet; this.unitSet = snapshot.unitSet;
this.schedule = options.schedule; this.schedule = options.schedule;
this.generalTurnHandler = this.generalTurnHandler =
@@ -597,6 +604,7 @@ export class InMemoryTurnWorld {
return structuredClone({ return structuredClone({
schedule: this.schedule, schedule: this.schedule,
state: this.state, state: this.state,
worldConfig: this.worldConfig,
checkpoint: this.checkpoint, checkpoint: this.checkpoint,
generals: Array.from(this.generals.entries()), generals: Array.from(this.generals.entries()),
cities: Array.from(this.cities.entries()), cities: Array.from(this.cities.entries()),
@@ -636,6 +644,10 @@ export class InMemoryTurnWorld {
const restored = structuredClone(snapshot); const restored = structuredClone(snapshot);
this.schedule = restored.schedule; this.schedule = restored.schedule;
this.state = restored.state; this.state = restored.state;
for (const key of Object.keys(this.worldConfig)) {
delete this.worldConfig[key];
}
Object.assign(this.worldConfig, restored.worldConfig);
this.checkpoint = restored.checkpoint; this.checkpoint = restored.checkpoint;
this.replaceMap(this.generals, restored.generals); this.replaceMap(this.generals, restored.generals);
this.replaceMap(this.cities, restored.cities); this.replaceMap(this.cities, restored.cities);
@@ -673,6 +685,7 @@ export class InMemoryTurnWorld {
inspectState(): InMemoryTurnWorldInspection { inspectState(): InMemoryTurnWorldInspection {
return structuredClone({ return structuredClone({
state: this.state, state: this.state,
worldConfig: this.worldConfig,
checkpoint: this.checkpoint, checkpoint: this.checkpoint,
generals: Array.from(this.generals.values()), generals: Array.from(this.generals.values()),
cities: Array.from(this.cities.values()), cities: Array.from(this.cities.values()),
@@ -698,46 +711,107 @@ export class InMemoryTurnWorld {
}; };
} }
updateWorldConfig(patch: Record<string, unknown>): void {
Object.assign(this.worldConfig, patch);
}
markGeneralAccessScoreReset(generalId: number): void { markGeneralAccessScoreReset(generalId: number): void {
if (Number.isSafeInteger(generalId) && generalId > 0) { if (Number.isSafeInteger(generalId) && generalId > 0) {
this.accessScoreResetGeneralIds.add(generalId); this.accessScoreResetGeneralIds.add(generalId);
} }
} }
changeTurnTerm(tickMinutes: number): void { changeTurnTerm(
tickMinutes: number,
wallNow = new Date()
): {
changed: boolean;
previousTurnTermMinutes: number;
turnTermMinutes: number;
previousClockBaseTime: string;
clockBaseTime: string;
shiftedGenerals: number;
lastTurnTime: string;
} {
if (!Number.isInteger(tickMinutes) || tickMinutes <= 0) { if (!Number.isInteger(tickMinutes) || tickMinutes <= 0) {
throw new Error('Turn term must be a positive integer.'); throw new Error('Turn term must be a positive integer.');
} }
const previousTickSeconds = this.state.tickSeconds; const previousTickSeconds = this.state.tickSeconds;
const nextTickSeconds = tickMinutes * 60; const nextTickSeconds = tickMinutes * 60;
if (previousTickSeconds === nextTickSeconds) {
return;
}
const previousClock = this.getGameClock(); const previousClock = this.getGameClock();
const anchorTick = this.state.clockTick ?? previousClock.tick; const previousClockBaseTime = previousClock.baseTime.toISOString();
if (previousTickSeconds === nextTickSeconds) {
this.updateWorldConfig({ turnTermMinutes: tickMinutes });
return {
changed: false,
previousTurnTermMinutes: previousTickSeconds / 60,
turnTermMinutes: tickMinutes,
previousClockBaseTime,
clockBaseTime: previousClockBaseTime,
shiftedGenerals: 0,
lastTurnTime: this.state.lastTurnTime.toISOString(),
};
}
const currentWallAnchor = this.state.clockWallAnchor ?? previousClock.wallAnchor;
const anchorWall = wallNow.getTime() < currentWallAnchor.getTime() ? currentWallAnchor : wallNow;
const anchorTick = previousClock.nowTick(anchorWall);
const anchorDisplay = previousClock.tickToDate(anchorTick); const anchorDisplay = previousClock.tickToDate(anchorTick);
const nextBaseTime = GameClock.baseTimeForProjection(anchorDisplay, anchorTick, nextTickSeconds); const nextBaseTime = GameClock.baseTimeForProjection(anchorDisplay, anchorTick, nextTickSeconds);
const ratio = nextTickSeconds / previousTickSeconds; const nextClock = new GameClock({
const baseTime = this.state.lastTurnTime.getTime(); baseTime: nextBaseTime,
const nextGeneralTimes = new Map( tick: anchorTick,
Array.from(this.generals.values(), (general) => [ mode: this.state.clockMode ?? 'manual',
general.id, wallAnchor: anchorWall,
new Date(baseTime + (general.turnTime.getTime() - baseTime) * ratio), turnSeconds: nextTickSeconds,
]) });
); const lastTurnTick = this.state.lastTurnTick ?? previousClock.dateToTick(this.state.lastTurnTime);
const nextLastTurnTime = nextClock.tickToDate(lastTurnTick);
this.schedule = { entries: [{ startMinute: 0, tickMinutes }] }; this.schedule = { entries: [{ startMinute: 0, tickMinutes }] };
this.state = { this.state = {
...this.state, ...this.state,
tickSeconds: nextTickSeconds, tickSeconds: nextTickSeconds,
clockBaseTime: nextBaseTime, clockBaseTime: nextBaseTime,
clockTick: anchorTick,
clockWallAnchor: new Date(anchorWall.getTime()),
lastTurnTick,
lastTurnTime: nextLastTurnTime,
meta: {
...this.state.meta,
turnterm: tickMinutes,
lastTurnTime: nextLastTurnTime.toISOString(),
},
}; };
this.updateWorldConfig({ turnTermMinutes: tickMinutes });
for (const general of this.generals.values()) { for (const general of this.generals.values()) {
const nextTurnTime = nextGeneralTimes.get(general.id); const turnTick = general.turnTick ?? previousClock.dateToTick(general.turnTime);
if (!nextTurnTime) { const recentWarTick =
throw new Error(`Missing projected turn time for general ${general.id}.`); general.recentWarTick ??
} (general.recentWarTime ? previousClock.dateToTick(general.recentWarTime) : null);
this.updateGeneral(general.id, { turnTime: nextTurnTime }); this.updateGeneral(general.id, {
turnTick,
turnTime: nextClock.tickToDate(turnTick),
recentWarTick,
recentWarTime: recentWarTick === null ? null : nextClock.tickToDate(recentWarTick),
});
} }
if (this.checkpoint) {
const checkpointTick =
this.checkpoint.turnTick ?? previousClock.dateToTick(new Date(this.checkpoint.turnTime));
this.checkpoint = {
...this.checkpoint,
turnTick: checkpointTick,
turnTime: nextClock.tickToDate(checkpointTick).toISOString(),
};
}
return {
changed: true,
previousTurnTermMinutes: previousTickSeconds / 60,
turnTermMinutes: tickMinutes,
previousClockBaseTime,
clockBaseTime: nextBaseTime.toISOString(),
shiftedGenerals: this.generals.size,
lastTurnTime: nextLastTurnTime.toISOString(),
};
} }
pushLog(entry: LogEntryDraft): void { pushLog(entry: LogEntryDraft): void {
@@ -793,6 +867,10 @@ export class InMemoryTurnWorld {
return this.scenarioConfig; return this.scenarioConfig;
} }
getWorldConfig(): Record<string, unknown> {
return this.worldConfig;
}
getUnitSet(): UnitSetDefinition | undefined { getUnitSet(): UnitSetDefinition | undefined {
return this.unitSet; return this.unitSet;
} }
@@ -0,0 +1,244 @@
import { randomUUID } from 'node:crypto';
import {
buildGameEventChannel,
GameClock,
isRecord,
writeTournamentProjection,
type RuntimeAutorunUserOption,
type RuntimeGameSettingsPatch,
type TurnDaemonCommand,
type TurnDaemonCommandResult,
} from '@sammo-ts/common';
import type { GamePrisma, GamePrismaClient } from '@sammo-ts/infra';
import type { GatewayAdminActionRecord, GatewayAdminActionResult } from './gatewayAdminActions.js';
interface RuntimeSettingsRedisClient {
get(key: string): Promise<string | null>;
set(key: string, value: string, options?: { NX?: boolean; PX?: number }): Promise<unknown>;
del(key: string): Promise<unknown>;
eval(script: string, options: { keys: string[]; arguments: string[] }): Promise<unknown>;
publish?(channel: string, message: string): Promise<unknown>;
}
type TournamentClockState = {
nextAt?: string;
bettingCloseAt?: string;
runtimeSettingsActionIds?: string[];
[key: string]: unknown;
};
const TURN_TERMS = new Set([1, 2, 5, 10, 20, 30, 60, 120]);
const AUTORUN_OPTIONS = new Set<RuntimeAutorunUserOption>([
'develop',
'warp',
'recruit',
'recruit_high',
'train',
'battle',
'chief',
]);
const asJson = (value: unknown): GamePrisma.InputJsonValue => value as GamePrisma.InputJsonValue;
const isUniqueConflict = (error: unknown): boolean =>
typeof error === 'object' && error !== null && 'code' in error && error.code === 'P2002';
const sleep = (ms: number): Promise<void> => new Promise((resolve) => setTimeout(resolve, ms));
const normalizeSettings = (value: unknown): RuntimeGameSettingsPatch | null => {
if (!isRecord(value)) return null;
const settings: RuntimeGameSettingsPatch = {};
if (value.turnTermMinutes !== undefined) {
if (!Number.isInteger(value.turnTermMinutes) || !TURN_TERMS.has(value.turnTermMinutes as number)) return null;
settings.turnTermMinutes = value.turnTermMinutes as number;
}
if (value.blockGeneralCreate !== undefined) {
if (![0, 1, 2].includes(value.blockGeneralCreate as number)) return null;
settings.blockGeneralCreate = value.blockGeneralCreate as 0 | 1 | 2;
}
if (value.autorunUser !== undefined) {
if (value.autorunUser === null) {
settings.autorunUser = null;
} else {
if (!isRecord(value.autorunUser)) return null;
const limitMinutes = value.autorunUser.limitMinutes;
const options = value.autorunUser.options;
if (
!Number.isInteger(limitMinutes) ||
(limitMinutes as number) < 1 ||
(limitMinutes as number) > 43200 ||
!Array.isArray(options) ||
options.length === 0 ||
!options.every(
(option): option is RuntimeAutorunUserOption =>
typeof option === 'string' && AUTORUN_OPTIONS.has(option as RuntimeAutorunUserOption)
)
) {
return null;
}
settings.autorunUser = {
limitMinutes: limitMinutes as number,
options: Array.from(new Set(options)),
};
}
}
return Object.keys(settings).length > 0 ? settings : null;
};
const ensureEngineCommand = async (
db: GamePrismaClient,
actionId: string,
settings: RuntimeGameSettingsPatch
): Promise<{ requestId: string; result?: TurnDaemonCommandResult; failed?: string }> => {
const requestId = `gateway-runtime:${actionId}`;
const command: TurnDaemonCommand = {
type: 'updateRuntimeSettings',
requestId,
actionId,
settings,
};
try {
await db.inputEvent.create({
data: {
requestId,
target: 'ENGINE',
eventType: command.type,
payload: asJson(command),
},
});
} catch (error) {
if (!isUniqueConflict(error)) throw error;
const existing = await db.inputEvent.findUniqueOrThrow({
where: { requestId },
select: { eventType: true, payload: true },
});
const payload = existing.payload as Partial<TurnDaemonCommand>;
if (
existing.eventType !== command.type ||
payload.type !== command.type ||
payload.actionId !== actionId ||
JSON.stringify(payload.settings) !== JSON.stringify(settings)
) {
return { requestId, failed: '같은 action ID에 다른 런타임 설정 payload가 이미 존재합니다.' };
}
}
const event = await db.inputEvent.findUniqueOrThrow({
where: { requestId },
select: { status: true, result: true, error: true },
});
if (event.status === 'FAILED') {
return { requestId, failed: event.error ?? '게임 엔진 런타임 설정 변경이 실패했습니다.' };
}
if (event.status !== 'SUCCEEDED') return { requestId };
return { requestId, result: event.result as TurnDaemonCommandResult };
};
const reprojectTournamentClock = async (
redis: RuntimeSettingsRedisClient,
profileName: string,
actionId: string,
result: Extract<TurnDaemonCommandResult, { type: 'updateRuntimeSettings'; ok: true }>
): Promise<boolean> => {
const stateKey = `sammo:${profileName}:tournament:state`;
const sourceKeys = {
stateKey,
sourceRevisionKey: `sammo:${profileName}:tournament:source-revision`,
sourceRevisionChannel: `sammo:${profileName}:tournament:source-changed`,
realtimeEventChannel: buildGameEventChannel(profileName),
};
const lockKey = `${stateKey}:mutation-lock`;
const token = randomUUID();
const deadline = Date.now() + 2_000;
while (Date.now() < deadline) {
const acquired = await redis.set(lockKey, token, { NX: true, PX: 30_000 });
if (acquired) {
try {
const rawState = await redis.get(stateKey);
if (!rawState) return false;
const state = JSON.parse(rawState) as TournamentClockState;
const applied = Array.isArray(state.runtimeSettingsActionIds)
? state.runtimeSettingsActionIds.filter((entry): entry is string => typeof entry === 'string')
: [];
if (applied.includes(actionId)) return true;
const previousClock = new GameClock({
baseTime: new Date(result.previousClockBaseTime),
tick: 0,
mode: 'manual',
wallAnchor: new Date(result.previousClockBaseTime),
turnSeconds: result.previousTurnTermMinutes * 60,
});
const nextClock = new GameClock({
baseTime: new Date(result.clockBaseTime),
tick: 0,
mode: 'manual',
wallAnchor: new Date(result.clockBaseTime),
turnSeconds: result.turnTermMinutes * 60,
});
const reproject = (value: string | undefined): string | undefined => {
if (!value) return value;
const parsed = new Date(value);
if (Number.isNaN(parsed.getTime())) return value;
return nextClock.tickToDate(previousClock.dateToTick(parsed)).toISOString();
};
const nextState: TournamentClockState = {
...state,
nextAt: reproject(state.nextAt),
bettingCloseAt: reproject(state.bettingCloseAt),
runtimeSettingsActionIds: [...applied, actionId],
};
await writeTournamentProjection(redis, sourceKeys, [{ key: stateKey, value: nextState }]);
return true;
} finally {
if ((await redis.get(lockKey)) === token) await redis.del(lockKey);
}
}
await sleep(10);
}
throw new Error('토너먼트 턴 간격 변경 lock을 획득하지 못했습니다.');
};
export const applyRuntimeGameSettings = async (options: {
action: GatewayAdminActionRecord;
profileName: string;
db: GamePrismaClient;
redis?: RuntimeSettingsRedisClient;
}): Promise<GatewayAdminActionResult> => {
const { action, profileName, db, redis } = options;
if (!action.id) return { status: 'FAILED', detail: '런타임 설정 action ID가 없습니다.' };
const settings = normalizeSettings(action.payload?.settings);
if (!settings) return { status: 'FAILED', detail: '런타임 설정 payload가 올바르지 않습니다.' };
const engine = await ensureEngineCommand(db, action.id, settings);
if (engine.failed) return { status: 'FAILED', detail: engine.failed };
if (!engine.result) return { status: 'REQUESTED', detail: `게임 엔진 처리 대기 중: ${engine.requestId}` };
if (engine.result.type !== 'updateRuntimeSettings' || !engine.result.ok) {
return {
status: 'FAILED',
detail:
engine.result.type === 'updateRuntimeSettings'
? engine.result.reason
: '게임 엔진이 다른 결과를 반환했습니다.',
};
}
if (engine.result.termChanged && !redis) {
return {
status: 'PARTIAL',
detail: `DB 설정은 적용됐지만 Redis 토너먼트 시각 동기화를 기다리는 중입니다: ${engine.requestId}`,
};
}
const tournamentReprojected =
engine.result.termChanged && redis
? await reprojectTournamentClock(redis, profileName, action.id, engine.result)
: false;
const summary = [
`${engine.result.turnTermMinutes}`,
settings.blockGeneralCreate === undefined ? null : `장수 생성 ${settings.blockGeneralCreate}`,
settings.autorunUser === undefined
? null
: settings.autorunUser === null
? '유저 자동턴 끔'
: `유저 자동턴 ${settings.autorunUser.limitMinutes}`,
engine.result.termChanged ? `장수 ${engine.result.shiftedGenerals}명 시각 보정` : null,
tournamentReprojected ? '토너먼트 시각 보정' : null,
].filter((entry): entry is string => entry !== null);
return { status: 'APPLIED', detail: summary.join(' · ') };
};
+16 -4
View File
@@ -89,6 +89,7 @@ import { buildCommandEnv } from './reservedTurnCommands.js';
import { DatabaseTurnDaemonLease, TurnDaemonLeaseUnavailableError } from '../lifecycle/databaseTurnDaemonLease.js'; import { DatabaseTurnDaemonLease, TurnDaemonLeaseUnavailableError } from '../lifecycle/databaseTurnDaemonLease.js';
import { EngineStateManager } from './engineStateManager.js'; import { EngineStateManager } from './engineStateManager.js';
import { applyRuntimeClockShift } from './runtimeClockShift.js'; import { applyRuntimeClockShift } from './runtimeClockShift.js';
import { applyRuntimeGameSettings } from './runtimeGameSettings.js';
export interface TurnDaemonRuntimeOptions { export interface TurnDaemonRuntimeOptions {
profile: string; profile: string;
@@ -442,7 +443,7 @@ const createMonthlyCalendarRuntime = async (options: {
profileName: options.profileName, profileName: options.profileName,
getWorld: options.getWorld, getWorld: options.getWorld,
getRedisClient: options.getRedisClient, getRedisClient: options.getRedisClient,
getWorldConfig: () => options.snapshot.worldConfig ?? null, getWorldConfig: () => options.getWorld()?.getWorldConfig() ?? options.snapshot.worldConfig ?? null,
getNationPowerRollCount: () => cache.nationPowerRollCount, getNationPowerRollCount: () => cache.nationPowerRollCount,
getTournamentRollConsumed: () => cache.tournamentRollConsumed, getTournamentRollConsumed: () => cache.tournamentRollConsumed,
now: () => options.getWorld()?.getGameNow(new Date(options.clock.nowMs())) ?? new Date(options.clock.nowMs()), now: () => options.getWorld()?.getGameNow(new Date(options.clock.nowMs())) ?? new Date(options.clock.nowMs()),
@@ -451,7 +452,7 @@ const createMonthlyCalendarRuntime = async (options: {
profileName: options.profileName, profileName: options.profileName,
getWorld: options.getWorld, getWorld: options.getWorld,
getRedisClient: options.getRedisClient, getRedisClient: options.getRedisClient,
getWorldConfig: () => options.snapshot.worldConfig ?? null, getWorldConfig: () => options.getWorld()?.getWorldConfig() ?? options.snapshot.worldConfig ?? null,
getNationPowerRollCount: () => cache.nationPowerRollCount, getNationPowerRollCount: () => cache.nationPowerRollCount,
onTournamentRollConsumed: (consumed) => { onTournamentRollConsumed: (consumed) => {
cache.tournamentRollConsumed = consumed; cache.tournamentRollConsumed = consumed;
@@ -599,6 +600,17 @@ const createStartedAdminActionConsumer = async (options: {
redis: options.redisConnector?.client, redis: options.redisConnector?.client,
}); });
} }
if (action.action === 'UPDATE_RUNTIME_SETTINGS') {
if (!options.commandConnector) {
return { status: 'FAILED', detail: '게임 command database 연결이 없습니다.' };
}
return applyRuntimeGameSettings({
action,
profileName,
db: options.commandConnector.prisma,
redis: options.redisConnector?.client,
});
}
switch (action.action) { switch (action.action) {
case 'RESUME': case 'RESUME':
options.controlQueue.enqueue({ type: 'resume', reason }); options.controlQueue.enqueue({ type: 'resume', reason });
@@ -766,7 +778,6 @@ const createTurnDaemonRuntimeWithLease = async (
const stateStore = new InMemoryTurnStateStore(world); const stateStore = new InMemoryTurnStateStore(world);
let fastForwardPreparedMonth = ''; let fastForwardPreparedMonth = '';
const processor = new InMemoryTurnProcessor(world, { const processor = new InMemoryTurnProcessor(world, {
tickMinutes,
beforeExecuteGeneral: reservedTurnStoreHandle beforeExecuteGeneral: reservedTurnStoreHandle
? async (general) => { ? async (general) => {
if (options.exclusiveFastForward) { if (options.exclusiveFastForward) {
@@ -959,7 +970,8 @@ const createTurnDaemonRuntimeWithLease = async (
{ {
clock, clock,
controlQueue: resolvedControlQueue, controlQueue: resolvedControlQueue,
getNextTickTime: (lastTurnTime) => getNextTickTime(lastTurnTime, tickMinutes), getNextTickTime: (lastTurnTime) =>
getNextTickTime(lastTurnTime, Math.max(1, Math.round(world.getState().tickSeconds / 60))),
stateStore, stateStore,
processor, processor,
hooks, hooks,
+134 -1
View File
@@ -5,7 +5,14 @@ import type {
TurnDaemonCommandResult, TurnDaemonCommandResult,
} from '../lifecycle/types.js'; } from '../lifecycle/types.js';
import { GamePrisma, type DatabaseClient } from '@sammo-ts/infra'; import { GamePrisma, type DatabaseClient } from '@sammo-ts/infra';
import { asRecord, isCanonicalIsoTimestamp, JosaUtil, LiteHashDRBG, RandUtil } from '@sammo-ts/common'; import {
asRecord,
GAME_TICKS_PER_TURN,
isCanonicalIsoTimestamp,
JosaUtil,
LiteHashDRBG,
RandUtil,
} from '@sammo-ts/common';
import { import {
LogCategory, LogCategory,
LogFormat, LogFormat,
@@ -921,6 +928,130 @@ async function handleShiftSchedule(
}; };
} }
async function handleUpdateRuntimeSettings(
ctx: CommandHandlerContext,
command: Extract<TurnDaemonCommand, { type: 'updateRuntimeSettings' }>
): Promise<TurnDaemonCommandResult> {
if (!ctx.commandDb) {
return {
type: 'updateRuntimeSettings',
ok: false,
actionId: command.actionId,
reason: '런타임 설정 변경은 데이터베이스 transaction 경계에서만 실행할 수 있습니다.',
};
}
const operationalAcceptedAt = await resolveOperationalAcceptedAt(ctx.commandDb, command);
if (command.settings.blockGeneralCreate !== undefined) {
ctx.world.updateWorldConfig({ blockGeneralCreate: command.settings.blockGeneralCreate });
}
if (command.settings.autorunUser !== undefined) {
ctx.world.updateWorldMeta({
autorun_user:
command.settings.autorunUser === null
? null
: {
limit_minutes: command.settings.autorunUser.limitMinutes,
options: Object.fromEntries(
command.settings.autorunUser.options.map((option) => [option, true])
),
},
});
}
const currentState = ctx.world.getState();
const currentTermMinutes = Math.max(1, Math.round(currentState.tickSeconds / 60));
const term =
command.settings.turnTermMinutes === undefined
? {
changed: false,
previousTurnTermMinutes: currentTermMinutes,
turnTermMinutes: currentTermMinutes,
previousClockBaseTime: (currentState.clockBaseTime ?? currentState.lastTurnTime).toISOString(),
clockBaseTime: (currentState.clockBaseTime ?? currentState.lastTurnTime).toISOString(),
shiftedGenerals: 0,
lastTurnTime: currentState.lastTurnTime.toISOString(),
}
: ctx.world.changeTurnTerm(command.settings.turnTermMinutes, operationalAcceptedAt);
let reprojectedAuctions = 0;
let reprojectedMessages = 0;
let reprojectedVotes = 0;
if (term.changed) {
const ticksPerSecond = BigInt(GAME_TICKS_PER_TURN / (term.turnTermMinutes * 60));
const baseTime = new Date(term.clockBaseTime);
reprojectedAuctions = await ctx.commandDb.$executeRaw(
GamePrisma.sql`
UPDATE auction
SET close_at = CAST(${baseTime} AS timestamp)
+ (close_tick / ${ticksPerSecond}) * INTERVAL '1 second'
+ (((close_tick % ${ticksPerSecond}) * 1000) / ${ticksPerSecond}) * INTERVAL '1 millisecond',
updated_at = NOW()
WHERE close_tick IS NOT NULL
`
);
reprojectedMessages = await ctx.commandDb.$executeRaw(
GamePrisma.sql`
UPDATE message
SET time = CASE
WHEN time_tick IS NULL THEN time
ELSE CAST(${baseTime} AS timestamp)
+ (time_tick / ${ticksPerSecond}) * INTERVAL '1 second'
+ (((time_tick % ${ticksPerSecond}) * 1000) / ${ticksPerSecond}) * INTERVAL '1 millisecond'
END,
valid_until = CASE
WHEN valid_until_tick IS NULL THEN valid_until
ELSE CAST(${baseTime} AS timestamp)
+ (valid_until_tick / ${ticksPerSecond}) * INTERVAL '1 second'
+ (((valid_until_tick % ${ticksPerSecond}) * 1000) / ${ticksPerSecond}) * INTERVAL '1 millisecond'
END
WHERE time_tick IS NOT NULL OR valid_until_tick IS NOT NULL
`
);
reprojectedVotes = await ctx.commandDb.$executeRaw(
GamePrisma.sql`
UPDATE vote_poll
SET start_at = CASE
WHEN start_tick IS NULL THEN start_at
ELSE CAST(${baseTime} AS timestamp)
+ (start_tick / ${ticksPerSecond}) * INTERVAL '1 second'
+ (((start_tick % ${ticksPerSecond}) * 1000) / ${ticksPerSecond}) * INTERVAL '1 millisecond'
END,
end_at = CASE
WHEN end_tick IS NULL THEN end_at
ELSE CAST(${baseTime} AS timestamp)
+ (end_tick / ${ticksPerSecond}) * INTERVAL '1 second'
+ (((end_tick % ${ticksPerSecond}) * 1000) / ${ticksPerSecond}) * INTERVAL '1 millisecond'
END
WHERE start_tick IS NOT NULL OR end_tick IS NOT NULL
`
);
ctx.world.pushLog({
scope: LogScope.SYSTEM,
category: LogCategory.HISTORY,
text: `<R>★</>턴시간이 <C>${term.turnTermMinutes}분</>으로 변경됩니다.`,
});
}
return {
type: 'updateRuntimeSettings',
ok: true,
actionId: command.actionId,
settings: command.settings,
termChanged: term.changed,
previousTurnTermMinutes: term.previousTurnTermMinutes,
turnTermMinutes: term.turnTermMinutes,
previousClockBaseTime: term.previousClockBaseTime,
clockBaseTime: term.clockBaseTime,
lastTurnTime: term.lastTurnTime,
shiftedGenerals: term.shiftedGenerals,
reprojectedAuctions,
reprojectedMessages,
reprojectedVotes,
checkpoint: ctx.world.getCheckpoint(),
};
}
async function handleTroopJoin( async function handleTroopJoin(
ctx: CommandHandlerContext, ctx: CommandHandlerContext,
command: Extract<TurnDaemonCommand, { type: 'troopJoin' }> command: Extract<TurnDaemonCommand, { type: 'troopJoin' }>
@@ -2505,6 +2636,8 @@ export const createTurnDaemonCommandHandler = (options: {
handleSelectPoolReselect(ctx, command as Extract<TurnDaemonCommand, { type: 'selectPoolReselect' }>), handleSelectPoolReselect(ctx, command as Extract<TurnDaemonCommand, { type: 'selectPoolReselect' }>),
shiftSchedule: (command) => shiftSchedule: (command) =>
handleShiftSchedule(ctx, command as Extract<TurnDaemonCommand, { type: 'shiftSchedule' }>), handleShiftSchedule(ctx, command as Extract<TurnDaemonCommand, { type: 'shiftSchedule' }>),
updateRuntimeSettings: (command) =>
handleUpdateRuntimeSettings(ctx, command as Extract<TurnDaemonCommand, { type: 'updateRuntimeSettings' }>),
}; };
return { return {
@@ -127,6 +127,7 @@ describe('durable read-model change journal mapping', () => {
const world = { const world = {
getState: () => ({ ...state, meta: { ...state.meta } }), getState: () => ({ ...state, meta: { ...state.meta } }),
getScenarioConfig: () => config, getScenarioConfig: () => config,
getWorldConfig: () => config,
} as unknown as InMemoryTurnWorld; } as unknown as InMemoryTurnWorld;
const baseline = createWorldReadModelSignature(world); const baseline = createWorldReadModelSignature(world);
@@ -3,6 +3,8 @@ import { describe, expect, it, vi } from 'vitest';
import type { GamePrismaClient } from '@sammo-ts/infra'; import type { GamePrismaClient } from '@sammo-ts/infra';
import { InMemoryTurnWorld } from '../src/turn/inMemoryWorld.js'; import { InMemoryTurnWorld } from '../src/turn/inMemoryWorld.js';
import { applyRuntimeClockShift } from '../src/turn/runtimeClockShift.js'; import { applyRuntimeClockShift } from '../src/turn/runtimeClockShift.js';
import { applyRuntimeGameSettings } from '../src/turn/runtimeGameSettings.js';
import { createTurnDaemonCommandHandler } from '../src/turn/worldCommandHandler.js';
import type { TurnGeneral, TurnWorldSnapshot, TurnWorldState } from '../src/turn/types.js'; import type { TurnGeneral, TurnWorldSnapshot, TurnWorldState } from '../src/turn/types.js';
const buildGeneral = (id: number, turnTime: string): TurnGeneral => const buildGeneral = (id: number, turnTime: string): TurnGeneral =>
@@ -160,6 +162,107 @@ describe('runtime clock shift', () => {
}); });
}); });
describe('runtime turn term change', () => {
it('preserves the current game display while reprojecting tick-owned dates', () => {
const wallAnchor = new Date('2026-07-30T10:00:00.000Z');
const changedAt = new Date('2026-07-30T10:05:00.000Z');
const world = buildWorld({
clockBaseTime: wallAnchor,
clockTick: 0,
clockMode: 'realtime',
clockWallAnchor: wallAnchor,
lastTurnTick: 0,
});
world.setCheckpoint({
turnTime: '2026-07-30T10:10:00.000Z',
turnTick: 36_000_000,
generalId: 1,
year: 190,
month: 1,
});
const before = world.getGameNow(changedAt);
const result = world.changeTurnTerm(20, changedAt);
expect(result).toMatchObject({
changed: true,
previousTurnTermMinutes: 10,
turnTermMinutes: 20,
previousClockBaseTime: '2026-07-30T10:00:00.000Z',
clockBaseTime: '2026-07-30T09:55:00.000Z',
lastTurnTime: '2026-07-30T09:55:00.000Z',
shiftedGenerals: 2,
});
expect(world.getGameNow(changedAt)).toEqual(before);
expect(world.getGeneralById(1)?.turnTime.toISOString()).toBe('2026-07-30T10:15:00.000Z');
expect(world.getGeneralById(1)?.turnTick).toBe(36_000_000);
expect(world.getCheckpoint()?.turnTime).toBe('2026-07-30T10:15:00.000Z');
expect(world.getState()).toMatchObject({
tickSeconds: 1200,
clockTick: 18_000_000,
lastTurnTick: 0,
});
expect(world.getWorldConfig()).toMatchObject({ turnTermMinutes: 20 });
});
it('updates all three live settings and only emits a new history log', async () => {
const changedAt = new Date('2026-07-30T10:05:00.000Z');
const world = buildWorld({
clockBaseTime: new Date('2026-07-30T10:00:00.000Z'),
clockTick: 0,
clockMode: 'realtime',
clockWallAnchor: new Date('2026-07-30T10:00:00.000Z'),
lastTurnTick: 0,
});
const executeRaw = vi.fn(async () => 1);
const db = {
inputEvent: {
findUnique: vi.fn(async () => ({
createdAt: changedAt,
target: 'ENGINE',
eventType: 'updateRuntimeSettings',
})),
},
$executeRaw: executeRaw,
} as unknown as GamePrismaClient;
const handler = createTurnDaemonCommandHandler({ world });
const result = await handler.handle(
{
type: 'updateRuntimeSettings',
requestId: 'runtime-settings:test',
actionId: 'action-test',
settings: {
turnTermMinutes: 20,
blockGeneralCreate: 2,
autorunUser: { limitMinutes: 720, options: ['develop', 'recruit_high', 'chief'] },
},
},
{ db }
);
expect(result).toMatchObject({
type: 'updateRuntimeSettings',
ok: true,
termChanged: true,
reprojectedAuctions: 1,
reprojectedMessages: 1,
reprojectedVotes: 1,
});
expect(executeRaw).toHaveBeenCalledTimes(3);
expect(world.getWorldConfig()).toMatchObject({ turnTermMinutes: 20, blockGeneralCreate: 2 });
expect(world.getState().meta).toMatchObject({
autorun_user: {
limit_minutes: 720,
options: { develop: true, recruit_high: true, chief: true },
},
});
expect(world.peekDirtyState().logs).toEqual([
expect.objectContaining({ text: '<R>★</>턴시간이 <C>20분</>으로 변경됩니다.' }),
]);
});
});
describe('runtime clock shift projection', () => { describe('runtime clock shift projection', () => {
it('waits for the durable engine event and applies Redis projections idempotently', async () => { it('waits for the durable engine event and applies Redis projections idempotently', async () => {
const actionId = '68f1f0e4-3b95-4aeb-9925-c7e93caf1ba7'; const actionId = '68f1f0e4-3b95-4aeb-9925-c7e93caf1ba7';
@@ -285,3 +388,126 @@ describe('runtime clock shift projection', () => {
expect(inputEventCreate).toHaveBeenCalledTimes(3); expect(inputEventCreate).toHaveBeenCalledTimes(3);
}); });
}); });
describe('runtime game settings projection', () => {
it('waits for the engine result and reprojects tournament tick dates idempotently', async () => {
const actionId = '98f1f0e4-3b95-4aeb-9925-c7e93caf1ba7';
let eventStatus: 'PENDING' | 'SUCCEEDED' = 'PENDING';
let created = false;
const db = {
inputEvent: {
create: vi.fn(async () => {
if (created) throw { code: 'P2002' };
created = true;
return {};
}),
findUniqueOrThrow: vi.fn(async () =>
eventStatus === 'PENDING'
? {
eventType: 'updateRuntimeSettings',
payload: {
type: 'updateRuntimeSettings',
actionId,
settings: {
turnTermMinutes: 20,
blockGeneralCreate: 2,
autorunUser: { limitMinutes: 720, options: ['develop', 'chief'] },
},
},
status: 'PENDING',
result: null,
error: null,
}
: {
eventType: 'updateRuntimeSettings',
payload: {
type: 'updateRuntimeSettings',
actionId,
settings: {
turnTermMinutes: 20,
blockGeneralCreate: 2,
autorunUser: { limitMinutes: 720, options: ['develop', 'chief'] },
},
},
status: 'SUCCEEDED',
result: {
type: 'updateRuntimeSettings',
ok: true,
actionId,
settings: {
turnTermMinutes: 20,
blockGeneralCreate: 2,
autorunUser: { limitMinutes: 720, options: ['develop', 'chief'] },
},
termChanged: true,
previousTurnTermMinutes: 10,
turnTermMinutes: 20,
previousClockBaseTime: '2026-07-30T10:00:00.000Z',
clockBaseTime: '2026-07-30T09:55:00.000Z',
lastTurnTime: '2026-07-30T09:55:00.000Z',
shiftedGenerals: 2,
reprojectedAuctions: 1,
reprojectedMessages: 1,
reprojectedVotes: 1,
},
error: null,
}
),
},
} as unknown as GamePrismaClient;
const stateKey = 'sammo:hwe:default:tournament:state';
const values = new Map<string, string>([
[
stateKey,
JSON.stringify({
stage: 1,
nextAt: '2026-07-30T10:10:00.000Z',
bettingCloseAt: '2026-07-30T10:05:00.000Z',
}),
],
]);
const redis = {
get: async (key: string) => values.get(key) ?? null,
set: async (key: string, value: string, options?: { NX?: boolean }) => {
if (options?.NX && values.has(key)) return null;
values.set(key, value);
return 'OK';
},
del: async (key: string) => (values.delete(key) ? 1 : 0),
eval: async (_script: string, options: { keys: string[]; arguments: string[] }) => {
options.arguments.forEach((value, index) => values.set(options.keys[index]!, value));
return '1';
},
};
const action = {
id: actionId,
profileName: 'hwe:default',
action: 'UPDATE_RUNTIME_SETTINGS',
durationMinutes: null,
payload: {
settings: {
turnTermMinutes: 20,
blockGeneralCreate: 2,
autorunUser: { limitMinutes: 720, options: ['develop', 'chief'] },
},
},
};
await expect(
applyRuntimeGameSettings({ action, profileName: 'hwe:default', db, redis })
).resolves.toMatchObject({ status: 'REQUESTED' });
eventStatus = 'SUCCEEDED';
await expect(
applyRuntimeGameSettings({ action, profileName: 'hwe:default', db, redis })
).resolves.toMatchObject({ status: 'APPLIED' });
await expect(
applyRuntimeGameSettings({ action, profileName: 'hwe:default', db, redis })
).resolves.toMatchObject({ status: 'APPLIED' });
expect(JSON.parse(values.get(stateKey) ?? '{}')).toMatchObject({
nextAt: '2026-07-30T10:15:00.000Z',
bettingCloseAt: '2026-07-30T10:05:00.000Z',
runtimeSettingsActionIds: [actionId],
});
});
});
@@ -17,7 +17,10 @@ const databaseUrl = process.env.INPUT_EVENT_DATABASE_URL;
const integration = describe.skipIf(!databaseUrl); const integration = describe.skipIf(!databaseUrl);
const requestId = 'integration:engine:runtime-clock-shift'; const requestId = 'integration:engine:runtime-clock-shift';
const actionId = 'b9f68480-dba9-4e03-a62b-499e6234f18a'; const actionId = 'b9f68480-dba9-4e03-a62b-499e6234f18a';
const generalIds = [990_301, 990_302] as const; const runtimeSettingsRequestId = 'integration:engine:runtime-game-settings';
const runtimeSettingsActionId = 'c9f68480-dba9-4e03-a62b-499e6234f18a';
const generalIds = [990_301, 990_302, 990_303] as const;
const runtimeSettingsLogText = 'runtime-settings-existing-log';
const buildGeneral = (id: number, turnTime: Date): TurnGeneral => const buildGeneral = (id: number, turnTime: Date): TurnGeneral =>
({ ({
@@ -50,16 +53,23 @@ const buildGeneral = (id: number, turnTime: Date): TurnGeneral =>
npcState: 0, npcState: 0,
}) as TurnGeneral; }) as TurnGeneral;
const waitForSucceeded = async (db: GamePrismaClient): Promise<void> => { const waitForSucceeded = async (db: GamePrismaClient, targetRequestId = requestId): Promise<void> => {
const deadline = Date.now() + 5_000; const deadline = Date.now() + 5_000;
while (Date.now() < deadline) { while (Date.now() < deadline) {
const event = await db.inputEvent.findUnique({ where: { requestId }, select: { status: true } }); const event = await db.inputEvent.findUnique({
where: { requestId: targetRequestId },
select: { status: true },
});
if (event?.status === 'SUCCEEDED') { if (event?.status === 'SUCCEEDED') {
return; return;
} }
await new Promise((resolve) => setTimeout(resolve, 25)); await new Promise((resolve) => setTimeout(resolve, 25));
} }
throw new Error('runtime clock shift input event did not complete'); const event = await db.inputEvent.findUnique({
where: { requestId: targetRequestId },
select: { status: true, error: true, attempts: true },
});
throw new Error(`runtime input event did not complete: ${JSON.stringify(event)}`);
}; };
integration('runtime clock shift persistence', () => { integration('runtime clock shift persistence', () => {
@@ -71,17 +81,27 @@ integration('runtime clock shift persistence', () => {
await connector.connect(); await connector.connect();
db = connector.prisma; db = connector.prisma;
closeDb = () => connector.disconnect(); closeDb = () => connector.disconnect();
await db.inputEvent.deleteMany({ where: { requestId } }); await db.inputEvent.deleteMany({ where: { requestId: { in: [requestId, runtimeSettingsRequestId] } } });
await db.votePoll.deleteMany({ where: { openerGeneralId: generalIds[2] } });
await db.message.deleteMany({ where: { mailbox: generalIds[2] } });
await db.logEntry.deleteMany({ where: { text: runtimeSettingsLogText } });
await db.auction.deleteMany({ where: { hostGeneralId: { in: [...generalIds] } } }); await db.auction.deleteMany({ where: { hostGeneralId: { in: [...generalIds] } } });
await db.general.deleteMany({ where: { id: { in: [...generalIds] } } }); await db.general.deleteMany({ where: { id: { in: [...generalIds] } } });
await db.worldState.deleteMany({ where: { scenarioCode: 'runtime-clock-shift' } }); await db.worldState.deleteMany({
where: { scenarioCode: { in: ['runtime-clock-shift', 'runtime-game-settings'] } },
});
}); });
afterAll(async () => { afterAll(async () => {
await db.inputEvent.deleteMany({ where: { requestId } }); await db.inputEvent.deleteMany({ where: { requestId: { in: [requestId, runtimeSettingsRequestId] } } });
await db.votePoll.deleteMany({ where: { openerGeneralId: generalIds[2] } });
await db.message.deleteMany({ where: { mailbox: generalIds[2] } });
await db.logEntry.deleteMany({ where: { text: runtimeSettingsLogText } });
await db.auction.deleteMany({ where: { hostGeneralId: { in: [...generalIds] } } }); await db.auction.deleteMany({ where: { hostGeneralId: { in: [...generalIds] } } });
await db.general.deleteMany({ where: { id: { in: [...generalIds] } } }); await db.general.deleteMany({ where: { id: { in: [...generalIds] } } });
await db.worldState.deleteMany({ where: { scenarioCode: 'runtime-clock-shift' } }); await db.worldState.deleteMany({
where: { scenarioCode: { in: ['runtime-clock-shift', 'runtime-game-settings'] } },
});
await closeDb?.(); await closeDb?.();
}); });
@@ -126,7 +146,7 @@ integration('runtime clock shift persistence', () => {
db.auction.create({ db.auction.create({
data: { data: {
type: 'BUY_RICE', type: 'BUY_RICE',
hostGeneralId: generalIds[index % generalIds.length]!, hostGeneralId: generals[index % generals.length]!.id,
detail: {}, detail: {},
status, status,
closeAt: new Date(`2099-07-30T1${index}:00:00.000Z`), closeAt: new Date(`2099-07-30T1${index}:00:00.000Z`),
@@ -278,4 +298,250 @@ integration('runtime clock shift persistence', () => {
await db.worldState.delete({ where: { id: row.id } }); await db.worldState.delete({ where: { id: row.id } });
}); });
it('reprojects tick-owned dates for a live turn-term change without rewriting existing log timestamps', async () => {
const base = new Date('2099-08-01T10:00:00.000Z');
const row = await db.worldState.create({
data: {
scenarioCode: 'runtime-game-settings',
currentYear: 191,
currentMonth: 2,
tickSeconds: 600,
clockBaseTime: base,
clockTick: 0,
clockMode: 'manual',
clockWallAnchor: base,
lastTurnTick: 0,
config: { turnTermMinutes: 10, blockGeneralCreate: 0 },
meta: { lastTurnTime: base.toISOString(), turnterm: 10 },
},
});
const general = {
...buildGeneral(generalIds[2], new Date('2099-08-01T10:10:00.000Z')),
turnTick: GAME_TICKS_PER_TURN,
recentWarTime: new Date('2099-08-01T10:05:00.000Z'),
recentWarTick: GAME_TICKS_PER_TURN / 2,
};
await db.general.create({
data: {
id: general.id,
name: general.name,
nationId: general.nationId,
cityId: general.cityId,
troopId: general.troopId,
turnTime: general.turnTime,
turnTick: BigInt(general.turnTick),
recentWarTime: general.recentWarTime,
recentWarTick: BigInt(general.recentWarTick),
},
});
const auction = await db.auction.create({
data: {
type: 'BUY_RICE',
hostGeneralId: general.id,
detail: {},
status: 'OPEN',
closeAt: new Date('2099-08-01T10:10:00.000Z'),
closeTick: BigInt(GAME_TICKS_PER_TURN),
},
});
const message = await db.message.create({
data: {
mailbox: general.id,
type: 'runtime-settings-test',
src: 0,
dest: general.id,
time: new Date('2099-08-01T10:05:00.000Z'),
timeTick: BigInt(GAME_TICKS_PER_TURN / 2),
validUntil: new Date('2099-08-01T10:10:00.000Z'),
validUntilTick: BigInt(GAME_TICKS_PER_TURN),
message: {},
},
});
const vote = await db.votePoll.create({
data: {
title: 'runtime settings test',
options: ['yes', 'no'],
revealMode: 'ALWAYS',
openerGeneralId: general.id,
openerName: general.name,
startAt: new Date('2099-08-01T10:05:00.000Z'),
startTick: BigInt(GAME_TICKS_PER_TURN / 2),
endAt: new Date('2099-08-01T10:10:00.000Z'),
endTick: BigInt(GAME_TICKS_PER_TURN),
},
});
const originalLogTime = new Date('2026-01-02T03:04:05.000Z');
const existingLog = await db.logEntry.create({
data: {
scope: 'SYSTEM',
category: 'HISTORY',
year: 191,
month: 2,
text: runtimeSettingsLogText,
createdAt: originalLogTime,
},
});
const state: TurnWorldState = {
id: row.id,
currentYear: 191,
currentMonth: 2,
tickSeconds: 600,
lastTurnTime: base,
clockBaseTime: base,
clockTick: 0,
clockMode: 'manual',
clockWallAnchor: base,
lastTurnTick: 0,
meta: row.meta as Record<string, unknown>,
};
const snapshot: TurnWorldSnapshot = {
scenarioConfig: {
stat: { total: 300, min: 10, max: 100, npcTotal: 150, npcMax: 50, npcMin: 10, chiefMin: 70 },
iconPath: '',
map: {},
const: {},
environment: { mapName: 'test', unitSet: 'default' },
},
worldConfig: row.config as Record<string, unknown>,
map: {
id: 'test',
name: 'test',
cities: [],
defaults: { trust: 50, trade: 100, supplyState: 1, frontState: 0 },
},
generals: [general],
cities: [],
nations: [],
troops: [],
diplomacy: [],
events: [],
initialEvents: [],
};
const world = new InMemoryTurnWorld(state, snapshot, {
schedule: { entries: [{ startMinute: 0, tickMinutes: 10 }] },
});
const stateStore = new InMemoryTurnStateStore(world);
await stateStore.saveCheckpoint({
turnTime: base.toISOString(),
turnTick: 0,
generalId: 0,
year: 191,
month: 2,
});
const hooks = await createDatabaseTurnHooks(databaseUrl!, world);
const queue = new DatabaseTurnDaemonCommandQueue(db);
await queue.initialize();
const stateManager = new EngineStateManager();
stateManager.register('world', {
capture: () => world.captureState(),
restore: (saved) => world.restoreState(saved),
});
const lifecycle = new TurnDaemonLifecycle(
{
clock: new SystemClock(),
controlQueue: queue,
commandResponder: queue,
commandHandler: createTurnDaemonCommandHandler({ world }),
hooks: hooks.hooks,
stateManager,
stateStore,
getNextTickTime: (lastTurnTime) =>
getNextTickTime(lastTurnTime, Math.max(1, Math.round(world.getState().tickSeconds / 60))),
processor: {
run: async () => ({
lastTurnTime: world.getState().lastTurnTime.toISOString(),
processedGenerals: 0,
processedTurns: 0,
durationMs: 0,
partial: false,
}),
},
},
{
profile: 'integration',
defaultBudget: { budgetMs: 1000, maxGenerals: 10, catchUpCap: 1 },
}
);
await db.inputEvent.create({
data: {
requestId: runtimeSettingsRequestId,
target: 'ENGINE',
eventType: 'updateRuntimeSettings',
payload: {
type: 'updateRuntimeSettings',
requestId: runtimeSettingsRequestId,
actionId: runtimeSettingsActionId,
settings: {
turnTermMinutes: 20,
blockGeneralCreate: 2,
autorunUser: {
limitMinutes: 720,
options: ['develop', 'recruit_high', 'chief'],
},
},
} as GamePrisma.InputJsonValue,
},
});
const loop = lifecycle.start();
try {
await waitForSucceeded(db, runtimeSettingsRequestId);
} finally {
await lifecycle.stop('test complete');
await loop;
await hooks.close();
}
const storedWorld = await db.worldState.findUniqueOrThrow({ where: { id: row.id } });
expect(storedWorld).toMatchObject({ tickSeconds: 1200, clockBaseTime: base, lastTurnTick: 0n });
expect(storedWorld.config).toMatchObject({ turnTermMinutes: 20, blockGeneralCreate: 2 });
expect(storedWorld.meta).toMatchObject({
turnterm: 20,
autorun_user: {
limit_minutes: 720,
options: { develop: true, recruit_high: true, chief: true },
},
});
expect(await db.general.findUniqueOrThrow({ where: { id: general.id } })).toMatchObject({
turnTime: new Date('2099-08-01T10:20:00.000Z'),
turnTick: BigInt(GAME_TICKS_PER_TURN),
recentWarTime: new Date('2099-08-01T10:10:00.000Z'),
});
expect((await db.auction.findUniqueOrThrow({ where: { id: auction.id } })).closeAt).toEqual(
new Date('2099-08-01T10:20:00.000Z')
);
expect(await db.message.findUniqueOrThrow({ where: { id: message.id } })).toMatchObject({
time: new Date('2099-08-01T10:10:00.000Z'),
validUntil: new Date('2099-08-01T10:20:00.000Z'),
});
expect(await db.votePoll.findUniqueOrThrow({ where: { id: vote.id } })).toMatchObject({
startAt: new Date('2099-08-01T10:10:00.000Z'),
endAt: new Date('2099-08-01T10:20:00.000Z'),
});
expect(await db.logEntry.findUniqueOrThrow({ where: { id: existingLog.id } })).toMatchObject({
text: runtimeSettingsLogText,
createdAt: originalLogTime,
});
expect(await db.logEntry.findFirst({ where: { text: { contains: '턴시간이 <C>20분' } } })).not.toBeNull();
expect(lifecycle.getStatus().nextTurnTime).toBe('2099-08-01T10:20:00.000Z');
expect(await db.inputEvent.findUniqueOrThrow({ where: { requestId: runtimeSettingsRequestId } })).toMatchObject(
{
status: 'SUCCEEDED',
result: {
type: 'updateRuntimeSettings',
ok: true,
actionId: runtimeSettingsActionId,
termChanged: true,
previousTurnTermMinutes: 10,
turnTermMinutes: 20,
shiftedGenerals: 1,
reprojectedAuctions: 1,
reprojectedMessages: 1,
reprojectedVotes: 1,
},
}
);
});
}); });
+1
View File
@@ -124,6 +124,7 @@ export const resolveAdminActionCapability = (path: string, rawInput?: unknown):
const action = (rawInput as { action?: unknown }).action; const action = (rawInput as { action?: unknown }).action;
if (action === 'RESET_SCHEDULED') return 'admin.reset.schedule'; if (action === 'RESET_SCHEDULED') return 'admin.reset.schedule';
if (action === 'RESUME') return 'admin.resume.when-stopped'; if (action === 'RESUME') return 'admin.resume.when-stopped';
if (action === 'UPDATE_RUNTIME_SETTINGS') return 'admin.profiles.runtime';
if (action === 'OPEN_SURVEY') return 'admin.survey.open'; if (action === 'OPEN_SURVEY') return 'admin.survey.open';
} }
if (path.endsWith('.operations.requestDeploy')) return 'admin.profiles.deploy'; if (path.endsWith('.operations.requestDeploy')) return 'admin.profiles.deploy';
+63 -3
View File
@@ -41,6 +41,7 @@ const zServerAction = z.enum([
'STOP', 'STOP',
'ACCELERATE', 'ACCELERATE',
'DELAY', 'DELAY',
'UPDATE_RUNTIME_SETTINGS',
'RESET_NOW', 'RESET_NOW',
'RESET_SCHEDULED', 'RESET_SCHEDULED',
'OPEN_SURVEY', 'OPEN_SURVEY',
@@ -440,6 +441,30 @@ const zInstallAutorun = z.object({
}); });
const isAllowedTurnTerm = (value: number): boolean => TURN_TERM_MINUTES.some((term) => term === value); const isAllowedTurnTerm = (value: number): boolean => TURN_TERM_MINUTES.some((term) => term === value);
const zRuntimeSettings = z
.object({
turnTermMinutes: z
.number()
.int()
.refine((value) => isAllowedTurnTerm(value), {
message: 'turnTermMinutes must divide 120.',
})
.optional(),
blockGeneralCreate: z.union([z.literal(0), z.literal(1), z.literal(2)]).optional(),
autorunUser: z
.object({
limitMinutes: z.number().int().min(1).max(43200),
options: z.array(z.enum(AUTORUN_USER_OPTIONS)).min(1),
})
.nullable()
.optional(),
})
.strict()
.refine((settings) => Object.values(settings).some((value) => value !== undefined), {
message: 'At least one runtime setting is required.',
});
const isUniqueConstraintError = (error: unknown): boolean => const isUniqueConstraintError = (error: unknown): boolean =>
Boolean(error && typeof error === 'object' && 'code' in error && error.code === 'P2002'); Boolean(error && typeof error === 'object' && 'code' in error && error.code === 'P2002');
@@ -1596,7 +1621,7 @@ export const adminRouter = router({
canReadProfile(adminAuth, profile.profileName) canReadProfile(adminAuth, profile.profileName)
); );
const profileNames = profiles.map((profile) => profile.profileName); const profileNames = profiles.map((profile) => profile.profileName);
const [runtimeActions, activeOperations] = await Promise.all([ const [runtimeActions, activeOperations, runtimeSettings] = await Promise.all([
ctx.prisma.gatewayRuntimeAction.findMany({ ctx.prisma.gatewayRuntimeAction.findMany({
where: { profileName: { in: profileNames } }, where: { profileName: { in: profileNames } },
orderBy: { createdAt: 'desc' }, orderBy: { createdAt: 'desc' },
@@ -1608,6 +1633,7 @@ export const adminRouter = router({
}, },
select: { id: true, profileName: true, status: true }, select: { id: true, profileName: true, status: true },
}), }),
ctx.orchestrator.listRuntimeSettings?.(profileNames) ?? Promise.resolve([]),
]); ]);
const activeOperationByProfile = new Map( const activeOperationByProfile = new Map(
activeOperations.map((operation) => [operation.profileName, operation]) activeOperations.map((operation) => [operation.profileName, operation])
@@ -1624,9 +1650,11 @@ export const adminRouter = router({
profiles.map((profile) => profile.profileName) profiles.map((profile) => profile.profileName)
); );
const runtimeMap = new Map(runtimeStates.map((state) => [state.profileName, state])); const runtimeMap = new Map(runtimeStates.map((state) => [state.profileName, state]));
const runtimeSettingsMap = new Map(runtimeSettings.map((settings) => [settings.profileName, settings]));
return profiles.map((profile) => ({ return profiles.map((profile) => ({
...profile, ...profile,
runtimeActions: runtimeActionsByProfile.get(profile.profileName) ?? [], runtimeActions: runtimeActionsByProfile.get(profile.profileName) ?? [],
runtimeSettings: runtimeSettingsMap.get(profile.profileName) ?? null,
activeOperation: activeOperationByProfile.get(profile.profileName) ?? null, activeOperation: activeOperationByProfile.get(profile.profileName) ?? null,
runtime: runtimeMap.get(profile.profileName) ?? { runtime: runtimeMap.get(profile.profileName) ?? {
profileName: profile.profileName, profileName: profile.profileName,
@@ -2014,6 +2042,7 @@ export const adminRouter = router({
profileName: z.string().min(1), profileName: z.string().min(1),
action: zServerAction, action: zServerAction,
durationMinutes: z.number().int().min(1).max(1440).optional(), durationMinutes: z.number().int().min(1).max(1440).optional(),
runtimeSettings: zRuntimeSettings.optional(),
scheduledAt: z.string().datetime().optional(), scheduledAt: z.string().datetime().optional(),
reason: z.string().max(200).optional(), reason: z.string().max(200).optional(),
}) })
@@ -2032,6 +2061,19 @@ export const adminRouter = router({
message: 'durationMinutes is required for acceleration or delay.', message: 'durationMinutes is required for acceleration or delay.',
}); });
} }
if (input.action === 'UPDATE_RUNTIME_SETTINGS') {
if (!input.runtimeSettings) {
throw new TRPCError({ code: 'BAD_REQUEST', message: 'runtimeSettings is required.' });
}
if (!input.reason || input.reason.trim().length < 3) {
throw new TRPCError({ code: 'BAD_REQUEST', message: '변경 사유를 입력해 주세요.' });
}
} else if (input.runtimeSettings) {
throw new TRPCError({
code: 'BAD_REQUEST',
message: 'runtimeSettings is not valid for this action.',
});
}
if (input.scheduledAt) { if (input.scheduledAt) {
throw new TRPCError({ throw new TRPCError({
code: 'BAD_REQUEST', code: 'BAD_REQUEST',
@@ -2092,6 +2134,19 @@ export const adminRouter = router({
message: 'Survey permission is required.', message: 'Survey permission is required.',
}); });
} }
} else if (input.action === 'UPDATE_RUNTIME_SETTINGS') {
if (!gatewayProfileCapabilities(profile.status).runtimeExpected) {
throw new TRPCError({
code: 'BAD_REQUEST',
message: '실행 중인 프로필에서만 현재 기수 설정을 바꿀 수 있습니다.',
});
}
if (!canManageProfiles) {
throw new TRPCError({
code: 'FORBIDDEN',
message: 'Profile management permission is required.',
});
}
} else if (!canManageProfiles) { } else if (!canManageProfiles) {
throw new TRPCError({ throw new TRPCError({
code: 'FORBIDDEN', code: 'FORBIDDEN',
@@ -2106,12 +2161,17 @@ export const adminRouter = router({
}); });
} }
if (input.action === 'ACCELERATE' || input.action === 'DELAY') { if (
input.action === 'ACCELERATE' ||
input.action === 'DELAY' ||
input.action === 'UPDATE_RUNTIME_SETTINGS'
) {
try { try {
const runtimeAction = await ctx.prisma.gatewayRuntimeAction.create({ const runtimeAction = await ctx.prisma.gatewayRuntimeAction.create({
data: { data: {
profileName: input.profileName, profileName: input.profileName,
action: input.action, action: input.action,
payload: input.runtimeSettings ? { settings: input.runtimeSettings } : {},
durationMinutes: input.durationMinutes, durationMinutes: input.durationMinutes,
reason: input.reason, reason: input.reason,
requestedBy: adminAuth.user.id, requestedBy: adminAuth.user.id,
@@ -2124,7 +2184,7 @@ export const adminRouter = router({
} }
throw new TRPCError({ throw new TRPCError({
code: 'CONFLICT', code: 'CONFLICT',
message: '이 프로필의 이전 시간 조정 요청이 아직 처리 중입니다.', message: '이 프로필의 이전 런타임 변경 요청이 아직 처리 중입니다.',
}); });
} }
} }
@@ -70,6 +70,23 @@ export interface ProfileRuntimeSnapshot extends ProfileRuntimeState {
profileName: string; profileName: string;
} }
export interface ProfileRuntimeSettingsSnapshot {
profileName: string;
turnTermMinutes: number;
blockGeneralCreate: 0 | 1 | 2;
autorunUser: {
limitMinutes: number;
options: Array<'develop' | 'warp' | 'recruit' | 'recruit_high' | 'train' | 'battle' | 'chief'>;
} | null;
}
type RuntimeAutorunOption =
NonNullable<ProfileRuntimeSettingsSnapshot['autorunUser']> extends {
options: Array<infer Option>;
}
? Option
: never;
export interface GatewayOrchestratorHandle { export interface GatewayOrchestratorHandle {
start(): void; start(): void;
stop(): Promise<void>; stop(): Promise<void>;
@@ -82,6 +99,7 @@ export interface GatewayOrchestratorHandle {
skipped: string[]; skipped: string[];
}>; }>;
listRuntimeStates(profileNames: string[]): Promise<ProfileRuntimeSnapshot[]>; listRuntimeStates(profileNames: string[]): Promise<ProfileRuntimeSnapshot[]>;
listRuntimeSettings?(profileNames: string[]): Promise<ProfileRuntimeSettingsSnapshot[]>;
} }
const SENSITIVE_ENV_NAME = /(SECRET|TOKEN|PASSWORD|PASSWD|PRIVATE_KEY|CLIENT_SECRET|DATABASE_URL|REDIS_URL)/iu; const SENSITIVE_ENV_NAME = /(SECRET|TOKEN|PASSWORD|PASSWD|PRIVATE_KEY|CLIENT_SECRET|DATABASE_URL|REDIS_URL)/iu;
@@ -706,6 +724,67 @@ export class GatewayOrchestrator implements GatewayOrchestratorHandle {
return mapRuntimeStates(profileNames, processStates); return mapRuntimeStates(profileNames, processStates);
} }
async listRuntimeSettings(profileNames: string[]): Promise<ProfileRuntimeSettingsSnapshot[]> {
const allowedAutorunOptions = new Set<RuntimeAutorunOption>([
'develop',
'warp',
'recruit',
'recruit_high',
'train',
'battle',
'chief',
] as const);
const snapshots = await Promise.all(
profileNames.map(async (profileName): Promise<ProfileRuntimeSettingsSnapshot | null> => {
const profile = await this.repository.getProfile(profileName);
if (!profile || profile.currentScenario === null) return null;
const connector = createGamePostgresConnector({ url: this.resolveProfileDatabaseUrl(profile) });
try {
await connector.connect();
const row = await connector.prisma.worldState.findFirst({
select: { tickSeconds: true, config: true, meta: true },
});
if (!row) return null;
const config = isRecord(row.config) ? row.config : {};
const meta = isRecord(row.meta) ? row.meta : {};
const rawBlock = Number(config.blockGeneralCreate ?? 0);
const blockGeneralCreate = ([0, 1, 2].includes(rawBlock) ? rawBlock : 0) as 0 | 1 | 2;
const rawAutorun = isRecord(meta.autorun_user) ? meta.autorun_user : null;
const limitMinutes = rawAutorun ? Number(rawAutorun.limit_minutes ?? 0) : 0;
const rawOptions = rawAutorun
? Array.isArray(rawAutorun.options)
? rawAutorun.options
: isRecord(rawAutorun.options)
? Object.entries(rawAutorun.options)
.filter(([, enabled]) => enabled === true)
.map(([option]) => option)
: []
: [];
const autorunOptions = rawOptions.filter(
(
option
): option is 'develop' | 'warp' | 'recruit' | 'recruit_high' | 'train' | 'battle' | 'chief' =>
typeof option === 'string' && allowedAutorunOptions.has(option as RuntimeAutorunOption)
);
return {
profileName,
turnTermMinutes: Math.max(1, Math.round(row.tickSeconds / 60)),
blockGeneralCreate,
autorunUser:
Number.isInteger(limitMinutes) && limitMinutes > 0 && autorunOptions.length > 0
? { limitMinutes, options: autorunOptions }
: null,
};
} catch {
return null;
} finally {
await connector.disconnect().catch(() => undefined);
}
})
);
return snapshots.filter((snapshot): snapshot is ProfileRuntimeSettingsSnapshot => snapshot !== null);
}
async reconcileNow(): Promise<void> { async reconcileNow(): Promise<void> {
if (this.stopping || this.reconcileInFlight) { if (this.stopping || this.reconcileInFlight) {
return; return;
+108 -1
View File
@@ -287,6 +287,14 @@ const buildCaller = async (
} }
}, },
cleanupStaleWorkspaces: async () => ({ removed: [], skipped: [] }), cleanupStaleWorkspaces: async () => ({ removed: [], skipped: [] }),
listRuntimeSettings: async () => [
{
profileName: 'che:2',
turnTermMinutes: 20,
blockGeneralCreate: 2,
autorunUser: { limitMinutes: 720, options: ['develop', 'recruit_high', 'chief'] },
},
],
listRuntimeStates: async () => { listRuntimeStates: async () => {
runtimeStateListCount += 1; runtimeStateListCount += 1;
return []; return [];
@@ -299,6 +307,7 @@ const buildCaller = async (
findFirst: async () => ({ id: options.firstUserIsAdmin === false ? 'bootstrap-user' : admin.id }), findFirst: async () => ({ id: options.firstUserIsAdmin === false ? 'bootstrap-user' : admin.id }),
}, },
gatewayRuntimeAction: { gatewayRuntimeAction: {
findMany: async () => [],
create: async ({ data }: { data: Record<string, unknown> }) => { create: async ({ data }: { data: Record<string, unknown> }) => {
if (options.runtimeActionCreateError) { if (options.runtimeActionCreateError) {
throw options.runtimeActionCreateError; throw options.runtimeActionCreateError;
@@ -317,6 +326,9 @@ const buildCaller = async (
}; };
}, },
}, },
gatewayOperation: {
findMany: async () => [],
},
systemSetting: { systemSetting: {
findUnique: async () => ({ id: 1, notice: storedNotice }), findUnique: async () => ({ id: 1, notice: storedNotice }),
upsert: async ({ create, update }: { create: { notice: string }; update: { notice: string } }) => { upsert: async ({ create, update }: { create: { notice: string }; update: { notice: string } }) => {
@@ -371,6 +383,32 @@ describe('admin profile navigation API', () => {
]); ]);
expect(harness.getRuntimeStateListCount()).toBe(0); expect(harness.getRuntimeStateListCount()).toBe(0);
}); });
it('returns live settings from the profile database separately from reset defaults', async () => {
const harness = await buildCaller(
async () => {
throw new Error('not used');
},
{
profileMeta: {
resetDefaults: {
turnTermMinutes: 60,
blockGeneralCreate: 0,
autorunUser: null,
},
},
}
);
const result = await harness.caller.admin.profiles.list();
expect(result[0]?.runtimeSettings).toEqual({
profileName: 'che:2',
turnTermMinutes: 20,
blockGeneralCreate: 2,
autorunUser: { limitMinutes: 720, options: ['develop', 'recruit_high', 'chief'] },
});
});
}); });
describe('admin scenario catalog API', () => { describe('admin scenario catalog API', () => {
@@ -1131,6 +1169,7 @@ describe('admin runtime clock action API', () => {
{ {
profileName: 'che:2', profileName: 'che:2',
action: 'ACCELERATE', action: 'ACCELERATE',
payload: {},
durationMinutes: 15, durationMinutes: 15,
reason: '운영 일정 조정', reason: '운영 일정 조정',
requestedBy: harness.admin.id, requestedBy: harness.admin.id,
@@ -1151,10 +1190,78 @@ describe('admin runtime clock action API', () => {
}) })
).rejects.toMatchObject({ ).rejects.toMatchObject({
code: 'CONFLICT', code: 'CONFLICT',
message: '이 프로필의 이전 시간 조정 요청이 아직 처리 중입니다.', message: '이 프로필의 이전 런타임 변경 요청이 아직 처리 중입니다.',
}); });
}); });
it('queues all live game settings as one durable runtime action', async () => {
const harness = await buildCaller(unusedCreateOperation, { initialProfileStatus: 'RUNNING' });
const result = await harness.caller.admin.profiles.requestAction({
profileName: 'che:2',
action: 'UPDATE_RUNTIME_SETTINGS',
runtimeSettings: {
turnTermMinutes: 20,
blockGeneralCreate: 2,
autorunUser: {
limitMinutes: 720,
options: ['develop', 'recruit_high', 'chief'],
},
},
reason: '운영 중 규칙 변경',
});
expect(result).toMatchObject({
ok: true,
action: { action: 'UPDATE_RUNTIME_SETTINGS', status: 'REQUESTED' },
});
expect(harness.createdRuntimeActions).toEqual([
{
profileName: 'che:2',
action: 'UPDATE_RUNTIME_SETTINGS',
payload: {
settings: {
turnTermMinutes: 20,
blockGeneralCreate: 2,
autorunUser: {
limitMinutes: 720,
options: ['develop', 'recruit_high', 'chief'],
},
},
},
durationMinutes: undefined,
reason: '운영 중 규칙 변경',
requestedBy: harness.admin.id,
},
]);
});
it('rejects a live game setting change without a reason or running database', async () => {
const running = await buildCaller(unusedCreateOperation, { initialProfileStatus: 'RUNNING' });
await expect(
running.caller.admin.profiles.requestAction({
profileName: 'che:2',
action: 'UPDATE_RUNTIME_SETTINGS',
runtimeSettings: { turnTermMinutes: 20 },
})
).rejects.toMatchObject({ code: 'BAD_REQUEST', message: '변경 사유를 입력해 주세요.' });
const stopped = await buildCaller(unusedCreateOperation, { initialProfileStatus: 'STOPPED' });
await expect(
stopped.caller.admin.profiles.requestAction({
profileName: 'che:2',
action: 'UPDATE_RUNTIME_SETTINGS',
runtimeSettings: { blockGeneralCreate: 1 },
reason: '운영 정책 변경',
})
).rejects.toMatchObject({
code: 'BAD_REQUEST',
message: '실행 중인 프로필에서만 현재 기수 설정을 바꿀 수 있습니다.',
});
expect(running.createdRuntimeActions).toEqual([]);
expect(stopped.createdRuntimeActions).toEqual([]);
});
it('rejects a scheduled clock shift instead of silently applying it immediately', async () => { it('rejects a scheduled clock shift instead of silently applying it immediately', async () => {
const harness = await buildCaller(unusedCreateOperation); const harness = await buildCaller(unusedCreateOperation);
@@ -8,8 +8,8 @@ const operationNames = (route: Route): string[] => {
type RuntimeAction = { type RuntimeAction = {
id: string; id: string;
action: 'ACCELERATE' | 'DELAY'; action: 'ACCELERATE' | 'DELAY' | 'UPDATE_RUNTIME_SETTINGS';
durationMinutes: number; durationMinutes: number | null;
status: 'REQUESTED' | 'PARTIAL' | 'APPLIED' | 'FAILED' | 'IGNORED'; status: 'REQUESTED' | 'PARTIAL' | 'APPLIED' | 'FAILED' | 'IGNORED';
detail: string; detail: string;
handler: string | null; handler: string | null;
@@ -45,6 +45,7 @@ const installFixture = async (
let installRequested = false; let installRequested = false;
let installActive = false; let installActive = false;
let postRequestProfileReads = 0; let postRequestProfileReads = 0;
let requestedRuntimeSettings = false;
const requestBodies: unknown[] = []; const requestBodies: unknown[] = [];
let releaseRequest = (): void => {}; let releaseRequest = (): void => {};
const requestGate = options.deferRequest const requestGate = options.deferRequest
@@ -66,6 +67,7 @@ const installFixture = async (
const operations = operationNames(route); const operations = operationNames(route);
if (operations.includes('admin.profiles.requestAction')) { if (operations.includes('admin.profiles.requestAction')) {
requested = true; requested = true;
requestedRuntimeSettings = JSON.stringify(body).includes('UPDATE_RUNTIME_SETTINGS');
requestBodies.push(body); requestBodies.push(body);
await requestGate; await requestGate;
} }
@@ -171,6 +173,20 @@ const installFixture = async (
status: options.profileStatus ?? 'RUNNING', status: options.profileStatus ?? 'RUNNING',
buildStatus: 'SUCCEEDED', buildStatus: 'SUCCEEDED',
meta: {}, meta: {},
runtimeSettings: requestedRuntimeSettings
? {
turnTermMinutes: 20,
blockGeneralCreate: 1,
autorunUser: {
limitMinutes: 720,
options: ['develop', 'recruit_high', 'chief'],
},
}
: {
turnTermMinutes: 10,
blockGeneralCreate: 2,
autorunUser: null,
},
activeOperation: installActive activeOperation: installActive
? { ? {
id: '77777777-7777-4777-8777-777777777777', id: '77777777-7777-4777-8777-777777777777',
@@ -189,11 +205,20 @@ const installFixture = async (
runtimeActions: keepPending runtimeActions: keepPending
? [runtimeAction('REQUESTED')] ? [runtimeAction('REQUESTED')]
: requested : requested
? (options.afterRequestActions ?? [ ? (options.afterRequestActions ??
runtimeAction('APPLIED', { (requestedRuntimeSettings
detail: '15분 가속 · 장수 2명 · 경매 1건', ? [
}), runtimeAction('APPLIED', {
]) action: 'UPDATE_RUNTIME_SETTINGS',
durationMinutes: null,
detail: '턴 20분 · 장수 생성 불가 · 유저 자동턴 적용',
}),
]
: [
runtimeAction('APPLIED', {
detail: '15분 가속 · 장수 2명 · 경매 1건',
}),
]))
: (options.initialActions ?? []), : (options.initialActions ?? []),
}, },
]); ]);
@@ -203,8 +228,8 @@ const installFixture = async (
ok: true, ok: true,
action: { action: {
id: '68f1f0e4-3b95-4aeb-9925-c7e93caf1ba7', id: '68f1f0e4-3b95-4aeb-9925-c7e93caf1ba7',
action: 'ACCELERATE', action: requestedRuntimeSettings ? 'UPDATE_RUNTIME_SETTINGS' : 'ACCELERATE',
durationMinutes: 15, durationMinutes: requestedRuntimeSettings ? null : 15,
status: 'REQUESTED', status: 'REQUESTED',
detail: null, detail: null,
handler: null, handler: null,
@@ -284,8 +309,69 @@ test('reports clock-shift acceptance separately from actual application', async
expect(fixture.requestBodies).toHaveLength(1); expect(fixture.requestBodies).toHaveLength(1);
expect(JSON.stringify(fixture.requestBodies[0])).toContain('"ACCELERATE"'); expect(JSON.stringify(fixture.requestBodies[0])).toContain('"ACCELERATE"');
expect(JSON.stringify(fixture.requestBodies[0])).toContain('"durationMinutes":15'); expect(JSON.stringify(fixture.requestBodies[0])).toContain('"durationMinutes":15');
await expect(page.getByRole('button', { name: '설문 오픈 (게임 내 관리)' })).toBeDisabled(); await expect(page.getByRole('button', { name: '설문 오픈 (게임 내 관리)' })).toHaveCount(0);
await expect(page.getByText('설문 생성은 해당 게임의 설문 관리 화면에서 진행해 주세요.')).toBeVisible(); await expect(page.getByText('설문 생성은 해당 게임의 설문 관리 화면에서 진행해 주세요.')).toHaveCount(0);
});
test('updates live game options from the authoritative database snapshot', async ({ page }, testInfo) => {
const fixture = await installFixture(page);
await page.goto('/gateway/admin/servers/hwe%3Adefault');
const settings = page.getByTestId('runtime-settings');
await expect(settings).toBeVisible();
await expect(page.getByTestId('runtime-turn-term')).toHaveValue('10');
await expect(page.getByTestId('runtime-block-general-create')).toHaveValue('2');
await expect(page.getByTestId('runtime-autorun-enabled')).not.toBeChecked();
await expect(page.getByRole('button', { name: '설문 오픈 (게임 내 관리)' })).toHaveCount(0);
await page.getByTestId('runtime-turn-term').selectOption('20');
await page.getByTestId('runtime-block-general-create').selectOption('1');
await page.getByTestId('runtime-autorun-enabled').check();
await page.getByTestId('runtime-autorun-minutes').fill('720');
for (const label of ['이동', '징병', '훈련', '전투']) {
await settings.getByLabel(label, { exact: true }).uncheck();
}
await page.getByPlaceholder('사유 / 메모').fill('운영 중 설정 변경');
const submit = page.getByTestId('runtime-settings-submit');
await submit.hover();
const hoverBackground = await submit.evaluate((element) => getComputedStyle(element).backgroundColor);
await submit.focus();
await expect(submit).toBeFocused();
const click = submit.click();
await expect.poll(() => fixture.requestBodies.length).toBe(1);
await click;
const requestJson = JSON.stringify(fixture.requestBodies[0]);
expect(requestJson).toContain('UPDATE_RUNTIME_SETTINGS');
expect(requestJson).toContain('"turnTermMinutes":20');
expect(requestJson).toContain('"blockGeneralCreate":1');
expect(requestJson).toContain('"limitMinutes":720');
expect(requestJson).toContain('"recruit_high"');
expect(requestJson).toContain('"chief"');
expect(hoverBackground).not.toBe('rgba(0, 0, 0, 0)');
await expect(page.getByText('APPLIED · UPDATE_RUNTIME_SETTINGS')).toBeVisible();
await expect(page.getByTestId('runtime-turn-term')).toHaveValue('20');
await expect(page.getByTestId('runtime-block-general-create')).toHaveValue('1');
await expect(page.getByTestId('runtime-autorun-enabled')).toBeChecked();
const geometry = await settings.evaluate((element) => {
const rect = element.getBoundingClientRect();
return { left: rect.left, right: rect.right, width: rect.width, viewport: window.innerWidth };
});
expect(geometry.left).toBeGreaterThanOrEqual(0);
expect(geometry.right).toBeLessThanOrEqual(geometry.viewport);
expect(geometry.width).toBeGreaterThan(250);
await page.screenshot({ path: testInfo.outputPath('runtime-settings-desktop.png'), fullPage: true });
await page.setViewportSize({ width: 390, height: 844 });
const mobileGeometry = await settings.evaluate((element) => {
const rect = element.getBoundingClientRect();
return { left: rect.left, right: rect.right, viewport: window.innerWidth };
});
expect(mobileGeometry.left).toBeGreaterThanOrEqual(0);
expect(mobileGeometry.right).toBeLessThanOrEqual(mobileGeometry.viewport);
await page.screenshot({ path: testInfo.outputPath('runtime-settings-mobile.png'), fullPage: true });
}); });
test('distinguishes a turn pause from an inaccessible stopped server in operator controls', async ({ page }) => { test('distinguishes a turn pause from an inaccessible stopped server in operator controls', async ({ page }) => {
@@ -1,4 +1,13 @@
export const RESET_AUTORUN_OPTIONS = ['develop', 'warp', 'recruit', 'train', 'battle'] as const; export const PROFILE_TURN_TERM_MINUTES = [1, 2, 5, 10, 20, 30, 60, 120] as const;
export const RESET_AUTORUN_OPTIONS = [
'develop',
'warp',
'recruit',
'recruit_high',
'train',
'battle',
'chief',
] as const;
export type ResetAutorunOption = (typeof RESET_AUTORUN_OPTIONS)[number]; export type ResetAutorunOption = (typeof RESET_AUTORUN_OPTIONS)[number];
@@ -48,7 +57,7 @@ export const normalizeProfileResetDefaults = (value: unknown): ProfileResetDefau
const autorunLimit = rawAutorun?.limitMinutes; const autorunLimit = rawAutorun?.limitMinutes;
return { return {
turnTermMinutes: enumNumber(raw.turnTermMinutes, [1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 24, 30, 40, 60, 120], 60), turnTermMinutes: enumNumber(raw.turnTermMinutes, PROFILE_TURN_TERM_MINUTES, 60),
sync: typeof raw.sync === 'boolean' ? raw.sync : SYSTEM_PROFILE_RESET_DEFAULTS.sync, sync: typeof raw.sync === 'boolean' ? raw.sync : SYSTEM_PROFILE_RESET_DEFAULTS.sync,
fiction: enumNumber(raw.fiction, [0, 1], SYSTEM_PROFILE_RESET_DEFAULTS.fiction), fiction: enumNumber(raw.fiction, [0, 1], SYSTEM_PROFILE_RESET_DEFAULTS.fiction),
extend: typeof raw.extend === 'boolean' ? raw.extend : SYSTEM_PROFILE_RESET_DEFAULTS.extend, extend: typeof raw.extend === 'boolean' ? raw.extend : SYSTEM_PROFILE_RESET_DEFAULTS.extend,
+187 -23
View File
@@ -12,6 +12,7 @@ import AdminConsoleLayout from '../layouts/AdminConsoleLayout.vue';
import { useToast } from '../composables/useToast'; import { useToast } from '../composables/useToast';
import { import {
normalizeProfileResetDefaults, normalizeProfileResetDefaults,
PROFILE_TURN_TERM_MINUTES,
type ProfileResetDefaults, type ProfileResetDefaults,
type ResetAutorunOption, type ResetAutorunOption,
} from '../utils/resetDefaults'; } from '../utils/resetDefaults';
@@ -201,6 +202,7 @@ type AdminProfile = {
status: 'QUEUED' | 'RUNNING'; status: 'QUEUED' | 'RUNNING';
} | null; } | null;
meta: Record<string, unknown>; meta: Record<string, unknown>;
runtimeSettings: ProfileRuntimeSettings | null;
runtimeActions: Array<{ runtimeActions: Array<{
id: string; id: string;
action: string; action: string;
@@ -210,11 +212,22 @@ type AdminProfile = {
handler: string | null; handler: string | null;
handledAt: string | null; handledAt: string | null;
createdAt: string; createdAt: string;
payload?: Record<string, unknown>;
}>; }>;
}; };
type ProfileRuntimeSettings = Pick<ProfileResetDefaults, 'turnTermMinutes' | 'blockGeneralCreate' | 'autorunUser'>;
type AdminAction = type AdminAction =
'RESUME' | 'PAUSE' | 'STOP' | 'ACCELERATE' | 'DELAY' | 'RESET_NOW' | 'RESET_SCHEDULED' | 'OPEN_SURVEY' | 'SHUTDOWN'; | 'RESUME'
| 'PAUSE'
| 'STOP'
| 'ACCELERATE'
| 'DELAY'
| 'UPDATE_RUNTIME_SETTINGS'
| 'RESET_NOW'
| 'RESET_SCHEDULED'
| 'SHUTDOWN';
type AdminClient = { type AdminClient = {
capabilities: { capabilities: {
@@ -351,6 +364,7 @@ type AdminClient = {
profileName: string; profileName: string;
action: AdminAction; action: AdminAction;
durationMinutes?: number; durationMinutes?: number;
runtimeSettings?: ProfileRuntimeSettings;
scheduledAt?: string; scheduledAt?: string;
reason?: string; reason?: string;
}) => Promise<{ ok: boolean; action?: AdminProfile['runtimeActions'][number] }>; }) => Promise<{ ok: boolean; action?: AdminProfile['runtimeActions'][number] }>;
@@ -409,6 +423,11 @@ const profileActions = ref<
durationMinutes: string; durationMinutes: string;
scheduledAt: string; scheduledAt: string;
reason: string; reason: string;
turnTermMinutes: number;
blockGeneralCreate: 0 | 1 | 2;
autorunEnabled: boolean;
autorunUserMinutes: string;
autorunOptions: ResetAutorunOption[];
} }
> >
>({}); >({});
@@ -416,8 +435,10 @@ const resetAutorunLabels: Array<{ value: ResetAutorunOption; label: string }> =
{ value: 'develop', label: '내정' }, { value: 'develop', label: '내정' },
{ value: 'warp', label: '이동' }, { value: 'warp', label: '이동' },
{ value: 'recruit', label: '징병' }, { value: 'recruit', label: '징병' },
{ value: 'recruit_high', label: '고급 징병' },
{ value: 'train', label: '훈련' }, { value: 'train', label: '훈련' },
{ value: 'battle', label: '전투' }, { value: 'battle', label: '전투' },
{ value: 'chief', label: '참모' },
]; ];
const profileActionStatus = ref<Record<string, string>>({}); const profileActionStatus = ref<Record<string, string>>({});
const profileActionSubmitting = ref<Record<string, boolean>>({}); const profileActionSubmitting = ref<Record<string, boolean>>({});
@@ -450,6 +471,16 @@ const validDuration = (profileName: string): boolean => {
return Number.isInteger(value) && value >= 1 && value <= 1440; return Number.isInteger(value) && value >= 1 && value <= 1440;
}; };
const validRuntimeSettings = (profileName: string): boolean => {
const value = profileActions.value[profileName];
if (!value || !PROFILE_TURN_TERM_MINUTES.some((minutes) => minutes === value.turnTermMinutes)) return false;
if (!value.autorunEnabled) return true;
const limitMinutes = Number(value.autorunUserMinutes);
return (
Number.isInteger(limitMinutes) && limitMinutes >= 1 && limitMinutes <= 43200 && value.autorunOptions.length > 0
);
};
const runtimeActionStatusClass = (status: AdminProfile['runtimeActions'][number]['status']): string => { const runtimeActionStatusClass = (status: AdminProfile['runtimeActions'][number]['status']): string => {
if (status === 'APPLIED') return 'text-emerald-400'; if (status === 'APPLIED') return 'text-emerald-400';
if (status === 'FAILED') return 'text-red-400'; if (status === 'FAILED') return 'text-red-400';
@@ -647,14 +678,31 @@ const ensureProfileBuffers = (profile: AdminProfile) => {
}; };
} }
if (!profileActions.value[profile.profileName]) { if (!profileActions.value[profile.profileName]) {
const settings = profile.runtimeSettings ?? normalizeProfileResetDefaults(profile.meta?.resetDefaults);
profileActions.value[profile.profileName] = { profileActions.value[profile.profileName] = {
durationMinutes: '', durationMinutes: '',
scheduledAt: '', scheduledAt: '',
reason: '', reason: '',
turnTermMinutes: settings.turnTermMinutes,
blockGeneralCreate: settings.blockGeneralCreate,
autorunEnabled: settings.autorunUser !== null,
autorunUserMinutes: String(settings.autorunUser?.limitMinutes ?? 1440),
autorunOptions: settings.autorunUser?.options.slice() ?? resetAutorunLabels.map(({ value }) => value),
}; };
} }
}; };
const syncRuntimeSettingsBuffer = (profile: AdminProfile): void => {
const settings = profile.runtimeSettings;
const buffer = profileActions.value[profile.profileName];
if (!settings || !buffer) return;
buffer.turnTermMinutes = settings.turnTermMinutes;
buffer.blockGeneralCreate = settings.blockGeneralCreate;
buffer.autorunEnabled = settings.autorunUser !== null;
buffer.autorunUserMinutes = String(settings.autorunUser?.limitMinutes ?? 1440);
buffer.autorunOptions = settings.autorunUser?.options.slice() ?? resetAutorunLabels.map(({ value }) => value);
};
const toLocalInputValue = (value: string): string => toServerDateTimeInputValue(value); const toLocalInputValue = (value: string): string => toServerDateTimeInputValue(value);
const loadProfiles = async () => { const loadProfiles = async () => {
@@ -688,6 +736,8 @@ const refreshRuntimeActionUntilTerminal = async (profileName: string, actionId:
.find((profile) => profile.profileName === profileName) .find((profile) => profile.profileName === profileName)
?.runtimeActions.find((action) => action.id === actionId); ?.runtimeActions.find((action) => action.id === actionId);
if (current && isRuntimeActionTerminal(current.status)) { if (current && isRuntimeActionTerminal(current.status)) {
const profile = profiles.value.find((item) => item.profileName === profileName);
if (profile && current.status === 'APPLIED') syncRuntimeSettingsBuffer(profile);
profileActionStatus.value = { profileActionStatus.value = {
...profileActionStatus.value, ...profileActionStatus.value,
[profileName]: '', [profileName]: '',
@@ -701,6 +751,13 @@ const refreshRuntimeActionUntilTerminal = async (profileName: string, actionId:
ensureProfileBuffers(profile); ensureProfileBuffers(profile);
}); });
profiles.value = result; profiles.value = result;
const refreshedAction = result
.find((profile) => profile.profileName === profileName)
?.runtimeActions.find((action) => action.id === actionId);
if (refreshedAction?.status === 'APPLIED') {
const profile = result.find((item) => item.profileName === profileName);
if (profile) syncRuntimeSettingsBuffer(profile);
}
} catch { } catch {
// bounded poll . // bounded poll .
} }
@@ -816,12 +873,37 @@ const requestProfileAction = async (profileName: string, action: AdminAction) =>
? serverDateTimeInputToIso(actionState.scheduledAt) ? serverDateTimeInputToIso(actionState.scheduledAt)
: undefined; : undefined;
const reason = actionState?.reason.trim() || undefined; const reason = actionState?.reason.trim() || undefined;
const runtimeSettings: ProfileRuntimeSettings | undefined =
action === 'UPDATE_RUNTIME_SETTINGS' && actionState
? {
turnTermMinutes: actionState.turnTermMinutes,
blockGeneralCreate: actionState.blockGeneralCreate,
autorunUser: actionState.autorunEnabled
? {
limitMinutes: Number(actionState.autorunUserMinutes),
options: actionState.autorunOptions,
}
: null,
}
: undefined;
if (action === 'UPDATE_RUNTIME_SETTINGS' && (!validRuntimeSettings(profileName) || !reason || reason.length < 3)) {
profileActionStatus.value = {
...profileActionStatus.value,
[profileName]:
!reason || reason.length < 3
? '현재 기수 설정 변경 사유를 입력하세요.'
: '턴 간격과 유저 자동턴 값을 확인하세요.',
};
profileActionSubmitting.value = { ...profileActionSubmitting.value, [profileName]: false };
return;
}
let runtimeActionId: string | undefined; let runtimeActionId: string | undefined;
try { try {
const result = await adminClient.profiles.requestAction.mutate({ const result = await adminClient.profiles.requestAction.mutate({
profileName, profileName,
action, action,
durationMinutes: durationValue, durationMinutes: durationValue,
runtimeSettings,
scheduledAt, scheduledAt,
reason, reason,
}); });
@@ -830,7 +912,9 @@ const requestProfileAction = async (profileName: string, action: AdminAction) =>
[profileName]: [profileName]:
result.action && (action === 'ACCELERATE' || action === 'DELAY') result.action && (action === 'ACCELERATE' || action === 'DELAY')
? `접수됨 · ${result.action.status} · ${action} ${result.action.durationMinutes ?? ''}` ? `접수됨 · ${result.action.status} · ${action} ${result.action.durationMinutes ?? ''}`
: `요청 접수: ${action}`, : result.action && action === 'UPDATE_RUNTIME_SETTINGS'
? `접수됨 · ${result.action.status} · 현재 기수 설정 변경`
: `요청 접수: ${action}`,
}; };
if (result.action) { if (result.action) {
runtimeActionId = result.action.id; runtimeActionId = result.action.id;
@@ -2166,9 +2250,7 @@ onMounted(() => {
data-testid="meta-reset-turn-term" data-testid="meta-reset-turn-term"
> >
<option <option
v-for="minutes in [ v-for="minutes in PROFILE_TURN_TERM_MINUTES"
1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 24, 30, 40, 60, 120,
]"
:key="minutes" :key="minutes"
:value="minutes" :value="minutes"
> >
@@ -2207,9 +2289,9 @@ onMounted(() => {
" "
class="mt-1 w-full rounded border border-zinc-700 bg-zinc-900 px-2 py-2" class="mt-1 w-full rounded border border-zinc-700 bg-zinc-900 px-2 py-2"
> >
<option :value="0">없음</option> <option :value="0">가능</option>
<option :value="1">제한</option> <option :value="2">장수명 무작위</option>
<option :value="2">차단</option> <option :value="1">불가</option>
</select> </select>
</label> </label>
<label> <label>
@@ -2351,6 +2433,102 @@ onMounted(() => {
v-if="hasCapability('admin.profiles.runtime', profile.profileName)" v-if="hasCapability('admin.profiles.runtime', profile.profileName)"
class="space-y-2" class="space-y-2"
> >
<fieldset
class="space-y-3 rounded border border-zinc-700 bg-zinc-950/60 p-3"
data-testid="runtime-settings"
>
<legend class="px-1 text-sm font-semibold text-zinc-200">
실행 게임 옵션
</legend>
<p class="text-xs text-zinc-500">
현재 기수에 즉시 적용합니다. 간격 변경 tick 기준 게임 시각은 같은 게임
시각을 유지하도록 재계산하고, 기존 로그 시각은 유지합니다.
</p>
<p v-if="!profile.runtimeSettings" class="text-xs text-amber-400" role="alert">
게임 DB에서 현재 설정을 읽지 못해 변경할 없습니다. 실제 처리 상태를
새로고침해 주세요.
</p>
<label class="block text-xs text-zinc-400">
간격
<select
v-model.number="profileActions[profile.profileName].turnTermMinutes"
class="mt-1 w-full rounded border border-zinc-700 bg-zinc-900 px-2 py-2 text-sm text-white"
data-testid="runtime-turn-term"
>
<option
v-for="minutes in PROFILE_TURN_TERM_MINUTES"
:key="minutes"
:value="minutes"
>
{{ minutes }}
</option>
</select>
</label>
<label class="block text-xs text-zinc-400">
장수 생성 제한
<select
v-model.number="profileActions[profile.profileName].blockGeneralCreate"
class="mt-1 w-full rounded border border-zinc-700 bg-zinc-900 px-2 py-2 text-sm text-white"
data-testid="runtime-block-general-create"
>
<option :value="0">가능</option>
<option :value="2">장수명 무작위</option>
<option :value="1">불가</option>
</select>
</label>
<label class="flex items-center gap-2 text-xs text-zinc-300">
<input
v-model="profileActions[profile.profileName].autorunEnabled"
type="checkbox"
data-testid="runtime-autorun-enabled"
/>
유저 자동턴 사용
</label>
<template v-if="profileActions[profile.profileName].autorunEnabled">
<label class="block text-xs text-zinc-400">
자동턴 제한
<input
v-model="profileActions[profile.profileName].autorunUserMinutes"
type="number"
min="1"
max="43200"
step="1"
class="mt-1 w-full rounded border border-zinc-700 bg-zinc-900 px-2 py-2 text-sm text-white"
data-testid="runtime-autorun-minutes"
/>
</label>
<div class="flex flex-wrap items-center gap-3 text-xs text-zinc-300">
<label
v-for="option in resetAutorunLabels"
:key="`runtime-${option.value}`"
class="flex items-center gap-1"
>
<input
v-model="profileActions[profile.profileName].autorunOptions"
type="checkbox"
:value="option.value"
/>
{{ option.label }}
</label>
</div>
</template>
<button
class="w-full rounded bg-cyan-600 px-4 py-2 font-semibold text-black hover:bg-cyan-500 disabled:cursor-not-allowed disabled:opacity-40"
data-testid="runtime-settings-submit"
:disabled="
profileActionSubmitting[profile.profileName] ||
!profile.runtimeSettings ||
!gatewayProfileCapabilities(profile.status).runtimeExpected ||
!validRuntimeSettings(profile.profileName) ||
runtimeActionPending(profile)
"
@click="
requestProfileAction(profile.profileName, 'UPDATE_RUNTIME_SETTINGS')
"
>
현재 기수에 적용
</button>
</fieldset>
<label class="text-xs text-zinc-400">특수 동작 메모</label> <label class="text-xs text-zinc-400">특수 동작 메모</label>
<input <input
v-model="profileActions[profile.profileName].reason" v-model="profileActions[profile.profileName].reason"
@@ -2438,15 +2616,7 @@ onMounted(() => {
연기 연기
</button> </button>
<button <button
class="bg-zinc-800 text-zinc-500 font-semibold px-3 py-2 rounded cursor-not-allowed" class="bg-black hover:bg-zinc-800 text-white font-semibold px-3 py-2 rounded"
disabled
title="게임 내 설문 관리 화면에서 생성해 주세요."
:aria-describedby="`survey-action-help-${profile.profileName}`"
>
설문 오픈 (게임 관리)
</button>
<button
class="bg-black hover:bg-zinc-800 text-white font-semibold px-3 py-2 rounded col-span-2"
@click="requestProfileAction(profile.profileName, 'SHUTDOWN')" @click="requestProfileAction(profile.profileName, 'SHUTDOWN')"
> >
서버 폐쇄 서버 폐쇄
@@ -2487,12 +2657,6 @@ onMounted(() => {
}} }}
</div> </div>
</div> </div>
<div
:id="`survey-action-help-${profile.profileName}`"
class="text-xs text-zinc-500"
>
설문 생성은 해당 게임의 설문 관리 화면에서 진행해 주세요.
</div>
<button type="button" class="text-xs text-zinc-400 underline" @click="loadProfiles"> <button type="button" class="text-xs text-zinc-400 underline" @click="loadProfiles">
실제 처리 상태 새로고침 실제 처리 상태 새로고침
</button> </button>
+6 -1
View File
@@ -59,6 +59,11 @@ Gateway 관리자 콘솔은 `/gateway/admin`에서 시작합니다. 공개 로
메타가 없거나 유효하지 않으면 기존 시스템 기본값을 사용합니다. 시나리오와 메타가 없거나 유효하지 않으면 기존 시스템 기본값을 사용합니다. 시나리오와
예약·가오픈·정식 오픈 시각은 매 실행마다 선택하므로 서버 기본값에 포함하지 예약·가오픈·정식 오픈 시각은 매 실행마다 선택하므로 서버 기본값에 포함하지
않습니다. 않습니다.
- 같은 화면의 `실행 중 게임 옵션`은 리셋 기본값과 별개로 현재 기수 DB의 턴
간격, 장수 생성 제한, 유저 자동턴 제한·동작을 읽어 표시합니다. 세 값은
`admin.profiles.runtime:<name>` 권한과 3자 이상의 사유가 있을 때 하나의
내구성 런타임 작업으로 적용됩니다. 현재 DB 값을 읽지 못하면 폼을 제출할 수
없습니다. 존재하지 않는 설문 오픈 동작은 서버 상태 화면에 노출하지 않습니다.
- Gateway 릴리스는 profile 작업과 다른 전역 `admin.releases.manage` 권한을 - Gateway 릴리스는 profile 작업과 다른 전역 `admin.releases.manage` 권한을
사용하며 외부 release-controller가 실행합니다. 선택한 릴리스 작업의 단계와 사용하며 외부 release-controller가 실행합니다. 선택한 릴리스 작업의 단계와
명령 출력을 관리자 화면이 long polling으로 이어 받아 표시하며, 완료된 이력의 명령 출력을 관리자 화면이 long polling으로 이어 받아 표시하며, 완료된 이력의
@@ -70,7 +75,7 @@ Gateway 관리자 콘솔은 `/gateway/admin`에서 시작합니다. 공개 로
| capability | 허용 작업 | | capability | 허용 작업 |
| -------------------------------- | --------------------------------------------------------- | | -------------------------------- | --------------------------------------------------------- |
| `admin.profiles.runtime:<name>` | 시작·정지·일시정지·재개 시간 조정 | | `admin.profiles.runtime:<name>` | 시작·정지·일시정지·재개, 시간 조정과 현재 기수 게임 옵션 |
| `admin.profiles.settings:<name>` | 표시 정보·리셋 기본 옵션·Kakao 미인증 접근/장수 생성 유예 | | `admin.profiles.settings:<name>` | 표시 정보·리셋 기본 옵션·Kakao 미인증 접근/장수 생성 유예 |
| `admin.profiles.deploy:<name>` | DB를 유지하는 Git 버전 업데이트, 초기화와 새 버전 결합 | | `admin.profiles.deploy:<name>` | DB를 유지하는 Git 버전 업데이트, 초기화와 새 버전 결합 |
| `admin.scenarios.reset:<name>` | 현재 배포 버전으로 시나리오 초기화 | | `admin.scenarios.reset:<name>` | 현재 배포 버전으로 시나리오 초기화 |
+5
View File
@@ -10,6 +10,11 @@
남은 턴 수가 보존됩니다. DateTime 필드는 이전 데이터와 화면을 위한 투영값이며 남은 턴 수가 보존됩니다. DateTime 필드는 이전 데이터와 화면을 위한 투영값이며
tick 필드가 존재하면 tick이 우선합니다. tick 필드가 존재하면 tick이 우선합니다.
운영 중 턴 간격 변경은 Gateway의 내구성 런타임 작업으로만 수행합니다. 같은
transaction에서 `world_state`, 장수·경매·메시지·설문 투영값과 checkpoint를
갱신하며 기존 역사/행동 로그의 `created_at`은 다시 쓰지 않습니다. 토너먼트의
Redis 투영은 DB commit 뒤 action ID로 멱등 적용됩니다.
## 실행 모드 ## 실행 모드
- `GAME_CLOCK_MODE=realtime`: `clock_wall_anchor` 이후의 실제 경과시간을 - `GAME_CLOCK_MODE=realtime`: `clock_wall_anchor` 이후의 실제 경과시간을
+11 -1
View File
@@ -30,7 +30,8 @@ Gateway API는 다음 저장 경계를 사용합니다.
- `GatewayProfile`: profile, scenario, port, 상태와 build 결과 - `GatewayProfile`: profile, scenario, port, 상태와 build 결과
- `GatewayOperation`: build/reset/open/close 등 실행 요청과 결과 - `GatewayOperation`: build/reset/open/close 등 실행 요청과 결과
- `GatewayReleaseOperation`, `GatewayReleaseState`: Gateway 전체 릴리스 queue와 현재·이전 commit - `GatewayReleaseOperation`, `GatewayReleaseState`: Gateway 전체 릴리스 queue와 현재·이전 commit
- `GatewayRuntimeAction`: profile별 시간 가속·연기 요청, 부분 적용과 최종 결과 - `GatewayRuntimeAction`: profile별 시간 가속·연기와 현재 기수 설정 변경 요청,
payload, 부분 적용과 최종 결과
- Redis: gateway session, OAuth 임시 상태, KakaoTalk 로그인 challenge, flush channel - Redis: gateway session, OAuth 임시 상태, KakaoTalk 로그인 challenge, flush channel
Kakao 로그인은 URL 이름만으로 사용자를 연결하지 않습니다. `account_email` Kakao 로그인은 URL 이름만으로 사용자를 연결하지 않습니다. `account_email`
@@ -102,6 +103,15 @@ DB partial unique index로 한 건만 허용합니다. Turn daemon은 자신의
Redis 단계가 실패하면 action은 `PARTIAL`과 backoff 상태로 남고 DB 시간은 Redis 단계가 실패하면 action은 `PARTIAL`과 backoff 상태로 남고 DB 시간은
다시 이동하지 않습니다. 다시 이동하지 않습니다.
현재 기수의 턴 간격·장수 생성 제한·유저 자동턴도 같은
`GatewayRuntimeAction`/`InputEvent` 경계를 사용합니다. Turn daemon은 세 값을
한 transaction에서 `world_state.config``meta`에 저장합니다. 턴 간격이
바뀌면 현재 표시 게임 시각과 game tick을 고정한 채 `clock_base_time`, 장수
턴·최근 전쟁, checkpoint, 경매·메시지·설문 DateTime 투영값을 새 간격으로
다시 계산합니다. 기존 `log_entry.created_at`은 갱신하지 않고 변경을 알리는 새
역사 로그만 추가합니다. Redis 토너먼트의 tick 소유 시각도 action ID로 한 번만
재투영하며 실패하면 `PARTIAL`에서 재시도합니다.
Gateway API와 독립 orchestrator의 SIGINT·SIGTERM은 Gateway API와 독립 orchestrator의 SIGINT·SIGTERM은
`installGatewayShutdownController()`가 하나의 종료 Promise로 합칩니다. `installGatewayShutdownController()`가 하나의 종료 Promise로 합칩니다.
Gateway API는 Fastify `app.close()`를 통해 orchestrator task를 drain한 뒤 Gateway API는 Fastify `app.close()`를 통해 orchestrator task를 drain한 뒤
+42
View File
@@ -41,6 +41,19 @@ export interface TurnDaemonStatus {
checkpoint?: TurnCheckpoint; checkpoint?: TurnCheckpoint;
} }
export type RuntimeAutorunUserOption = 'develop' | 'warp' | 'recruit' | 'recruit_high' | 'train' | 'battle' | 'chief';
export interface RuntimeAutorunUserSettings {
limitMinutes: number;
options: RuntimeAutorunUserOption[];
}
export interface RuntimeGameSettingsPatch {
turnTermMinutes?: number;
blockGeneralCreate?: 0 | 1 | 2;
autorunUser?: RuntimeAutorunUserSettings | null;
}
export type TurnDaemonCommand = export type TurnDaemonCommand =
| { | {
type: 'run'; type: 'run';
@@ -49,6 +62,12 @@ export type TurnDaemonCommand =
targetTime?: string; targetTime?: string;
budget?: TurnRunBudget; budget?: TurnRunBudget;
} }
| {
type: 'updateRuntimeSettings';
requestId?: string;
actionId: string;
settings: RuntimeGameSettingsPatch;
}
| { type: 'pause'; requestId?: string; reason?: string } | { type: 'pause'; requestId?: string; reason?: string }
| { type: 'resume'; requestId?: string; reason?: string } | { type: 'resume'; requestId?: string; reason?: string }
| { type: 'shutdown'; requestId?: string; reason?: string } | { type: 'shutdown'; requestId?: string; reason?: string }
@@ -284,6 +303,29 @@ export type TurnDaemonCommandResult =
commandType: TurnDaemonCommand['type']; commandType: TurnDaemonCommand['type'];
reason: string; reason: string;
} }
| {
type: 'updateRuntimeSettings';
ok: true;
actionId: string;
settings: RuntimeGameSettingsPatch;
termChanged: boolean;
previousTurnTermMinutes: number;
turnTermMinutes: number;
previousClockBaseTime: string;
clockBaseTime: string;
lastTurnTime: string;
shiftedGenerals: number;
reprojectedAuctions: number;
reprojectedMessages: number;
reprojectedVotes: number;
checkpoint?: TurnCheckpoint;
}
| {
type: 'updateRuntimeSettings';
ok: false;
actionId: string;
reason: string;
}
| { | {
type: 'shiftSchedule'; type: 'shiftSchedule';
ok: true; ok: true;
@@ -0,0 +1,2 @@
ALTER TABLE "gateway_runtime_action"
ADD COLUMN "payload" JSONB NOT NULL DEFAULT '{}'::jsonb;
+30 -29
View File
@@ -77,35 +77,35 @@ enum GatewaySourceMode {
} }
model AppUser { model AppUser {
id String @id @default(uuid()) id String @id @default(uuid())
loginId String @unique @map("login_id") loginId String @unique @map("login_id")
displayName String @unique @map("display_name") displayName String @unique @map("display_name")
passwordHash String @map("password_hash") passwordHash String @map("password_hash")
passwordSalt String @map("password_salt") passwordSalt String @map("password_salt")
roles Json @default(dbgenerated("'[]'::jsonb")) roles Json @default(dbgenerated("'[]'::jsonb"))
sanctions Json @default(dbgenerated("'{}'::jsonb")) sanctions Json @default(dbgenerated("'{}'::jsonb"))
oauthType OAuthType @default(NONE) @map("oauth_type") oauthType OAuthType @default(NONE) @map("oauth_type")
oauthId String? @unique @map("oauth_id") oauthId String? @unique @map("oauth_id")
email String? @unique email String? @unique
oauthInfo Json @default(dbgenerated("'{}'::jsonb")) @map("oauth_info") oauthInfo Json @default(dbgenerated("'{}'::jsonb")) @map("oauth_info")
picture String @default("default.jpg") picture String @default("default.jpg")
imageServer Int @default(0) @map("image_server") imageServer Int @default(0) @map("image_server")
iconUpdatedAt DateTime? @map("icon_updated_at") iconUpdatedAt DateTime? @map("icon_updated_at")
iconRevision DateTime? @map("icon_revision") iconRevision DateTime? @map("icon_revision")
profileIconResetAt DateTime? @map("profile_icon_reset_at") profileIconResetAt DateTime? @map("profile_icon_reset_at")
iconRetiredAt DateTime? @map("icon_retired_at") iconRetiredAt DateTime? @map("icon_retired_at")
thirdPartyUse Boolean @default(true) @map("third_party_use") thirdPartyUse Boolean @default(true) @map("third_party_use")
termsAcceptedAt DateTime? @map("terms_accepted_at") termsAcceptedAt DateTime? @map("terms_accepted_at")
privacyAcceptedAt DateTime? @map("privacy_accepted_at") privacyAcceptedAt DateTime? @map("privacy_accepted_at")
kakaoVerifiedAt DateTime? @map("kakao_verified_at") kakaoVerifiedAt DateTime? @map("kakao_verified_at")
kakaoTalkVerifiedUntil DateTime? @map("kakao_talk_verified_until") kakaoTalkVerifiedUntil DateTime? @map("kakao_talk_verified_until")
kakaoGraceStartedAt DateTime @default(now()) @map("kakao_grace_started_at") kakaoGraceStartedAt DateTime @default(now()) @map("kakao_grace_started_at")
kakaoGraceUntil DateTime? @map("kakao_grace_until") kakaoGraceUntil DateTime? @map("kakao_grace_until")
deleteAfter DateTime? @map("delete_after") deleteAfter DateTime? @map("delete_after")
createdAt DateTime @default(now()) @map("created_at") createdAt DateTime @default(now()) @map("created_at")
updatedAt DateTime @updatedAt @map("updated_at") updatedAt DateTime @updatedAt @map("updated_at")
lastLoginAt DateTime? @map("last_login_at") lastLoginAt DateTime? @map("last_login_at")
legacyData Json @default(dbgenerated("'{}'::jsonb")) @map("legacy_data") legacyData Json @default(dbgenerated("'{}'::jsonb")) @map("legacy_data")
icons UserIcon[] icons UserIcon[]
specialAccessGrants SpecialAccountAccessGrant[] specialAccessGrants SpecialAccountAccessGrant[]
@@ -242,6 +242,7 @@ model GatewayRuntimeAction {
profileName String @map("profile_name") profileName String @map("profile_name")
profile GatewayProfile @relation(fields: [profileName], references: [profileName], onDelete: Cascade) profile GatewayProfile @relation(fields: [profileName], references: [profileName], onDelete: Cascade)
action String action String
payload Json @default(dbgenerated("'{}'::jsonb"))
durationMinutes Int? @map("duration_minutes") durationMinutes Int? @map("duration_minutes")
scheduledAt DateTime? @map("scheduled_at") scheduledAt DateTime? @map("scheduled_at")
reason String? reason String?
+1
View File
@@ -171,6 +171,7 @@ export interface TurnEngineWorldStateUpdateInput {
clockMode: string; clockMode: string;
clockWallAnchor: Date; clockWallAnchor: Date;
lastTurnTick: bigint; lastTurnTick: bigint;
config: InputJsonValue;
meta: InputJsonValue; meta: InputJsonValue;
} }