Java 后端文档

Art Design Pro X Java 是配套 Vue 管理端使用的后台系统后端。它提供账号权限、系统管理、文件、通知、审批和商城等功能，基于 Java 21、Spring Boot、MySQL 和 Redis，适合在已有后台能力上开发自己的业务。

如果你刚拿到源码，按 准备工作 → 快速开始 → 首次使用 阅读即可。先完成登录，再按需要配置存储、审批、商城或 AI，无需一开始理解全部模块。

先认识两个项目

项目	作用	本地运行后
art-design-pro-x-java	Java 后端，处理接口、权限和业务数据	默认接口端口 13001
art-design-pro-x-ui	Vue 管理端，提供浏览器中的操作页面	开发地址默认 http://localhost:3000

两份源码分别启动。MySQL 保存业务数据，Redis 保存登录态与缓存；本地文件存储默认可用，OSS、MinIO、AI 和在线支付按需配置。

浏览器访问管理端（本地默认 3000）
    ↓ 前端开发代理 / 生产环境网关
Java 后端（默认 13001）
    ├── MySQL：业务数据、审批、交易记录
    ├── Redis：会话、缓存、临时凭证
    └── 文件存储；可选 AI 模型和支付渠道

选择 Java 版后端

配套前端也可连接 Nest.js 版。使用本套文档时，请将前端代理指向 Java 的 13001 端口；Java 与 Nest.js 分别维护数据库、配置和迁移，不能混用。前端操作与开发见 商用版前端文档。

按你的任务阅读

你现在要做什么	从这里开始
第一次运行源码	准备工作 → 快速开始
登录后配置自己的系统	首次使用 → 功能与使用范围
修改连接、端口、上传目录或模型	应用配置
阅读源码、增加功能	项目结构 → 系统架构 → 扩展开发
部署到服务器	部署运维 → 备份与升级
启动或使用时出错	常见问题
使用 AI 辅助开发	AI 协作开发

文档适用范围

本套文档对应 Java 商用版当前实现。它是一个应用统一部署的模块化单体；审批使用内嵌 Flowable，无需另外安装引擎服务。商城提供后台业务能力，消费者客户端需要另行开发；在线支付还需准备商户资料并完成渠道验证。完整说明见 功能与使用范围。

文中的后端相对路径均从 art-design-pro-x-java 根目录计算，前端路径会单独标注。example.com、示例密码和商户信息需要替换为自己的值。官网会随版本更新，维护已有交付版本时同时参考该版本仓库里的 README.md 与 docs/guides/。

下一步：准备开发环境和源码。