fix: Ref 게임 로직과 시나리오 풀 호환을 보정

월 경계, 전투 기술 상한, 연감과 베팅·설문·경매 정산 순서를 Ref 계약에 맞춘다.\n\n시나리오 일반 풀을 ENGINE mutation과 logical tick 기반으로 직렬화하고 914·915 catalog 및 조건부 100기 pool 실행 경계를 추가한다.\n\n경매 worker는 세대별 durable event만 만들고 ENGINE이 row lock 후 상태 전이와 정산을 단일 transaction으로 소유한다.
2026-08-23 16:26:14 +00:00
parent bf6b7be7b0
commit 85591c68ad
114 changed files with 13327 additions and 901 deletions
@@ -0,0 +1,98 @@
+import { asNumber, asRecord } from '@sammo-ts/common';
+import {
+    CENTENNIAL_ALL_STAR_DEFAULT_DEX_LIMIT,
+    CENTENNIAL_ALL_STAR_NPC_PROGRESS_MULTIPLIER,
+    CENTENNIAL_ALL_STAR_POOL,
+    LogCategory,
+    LogFormat,
+    LogScope,
+    applyCentennialAllStarTarget,
+    readCentennialAllStarAux,
+    type CentennialAllStarRules,
+} from '@sammo-ts/logic';
+
+import type { InMemoryTurnWorld } from './inMemoryWorld.js';
+import type { MonthlyEventActionHandler } from './monthlyEventHandler.js';
+
+const resolveRules = (world: InMemoryTurnWorld): CentennialAllStarRules => {
+    const scenario = world.getScenarioConfig();
+    const configConst = asRecord(scenario.const);
+    return {
+        defaultStatMin: scenario.stat.min,
+        defaultStatMax: scenario.stat.max,
+        defaultStatTotal: scenario.stat.total,
+        maxStatLevel: asNumber(configConst.maxLevel, 255),
+        defaultSpecialDomestic:
+            typeof configConst.defaultSpecialDomestic === 'string' ? configConst.defaultSpecialDomestic : 'None',
+        dexLimit: asNumber(configConst.dexLimit, CENTENNIAL_ALL_STAR_DEFAULT_DEX_LIMIT),
+    };
+};
+
+const resolveNpcDexTargetRatio = (world: InMemoryTurnWorld): number => {
+    const value = asNumber(asRecord(world.getScenarioConfig().map).centennialNpcDexTargetRatio, 0.4);
+    if (value < 0 || value > 1) {
+        throw new Error('centennialNpcDexTargetRatio must be between 0 and 1');
+    }
+    return value;
+};
+
+export const createAdvanceCentennialAllStarHandler = (options: {
+    getWorld: () => InMemoryTurnWorld | null;
+}): MonthlyEventActionHandler => {
+    return (_args, environment) => {
+        const world = options.getWorld();
+        if (!world || asRecord(world.getScenarioConfig().map).targetGeneralPool !== CENTENNIAL_ALL_STAR_POOL) {
+            return;
+        }
+        const rules = resolveRules(world);
+        const npcDexTargetRatio = resolveNpcDexTargetRatio(world);
+        for (const general of world.listGenerals()) {
+            const aux = readCentennialAllStarAux(general.meta as Record<string, unknown>);
+            if (!aux) {
+                continue;
+            }
+            const isGeneratedNpc = general.npcState === 3 || general.npcState === 4;
+            const result = applyCentennialAllStarTarget(
+                general,
+                aux.target,
+                {
+                    startYear: environment.startyear,
+                    year: environment.year,
+                    month: environment.month,
+                },
+                rules,
+                isGeneratedNpc ? CENTENNIAL_ALL_STAR_NPC_PROGRESS_MULTIPLIER : 1,
+                isGeneratedNpc ? npcDexTargetRatio : 1
+            );
+            // progressMonth 같은 aux 필드도 월마다 영속화해야 하므로 실제 수치
+            // 변화가 없는 경우에도 Ref General::applyDB()와 같이 dirty 처리한다.
+            world.updateGeneral(general.id, {
+                stats: result.stats,
+                role: result.role,
+                meta: result.meta,
+            });
+            if (result.milestone <= result.previousMilestone) {
+                continue;
+            }
+            const percent = result.milestone * 20;
+            world.pushLog({
+                scope: LogScope.GENERAL,
+                category: LogCategory.ACTION,
+                generalId: general.id,
+                text: `<L>올스타 동조율</>이 <C>${percent}%</>에 도달했습니다!`,
+                format: LogFormat.PLAIN,
+                year: environment.year,
+                month: environment.month,
+            });
+            world.pushLog({
+                scope: LogScope.GENERAL,
+                category: LogCategory.HISTORY,
+                generalId: general.id,
+                text: `<L>올스타 동조율 ${percent}% 달성</>`,
+                format: LogFormat.YEAR_MONTH,
+                year: environment.year,
+                month: environment.month,
+            });
+        }
+    };
+};