From 6adca8c229c3e5fe84267dc758c072499a689ca5 Mon Sep 17 00:00:00 2001
From: Chris <wtc.justin82@gmail.com>
Date: Fri, 3 Apr 2026 01:10:13 +0800
Subject: [PATCH] fix: add provider column migration script for existing db

---
 backend/scripts/migrate_provider_columns.sql | 67 ++++++++++++++++++++
 docs/LOCAL_DEV_RUNBOOK.md                    | 21 ++++++
 2 files changed, 88 insertions(+)
 create mode 100644 backend/scripts/migrate_provider_columns.sql

diff --git a/backend/scripts/migrate_provider_columns.sql b/backend/scripts/migrate_provider_columns.sql
new file mode 100644
index 0000000..1e3b4b6
--- /dev/null
+++ b/backend/scripts/migrate_provider_columns.sql
@@ -0,0 +1,67 @@
+-- Rename legacy IdP column names to provider_* naming.
+-- Safe to run multiple times.
+
+DO $$
+BEGIN
+  IF EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_schema = 'public' AND table_name = 'companies' AND column_name = 'idp_group_id'
+  ) AND NOT EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_schema = 'public' AND table_name = 'companies' AND column_name = 'provider_group_id'
+  ) THEN
+    ALTER TABLE public.companies RENAME COLUMN idp_group_id TO provider_group_id;
+  END IF;
+END $$;
+
+DO $$
+BEGIN
+  IF EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_schema = 'public' AND table_name = 'sites' AND column_name = 'idp_group_id'
+  ) AND NOT EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_schema = 'public' AND table_name = 'sites' AND column_name = 'provider_group_id'
+  ) THEN
+    ALTER TABLE public.sites RENAME COLUMN idp_group_id TO provider_group_id;
+  END IF;
+END $$;
+
+DO $$
+BEGIN
+  IF EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_schema = 'public' AND table_name = 'systems' AND column_name = 'idp_client_id'
+  ) AND NOT EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_schema = 'public' AND table_name = 'systems' AND column_name = 'provider_client_id'
+  ) THEN
+    ALTER TABLE public.systems RENAME COLUMN idp_client_id TO provider_client_id;
+  END IF;
+END $$;
+
+DO $$
+BEGIN
+  IF EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_schema = 'public' AND table_name = 'roles' AND column_name = 'idp_role_name'
+  ) AND NOT EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_schema = 'public' AND table_name = 'roles' AND column_name = 'provider_role_name'
+  ) THEN
+    ALTER TABLE public.roles RENAME COLUMN idp_role_name TO provider_role_name;
+  END IF;
+END $$;
+
+DO $$
+BEGIN
+  IF EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_schema = 'public' AND table_name = 'users' AND column_name = 'idp_user_id'
+  ) AND NOT EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_schema = 'public' AND table_name = 'users' AND column_name = 'provider_user_id'
+  ) THEN
+    ALTER TABLE public.users RENAME COLUMN idp_user_id TO provider_user_id;
+  END IF;
+END $$;
diff --git a/docs/LOCAL_DEV_RUNBOOK.md b/docs/LOCAL_DEV_RUNBOOK.md
index fe352a8..8839f7a 100644
--- a/docs/LOCAL_DEV_RUNBOOK.md
+++ b/docs/LOCAL_DEV_RUNBOOK.md
@@ -7,6 +7,27 @@ psql "$DATABASE_URL" -f scripts/init_schema.sql
 ```
 - DB schema 檔案：[backend/scripts/init_schema.sql](../backend/scripts/init_schema.sql)
 
+如果你是 macOS 本機沒裝 `psql`，改用：
+```bash
+cd backend
+./.venv/bin/python - <<'PY'
+import psycopg
+from pathlib import Path
+sql = Path('scripts/migrate_provider_columns.sql').read_text()
+with psycopg.connect(
+    host='127.0.0.1',
+    port=54321,
+    dbname='member.ose.tw',
+    user='member_ose',
+    password='你的DB密碼'
+) as conn:
+    with conn.cursor() as cur:
+        cur.execute(sql)
+print('provider column migration done')
+PY
+```
+- 欄位改名 migration：[backend/scripts/migrate_provider_columns.sql](../backend/scripts/migrate_provider_columns.sql)
+
 ## 2) 啟動後端
 ```bash
 cd backend