fix: deploy.sh build check lenient + per-file import order (M4 feedback)

- Accept SRV_BUILD=unknown (skip build check, only compare version)
- Per-table import with explicit FK order (nodes before edges)

docs_v1.0/M4_HANDOVER/deploy.sh

@@ -33,14 +33,15 @@ SRV_VER=$(echo "$SRV" | cut -d' ' -f1)
 SRV_BUILD=$(echo "$SRV" | cut -d' ' -f2)
 if [ "$SRV_VER" = "down" ]; then
     echo "  ⚠️  Cannot reach server at localhost:3003, skipping version check"
-elif [ "$SRV_VER" != "$PKG_VER" ] || [ "$SRV_BUILD" != "$PKG_BUILD" ]; then
-    echo "  ❌ Mismatch:"
+elif [ "$SRV_VER" != "$PKG_VER" ]; then
+    echo "  ❌ Version mismatch:"
     echo "                 Package      Server"
     echo "    Version:    $PKG_VER      $SRV_VER"
-    echo "    Build:      $PKG_BUILD    $SRV_BUILD"
     echo ""
     echo "    Please obtain the matching system upgrade package."
     exit 1
+elif [ "$SRV_BUILD" != "unknown" ] && [ "$SRV_BUILD" != "$PKG_BUILD" ]; then
+    echo "  ⚠️  Build mismatch (package=$PKG_BUILD, server=$SRV_BUILD) — version ok, continuing"
 else
     echo "  ✅ Server v$SRV_VER (build $SRV_BUILD) matches package"
 fi
@@ -65,9 +66,23 @@ echo "[2/8] Pre-cleaning existing identities for this file..."
 "$PG_BIN/psql" -U "$DB_USER" -d "$DB_NAME" -c "DELETE FROM dev.identities WHERE file_uuid = '$UUID'" > /dev/null 2>&1
 echo "  ✅ Cleared identities for $UUID"
 
-# 3. Import data.sql (uses \i to load per-table files from sql/)
-echo "[3/8] Importing DB data..."
-(cd "$DIR" && "$PG_BIN/psql" -U "$DB_USER" -d "$DB_NAME" -f data.sql 2>&1) | tail -5
+# 3. Import each table file in dependency order (FK constraints)
+echo "[3/8] Importing DB data (per-table)..."
+IMPORT_ORDER=(
+    "sql/dev_videos.sql"
+    "sql/dev_chunk.sql"
+    "sql/dev_chunk_vectors.sql"
+    "sql/dev_face_detections.sql"
+    "sql/dev_identities.sql"
+    "sql/dev_identity_bindings.sql"
+    "sql/dev_tkg_nodes.sql"
+    "sql/dev_tkg_edges.sql"
+)
+for tbl_sql in "${IMPORT_ORDER[@]}"; do
+    tbl=$(basename "$tbl_sql" .sql)
+    echo "  Importing $tbl..."
+    "$PG_BIN/psql" -U "$DB_USER" -d "$DB_NAME" -f "$DIR/$tbl_sql" 2>&1 | tail -1
+done
 echo "  ✅ Data imported"
 
 # 4. Copy video to demo dir (only this package's video, not scanning others)

docs_v1.0/M4_workspace/2026-05-13_deploy_111614_response.md

@@ -0,0 +1,47 @@
+# 111614 包 deploy.sh 最終修正回報
+
+**Date**: 2026-05-13
+**From**: M4
+**To**: M5
+**Ref**: `2026-05-13_111614_test_report.md`
+
+---
+
+## ✅ 確認完成
+
+9 個 table 全部匯入成功，TMDB 7 演員匹配：
+
+| Table | Count | Status |
+|-------|------:|:--:|
+| videos | 1 | ✅ |
+| chunk | 2,407 | ✅ |
+| chunk_vectors | 2,407 | ✅ |
+| face_detections | 70,691 | ✅ |
+| identities (TMDB) | 7 | ✅ Cary Grant, Audrey Hepburn 等 |
+| identities (auto) | 417 | ✅ |
+| identity_bindings | 18,635 | ✅ |
+| tkg_nodes | 6,457 | ✅ |
+| tkg_edges | 21,028 | ✅ |
+| status | completed | ✅ |
+
+## deploy.sh 需微調 (2 項)
+
+### 1. build check 接受 `unknown`
+
+M4 的 playground binary 沒有 `build_git_hash` 欄位 → `/health` 回 `unknown`。目前 deploy.sh 將 `unknown` ≠ `d34bcae` 當作 mismatch → exit 1。
+
+**修正**：`SRV_BUILD` 為 `unknown` 時只比對 version，skip build check。
+
+### 2. import 改逐檔 `psql -f`
+
+`data.sql` 使用 `BEGIN; \i sql/*.sql COMMIT;` 包 transaction。任一 COPY 失敗（如 re-deploy 時 dup key），整個 transaction abort → 全部 table rollback。
+
+**修正**：deploy.sh import 步驟改為逐一 import `sql/*.sql` 每個檔案（各有自己的 auto-commit），而非透過 `data.sql` 的 `\i` chain。
+
+---
+
+## 檔案變更
+
+| 檔案 | 說明 |
+|------|------|
+| `deploy.sh` | build check lenient + import 改逐檔 |

scripts/deploy_package.sh

@@ -33,14 +33,15 @@ SRV_VER=$(echo "$SRV" | cut -d' ' -f1)
 SRV_BUILD=$(echo "$SRV" | cut -d' ' -f2)
 if [ "$SRV_VER" = "down" ]; then
     echo "  ⚠️  Cannot reach server at localhost:3003, skipping version check"
-elif [ "$SRV_VER" != "$PKG_VER" ] || [ "$SRV_BUILD" != "$PKG_BUILD" ]; then
-    echo "  ❌ Mismatch:"
+elif [ "$SRV_VER" != "$PKG_VER" ]; then
+    echo "  ❌ Version mismatch:"
     echo "                 Package      Server"
     echo "    Version:    $PKG_VER      $SRV_VER"
-    echo "    Build:      $PKG_BUILD    $SRV_BUILD"
     echo ""
     echo "    Please obtain the matching system upgrade package."
     exit 1
+elif [ "$SRV_BUILD" != "unknown" ] && [ "$SRV_BUILD" != "$PKG_BUILD" ]; then
+    echo "  ⚠️  Build mismatch (package=$PKG_BUILD, server=$SRV_BUILD) — version ok, continuing"
 else
     echo "  ✅ Server v$SRV_VER (build $SRV_BUILD) matches package"
 fi
@@ -65,9 +66,23 @@ echo "[2/8] Pre-cleaning existing identities for this file..."
 "$PG_BIN/psql" -U "$DB_USER" -d "$DB_NAME" -c "DELETE FROM dev.identities WHERE file_uuid = '$UUID'" > /dev/null 2>&1
 echo "  ✅ Cleared identities for $UUID"
 
-# 3. Import data.sql (uses \i to load per-table files from sql/)
-echo "[3/8] Importing DB data..."
-(cd "$DIR" && "$PG_BIN/psql" -U "$DB_USER" -d "$DB_NAME" -f data.sql 2>&1) | tail -5
+# 3. Import each table file in dependency order (FK constraints)
+echo "[3/8] Importing DB data (per-table)..."
+IMPORT_ORDER=(
+    "sql/dev_videos.sql"
+    "sql/dev_chunk.sql"
+    "sql/dev_chunk_vectors.sql"
+    "sql/dev_face_detections.sql"
+    "sql/dev_identities.sql"
+    "sql/dev_identity_bindings.sql"
+    "sql/dev_tkg_nodes.sql"
+    "sql/dev_tkg_edges.sql"
+)
+for tbl_sql in "${IMPORT_ORDER[@]}"; do
+    tbl=$(basename "$tbl_sql" .sql)
+    echo "  Importing $tbl..."
+    "$PG_BIN/psql" -U "$DB_USER" -d "$DB_NAME" -f "$DIR/$tbl_sql" 2>&1 | tail -1
+done
 echo "  ✅ Data imported"
 
 # 4. Copy video to demo dir (only this package's video, not scanning others)