From 6dabc2eab640c5fffae10a660f0be4be0c2f135a Mon Sep 17 00:00:00 2001
From: Chris <wtc.justin82@gmail.com>
Date: Fri, 3 Apr 2026 04:31:59 +0800
Subject: [PATCH] Document single backend .env workflow

---
 backend                   |  2 +-
 docs/LOCAL_DEV_RUNBOOK.md | 11 ++++++++++-
 2 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/backend b/backend
index 065f1d5..7c4364b 160000
--- a/backend
+++ b/backend
@@ -1 +1 @@
-Subproject commit 065f1d52f0d66588773acfba019a7917de504cf9
+Subproject commit 7c4364b52f82f9654082e0734598c6cdaa98c668
diff --git a/docs/LOCAL_DEV_RUNBOOK.md b/docs/LOCAL_DEV_RUNBOOK.md
index 8545c6f..1662fab 100644
--- a/docs/LOCAL_DEV_RUNBOOK.md
+++ b/docs/LOCAL_DEV_RUNBOOK.md
@@ -8,6 +8,15 @@ psql "$DATABASE_URL" -f scripts/init_schema.sql
 - DB schema 檔案：[backend/scripts/init_schema.sql](../backend/scripts/init_schema.sql)
 
 ## 2) 啟動後端
+先準備 `.env`：
+```bash
+cd backend
+cp .env.example .env
+```
+
+本機開發與 VPS 一律使用 `backend/.env`（不再分 `.env.development`）。
+
+再啟動：
 ```bash
 cd backend
 ./scripts/start_dev.sh
@@ -23,7 +32,7 @@ npm run dev
 ```
 - 專案路徑：[frontend](../frontend)
 
-## 4) 必要環境變數（[backend/.env.development](../backend/.env.development)）
+## 4) 必要環境變數（[backend/.env](../backend/.env)）
 - `KEYCLOAK_BASE_URL`
 - `KEYCLOAK_REALM`
 - `KEYCLOAK_CLIENT_ID`