MiragenFlow 前后台组件统一迁移方案

MiragenFlow 前后台组件统一迁移方案 由 Archify 生成的架构图。 用户端页面 · web/src/pages + user-console · 用户端现状与历史节点 · 保留页面与业务流程 用户端页面 web/src/pages + user-console 保留页面与业务流程 历史 Ant Design · 已从当前用户端依赖清理 · 用户端现状与历史节点 · 历史迁移节点 历史 Ant Design 已从当前用户端依赖清理 历史迁移节点 历史 Radix 封装 · 普通控件已收敛 · 用户端现状与历史节点 · 历史迁移节点 历史 Radix 封装 普通控件已收敛 历史迁移节点 用户端样式适配层 · 保留用户 tokens 与页面 API · 目标：统一 TDesign 与 Lineicons › 用户端现状与历史节点 · 过渡与隔离边界 用户端样式适配层 保留用户 tokens 与页面 API 过渡与隔离边界 管理台页面 · admin/src/pages + layouts · 现状：管理台依赖 · 页面业务不变 管理台页面 admin/src/pages + layouts 页面业务不变 管理台 TDesign · tdesign-react + 现有主题 · 现状：管理台依赖 · 保持视觉不变 管理台 TDesign tdesign-react + 现有主题 保持视觉不变 统一 TDesign 基础层 · 组件、弹层、交互与无障碍 · 目标：统一 TDesign 与 Lineicons · 目标共享层 统一 TDesign 基础层 组件、弹层、交互与无障碍 目标共享层 本地 Lineicons · web 与 admin 精选子集 · 目标：统一 TDesign 与 Lineicons · 两端共用图标规范 本地 Lineicons web 与 admin 精选子集 两端共用图标规范 共享接口契约 · packages/contracts · 稳定业务边界 · 与 UI 解耦 共享接口契约 packages/contracts 与 UI 解耦 平台服务端 · server/src/app/http.ts · 稳定业务边界 · 业务逻辑不迁移 平台服务端 server/src/app/http.ts 业务逻辑不迁移 页面 props 保留 组件 API 适配 当前已接入 抽取稳定基础能力 图标插槽统一 用户端现状与历史节点 现状：管理台依赖 目标：统一 TDesign 与 Lineicons 稳定业务边界 图例 前端 后端 外部系统

可行性结论

  • • 可行：UI 组件替换不改变 server、contracts、路由和业务数据
  • • 管理台 TDesign 作为视觉基准，用户端通过适配层保留现有 tokens 与布局
  • • 统一后可减少重复弹层、表单状态和依赖加载

保留与删除

  • • 保留用户端页面、中文文案、主题变量、业务组件和 Lineicons
  • • 完成等价能力后删除用户端 Ant Design 核心依赖与重复的 Radix 普通控件封装
  • • 标签多选、搜索下拉、日期、上传和画布控件先由适配层承接

迁移门槛

  • • 先建立 TDesign 主题桥接和用户端适配 API，禁止新页面继续引入 Ant Design
  • • 每类控件都要验证键盘、ESC、遮罩、主题、移动端和表单受控状态
  • • 按普通输入/选择器、反馈弹层、复杂业务组件分批切换并逐批删除旧依赖