能力概览

Art Design Pro X 的核心价值不是堆叠页面数量，而是提供一套可以持续扩展的中后台前端基础设施。你可以直接使用现有布局、菜单、表格、权限、主题和业务页面，也可以在不改变页面层的前提下逐步替换数据来源。

能力分层

应用基础设施

项目已经内置：

• Vue Router 静态路由、动态菜单路由和运行时注册机制。
• Bearer Token 请求、统一响应解包、错误提示和 401 登出处理。
• Pinia 状态管理、按 Store 持久化和版本化存储键。
• 多布局菜单、工作标签页、面包屑、全局搜索和快捷入口。
• 亮色、暗色、系统主题与运行时主题定制。
• 中英文国际化和 Element Plus 语言联动。
• 构建版本检测、代码分包、Gzip 产物和开发代理。

页面开发能力

普通业务页面可以复用：

场景	主要能力
搜索表单	ArtSearchBar 配置式字段、校验、重置与响应式布局
数据列表	useTable 请求、分页、筛选、刷新和响应适配
表格展示	ArtTable 列配置、选择、固定列、分页和加载状态
表格工具栏	ArtTableHeader 刷新、列设置和业务操作插槽
权限按钮	v-auth、v-roles、hasAuth、hasRole
弹窗表单	Element Plus 表单与项目现有弹窗组织方式
安全 HTML	ArtSafeHtml 与 DOMPurify 白名单渲染

标准列表页建议从 src/views/system/user 开始阅读，而不是从零手写分页和查询状态。

业务模块

当前源码已经覆盖以下前端业务域：

• 仪表盘与多套业务看板
• 数据大屏
• 用户、角色、部门、岗位、菜单、字典和系统参数
• 登录日志、操作日志、在线用户和安全审计页面
• 内容分类、标签、内容列表、详情和回收站
• 通知中心与通知管理
• 工作流定义、实例、任务和设计器
• 调度任务与执行日志
• 文件和资源选择
• 图表、富文本、Excel、视频、二维码、拖拽等组件示例

这些页面提供了真实的前端结构和交互参考，但其生产数据能力取决于你是否已经接入对应后端。

数据能力矩阵

能力	初始实现	是否需要客户后端
登录	真实 API	是，至少实现登录接口
退出登录	真实 API	是
当前用户、角色、按钮权限	真实 API	是
本地菜单	前端路由 + 角色过滤	否
远程菜单	/api/v1/user/menus	仅启用 remote 时需要
注册	本地说明型实现	正式开放注册时需要
个人资料、密码、会话	本地预置数据	生产使用时需要
业务列表查询	src/mock 预置数据	可按页面逐步接入
新增、编辑、删除	明确提示未写入服务端	需要
通知实时推送	未内置	需要 WebSocket、SSE 或其他服务
文件持久化	会话内预览或预置记录	需要文件服务或对象存储
工作流执行	前端页面与设计器	需要流程引擎
调度任务执行	前端管理页面	需要调度器和执行器
监控与审计采集	前端展示页面	需要服务端采集与存储
AI 模型调用	前端演示	需要服务端代理并保护密钥

不要把界面能力等同于生产能力

例如“工作流设计器存在”说明前端已经具备流程建模界面，不代表浏览器可以可靠执行流程；“文件中心存在”说明已有资源管理交互，不代表文件已经上传到对象存储。生产能力必须由后端完成权限、持久化、一致性、审计和任务执行。

认证与权限特点

纯前端商业版采用容易与现有后端对接的标准模型：

• 登录参数使用普通 JSON，通过 HTTPS 保护传输。
• 登录成功后保存 accessToken。
• 后续请求自动携带 Authorization: Bearer <accessToken>。
• 页面刷新后恢复 Token，并通过 /api/v1/user/info 重新校验会话。
• 当前没有内置 Refresh Token、请求签名、Nonce、时间戳、RSA 密码加密或图片验证码协议。

这意味着你不需要复制前后端商业版的后端协议，但必须根据自己的安全要求在服务端设计登录限制、令牌有效期、风控和审计。

渐进式接入

项目允许在同一阶段同时存在三类页面：

已完成接口迁移的页面  -> src/api/customer/* -> 客户后端
尚未迁移的业务页面    -> src/mock/*         -> 前端预置数据
认证与会话             -> src/api/auth.ts    -> 最小认证后端

推荐迁移顺序：

1. 先完成登录、当前用户和退出登录。
2. 决定菜单使用 local 还是 remote。
3. 选择一个标准列表页，先迁移查询和分页。
4. 再迁移新增、编辑、删除，并完成服务端鉴权。
5. 一个页面验收通过后，再继续同一业务域的其他页面。

详细方法见本地数据模式和接口接入。

版本选择建议

选择纯前端商业版时，你获得的是更高的后端自由度，也需要自己承担服务端实现。选择前后端商业版时，前后端契约和业务服务已经配套，但技术栈与数据模型更固定。

在正式开发前，建议先阅读功能与交付边界，把需要保留的页面、必须建设的后端能力和计划删除的演示模块列成项目清单。