feat: 레거시 DB 순차 증분 이관 CLI 추가

2026-08-18 12:35:24 +00:00
parent e910a635e6
commit da0e32f422
21 changed files with 1375 additions and 104 deletions
@@ -0,0 +1,105 @@
+import { createMariaPool, createPostgresPool, querySource } from './db.js';
+import { migrateGame } from './game.js';
+import { migrateGateway, type MigrationSummary } from './gateway.js';
+import type { MigrationMode } from './incremental.js';
+import type { ResolvedMigrationPlan, ResolvedMigrationStage } from './config.js';
+
+export interface PlanRunSummary {
+    command: 'run-plan';
+    sourceSet: string;
+    mode: MigrationMode;
+    apply: boolean;
+    stages: Array<{ name: string; status: 'COMPLETED'; summary: MigrationSummary }>;
+}
+
+const preflightStage = async (stage: ResolvedMigrationStage): Promise<void> => {
+    const source = createMariaPool(stage.sourceUrl);
+    const target = createPostgresPool(stage.targetUrl);
+    try {
+        const sourceDatabase = await querySource(source, 'SELECT DATABASE() AS database_name');
+        if (typeof sourceDatabase[0]?.database_name !== 'string') {
+            throw new Error(`Source preflight did not select a database for ${stage.name}`);
+        }
+        const requiredSourceTables =
+            stage.kind === 'gateway'
+                ? ['member', 'member_log', 'banned_member', 'storage', 'system']
+                : [
+                      'ng_games',
+                      'hall',
+                      'ng_old_generals',
+                      'ng_old_nations',
+                      'emperior',
+                      'inheritance_result',
+                      'user_record',
+                      'storage',
+                      'ng_history',
+                  ];
+        const sourceTables = await querySource(
+            source,
+            `SELECT table_name AS source_table_name
+             FROM information_schema.tables
+             WHERE table_schema = DATABASE() AND table_name IN (${requiredSourceTables.map(() => '?').join(', ')})`,
+            requiredSourceTables
+        );
+        const availableSourceTables = new Set(sourceTables.map((row) => String(row.source_table_name)));
+        const missingSourceTables = requiredSourceTables.filter((table) => !availableSourceTables.has(table));
+        if (missingSourceTables.length) {
+            throw new Error(`Source ${stage.name} is missing required tables: ${missingSourceTables.join(', ')}`);
+        }
+        await target.query('SELECT 1');
+        const checkpointTable =
+            stage.kind === 'gateway' ? 'public.legacy_import_checkpoint' : 'legacy_archive.import_checkpoint';
+        const migrationReady = await target.query<{ table_name: string | null }>(
+            'SELECT to_regclass($1) AS table_name',
+            [checkpointTable]
+        );
+        if (!migrationReady.rows[0]?.table_name) {
+            throw new Error(`Target migrations are not current for ${stage.name}; missing ${checkpointTable}`);
+        }
+        const targetDataTable = stage.kind === 'gateway' ? 'public.app_user' : 'inheritance_result';
+        const targetReady = await target.query<{ table_name: string | null }>('SELECT to_regclass($1) AS table_name', [
+            targetDataTable,
+        ]);
+        if (!targetReady.rows[0]?.table_name) {
+            throw new Error(`Target migrations are not current for ${stage.name}; missing ${targetDataTable}`);
+        }
+    } finally {
+        await source.end();
+        await target.end();
+    }
+};
+
+export const checkMigrationPlan = async (plan: ResolvedMigrationPlan): Promise<Record<string, unknown>> => {
+    for (const stage of plan.stages) await preflightStage(stage);
+    return {
+        command: 'check-plan',
+        sourceSet: plan.sourceSet,
+        stages: plan.stages.map((stage) => ({ name: stage.name, kind: stage.kind, status: 'READY' })),
+    };
+};
+
+export const runMigrationPlan = async (
+    plan: ResolvedMigrationPlan,
+    mode: MigrationMode,
+    apply: boolean,
+    migratedAt = new Date()
+): Promise<PlanRunSummary> => {
+    await checkMigrationPlan(plan);
+    const stages: PlanRunSummary['stages'] = [];
+    for (const stage of plan.stages) {
+        const source = createMariaPool(stage.sourceUrl);
+        const target = createPostgresPool(stage.targetUrl);
+        try {
+            const execution = { mode, source: stage.sourceIdentity } as const;
+            const summary =
+                stage.kind === 'gateway'
+                    ? await migrateGateway(source, target, apply, migratedAt, execution)
+                    : await migrateGame(source, target, apply, stage.profile!, execution);
+            stages.push({ name: stage.name, status: 'COMPLETED', summary });
+        } finally {
+            await source.end();
+            await target.end();
+        }
+    }
+    return { command: 'run-plan', sourceSet: plan.sourceSet, mode, apply, stages };
+};