Skip to content

fix(frontend): SPA 去脚手架/AI 味体验打磨 - #110

Closed
ZeroPointSix wants to merge 14 commits into
mainfrom
cursor/spa-ux-polish-d7dc
Closed

fix(frontend): SPA 去脚手架/AI 味体验打磨#110
ZeroPointSix wants to merge 14 commits into
mainfrom
cursor/spa-ux-polish-d7dc

Conversation

@ZeroPointSix

Copy link
Copy Markdown
Owner

Summary

针对第二版 UAT 体验走查中的「AI 味 / 脚手架感」问题做产品化打磨。

本提交也已推送到 PR #109 分支 feat/ant-design-pro-frontend-migration17c5417),便于同一 UAT 环境拉取重建。

改动要点

  • 去掉业务页 对接 /api/... 联调式副标题,改为正常产品文案
  • 默认语言 zh-CN;登录 placeholder / 按钮中文化;去掉 ant.design 残留
  • Footer / manifest / title 品牌统一为「Outlook 邮件管理」,去掉 Umi/Utoo 展示
  • 账号/邮箱池状态枚举中文化;Provider → 来源
  • Mailbox 错误可读化:中文原因 + 重试,JSON 收进可折叠「技术详情」
  • 修复审计 Trace ID 显示 [object Object]
  • 生产环境隐藏 SettingDrawer;补齐 SPA public/img/ico.png

Test plan

  • UAT 重建后登录页:中文「请输入登录密码」/「登录」,logo 正常,页脚无 Ant Design Pro
  • 侧栏默认中文
  • Accounts / Pool 状态显示「正常/失败/可用」等中文
  • Mailbox Token 失败时不再默认整页 JSON
  • 审计 Trace ID 为可读字符串

对照走查评论:见 PR #109 体验走查评论。

Slack Thread

Open in Web Open in Cursor 

ZeroPointSix and others added 14 commits July 10, 2026 18:28
引入 ant-design-pro 作为与 outlook_web 平级的前端工程,完成 Flask
session/CSRF 鉴权适配与业务路由骨架,作为按功能迁移的基础设施。

- 后端新增 /api/auth/current-user、/api/auth/logout,兼容旧 /logout
- 前端 proxy 到 Flask,统一 credentials + CSRF 请求封装
- 登录页改为单密码;菜单对齐旧侧栏功能模块
- 补充 SPA 鉴权适配单测(含对抗用例)
将旧 dashboard 的五个概览 Tab 迁到 /overview:
- services/outlook/overview 对接 /api/overview/*
- 按 Tab 懒加载(react-query useQuery)
- KPI / 进度 / 表格展示账号、验证码、对外 API、邮箱池、活动
- 补充 overview API 契约测试与 utils 单测
将账号/分组管理迁入 Ant Design Pro:
- services/outlook/accounts|groups 对接列表、创建、更新、删除
- /groups:ProTable + ModalForm CRUD,过滤临时邮箱系统组
- /accounts:分页搜索、分组筛选、删除与跳转邮箱
- 补充 accounts/groups API 契约测试(含重名对抗)
对接 /api/emails 与 /api/email 详情链路:账号选择、文件夹切换、列表/详情双栏、502 错误 details 展示、批量删除。补充邮件 API 契约测试(登录鉴权、404、全链路失败结构、成功字段形状)。
临时邮箱三栏工作区(生成/列表/消息/详情)对接 /api/temp-emails/*;插件管理对接安装/卸载/配置/连接测试/应用变更。补充 P4 API 契约测试。
完成设置 Tabs、审计日志、邮箱池管理、OAuth Token 工具与刷新日志页面迁移;补充对应 service 层与 P5 API 契约测试。
Align SPA pool filters/actions with backend true|false|all and ACTION_RULES,
narrow /token-tool proxy to OAuth callback only, normalize HTTP error bodies
in outlookRequest, and harden P5 contract tests.
Support masked secret fields on settings page (skip unchanged masks on
save), document production build/proxy cutover, and list residual SPA gaps.
Bring remote pool/gunicorn/docs updates into the Ant Design Pro migration branch before opening the PR.
Login succeeds but post-auth layout crashes with ReferenceError: Link is not defined because menuItemRender uses <Link> without importing it from @umijs/max.
Align Ant Design Pro admin with Flask contracts and old UI capabilities:
account batch/export, pool claimed rules, multi-key settings, mailbox
3-column workbench with resizable layout and compact poll controls.
Replace API-style PageContainer subTitles with product copy, localize
status enums, improve mailbox errors, fix audit trace_id rendering,
default locale to zh-CN, and align brand/footer/logo for Outlook 邮件管理.

Co-authored-by: ZeroPointSix <ZeroPointSix@users.noreply.github.com>

Copy link
Copy Markdown
Owner Author

仓库清理结论:本 PR 的 UX 打磨提交已经同步进入主迁移 PR #109(对应提交与后续修复均已在 #109 演进)。为避免同一功能保留两个发布入口,现关闭本辅助 PR;后续统一在 #109 跟踪。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants