sonamu 0.6.0 → 0.7.1

package/src/testing/fixture-manager.ts

@@ -1,27 +1,38 @@
+import assert from "assert";
 import chalk from "chalk";
-import * as _ from "lodash-es";
+import { execSync } from "child_process";
+import { readFileSync, writeFileSync } from "fs";
+import inflection from "inflection";
+import knex, { type Knex } from "knex";
+import { unique } from "radashi";
+import { inspect } from "util";
 import { Sonamu } from "../api";
+import { BaseModel } from "../database/base-model";
+import type { SonamuDBConfig } from "../database/db";
+import { type UBRef, UpsertBuilder } from "../database/upsert-builder";
+import type { Entity } from "../entity/entity";
 import { EntityManager } from "../entity/entity-manager";
 import {
-  EntityProp,
-  FixtureImportResult,
-  FixtureRecord,
-  FixtureSearchOptions,
-  ManyToManyRelationProp,
+  type EntityProp,
+  type FixtureImportResult,
+  type FixtureRecord,
+  type FixtureSearchOptions,
   isBelongsToOneRelationProp,
   isHasManyRelationProp,
   isManyToManyRelationProp,
   isOneToOneRelationProp,
   isRelationProp,
   isVirtualProp,
+  type ManyToManyRelationProp,
 } from "../types/types";
-import { Entity } from "../entity/entity";
-import inflection from "inflection";
-import { readFileSync, writeFileSync } from "fs";
 import { RelationGraph } from "./_relation-graph";
