Add development environment setup and deployment guides

QUICK_START.md

@@ -0,0 +1,92 @@
+# WebMail Gateway 快速開發指南
+
+## 開發環境設定 (最簡單方式)
+
+### 第一步：停止正式環境
+
+```bash
+ssh porsche@10.1.0.254 'cd /home/porsche/services/webmail-gateway && docker compose down'
+```
+
+### 第二步：在開發機啟動服務
+
+```batch
+cd D:\_Develop\porscheworld_develop\webmail-gateway
+START_DEVELOPMENT.bat
+```
+
+服務會在 `http://10.1.0.245:8100` 啟動
+
+### 第三步：測試訪問
+
+**方式 A: 直接訪問開發機 (推薦)**
+- ✅ http://10.1.0.245:8100/vmis-admin
+- ✅ http://10.1.0.245:8100/porsche1
+
+**方式 B: 透過 SSH 隧道**
+```bash
+# 在本機執行
+ssh -L 8100:10.1.0.245:8100 porsche@10.1.0.254
+
+# 然後訪問
+# http://localhost:8100/vmis-admin
+```
+
+**方式 C: 修改 hosts 檔案 (如果需要 HTTPS)**
+```
+# Windows: C:\Windows\System32\drivers\etc\hosts
+10.1.0.245  webmail.lab.taipei
+```
+然後訪問: http://webmail.lab.taipei:8100/vmis-admin
+
+---
+
+## 開發完成後：部署到正式環境
+
+### 快速部署
+
+```bash
+# 1. 上傳修改的檔案
+scp app.py porsche@10.1.0.254:/home/porsche/services/webmail-gateway/
+
+# 2. 重啟正式環境
+ssh porsche@10.1.0.254 'cd /home/porsche/services/webmail-gateway && docker compose down && docker compose build && docker compose up -d'
+```
+
+### 透過 Git 部署 (建立 Gitea 倉庫後)
+
+```bash
+# 1. 提交變更
+git add .
+git commit -m "Feature: 完整 UI 功能"
+git push gitea main
+
+# 2. 伺服器拉取
+ssh porsche@10.1.0.254
+cd /home/porsche/services/webmail-gateway
+git pull
+docker compose down && docker compose build && docker compose up -d
+```
+
+---
+
+## 重要注意事項
+
+⚠️ **Keycloak Redirect URI**
+
+開發時如果使用不同的 URL，需要更新 Keycloak client 的 Redirect URI：
+
+```
+正式環境: https://webmail.lab.taipei/{tenant_code}/callback
+開發環境: http://10.1.0.245:8100/{tenant_code}/callback
+```
+
+可以同時設定兩個 URI，這樣開發和正式環境都能用。
+
+⚠️ **Redis 和 Database**
+
+開發環境會直接連接正式環境的 Redis (10.1.0.20) 和 PostgreSQL (10.1.0.20)，請小心操作。
+
+⚠️ **Session 衝突**
+
+如果同時有人在使用正式環境，Session 可能會衝突。建議開發時使用測試帳號。