feat: 後端API

2026-08-06 14:34:20 +08:00
parent db6fe95a11
commit 60c4a414a3
8 changed files with 230 additions and 74 deletions
@@ -1,5 +1,19 @@
-# 後端 API base URL；留空則使用同網域的 /api
+# 後端 API base URL；留空則使用同網域的相對路徑 /api
+#
+# 目前的後端沒有開放 CORS，瀏覽器直接跨網域呼叫會被擋下（OPTIONS preflight 回 405、
+# 回應也沒有 Access-Control-Allow-Origin）。因此本機開發改用下面的 API_PROXY_TARGET
+# 讓 dev server 轉發 /api，這裡的 VITE_API_BASE_URL 留空即可，不要直接填後端網址。
+#
+# 本機開發：複製這份檔案為 .env.local（已在根目錄 .gitignore 以 *.local 排除，不進版控），
+# 填入內網後端位址，例如：
+#   API_PROXY_TARGET=http://192.168.89.54:9004/service/api
+#   VITE_API_BASE_URL=
+#
+# 正式站（Cloudflare Pages）：後端目前是內網位址，Cloudflare 的邊緣節點連不到，
+# 尚未有可用的正式站串接方式（例如另開對外網址、或架 Cloudflare Tunnel），
+# 待確定後再設定 Cloudflare Pages 專案的 Settings → Environment variables。
 VITE_API_BASE_URL=

 # 後端尚未完成前保持 true，改為 false 才會實際發出 API 請求
+# 本機串接測試請在 .env.local 覆寫為 false
 VITE_USE_MOCK=true