feat(frontend): Ant Design Pro SPA migration (P0–P5 + review fixes)

.build-info

@@ -0,0 +1,4 @@
+branch=feat/ant-design-pro-frontend-migration
+sha=fc5844bccd0028882a151617236b31c1a1f1bc63
+time=2026-08-09T09:44:14Z
+note=include-pr-128-129-zer381-fixes

.dockerignore

@@ -27,6 +27,8 @@ ENV/
 
 # Node / Jest
 node_modules/
+**/node_modules/
+**/dist/
 tests/
 
 # 数据库文件（使用 volume 挂载）

.github/workflows/docker-build-push.yml

@@ -8,13 +8,17 @@ on:
       - main
       - master
       - dev          # dev 分支自动构建 :dev 标签
+      - feat/ant-design-pro-frontend-migration
+      - cursor/zer-381-frontend-polish-b985
+      - cursor/railway-spa-deploy-e902
     paths:
       - '**.py'
       - 'pyproject.toml'
       - 'requirements.txt'
       - 'Dockerfile'
       - 'templates/**'
       - 'static/**'
+      - 'ant-design-pro/**'
       - '.github/workflows/docker-build-push.yml'
   workflow_dispatch:
 

.github/workflows/frontend-quality.yml

@@ -0,0 +1,67 @@
+name: Frontend Quality
+
+on:
+  pull_request:
+    paths:
+      - "ant-design-pro/**"
+      - ".github/workflows/frontend-quality.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  frontend-quality:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    defaults:
+      run:
+        working-directory: ant-design-pro
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: ant-design-pro/package-lock.json
+      - name: Install dependencies
+        run: npm ci --ignore-scripts --no-audit --no-fund
+      - name: Generate Umi runtime types
+        run: npx max setup
+      - name: Lint
+        run: npm run biome:lint
+      - name: Type check
+        run: npm run tsc
+      - name: Test
+        run: npm test
+      - name: Build
+        run: npm run build
+      - name: Start performance visual smoke server
+        run: |
+          nohup node scripts/performance-preview-server.mjs > /tmp/performance-preview.log 2>&1 &
+          for attempt in {1..30}; do
+            if curl --fail --silent http://127.0.0.1:4173/overview?tab=performance > /dev/null; then
+              exit 0
+            fi
+            sleep 1
+          done
+          cat /tmp/performance-preview.log
+          exit 1
+      - name: Capture performance dashboard
+        run: |
+          google-chrome --headless --no-sandbox --disable-gpu \
+            --window-size=1440,1200 --virtual-time-budget=5000 \
+            --screenshot=performance-dashboard.png \
+            "http://127.0.0.1:4173/overview?tab=performance"
+          google-chrome --headless --no-sandbox --disable-gpu \
+            --window-size=390,844 --virtual-time-budget=5000 \
+            --screenshot=performance-dashboard-mobile.png \
+            "http://127.0.0.1:4173/overview?tab=performance"
+          test -s performance-dashboard.png
+          test -s performance-dashboard-mobile.png
+      - name: Upload visual smoke artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: performance-dashboard
+          path: ant-design-pro/performance-dashboard*.png
+          if-no-files-found: error

.github/workflows/frontend.yml

@@ -0,0 +1,49 @@
+name: Frontend Checks
+
+on:
+  pull_request:
+    paths:
+      - "ant-design-pro/**"
+      - ".github/workflows/frontend.yml"
+  push:
+    branches:
+      - main
+      - dev
+    paths:
+      - "ant-design-pro/**"
+      - ".github/workflows/frontend.yml"
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Vitest, TypeScript, and build
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    defaults:
+      run:
+        working-directory: ant-design-pro
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: npm
+          cache-dependency-path: ant-design-pro/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run unit tests
+        run: npm test
+
+      - name: Run TypeScript checks
+        run: npm run tsc
+
+      - name: Build production bundle
+        run: npm run build

.github/workflows/sonar.yml

@@ -39,7 +39,7 @@ jobs:
           coverage xml
 
       - name: SonarQube Scan
-        uses: sonarsource/sonarqube-scan-action@v5
+        uses: sonarsource/sonarqube-scan-action@v6
         env:
           SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
           SONAR_HOST_URL: ${{ secrets.SONAR_HOST_URL }}

.gitignore

@@ -55,8 +55,14 @@ TODO.md
 
 # Node.js
 node_modules/
-package.json
-package-lock.json
+# 根目录 Jest 本地工具链（不入库）；ant-design-pro 前端工程单独跟踪
+/package.json
+/package-lock.json
+ant-design-pro/node_modules/
+ant-design-pro/dist/
+ant-design-pro/src/.umi/
+ant-design-pro/src/.umi-production/
+ant-design-pro/.swc/
 
 # 临时文件
 *.log