-import knex, { Knex } from "knex";
-import { BaseModel } from "../database/base-model";
-import { SonamuDBConfig } from "../database/db";
+
+/** 사용자 지정 중복 확인 컬럼 (entityId별로 지정) */
+export interface DuplicateCheckOptions {
+  columns?: {
+    [entityId: string]: string[];
+  };
+}
 
 export class FixtureManagerClass {
   private _tdb: Knex | null = null;
@@ -49,6 +60,12 @@ export class FixtureManagerClass {
 
   private relationGraph = new RelationGraph();
 
+  // UpsertBuilder 기반 import를 위한 상태
+  private builder: UpsertBuilder = new UpsertBuilder();
+  private fixtureRefMap: Map<string, UBRef> = new Map();
+  private uuidToFixtureId: Map<string, string> = new Map();
+  private skippedFixtures: Map<string, { entityId: string; existingId: number }> = new Map();
+
   init() {
     if (this._tdb !== null) {
       return;
@@ -57,89 +74,19 @@ export class FixtureManagerClass {
       const tConn = Sonamu.dbConfig.test.connection as Knex.ConnectionConfig & {
         port?: number;
       };
-      const pConn = Sonamu.dbConfig.production_master
-        .connection as Knex.ConnectionConfig & { port?: number };
+      const pConn = Sonamu.dbConfig.production_master.connection as Knex.ConnectionConfig & {
+        port?: number;
+      };
       if (
-        `${tConn.host ?? "localhost"}:${tConn.port ?? 3306}/${
-          tConn.database
-        }` ===
-        `${pConn.host ?? "localhost"}:${pConn.port ?? 3306}/${pConn.database}`
+        `${tConn.host ?? "localhost"}:${tConn.port ?? 5432}/${tConn.database}` ===
+        `${pConn.host ?? "localhost"}:${pConn.port ?? 5432}/${pConn.database}`
       ) {
-        throw new Error(
-          `테스트DB와 프로덕션DB에 동일한 데이터베이스가 사용되었습니다.`
-        );
+        throw new Error(`테스트DB와 프로덕션DB에 동일한 데이터베이스가 사용되었습니다.`);
       }
     }
 
     this.tdb = knex(Sonamu.dbConfig.test);
-    this.fdb = knex(Sonamu.dbConfig.fixture_local);
-  }
-
-  async cleanAndSeed(usingTables?: string[]) {
-    const tableNames: string[] = await (async () => {
-      if (usingTables) {
-        return usingTables;
-      }
-      if (this.cachedTableNames) {
-        return this.cachedTableNames;
-      }
-
-      const [tables] = await this.tdb.raw(
-        `SHOW TABLE STATUS WHERE Engine IS NOT NULL AND Name != 'migrations'`
-      );
-      const tableNames = tables.map(
-        (tableInfo: { Name: string }) => tableInfo["Name"]
-      );
-      this.cachedTableNames = tableNames;
-      return tableNames;
-    })();
-
-    // migrations 제외한 테이블 목록
-    const tableListStr = tableNames.join(", ");
-
-    // 한 번에 모든 테이블 체크섬 확인
-    const [fdbChecksumRows] = await this.fdb.raw<
-      [{ Table: string; Checksum: number }[]]
-    >(`CHECKSUM TABLE ${tableListStr}`);
-    const [tdbChecksumRows] = await this.tdb.raw<
-      [{ Table: string; Checksum: number }[]]
-    >(`CHECKSUM TABLE ${tableListStr}`);
-
-    // 체크섬 맵 생성
-    const fdbChecksums = new Map(
-      fdbChecksumRows.map((row) => [row.Table.split(".").pop()!, row.Checksum])
-    );
-    const tdbChecksums = new Map(
-      tdbChecksumRows.map((row) => [row.Table.split(".").pop()!, row.Checksum])
-    );
-
-    // 변경된 테이블들만 처리
-    const changedTables = tableNames.filter(
-      (tableName) => fdbChecksums.get(tableName) !== tdbChecksums.get(tableName)
-    );
-
-    // 병렬로 truncate + insert 실행
-    await this.tdb.transaction(async (trx) => {
-      await trx.raw(`SET FOREIGN_KEY_CHECKS = 0`);
-
-      await Promise.all(
-        changedTables.map(async (tableName) => {
-          await trx.raw(`SET FOREIGN_KEY_CHECKS = 0`);
-          await trx(tableName).truncate();
-          const rawQuery = `INSERT INTO ${
-            (Sonamu.dbConfig.test.connection as Knex.ConnectionConfig).database
-          }.${tableName}
-        SELECT * FROM ${
-          (Sonamu.dbConfig.fixture_local.connection as Knex.ConnectionConfig)
-            .database
-        }.${tableName}`;
-          await trx.raw(rawQuery);
-        })
-      );
-      await trx.raw(`SET FOREIGN_KEY_CHECKS = 1`);
-    });
-
-    // console.timeEnd("FIXTURE-CleanAndSeed");
+    this.fdb = knex(Sonamu.dbConfig.fixture_remote);
   }
 
   async getChecksum(db: Knex, tableName: string) {
@@ -147,68 +94,48 @@ export class FixtureManagerClass {
     return checksumRow.Checksum;
   }
 
+  /**
+    이제 FixtureManager.sync() 는 checksum 비교 없이 create database template 으로 수행합니다.
+  */
   async sync() {
-    const frdb = knex(Sonamu.dbConfig.fixture_remote);
-
-    const [tables] = await this.fdb.raw(
-      "SHOW TABLE STATUS WHERE Engine IS NOT NULL"
-    );
-    const tableNames: string[] = tables.map(
-      (table: any) => table.Name as string
+    const fixtureConn = Sonamu.dbConfig.fixture_remote.connection as Knex.PgConnectionConfig;
+    const testConn = Sonamu.dbConfig.test.connection as Knex.PgConnectionConfig;
+
+    // PostgreSQL 패스워드 환경변수 설정
+    const pgEnv = { PGPASSWORD: testConn.password || "" };
+
+    // 1. 연결 강제 종료
+    execSync(
+      `psql -h ${testConn.host} -p ${testConn.port ?? 5432} -U ${testConn.user} -d postgres -c "
+      SELECT pg_terminate_backend(pg_stat_activity.pid)
+      FROM pg_stat_activity
+      WHERE datname = '${testConn.database}'
+        AND pid <> pg_backend_pid();
+    "`,
+      { stdio: "inherit", env: { ...process.env, ...pgEnv } as NodeJS.ProcessEnv },
     );
 
-    console.log(chalk.magenta("SYNC..."));
-    await Promise.all(
-      tableNames.map(async (tableName) => {
-        if (tableName.startsWith("knex_migrations")) {
-          return;
-        }
-
-        const remoteChecksum = await this.getChecksum(frdb, tableName);
-        const localChecksum = await this.getChecksum(this.fdb, tableName);
-
-        if (remoteChecksum !== localChecksum) {
-          await this.fdb.transaction(async (transaction) => {
-            await transaction.raw(`SET FOREIGN_KEY_CHECKS = 0`);
-            await transaction(tableName).truncate();
-
-            const rows = await frdb(tableName);
-            if (rows.length === 0) {
-              return;
-            }
+    execSync(
+      `psql -h ${fixtureConn.host} -p ${fixtureConn.port ?? 5432} -U ${fixtureConn.user} -d postgres -c "
+        SELECT pg_terminate_backend(pg_stat_activity.pid)
+        FROM pg_stat_activity
+        WHERE datname = '${fixtureConn.database}'
+          AND pid <> pg_backend_pid();
+      "`,
+      { stdio: "inherit", env: { ...process.env, ...pgEnv } as NodeJS.ProcessEnv },
+    );
 
-            console.log(chalk.blue(tableName), rows.length);
-            await transaction
-              .insert(
-                rows.map((row: any) => {
-                  return Object.fromEntries(
-                    Object.entries(row).map(([key, value]) => {
-                      if (value === null) {
-                        return [key, null];
-                      } else if (typeof value === "boolean") {
-                        return [key, value ? 1 : 0];
-                      } else if (
-                        typeof value === "object" &&
-                        !(value instanceof Date)
-                      ) {
-                        return [key, JSON.stringify(value)];
-                      } else {
-                        return [key, value];
-                      }
-                    })
-                  );
-                })
-              )
-              .into(tableName);
-            console.log("OK");
-            await transaction.raw(`SET FOREIGN_KEY_CHECKS = 1`);
-          });
-        }
-      })
+    // 2. DROP DATABASE (별도 실행!)
+    execSync(
+      `psql -h ${testConn.host} -p ${testConn.port ?? 5432} -U ${testConn.user} -d postgres -c "DROP DATABASE IF EXISTS \\"${testConn.database}\\""`,
+      { stdio: "inherit", env: { ...process.env, ...pgEnv } as NodeJS.ProcessEnv },
     );
-    console.log(chalk.magenta("DONE!"));
 
-    await frdb.destroy();
+    // 3. CREATE DATABASE
+    execSync(
+      `psql -h ${testConn.host} -p ${testConn.port ?? 5432} -U ${testConn.user} -d postgres -c "CREATE DATABASE \\"${testConn.database}\\" TEMPLATE \\"${fixtureConn.database}\\""`,
+      { stdio: "inherit", env: { ...process.env, ...pgEnv } as NodeJS.ProcessEnv },
+    );
   }
 
   private visitedRecords = new Set<string>();
@@ -216,18 +143,18 @@ export class FixtureManagerClass {
     // 방문 기록 초기화 (새로운 import 작업 시작)
     this.visitedRecords.clear();
 
-    const queries = _.uniq(
+    const queries = unique(
       (
         await Promise.all(
           ids.map(async (id) => {
             return await this.getImportQueries(entityId, "id", id);
-          })
+          }),
         )
-      ).flat()
+      ).flat(),
     );
 
     const wdb = BaseModel.getDB("w");
-    for (let query of queries) {
+    for (const query of queries) {
       const [rsh] = await wdb.raw(query);
       console.log({
         query,
@@ -236,11 +163,7 @@ export class FixtureManagerClass {
     }
   }
 
-  async getImportQueries(
-    entityId: string,
-    field: string,
-    id: number
-  ): Promise<string[]> {
+  async getImportQueries(entityId: string, field: string, id: number): Promise<string[]> {
     const recordKey = `${entityId}#${field}#${id}`;
 
     // 순환 참조 방지: 이미 방문한 레코드는 스킵
@@ -260,9 +183,9 @@ export class FixtureManagerClass {
     }
 
     // 픽스쳐DB, 실DB
-    const fixtureDatabase = (Sonamu.dbConfig.fixture_remote.connection as any)
+    const fixtureDatabase = (Sonamu.dbConfig.fixture_remote.connection as Knex.ConnectionConfig)
       .database;
-    const realDatabase = (Sonamu.dbConfig.production_master.connection as any)
+    const realDatabase = (Sonamu.dbConfig.production_master.connection as Knex.ConnectionConfig)
       .database;
 
     const selfQuery = `INSERT IGNORE INTO \`${fixtureDatabase}\`.\`${entity.table}\` (SELECT * FROM \`${realDatabase}\`.\`${entity.table}\` WHERE \`id\` = ${id})`;
@@ -271,8 +194,7 @@ export class FixtureManagerClass {
       .filter(
         ([, relation]) =>
           isBelongsToOneRelationProp(relation) ||
-          (isOneToOneRelationProp(relation) &&
-            relation.customJoinClause === undefined)
+          (isOneToOneRelationProp(relation) && relation.customJoinClause === undefined),
       )
       .map(([, relation]) => {
         /*
@@ -288,15 +210,13 @@ export class FixtureManagerClass {
         if (isOneToOneRelationProp(relation) && !relation.hasJoinColumn) {
           const relatedEntity = EntityManager.get(relation.with);
           const relatedIdColumnName = relatedEntity.props.find(
-            (p) => isRelationProp(p) && p.with === entity.id
+            (p) => isRelationProp(p) && p.with === entity.id,
           )?.name;
           if (!relatedIdColumnName) {
-            throw new Error(
-              `${relatedEntity.id}의 ${entity.id} 관계 프롭을 찾을 수 없습니다.`
-            );
+            throw new Error(`${relatedEntity.id}의 ${entity.id} 관계 프롭을 찾을 수 없습니다.`);
           }
           field = `${relatedIdColumnName}_id`;
-          id = row["id"];
+          id = row.id;
         } else {
           field = "id";
           id = row[`${relation.name}_id`];
@@ -312,10 +232,10 @@ export class FixtureManagerClass {
     const relQueries = await Promise.all(
       args.map(async (args) => {
         return this.getImportQueries(args.entityId, args.field, args.id);
-      })
+      }),
     );
 
-    return [..._.uniq(relQueries.reverse().flat()), selfQuery];
+    return [...unique(relQueries.reverse().flat()), selfQuery];
   }
 
   async destroy() {
@@ -333,17 +253,17 @@ export class FixtureManagerClass {
   async getFixtures(
     sourceDBName: keyof SonamuDBConfig,
     targetDBName: keyof SonamuDBConfig,
-    searchOptions: FixtureSearchOptions
+    searchOptions: FixtureSearchOptions,
+    duplicateCheck?: DuplicateCheckOptions,
   ) {
     const sourceDB = knex(Sonamu.dbConfig[sourceDBName]);
     const targetDB = knex(Sonamu.dbConfig[targetDBName]);
+
     const { entityId, field, value, searchType } = searchOptions;
 
     const entity = EntityManager.get(entityId);
     const column =
-      entity.props.find((prop) => prop.name === field)?.type === "relation"
-        ? `${field}_id`
-        : field;
+      entity.props.find((prop) => prop.name === field)?.type === "relation" ? `${field}_id` : field;
 
     let query = sourceDB(entity.table);
     if (searchType === "equals") {
@@ -360,11 +280,11 @@ export class FixtureManagerClass {
     const fixtures: FixtureRecord[] = [];
     for (const row of rows) {
       const initialRecordsLength = fixtures.length;
-      const newRecords = await this.createFixtureRecord(entity, row);
+      const newRecords = await this.createFixtureRecord(entity, row, {
+        _db: sourceDB,
+      });
       fixtures.push(...newRecords);
-      const currentFixtureRecord = fixtures.find(
-        (r) => r.fixtureId === `${entityId}#${row.id}`
-      );
+      const currentFixtureRecord = fixtures.find((r) => r.fixtureId === `${entityId}#${row.id}`);
 
       if (currentFixtureRecord) {
         // 현재 fixture로부터 생성된 fetchedRecords 설정
@@ -378,23 +298,26 @@ export class FixtureManagerClass {
     for await (const fixture of fixtures) {
       const entity = EntityManager.get(fixture.entityId);
 
-      // ID를 이용하여 targetDB에 레코드가 존재하는지 확인
-      const row = await targetDB(entity.table).where("id", fixture.id).first();
-      if (row) {
-        const [record] = await this.createFixtureRecord(entity, row, {
-          singleRecord: true,
-          _db: targetDB,
-        });
-        fixture.target = record;
-        continue;
+      // 사용자 지정 컬럼 기준 중복 확인 → target
+      const customColumns = duplicateCheck?.columns?.[fixture.entityId];
+      if (customColumns && customColumns.length > 0) {
+        const customDuplicateRow = await this.checkDuplicateByColumns(
+          targetDB,
+          entity,
+          fixture,
+          customColumns,
+        );
+        if (customDuplicateRow) {
+          const [record] = await this.createFixtureRecord(entity, customDuplicateRow, {
+            singleRecord: true,
+            _db: targetDB,
+          });
+          fixture.target = record;
+        }
       }
 
-      // ID를 이용하여 targetDB에서 조회되지 않는 경우, unique 제약을 위반하는지 확인
-      const uniqueRow = await this.checkUniqueViolation(
-        targetDB,
-        entity,
-        fixture
-      );
+      // Unique index 기준 중복 확인 → fixture.unique
+      const uniqueRow = await this.checkUniqueViolation(targetDB, entity, fixture);
       if (uniqueRow) {
         const [record] = await this.createFixtureRecord(entity, uniqueRow, {
           singleRecord: true,
@@ -407,21 +330,30 @@ export class FixtureManagerClass {
     await targetDB.destroy();
     await sourceDB.destroy();
 
-    return _.uniqBy(fixtures, (f) => f.fixtureId);
+    return unique(fixtures, (f) => f.fixtureId);
   }
 
   async createFixtureRecord(
     entity: Entity,
-    row: any,
+    row: {
+      id: number;
+      [key: string]: string | number | boolean | null;
+    },
     options?: {
       singleRecord?: boolean;
       _db?: Knex;
-    }
+    },
   ): Promise<FixtureRecord[]> {
     const records: FixtureRecord[] = [];
     const visitedEntities = new Set<string>();
 
-    const create = async (entity: Entity, row: any) => {
+    const create = async (
+      entity: Entity,
+      row: {
+        id: number;
+        [key: string]: string | number | boolean | null;
+      },
+    ) => {
       const fixtureId = `${entity.id}#${row.id}`;
       if (visitedEntities.has(fixtureId)) {
         return;
@@ -454,9 +386,7 @@ export class FixtureManagerClass {
           const fromColumn = `${inflection.singularize(entity.table)}_id`;
           const toColumn = `${inflection.singularize(relatedEntity.table)}_id`;
 
-          const relatedIds = await db(throughTable)
-            .where(fromColumn, row.id)
-            .pluck(toColumn);
+          const relatedIds = await db(throughTable).where(fromColumn, row.id).pluck(toColumn);
           record.columns[prop.name].value = relatedIds;
         } else if (isHasManyRelationProp(prop)) {
           const relatedEntity = EntityManager.get(prop.with);
@@ -467,12 +397,10 @@ export class FixtureManagerClass {
         } else if (isOneToOneRelationProp(prop) && !prop.hasJoinColumn) {
           const relatedEntity = EntityManager.get(prop.with);
           const relatedProp = relatedEntity.props.find(
-            (p) => isRelationProp(p) && p.with === entity.id
+            (p) => isRelationProp(p) && p.with === entity.id,
           );
           if (relatedProp) {
-            const relatedRow = await db(relatedEntity.table)
-              .where("id", row.id)
-              .first();
+            const relatedRow = await db(relatedEntity.table).where("id", row.id).first();
             record.columns[prop.name].value = relatedRow?.id;
           }
         } else if (isRelationProp(prop)) {
@@ -483,9 +411,7 @@ export class FixtureManagerClass {
           }
           if (!options?.singleRecord && relatedId) {
             const relatedEntity = EntityManager.get(prop.with);
-            const relatedRow = await db(relatedEntity.table)
-              .where("id", relatedId)
-              .first();
+            const relatedRow = await db(relatedEntity.table).where("id", relatedId).first();
             if (relatedRow) {
               await create(relatedEntity, relatedRow);
             }
@@ -501,221 +427,348 @@ export class FixtureManagerClass {
     return records;
   }
 
+  /**
+   * 1. RelationGraph로 fixture 단위 삽입 순서 계산 (self-reference 포함)
+   * 2. 순서대로 UpsertBuilder에 등록 (UBRef로 참조 관계 표현)
+   * 3. 테이블별 upsert 실행 (ID는 DB가 자동 할당)
+   */
   async insertFixtures(
     dbName: keyof SonamuDBConfig,
-    _fixtures: FixtureRecord[]
-  ) {
-    const fixtures = _.uniqBy(_fixtures, (f) => f.fixtureId);
+    _fixtures: FixtureRecord[],
+  ): Promise<FixtureImportResult[]> {
+    const fixtures = unique(_fixtures, (f) => f.fixtureId);
+
+    // 초기화
+    this.builder = new UpsertBuilder();
+    this.fixtureRefMap = new Map();
+    this.uuidToFixtureId = new Map();
+    this.skippedFixtures = new Map();
 
-    this.relationGraph.buildGraph(fixtures);
-    const insertionOrder = this.relationGraph.getInsertionOrder();
     const db = knex(Sonamu.dbConfig[dbName]);
+    const results: FixtureImportResult[] = [];
 
-    await db.transaction(async (trx) => {
-      await trx.raw(`SET FOREIGN_KEY_CHECKS = 0`);
+    try {
+      // 1. RelationGraph로 fixture 단위 삽입 순서 계산
+      this.relationGraph.buildGraph(fixtures);
+      const insertionOrder = this.relationGraph.getInsertionOrder();
 
+      // 2. 순서대로 UpsertBuilder에 등록 (override 체크)
       for (const fixtureId of insertionOrder) {
-        const fixture = fixtures.find((f) => f.fixtureId === fixtureId)!;
-        const result = await this.insertFixture(trx as any, fixture);
-        if (result.id !== fixture.id) {
-          // ID가 변경된 경우, 다른 fixture에서 참조하는 경우가 찾아서 수정
+        const fixture = fixtures.find((f) => f.fixtureId === fixtureId);
+        if (!fixture) continue;
+
+        const hasTarget = !!fixture.target;
+        const hasUnique = !!fixture.unique;
+        const hasDuplicate = hasTarget || hasUnique;
+
+        // 중복이 있고 override=false인 경우: 스킵
+        if (hasDuplicate && !fixture.override) {
+          // 기존 레코드 ID 저장 (unique 우선, 없으면 target)
+          const existingId = fixture.unique?.id ?? fixture.target?.id;
+          assert(existingId);
+          this.skippedFixtures.set(fixtureId, {
+            entityId: fixture.entityId,
+            existingId,
+          });
+
           console.log(
             chalk.yellow(
-              `Unique constraint violation: ${fixture.entityId}#${fixture.id} -> ${fixture.entityId}#${result.id}`
-            )
+              `Skipped ${fixture.entityId}#${fixture.id} (existing: #${existingId}, override: false)`,
+            ),
           );
-          fixtures.forEach((f) => {
-            Object.values(f.columns).forEach((column) => {
-              if (
-                column.prop.type === "relation" &&
-                column.prop.with === result.entityId &&
-                column.value === fixture.id
-              ) {
-                column.value = result.id;
-              }
-            });
-          });
-          fixture.id = result.id;
+          continue;
         }
-      }
 
-      for (const fixtureId of insertionOrder) {
-        const fixture = fixtures.find((f) => f.fixtureId === fixtureId)!;
-        await this.handleManyToManyRelations(trx as any, fixture, fixtures);
+        this.registerFixture(fixture);
+        console.log(
+          chalk.blue(
+            `Registered ${fixture.entityId}#${fixture.id}${fixture.override ? ` (override existing: #${fixture.target?.id})` : ""}`,
+          ),
+        );
       }
-      await trx.raw(`SET FOREIGN_KEY_CHECKS = 1`);
-    });
 
-    const records: FixtureImportResult[] = [];
+      // 3. 테이블별 upsert 실행
+      const tableOrder = this.getTableOrder(fixtures);
+
+      await db.transaction(async (trx) => {
+        const insertedIdsByTable = new Map<string, Map<string, number>>();
+
+        for (const tableName of tableOrder) {
+          if (!this.builder.hasTable(tableName)) continue;
 
-    for await (const r of fixtures) {
-      const entity = EntityManager.get(r.entityId);
-      const record = await db(entity.table).where("id", r.id).first();
-      records.push({
-        entityId: r.entityId,
-        data: record,
+          // upsert 실행 전 uuid 목록 저장
+          const table = this.builder.getTable(tableName);
+          const uuids = table.rows.map((row) => row.uuid as string);
+
+          console.log(chalk.blue(`Upserting ${tableName} with ${uuids.length} rows`));
+          await this.builder.upsert(trx, tableName);
+
+          // upsert된 row들의 uuid -> id 매핑 구축
+          if (uuids.length > 0) {
+            const uuidToId = new Map<string, number>();
+            const rows = await trx(tableName).select("uuid", "id").whereIn("uuid", uuids);
+
+            for (const row of rows) {
+              uuidToId.set(row.uuid, row.id);
+            }
+
+            insertedIdsByTable.set(tableName, uuidToId);
+          }
+        }
+
+        // 4. ManyToMany 관계 처리
+        await this.processManyToManyRelations(trx, fixtures, insertedIdsByTable);
+
+        // 5. 결과 수집
+        for (const fixture of fixtures) {
+          const entity = EntityManager.get(fixture.entityId);
+
+          // 스킵된 fixture는 기존 레코드 정보로 결과 추가
+          const skipped = this.skippedFixtures.get(fixture.fixtureId);
+          if (skipped) {
+            results.push({
+              entityId: fixture.entityId,
+              data: await trx(entity.table).where("id", skipped.existingId).first(),
+            });
+            continue;
+          }
+
+          const ref = this.fixtureRefMap.get(fixture.fixtureId);
+          if (ref) {
+            const uuidToId = insertedIdsByTable.get(entity.table);
+            const insertedId = uuidToId?.get(ref.uuid);
+
+            if (insertedId !== undefined) {
+              results.push({
+                entityId: fixture.entityId,
+                data: await trx(entity.table).where("id", insertedId).first(),
+              });
+
+              console.log(
+                chalk.green(`Inserted into ${entity.table}: #${fixture.id} -> #${insertedId}`),
+              );
+            }
+          }
+        }
       });
+    } finally {
+      await db.destroy();
     }
 
-    await db.destroy();
-
-    return _.uniqBy(records, (r) => `${r.entityId}#${r.data.id}`);
+    return unique(results, (r) => `${r.entityId}#${r.data.id}`);
   }
 
-  private prepareInsertData(fixture: FixtureRecord) {
-    const insertData: any = {};
+  /**
+   * FixtureRecord를 UpsertBuilder에 등록
+   */
+  private registerFixture(fixture: FixtureRecord): UBRef {
+    const entity = EntityManager.get(fixture.entityId);
+    const row: Record<string, unknown> = {};
+
+    // Override 모드 판단: target 또는 unique가 있고 override=true인 경우
+    const existingRecord = fixture.target ?? fixture.unique;
+    const isOverrideMode = fixture.override && existingRecord;
+
     for (const [propName, column] of Object.entries(fixture.columns)) {
-      if (isVirtualProp(column.prop)) {
+      const prop = column.prop;
+
+      if (isVirtualProp(prop)) {
         continue;
       }
 
-      const prop = column.prop as EntityProp;
-      if (!isRelationProp(prop)) {
-        if (prop.type === "json") {
-          insertData[propName] = JSON.stringify(column.value);
-        } else if (prop.type === "timestamp" || prop.type === "datetime") {
-          insertData[propName] = new Date(column.value);
-        } else {
-          insertData[propName] = column.value;
+      // id/uuid 처리: Override 모드일 때만 기존 값 사용
+      if (propName === "id" || propName === "uuid") {
+        if (isOverrideMode && existingRecord) {
+          // Override: 기존 레코드의 값 사용 → UPDATE
+          row[propName] = existingRecord.columns[propName]?.value;
         }
-      } else if (
-        isBelongsToOneRelationProp(prop) ||
-        (isOneToOneRelationProp(prop) && prop.hasJoinColumn)
-      ) {
-        insertData[`${propName}_id`] = column.value;
+        // 새 레코드: 제외 → INSERT (DB/UpsertBuilder가 생성)
+        continue;
+      }
+
+      if (isRelationProp(prop)) {
+        if (
+          isBelongsToOneRelationProp(prop) ||
+          (isOneToOneRelationProp(prop) && prop.hasJoinColumn)
+        ) {
+          const relatedId = column.value as number | null;
+          if (relatedId !== null && relatedId !== undefined) {
+            const relatedFixtureId = `${prop.with}#${relatedId}`;
+
+            // 먼저 skip된 fixture인지 확인
+            const skippedExistingId = this.skippedFixtures.get(relatedFixtureId)?.existingId;
+            if (skippedExistingId !== undefined) {
+              // skip된 fixture → target DB의 기존 레코드 id 사용
+              row[`${propName}_id`] = skippedExistingId;
+            } else {
+              const relatedRef = this.fixtureRefMap.get(relatedFixtureId);
+              if (relatedRef) {
+                // 이미 등록된 fixture 참조 → UBRef 사용
+                row[`${propName}_id`] = relatedRef;
+              } else {
+                // fixtures에 포함되지 않은 레코드 → ID 그대로 사용
+                row[`${propName}_id`] = relatedId;
+              }
+            }
+          } else {
+            row[`${propName}_id`] = null;
+          }
+        }
+        // HasMany, ManyToMany는 별도 처리
+      } else {
+        // 일반 컬럼
+        row[propName] = this.convertColumnValue(prop as EntityProp, column.value);
       }
     }
-    return insertData;
+
+    console.log(chalk.blue(`Registering ${entity.table} - ${inspect(row, false, null, true)}`));
+    const ref = this.builder.register(entity.table, row);
+    this.fixtureRefMap.set(fixture.fixtureId, ref);
+    this.uuidToFixtureId.set(ref.uuid, fixture.fixtureId);
+
+    return ref;
   }
 
-  private async insertFixture(db: Knex, fixture: FixtureRecord) {
-    const insertData = this.prepareInsertData(fixture);
-    const entity = EntityManager.get(fixture.entityId);
+  /**
+   * 컬럼 값 변환
+   */
+  private convertColumnValue(prop: EntityProp, value: unknown): unknown {
+    if (value === null || value === undefined) {
+      return null;
+    }
 
-    try {
-      const uniqueFound = await this.checkUniqueViolation(db, entity, fixture);
-      if (uniqueFound) {
-        return {
-          entityId: fixture.entityId,
-          id: uniqueFound.id,
-        };
-      }
+    switch (prop.type) {
+      case "json":
+        // UpsertBuilder.register에서 JSON.stringify 처리하므로 object 그대로 전달
+        return value;
 
-      const found = await db(entity.table).where("id", fixture.id).first();
-      if (found && !fixture.override) {
-        return {
-          entityId: fixture.entityId,
-          id: found.id,
-        };
-      }
+      case "date":
+        if (typeof value === "string" || typeof value === "number") {
+          return new Date(value);
+        }
+        return value;
+
+      default:
+        return value;
+    }
+  }
 
-      const q = db.insert(insertData).into(entity.table);
-      await q.onDuplicateUpdate.apply(q, Object.keys(insertData));
-      console.log(chalk.green(`Inserted into ${entity.table}: #${fixture.id}`));
+  /**
+   * 테이블 순서 추출 (fixtures에 포함된 테이블만)
+   */
+  private getTableOrder(fixtures: FixtureRecord[]): string[] {
+    const tables: string[] = [];
+    const seen = new Set<string>();
 
-      return {
-        entityId: fixture.entityId,
-        id: fixture.id,
-      };
-    } catch (err) {
-      console.log(err);
-      throw err;
+    for (const fixture of fixtures) {
+      const entity = EntityManager.get(fixture.entityId);
+      if (!seen.has(entity.table)) {
+        seen.add(entity.table);
+        tables.push(entity.table);
+      }
     }
+
+    return tables;
   }
 
-  private async handleManyToManyRelations(
-    db: Knex,
-    fixture: FixtureRecord,
-    fixtures: FixtureRecord[]
-  ) {
-    for (const [, column] of Object.entries(fixture.columns)) {
-      const prop = column.prop as EntityProp;
-      if (isManyToManyRelationProp(prop)) {
-        const joinTable = (prop as ManyToManyRelationProp).joinTable;
-        const relatedIds = column.value as number[];
-
-        for (const relatedId of relatedIds) {
-          if (
-            !fixtures.find((f) => f.fixtureId === `${prop.with}#${relatedId}`)
-          ) {
-            continue;
-          }
+  private async processManyToManyRelations(
+    trx: Knex.Transaction,
+    fixtures: FixtureRecord[],
+    insertedIdsByTable: Map<string, Map<string, number>>,
+  ): Promise<void> {
+    for (const fixture of fixtures) {
+      const entity = EntityManager.get(fixture.entityId);
+      const sourceRef = this.fixtureRefMap.get(fixture.fixtureId);
 
-          const entity = EntityManager.get(fixture.entityId);
+      if (!sourceRef) continue;
+
+      const sourceUuidToId = insertedIdsByTable.get(entity.table);
+      const sourceId = sourceUuidToId?.get(sourceRef.uuid);
+
+      if (sourceId === undefined) continue;
+
+      for (const [, column] of Object.entries(fixture.columns)) {
+        const prop = column.prop;
+
+        if (isManyToManyRelationProp(prop) && Array.isArray(column.value)) {
+          // 선택되지 않은 ManyToMany 관계는 저장하지 않음
+          const targetTable = EntityManager.get(prop.with);
+          if (this.builder.hasTable(targetTable.table) === false) continue;
+
+          const relatedIds = column.value as number[];
+          if (relatedIds.length === 0) continue;
+
+          const joinTable = (prop as ManyToManyRelationProp).joinTable;
           const relatedEntity = EntityManager.get(prop.with);
-          if (!entity || !relatedEntity) {
-            throw new Error(
-              `Entity not found: ${fixture.entityId}, ${prop.with}`
-            );
-          }
 
-          const [found] = await db(joinTable)
-            .where({
-              [`${inflection.singularize(entity.table)}_id`]: fixture.id,
-              [`${inflection.singularize(relatedEntity.table)}_id`]: relatedId,
-            })
-            .limit(1);
-          if (found) {
-            continue;
-          }
+          const sourceColumn = `${inflection.singularize(entity.table)}_id`;
+          const targetColumn = `${inflection.singularize(relatedEntity.table)}_id`;
 
-          const newIds = await db(joinTable).insert({
-            [`${inflection.singularize(entity.table)}_id`]: fixture.id,
-            [`${inflection.singularize(relatedEntity.table)}_id`]: relatedId,
-          });
-          console.log(
-            chalk.green(
-              `Inserted into ${joinTable}: ${entity.table}(${fixture.id}) - ${relatedEntity.table}(${relatedId}) ID: ${newIds}`
-            )
-          );
-        }
-      }
-    }
-  }
+          for (const relatedId of relatedIds) {
+            const relatedFixtureId = `${prop.with}#${relatedId}`;
+            const relatedRef = this.fixtureRefMap.get(relatedFixtureId);
 
-  async addFixtureLoader(code: string) {
-    const path = Sonamu.apiRootPath + "/src/testing/fixture.ts";
-    let content = readFileSync(path).toString();
+            let targetId: number;
 
-    const fixtureLoaderStart = content.indexOf("const fixtureLoader = {");
-    const fixtureLoaderEnd = content.indexOf("};", fixtureLoaderStart);
+            if (relatedRef) {
+              const relatedUuidToId = insertedIdsByTable.get(relatedEntity.table);
+              const resolvedId = relatedUuidToId?.get(relatedRef.uuid);
 
-    if (fixtureLoaderStart !== -1 && fixtureLoaderEnd !== -1) {
-      const newContent =
-        content.slice(0, fixtureLoaderEnd) +
-        "  " +
-        code +
-        "\n" +
-        content.slice(fixtureLoaderEnd);
+              if (resolvedId === undefined) {
+                console.warn(
+                  `Related fixture ${relatedFixtureId} not found in insertedIds, skipping`,
+                );
+                continue;
+              }
+              targetId = resolvedId;
+            } else {
+              targetId = relatedId;
+            }
 
-      writeFileSync(path, newContent);
-    } else {
-      throw new Error("Failed to find fixtureLoader in fixture.ts");
+            // JoinTable에 삽입
+            const [found] = await trx(joinTable)
+              .where({
+                [sourceColumn]: sourceId,
+                [targetColumn]: targetId,
+              })
+              .limit(1);
+
+            if (!found) {
+              await trx(joinTable).insert({
+                [sourceColumn]: sourceId,
+                [targetColumn]: targetId,
+              });
+
+              console.log(
+                chalk.green(
+                  `Inserted into ${joinTable}: ${entity.table}(${sourceId}) - ${relatedEntity.table}(${targetId})`,
+                ),
+              );
+            }
+          }
+        }
+      }
     }
   }
 
-  // 해당 픽스쳐의 값으로 유니크 제약에 위배되는 레코드가 있는지 확인
-  private async checkUniqueViolation(
-    db: Knex,
-    entity: Entity,
-    fixture: FixtureRecord
-  ) {
-    const _uniqueIndexes = entity.indexes.filter((i) => i.type === "unique");
+  private async checkUniqueViolation(db: Knex, entity: Entity, fixture: FixtureRecord) {
+    const _uniqueIndexes = entity.indexes?.filter((i) => i.type === "unique") ?? [];
 
-    // ManyToMany 관계 테이블의 유니크 제약은 제외
     const uniqueIndexes = _uniqueIndexes.filter((index) =>
-      index.columns.every((column) => !column.startsWith(`${entity.table}__`))
+      index.columns.every((column) => !column.startsWith(`${entity.table}__`)),
     );
     if (uniqueIndexes.length === 0) {
       return null;
     }
 
     let uniqueQuery = db(entity.table);
+    let hasCondition = false;
+
     for (const index of uniqueIndexes) {
       // 컬럼 중 하나라도 null이면 유니크 제약을 위반하지 않기 때문에 해당 인덱스는 무시
       const containsNull = index.columns.some((column) => {
-        const field = column.split("_id")[0];
-        return fixture.columns[field].value === null;
+        const field = column.replace(/_id$/, "");
+        return fixture.columns[field]?.value === null;
       });
       if (containsNull) {
         continue;
@@ -723,18 +776,71 @@ export class FixtureManagerClass {
 
       uniqueQuery = uniqueQuery.orWhere((qb) => {
         for (const column of index.columns) {
-          const field = column.split("_id")[0];
+          const field = column.replace(/_id$/, "");
 
-          if (Array.isArray(fixture.columns[field].value)) {
+          if (Array.isArray(fixture.columns[field]?.value)) {
             qb.whereIn(column, fixture.columns[field].value);
           } else {
-            qb.andWhere(column, fixture.columns[field].value);
+            qb.andWhere(column, fixture.columns[field]?.value);
           }
         }
       });
+      hasCondition = true;
+    }
+
+    if (!hasCondition) {
+      return null;
     }
+
     const [uniqueFound] = await uniqueQuery;
     return uniqueFound;
   }
+
+  private async checkDuplicateByColumns(
+    db: Knex,
+    entity: Entity,
+    fixture: FixtureRecord,
+    columns: string[],
+  ) {
+    if (columns.length === 0) {
+      return null;
+    }
+
+    const whereClause: Record<string, unknown> = {};
+
+    for (const column of columns) {
+      // relation 필드인 경우 _id 붙이기
+      const prop = entity.props.find((p) => p.name === column);
+      const dbColumn = prop && isRelationProp(prop) ? `${column}_id` : column;
+      const value = fixture.columns[column]?.value;
+
+      // null 값이 포함된 경우 중복 확인 스킵
+      if (value === null || value === undefined) {
+        return null;
+      }
+
+      whereClause[dbColumn] = value;
+    }
+
+    const [found] = await db(entity.table).where(whereClause).limit(1);
+    return found;
+  }
+
+  async addFixtureLoader(code: string) {
+    const path = `${Sonamu.apiRootPath}/src/testing/fixture.ts`;
+    const content = readFileSync(path).toString();
+
+    const fixtureLoaderStart = content.indexOf("const fixtureLoader = {");
+    const fixtureLoaderEnd = content.indexOf("};", fixtureLoaderStart);
+
+    if (fixtureLoaderStart !== -1 && fixtureLoaderEnd !== -1) {
+      const newContent = `${content.slice(0, fixtureLoaderEnd)}  ${code}\n${content.slice(fixtureLoaderEnd)}`;
+
+      writeFileSync(path, newContent);
+    } else {
+      throw new Error("Failed to find fixtureLoader in fixture.ts");
+    }
+  }
 }
+
 export const FixtureManager = new FixtureManagerClass();