Initial commit: WebMail Gateway with PKCE support

- Multi-tenant routing support
- Keycloak SSO integration with PKCE
- Basic inbox functionality
- Redis session management

.gitignore

@@ -0,0 +1,43 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+ENV/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Logs
+*.log
+
+# OS
+.DS_Store
+Thumbs.db

Dockerfile

@@ -0,0 +1,10 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY app.py .
+
+CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "8000"]

README.md

@@ -0,0 +1,115 @@
+# WebMail Gateway
+
+多租戶 WebMail Gateway，整合 Keycloak SSO 和 IMAP/SMTP 郵件服務。
+
+## 功能
+
+- 🔐 Keycloak SSO 整合 (支援 PKCE)
+- 📧 IMAP/SMTP 郵件收發
+- 🏢 多租戶支援 (路徑參數路由)
+- 🔄 Redis Session 管理
+- 🎨 多主題支援 (待恢復)
+- 📎 附件支援 (待恢復)
+
+## 技術架構
+
+- **後端**: FastAPI + Python 3.11
+- **資料庫**: PostgreSQL (Virtual MIS Database)
+- **快取**: Redis
+- **認證**: Keycloak OAuth 2.0 + PKCE
+- **郵件**: IMAP (port 143) / SMTP (port 587)
+- **部署**: Docker + Traefik
+
+## 開發環境
+
+### 目錄結構
+
+```
+webmail-gateway/
+├── app.py                 # 主程式
+├── requirements.txt       # Python 依賴
+├── Dockerfile            # Docker 映像檔定義
+├── docker-compose.yml    # Docker Compose 配置
+└── README.md            # 說明文件
+```
+
+### 本地開發
+
+```bash
+# 安裝依賴
+pip install -r requirements.txt
+
+# 設定環境變數
+export REDIS_HOST=10.1.0.20
+export REDIS_PORT=6379
+export REDIS_PASSWORD=DC1qaz2wsx
+export REDIS_DB=2
+export DATABASE_URL=postgresql://admin:DC1qaz2wsx@10.1.0.20:5433/virtual_mis
+export KEYCLOAK_SERVER_URL=https://auth.lab.taipei
+
+# 啟動開發伺服器
+uvicorn app:app --host 0.0.0.0 --port 8000 --reload
+```
+
+### 部署到正式環境
+
+```bash
+# 1. 推送到 Gitea
+git add .
+git commit -m "Update WebMail Gateway"
+git push origin main
+
+# 2. SSH 到伺服器
+ssh porsche@10.1.0.254
+
+# 3. 拉取最新代碼
+cd /home/porsche/services/webmail-gateway
+git pull
+
+# 4. 重建並啟動容器
+docker compose down
+docker compose build
+docker compose up -d
+```
+
+## 多租戶路由
+
+### 訪問方式
+
+- **vmis-admin 租戶**: https://webmail.lab.taipei/vmis-admin
+- **porsche1 租戶**: https://webmail.lab.taipei/porsche1
+- **其他租戶**: https://webmail.lab.taipei/{tenant_code}
+
+### 自動導向邏輯
+
+1. 使用者訪問 `/{tenant_code}`
+2. 查詢租戶資訊 (從 Virtual MIS Database)
+3. 取得對應的 Keycloak Realm
+4. 生成 PKCE 參數
+5. 導向 Keycloak 登入頁面
+6. 回調處理並驗證 PKCE
+7. 建立 Session 並導向收件匣
+
+## Keycloak 配置
+
+每個租戶的 Realm 都需要建立 `webmail` client：
+
+- **Client ID**: webmail
+- **Client Type**: Public Client
+- **PKCE**: Enabled (S256)
+- **Standard Flow**: Enabled
+- **Redirect URI**: https://webmail.lab.taipei/{tenant_code}/callback
+
+## 待辦事項
+
+- [ ] 恢復完整 Gmail 風格 UI
+- [ ] 恢復主題切換功能
+- [ ] 恢復郵件詳情 Modal
+- [ ] 恢復批次刪除功能
+- [ ] 恢復 Rich Text 編輯器
+- [ ] 建立 Gitea 遠端倉庫
+- [ ] 設定 CI/CD 流程
+
+## 版本歷史
+
+- **v1.0** (2026-03-04): 基礎 PKCE 支援 + 多租戶路由

docker-compose.yml

@@ -0,0 +1,32 @@
+services:
+  webmail-gateway:
+    build: .
+    container_name: webmail-gateway
+    environment:
+      - REDIS_HOST=10.1.0.20
+      - REDIS_PORT=6379
+      - REDIS_PASSWORD=DC1qaz2wsx
+      - REDIS_DB=2
+      - DATABASE_URL=postgresql://admin:DC1qaz2wsx@10.1.0.20:5433/virtual_mis
+      - KEYCLOAK_SERVER_URL=https://auth.lab.taipei
+      - KEYCLOAK_REALM=vmis-admin
+      - KEYCLOAK_CLIENT_ID=vmis-services
+      - KEYCLOAK_CLIENT_SECRET=VirtualMIS2026ServiceSecret12345
+      - REDIRECT_URI=https://webmail.lab.taipei/callback
+    networks:
+      - traefik-network
+      - mailserver_mailserver-internal
+    labels:
+      - "traefik.enable=true"
+      - "traefik.docker.network=traefik-network"
+      - "traefik.http.routers.webmail.rule=Host(`webmail.lab.taipei`)"
+      - "traefik.http.routers.webmail.entrypoints=web,websecure"
+      - "traefik.http.routers.webmail.tls.certresolver=letsencrypt"
+      - "traefik.http.services.webmail.loadbalancer.server.port=8000"
+    restart: always
+
+networks:
+  traefik-network:
+    external: true
+  mailserver_mailserver-internal:
+    external: true

requirements.txt

@@ -0,0 +1,11 @@
+fastapi==0.115.0
+uvicorn[standard]==0.32.0
+authlib==1.3.2
+itsdangerous==2.2.0
+redis==5.2.0
+httpx==0.27.2
+python-multipart==0.0.12
+sqlalchemy==2.0.23
+psycopg2-binary==2.9.9
+imap-tools==1.7.1
+requests==2.31.0