CHANGELOG.md

@@ -4,6 +4,53 @@ All notable changes to OutlookMail Plus are documented in this file.
 
 ## [Unreleased]
 
+### 优化 / Improvements
+
+- **ZER-657 新前端临时邮箱设置迁移补齐**：临时邮箱页的设置入口直达独立设置页签；恢复 Provider、API、域名、默认域名、前缀规则和 Cloudflare Worker 配置，并补充 JSON 结构校验、脱敏密钥保护与域名对象展示兼容。
+- **ZER-582 纯白前端服务展示优化**：保持现有纯白主题、导航与全局色板不变；API Key 改为名称 / 状态 / 脱敏 Token / 操作的简洁列表，权限和邮箱范围固定在创建时选择并通过详情查看；Webhook 测试展示已保存配置的真实投递 URL、上游 HTTP 状态、耗时和尝试次数，Token 留空表示清空；AI 测试区分连通性与契约状态，并在请求失败时保留端点、模型和 HTTP 诊断。
+- **版本号更新为 2.9.10**。
+
+### 集成 / Integration
+
+- **#109 新前端主线回收**：将 polish 分支与功能 PR（#130/#131/#132/#133/#134/#137）统一回收到 `feat/ant-design-pro-frontend-migration`（PR #109）。Railway 测试环境源分支改绑本分支。
+- **/healthz 构建标识**：返回 `git_sha` / `git_branch` / `build_time`，便于确认 Railway 实际运行提交。
+
+### 新增功能 / New Features
+
+- **ZER-381 新前端自动轮询对齐旧前端**：开启「自动轮询」设置后，标准模式选中账号即自动开始监听新邮件（对齐旧前端 `accounts.js` 选中即监听）；复制邮箱地址成功后立即开始监听该账号（对齐旧前端 `email-copied` 事件），覆盖注册收验证码主流程，不再只能手动拉取。
+- **ZER-381 顶栏 GitHub 链接**：头部操作区新增 GitHub 仓库入口（对齐旧前端抬头 `btn-github`），仓库地址逻辑抽取为 `utils/repoUrl.ts` 供顶栏与页脚复用。
+- **
+
+### 修复 / Bug Fixes
+
+- **ZER-381 监听完成后状态丢失**：轮询引擎停止/发现后不再删除条目，改为保留最终快照（`active=false`），「检测到验证码」「监听超时」等结果持续展示在账号卡片与简洁表格中。
+- **ZER-381 验证码提取后摘要不更新**：监听发现新邮件/验证码后自动刷新账号摘要与当前邮件列表；手动提取验证码成功后同步刷新，最新邮件摘要与摘要验证码即时更新。
+- **ZER-381 页面整页滚动与底部空白**：改为固定视口布局（对齐旧前端 `body{overflow:hidden}`），页面本身不再滚动，仅内容区内部滚动，顶栏与侧边栏保持固定。
+- **ZER-381 账号管理删除项字体不一致**：antd 主题 `fontFamily` 与全局 body 字体栈统一为同一 AlibabaSans 回退链，消除 AlibabaSans 加载失败时组件回退到不同默认字体造成的同页字体不一致。
+- **ZER-381 部署环境 logo/favicon 404**：Docker 镜像按 `.dockerignore` 排除了仓库 `img/` 目录，而 Flask `/img/<path>` 与 `/favicon.ico` 路由只从该目录取文件，导致新前端 logo、头像与 favicon 在部署环境全部 404。现在仓库文件缺失时回退到 SPA 构建产物（`ant-design-pro/public/img/`），两种运行环境均可加载。
+- **ZER-381 邮箱页账号栏信息不全且无法复制**：账号从截断的 Menu 项改为对齐旧前端的账号卡片——完整邮箱地址（截断改为完整展示，点击文本或复制图标即复制）、provider/状态/标签、备注、最近刷新时间，并恢复每账号快捷操作（验证码 / 复制 / 监听）。
+- **ZER-381 简洁模式竖排错乱**：简洁模式账号列表从竖排 List 改为横向长条表格（选择 / 邮箱(点击复制) / 验证码 / 最新邮件 / 分组标签 / 操作），对齐旧前端 `mail-row` 六列栅格；验证码按钮优先复用账号摘要码，无摘要码时兜底实时提取。
+- **ZER-381 邮件详情验证码区布局**：工具栏顺序对齐旧前端（提取并复制验证码主按钮 → 再次复制 → 信任原始 HTML），不再把信任开关放在最前。
+
+## [v2.9.7] - 2026-08-09
+
+### 修复 / Bug Fixes
+
+- **
+
+## [v2.9.6] - 2026-08-08
+
+### 优化 / Improvements
+
+- **
+
+## [v2.9.5] - 2026-08-05
+
+### 修复 / Bug Fixes
+
+- **ZER-381 无代理场景错误误分类**：仅在分组明确配置 `proxy_url` 时，才将 Graph 的 `ProxyError`/`ConnectionError` 判定为 `EMAIL_PROXY_CONNECTION_FAILED` / `PROXY_ERROR` 并跳过 IMAP 回退；无代理时继续 Graph → IMAP 回退。覆盖 `/api/emails`、external messages 与删除邮件回退路径。
+- **主题抽屉开关语义**：修正 Ant Design Pro `SettingDrawer` 的 `collapse` 开合状态接线。
+
 ## [v2.8.0] - 2026-07-26
 
 旧前端紧急版本（Issue #115）。在 SPA 新前端迁移（#109）之前，先发布一个范围受控、可回滚的稳定旧前端版本，合入近期关键缺陷修复与验证码能力增强。

