前端能力概览
本文面向需要评估 art-design-pro-x-ui 功能范围的研发团队。它用于确认商业版前端已经提供哪些页面与平台能力，以及哪些内容需要在业务项目中继续配置或改造。
核心能力
art-design-pro-x-ui 面向中后台业务项目，重点能力包括：
- 登录、注册、忘记密码、用户中心等账号相关页面。
- 动态菜单、路由注册、按钮权限和用户信息初始化链路。
- 系统管理、监控、通知、定时任务、工作流、内容管理、商城等业务页面。
- 站点配置、布局主题、国际化、全局搜索、工作标签页等平台体验能力。
- 基于 Vue 3、TypeScript、Vite、Pinia、Element Plus 的工程化开发基础。
后端版本与功能边界
Java 与 Nest.js 前后端版使用同一套前端源码，页面入口由所选后端返回的菜单和当前角色权限决定。不能仅凭 src/views 中存在页面，就判断后端已提供对应能力。
| 能力 | 共用方式与版本差异 |
|---|---|
| 布局、主题、通用组件、表格、国际化 | 共用前端实现，无需按后端复制维护 |
| 登录、刷新令牌、动态菜单、站点配置 | 共用前端接口封装，连接所选后端并完成联调 |
| 开发工具与 AI 代码生成器 | Java 版不包含；Nest.js 版按其交付范围使用 |
| AI 助手 | 共用聊天页面与流式接口；Java 提供对话，不执行业务操作、不读取业务表，也不持久化对话历史，模型服务需自行配置 |
| 审批中心 | 共用管理页面；Java 内嵌 Flowable，后端配置、扩展和迁移以 Java 源码说明为准 |
| 商城 | Java 提供后台业务模块，不包含独立消费者客户端，不提供商城租户或部门级数据隔离；在线支付需商户配置与实际环境验证 |
| 文件中心 | Java 支持本地、阿里云 OSS、MinIO；前端当前尚未定义 MINIO 类型、标签和筛选选项，启用 MinIO 需补齐这些展示适配 |
MinIO 的上传、预览和下载链路可以使用，但不能把缺少存储标签与筛选选项描述为完全适配。其他存储提供方也应以所选后端实际实现为准，前端枚举不代表后端支持范围。
Java 初始库提供管理员、角色、菜单权限和必要配置，不导入演示组织、商品与交易数据。菜单或列表与在线演示不同不一定是故障；先核对安装数据、角色授权和业务配置。更完整的 Java 产品范围见交付仓库 PRODUCT.md。
模块落点
| 能力 | 主要落点 |
|---|---|
| 页面实现 | src/views |
| 接口封装 | src/api |
| 动态路由 | src/router/modules、src/router/routes |
| 菜单与用户状态 | src/store/modules/menu.ts、src/store/modules/user.ts |
| 站点与主题配置 | src/config、src/store/modules/site-settings.ts、src/store/modules/setting.ts |
| 通用组件与逻辑 | src/components、src/hooks、src/utils |
配置建议
开始接入前，建议至少确认：
- 前端能通过真实后端完成登录、刷新令牌、用户信息、菜单和站点配置加载。
- 需要保留、裁剪或项目定制的业务模块已经明确。
- 新增页面已同步路由模板、菜单配置、按钮权限和后端接口。
- 生产环境部署路径、API 地址、Cookie 策略和文件访问域名已经确认。