diff --git a/LOGICAL_RELATIONSHIPS.md b/LOGICAL_RELATIONSHIPS.md
index 52105c9..850b2b5 100644
--- a/LOGICAL_RELATIONSHIPS.md
+++ b/LOGICAL_RELATIONSHIPS.md
@@ -1,6 +1,6 @@
 # 논리적 데이터베이스 관계 문서
 
-> **자동 생성**: 2025-12-02 20:39:31
+> **자동 생성**: 2025-12-03 15:19:21
 > **소스**: Eloquent 모델 관계 분석
 
 ## 📊 모델별 관계 현황
diff --git a/database/migrations/2025_12_02_232143_alter_failed_step_column_in_admin_api_flow_runs_table.php b/database/migrations/2025_12_02_232143_alter_failed_step_column_in_admin_api_flow_runs_table.php
new file mode 100644
index 0000000..91a022a
--- /dev/null
+++ b/database/migrations/2025_12_02_232143_alter_failed_step_column_in_admin_api_flow_runs_table.php
@@ -0,0 +1,30 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+/**
+ * failed_step 컬럼 타입 변경
+ *
+ * 원인: FlowExecutor가 stepId (문자열, 예: 'login')를 반환하는데,
+ *       컬럼이 smallint로 정의되어 있어서 저장 실패
+ *
+ * 변경: smallint → varchar(100)
+ */
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('admin_api_flow_runs', function (Blueprint $table) {
+            $table->string('failed_step', 100)->nullable()->change();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('admin_api_flow_runs', function (Blueprint $table) {
+            $table->smallInteger('failed_step')->nullable()->change();
+        });
+    }
+};