Dockerfile

@@ -1,37 +1,39 @@
-# 使用 Python 3.11 作为基础镜像
+# syntax=docker/dockerfile:1
+
+FROM node:22-bookworm-slim AS frontend
+WORKDIR /frontend
+
+COPY ant-design-pro/ ./
+ENV HUSKY=0 CI=true
+RUN npm install --no-audit --no-fund --include=dev
+ENV NODE_ENV=production
+RUN npm run build
+
 FROM python:3.11-slim
 
-# 设置工作目录
 WORKDIR /app
 
-# 设置环境变量
 ENV PYTHONUNBUFFERED=1 \
     PYTHONDONTWRITEBYTECODE=1 \
     PIP_NO_CACHE_DIR=1 \
     GUNICORN_WORKERS=1 \
     GUNICORN_THREADS=8 \
-    GUNICORN_TIMEOUT=120
+    GUNICORN_TIMEOUT=120 \
+    SPA_ENABLED=true
 
-# 复制依赖文件
 COPY requirements.txt .
-
-# 安装依赖（pip 走国内镜像加速）
 RUN pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple && \
     pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple && \
     pip install gunicorn -i https://pypi.tuna.tsinghua.edu.cn/simple
 
-# 复制应用代码
 COPY . .
+COPY --from=frontend /frontend/dist /app/ant-design-pro/dist
 
-# 创建数据目录
-RUN mkdir -p /app/data && chmod +x /app/scripts/start-gunicorn.sh
+RUN mkdir -p /app/data && chmod +x /app/scripts/start-gunicorn.sh && \
+    if [ -f /app/.build-info ]; then cp /app/.build-info /app/.build_info_copy; fi
 
-# 暴露端口
 EXPOSE 5000
 
-# 健康检查
 HEALTHCHECK --interval=30s --timeout=5s --start-period=20s CMD ["python","-c","import urllib.request as u; u.urlopen('http://localhost:5000/healthz', timeout=4).read()"]
 
-# 启动应用：默认单 worker + 多线程，避免同步长轮询阻塞整站
-# 注意：禁用 --preload，避免在 master 进程中启动后台调度线程
 CMD ["scripts/start-gunicorn.sh"]

ant-design-pro/.commitlintrc.js

@@ -0,0 +1 @@
+module.exports = { extends: ['@commitlint/config-conventional'] };

ant-design-pro/.editorconfig

@@ -0,0 +1,16 @@
+# http://editorconfig.org
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab

ant-design-pro/.gitignore

@@ -0,0 +1,54 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+**/node_modules
+# roadhog-api-doc ignore
+/src/utils/request-temp.js
+_roadhog-api-doc
+
+# production
+/dist
+
+# misc
+.DS_Store
+npm-debug.log*
+yarn-error.log
+
+/coverage
+.idea
+yarn.lock
+*bak
+.vscode
+
+
+# visual studio code
+.history
+*.log
+functions/*
+.temp/**
+
+# claude code local settings
+.claude/settings.local.json
+
+# umi
+.umi
+.umi-production
+.umi-test
+.umi-undefined
+.turbopack
+
+# screenshot
+screenshot
+.firebase
+
+build
+
+# worktrees
+.worktrees
+
+# superpowers docs
+docs/superpowers
+
+# cloudflare wrangler
+.wrangler
+requestRecord.mock.js

ant-design-pro/.husky/commit-msg

@@ -0,0 +1 @@
+npx --no -- commitlint --edit $1

ant-design-pro/.husky/pre-commit

@@ -0,0 +1 @@
+lint-staged

ant-design-pro/.lintstagedrc

@@ -0,0 +1,8 @@
+{
+  "**/*.{js,jsx,tsx,ts,css,less}": [
+    "npx @biomejs/biome check --write"
+  ],
+  "src/**/*.md": [
+    "npx @biomejs/biome check --write"
+  ]
+}

ant-design-pro/.npmrc

@@ -0,0 +1 @@
+legacy-peer-deps=true