feat: API 변화 저널과 outbox worker를 연결

입력 이벤트의 업무 변경, 성공 원장, revision 및 outbox를 한 transaction에서 커밋한다. 설문의 commit 전 Redis 발행을 제거하고 접속 점수용 private revision과 재시도·retention을 갖춘 dispatcher lifecycle을 추가한다.

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

@@ -0,0 +1,143 @@
+import { describe, expect, it, vi } from 'vitest';
+
+import type { RedisConnector } from '@sammo-ts/infra';
+import type { ReadModelOutboxDatabase } from '@sammo-ts/infra';
+
+import { ReadModelOutboxWorker } from '../src/realtime/outboxWorker.js';
+
+const payload = (domain: 'front.general' | 'access.general' | 'tournament' | 'betting') => ({
+    version: 1,
+    changes: [[domain, domain === 'front.general' || domain === 'access.general' ? 7 : 0, '1']],
+});
+
+const createFixture = (rows: readonly object[]) => {
+    const queryRaw = vi.fn().mockResolvedValueOnce(rows).mockResolvedValue([]);
+    const updateMany = vi.fn().mockResolvedValue({ count: 1 });
+    const incr = vi.fn().mockResolvedValue(41);
+    const publish = vi.fn().mockResolvedValue(1);
+    const db = {
+        $queryRaw: queryRaw,
+        readModelOutbox: { updateMany },
+    } as unknown as ReadModelOutboxDatabase;
+    const redis = { incr, publish } as unknown as RedisConnector['client'];
+    return { db, redis, queryRaw, updateMany, incr, publish };
+};
+
+describe('ReadModelOutboxWorker', () => {
+    it('publishes a legacy internal readModelChanged event and acknowledges the durable row', async () => {
+        const fixture = createFixture([{ id: 11n, payload: payload('front.general'), attempts: 1 }]);
+        const worker = new ReadModelOutboxWorker(fixture.db, fixture.redis, 'che:default', {
+            owner: 'worker-test',
+            intervalMs: 60_000,
+        });
+
+        worker.start();
+        await vi.waitFor(() => expect(fixture.updateMany).toHaveBeenCalledTimes(1));
+        await worker.stop();
+
+        expect(fixture.incr).toHaveBeenCalledWith('sammo:che:default:read-model:revision');
+        const event = JSON.parse(String(fixture.publish.mock.calls[0]?.[1]));
+        expect(event).toMatchObject({
+            type: 'readModelChanged',
+            revision: 41,
+            changes: { frontStatusActorIds: [7] },
+        });
+        expect(fixture.updateMany).toHaveBeenCalledWith(
+            expect.objectContaining({ where: { id: 11n, lockOwner: 'worker-test', deliveredAt: null } })
+        );
+    });
+
+    it.each(['access.general', 'tournament', 'betting'] as const)(
+        'marks a %s-only envelope delivered without dashboard Redis publish',
+        async (domain) => {
+            const fixture = createFixture([{ id: 12n, payload: payload(domain), attempts: 1 }]);
+            const worker = new ReadModelOutboxWorker(fixture.db, fixture.redis, 'che:default', {
+                owner: 'worker-test',
+                intervalMs: 60_000,
+            });
+
+            worker.start();
+            await vi.waitFor(() => expect(fixture.updateMany).toHaveBeenCalledTimes(1));
+            await worker.stop();
+
+            expect(fixture.incr).not.toHaveBeenCalled();
+            expect(fixture.publish).not.toHaveBeenCalled();
+        }
+    );
+
+    it('coalesces repeated wakeups into one trailing batch and waits for it on shutdown', async () => {
+        let releaseFirst: (() => void) | undefined;
+        const first = new Promise<readonly object[]>((resolve) => {
+            releaseFirst = () => resolve([]);
+        });
+        const fixture = createFixture([]);
+        fixture.queryRaw.mockReset();
+        fixture.queryRaw.mockReturnValueOnce(first).mockResolvedValue([]);
+        const worker = new ReadModelOutboxWorker(fixture.db, fixture.redis, 'che:default', {
+            owner: 'worker-test',
+            intervalMs: 60_000,
+        });
+
+        worker.start();
+        worker.wake();
+        worker.wake();
+        expect(fixture.queryRaw).toHaveBeenCalledTimes(1);
+
+        releaseFirst?.();
+        await vi.waitFor(() => expect(fixture.queryRaw).toHaveBeenCalledTimes(2));
+        await worker.stop();
+        expect(fixture.queryRaw).toHaveBeenCalledTimes(2);
+    });
+
+    it('reports item failures while leaving the row released for dispatcher retry', async () => {
+        const fixture = createFixture([{ id: 13n, payload: payload('front.general'), attempts: 1 }]);
+        fixture.publish.mockRejectedValueOnce(new Error('redis unavailable'));
+        const onError = vi.fn();
+        const worker = new ReadModelOutboxWorker(fixture.db, fixture.redis, 'che:default', {
+            owner: 'worker-test',
+            intervalMs: 60_000,
+            onError,
+        });
+
+        worker.start();
+        await vi.waitFor(() => expect(fixture.updateMany).toHaveBeenCalledTimes(1));
+        await worker.stop();
+
+        expect(onError).toHaveBeenCalledWith(
+            expect.objectContaining({ message: '1 read-model outbox delivery attempt(s) failed.' })
+        );
+        expect(fixture.updateMany).toHaveBeenCalledWith(
+            expect.objectContaining({
+                where: { id: 13n, lockOwner: 'worker-test', deliveredAt: null },
+                data: expect.objectContaining({
+                    lockedAt: null,
+                    lockOwner: null,
+                    lastError: expect.stringContaining('redis unavailable'),
+                }),
+            })
+        );
+    });
+
+    it('prunes only a bounded retention batch on the lower-frequency cadence', async () => {
+        let now = new Date('2026-08-16T00:00:00.000Z');
+        const fixture = createFixture([]);
+        const worker = new ReadModelOutboxWorker(fixture.db, fixture.redis, 'che:default', {
+            owner: 'worker-test',
+            intervalMs: 60_000,
+            retentionMs: 24 * 60 * 60 * 1_000,
+            pruneIntervalMs: 60_000,
+            pruneLimit: 100,
+            now: () => now,
+        });
+        now = new Date('2026-08-16T00:01:00.000Z');
+
+        worker.start();
+        await vi.waitFor(() => expect(fixture.queryRaw).toHaveBeenCalledTimes(2));
+        await worker.stop();
+
+        const pruneQuery = fixture.queryRaw.mock.calls[1]?.[0] as { sql: string; values: unknown[] };
+        expect(pruneQuery.sql).toContain('DELETE FROM "read_model_outbox"');
+        expect(pruneQuery.values).toContainEqual(new Date('2026-08-15T00:01:00.000Z'));
+        expect(pruneQuery.values).toContain(100);
+    });
+});