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,129 @@
+import { describe, expect, it } from 'vitest';
+
+import {
+    buildScenarioGeneralPoolClaimMeta,
+    getScenarioGeneralPoolCandidateWeight,
+    parseScenarioGeneralPoolCandidate,
+    pickUniqueScenarioGeneralPoolCandidates,
+    readScenarioGeneralPoolClaim,
+    resolveLegacyNpcStatTypeFromFixedStats,
+    type ScenarioGeneralPoolCandidate,
+} from '../../../src/actions/turn/generalPool.js';
+
+const candidate = (poolEntryId: number, name: string, weight: number): ScenarioGeneralPoolCandidate => ({
+    poolEntryId,
+    uniqueName: name,
+    name,
+    dex: [weight, 0, 0, 0, 0],
+    sourceInfo: {},
+});
+
+describe('scenario general pool', () => {
+    it('keeps the Ref weighted array and consumes duplicate draws before selecting a new row', () => {
+        const draws = [0, 0, 0.75];
+        let drawCount = 0;
+        const rng = {
+            nextFloat1: () => {
+                const value = draws[drawCount];
+                drawCount += 1;
+                return value ?? 0;
+            },
+            nextBool: () => false,
+            nextInt: () => 0,
+        };
+
+        expect(pickUniqueScenarioGeneralPoolCandidates(rng, [candidate(1, '갑', 1), candidate(2, '을', 1)], 2)).toEqual(
+            [expect.objectContaining({ poolEntryId: 1 }), expect.objectContaining({ poolEntryId: 2 })]
+        );
+        expect(drawCount).toBe(3);
+    });
+
+    it('fails with the Ref pool-shortage message instead of using a random-name fallback', () => {
+        const rng = { nextFloat1: () => 0, nextBool: () => false, nextInt: () => 0 };
+        expect(() => pickUniqueScenarioGeneralPoolCandidates(rng, [candidate(1, '갑', 1)], 2)).toThrow('pool 부족');
+    });
+
+    it('keeps zero-dex centennial NPC candidates selectable with the Ref minimum weight', () => {
+        const centennial = {
+            ...candidate(3, '성장후보', 0),
+            sourceInfo: { event100Growth: true },
+        };
+        let draws = 0;
+        const rng = {
+            nextFloat1: () => {
+                draws += 1;
+                return 0;
+            },
+            nextBool: () => false,
+            nextInt: () => 0,
+        };
+
+        expect(getScenarioGeneralPoolCandidateWeight(centennial)).toBe(100_000);
+        expect(pickUniqueScenarioGeneralPoolCandidates(rng, [centennial], 1)).toEqual([centennial]);
+        expect(draws).toBe(1);
+    });
+
+    it('parses the U30 builder fields and round-trips the persisted claim marker', () => {
+        const parsed = parseScenarioGeneralPoolCandidate({
+            id: 17,
+            uniqueName: '풀장수',
+            info: {
+                generalName: '풀장수',
+                leadership: 69,
+                strength: 12,
+                intel: 80,
+                specialDomestic: 'che_event_징병',
+                dex: [1, 2, 3, 4, 5],
+                imgsvr: 1,
+                picture: 'pool.gif',
+            },
+        });
+        const claimedAt = new Date('0200-05-01T00:00:00.000Z');
+        const meta = { killturn: 1, ...buildScenarioGeneralPoolClaimMeta(parsed, claimedAt) };
+
+        expect(parsed).toMatchObject({
+            poolEntryId: 17,
+            uniqueName: '풀장수',
+            name: '풀장수',
+            stats: { leadership: 69, strength: 12, intelligence: 80 },
+            dex: [1, 2, 3, 4, 5],
+            specialDomestic: 'che_event_징병',
+            imageServer: 1,
+            picture: 'pool.gif',
+        });
+        expect(readScenarioGeneralPoolClaim(meta)).toEqual({
+            poolEntryId: 17,
+            uniqueName: '풀장수',
+            claimedAt: claimedAt.toISOString(),
+        });
+    });
+
+    it('only consumes a stat-type draw for an ambiguous fixed-stat candidate', () => {
+        let draws = 0;
+        const rng = {
+            nextFloat1: () => {
+                draws += 1;
+                return 0;
+            },
+            nextBool: () => false,
+            nextInt: () => 0,
+        };
+
+        expect(
+            resolveLegacyNpcStatTypeFromFixedStats(rng, {
+                leadership: 70,
+                strength: 80,
+                intelligence: 10,
+            })
+        ).toBe('무');
+        expect(draws).toBe(0);
+        expect(
+            resolveLegacyNpcStatTypeFromFixedStats(rng, {
+                leadership: 70,
+                strength: 50,
+                intelligence: 50,
+            })
+        ).toBe('무');
+        expect(draws).toBe(1);
+    });
+});