first commit

docs/frontend/FRONTEND_ENV_SETUP.md

@@ -0,0 +1,48 @@
+# Frontend Env Setup
+
+## 目前 frontend 主線
+
+- `mkt.ose.tw/frontend` 為主線前端
+- 技術棧：`Vue 3 + Element Plus + Vuex + Vite`
+- API 正在由 Directus 逐步收斂到 FastAPI
+
+## env 來源
+
+```text
+frontend/env/.env.development
+frontend/env/.env.production
+frontend/env/.env.local
+```
+
+`vite.config.js` 目前允許：
+
+- `VITE_*`
+- `_*`（相容用途）
+
+## 建議欄位
+
+```env
+VITE_DIRECTUS_BASE_URL=https://mktcms.ose.tw
+VITE_MKTAPI_BASE_URL=https://mktapi.ose.tw
+VITE_DIRECTUS_DEBUG_TOKEN=
+```
+
+## local 建議
+
+```env
+VITE_DIRECTUS_BASE_URL=https://mktcms.ose.tw
+VITE_MKTAPI_BASE_URL=http://127.0.0.1:8011
+VITE_DIRECTUS_DEBUG_TOKEN=
+```
+
+## 舊欄位相容
+
+仍相容舊欄位：
+
+```env
+_API_URL
+_API_TOKEN
+```
+
+但新程式應以統一 config 與 service 層讀取，不在頁面直接散讀 env。
+