diff --git a/API文档.md b/API文档.md new file mode 100644 index 0000000..f0d40ed --- /dev/null +++ b/API文档.md @@ -0,0 +1,905 @@ +# Ruoyi-Vue-Pro API 文档 + +## 项目概述 + +Ruoyi-Vue-Pro 是一个基于 Spring Boot 的企业级管理系统,提供完整的 RESTful API 接口。本文档详细列出了系统提供的所有 API 接口。 + +## API 基础信息 + +- **基础路径**: `/api` +- **认证方式**: Bearer Token (OAuth2) +- **响应格式**: JSON +- **权限控制**: 基于 Spring Security 的 `@PreAuthorize` 注解 + +## 通用响应格式 + +```json +{ + "code": 0, + "data": {}, + "msg": "操作成功" +} +``` + +--- + +## 1. 系统管理模块 (System) + +### 1.1 用户管理 (User) + +**基础路径**: `/system/user` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建用户 | `system:user:create` | +| PUT | `/update` | 更新用户 | `system:user:update` | +| DELETE | `/delete` | 删除用户 | `system:user:delete` | +| GET | `/get` | 获取用户详情 | `system:user:query` | +| GET | `/page` | 分页查询用户 | `system:user:query` | +| PUT | `/update-password` | 修改密码 | `system:user:update-password` | +| PUT | `/update-status` | 修改用户状态 | `system:user:update` | + +**主要字段**: +- `id`: 用户ID +- `username`: 用户名 +- `nickname`: 昵称 +- `email`: 邮箱 +- `mobile`: 手机号 +- `status`: 状态 (0=正常, 1=停用) + +### 1.2 角色管理 (Role) + +**基础路径**: `/system/role` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建角色 | `system:role:create` | +| PUT | `/update` | 更新角色 | `system:role:update` | +| DELETE | `/delete` | 删除角色 | `system:role:delete` | +| GET | `/get` | 获取角色详情 | `system:role:query` | +| GET | `/page` | 分页查询角色 | `system:role:query` | +| GET | `/list-all-simple` | 获取所有角色列表 | `system:role:query` | + +### 1.3 菜单管理 (Menu) + +**基础路径**: `/system/menu` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建菜单 | `system:menu:create` | +| PUT | `/update` | 更新菜单 | `system:menu:update` | +| DELETE | `/delete` | 删除菜单 | `system:menu:delete` | +| GET | `/get` | 获取菜单详情 | `system:menu:query` | +| GET | `/list` | 获取菜单列表 | `system:menu:query` | + +### 1.4 部门管理 (Dept) + +**基础路径**: `/system/dept` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建部门 | `system:dept:create` | +| PUT | `/update` | 更新部门 | `system:dept:update` | +| DELETE | `/delete` | 删除部门 | `system:dept:delete` | +| GET | `/get` | 获取部门详情 | `system:dept:query` | +| GET | `/list` | 获取部门列表 | `system:dept:query` | + +### 1.5 岗位管理 (Post) + +**基础路径**: `/system/post` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建岗位 | `system:post:create` | +| PUT | `/update` | 更新岗位 | `system:post:update` | +| DELETE | `/delete` | 删除岗位 | `system:post:delete` | +| GET | `/get` | 获取岗位详情 | `system:post:query` | +| GET | `/page` | 分页查询岗位 | `system:post:query` | + +### 1.6 字典管理 (Dict) + +**字典类型**: `/system/dict-type` +**字典数据**: `/system/dict-data` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建字典 | `system:dict:create` | +| PUT | `/update` | 更新字典 | `system:dict:update` | +| DELETE | `/delete` | 删除字典 | `system:dict:delete` | +| GET | `/get` | 获取字典详情 | `system:dict:query` | +| GET | `/page` | 分页查询字典 | `system:dict:query` | + +### 1.7 通知公告 (Notice) + +**基础路径**: `/system/notice` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建公告 | `system:notice:create` | +| PUT | `/update` | 更新公告 | `system:notice:update` | +| DELETE | `/delete` | 删除公告 | `system:notice:delete` | +| GET | `/get` | 获取公告详情 | `system:notice:query` | +| GET | `/page` | 分页查询公告 | `system:notice:query` | + +### 1.8 操作日志 (OperateLog) + +**基础路径**: `/system/operate-log` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| GET | `/page` | 分页查询操作日志 | `system:operate-log:query` | +| GET | `/export-excel` | 导出操作日志 | `system:operate-log:export` | + +### 1.9 登录日志 (LoginLog) + +**基础路径**: `/system/login-log` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| GET | `/page` | 分页查询登录日志 | `system:login-log:query` | +| GET | `/export-excel` | 导出登录日志 | `system:login-log:export` | + +### 1.10 邮件管理 (Mail) + +**邮件账号**: `/system/mail-account` +**邮件模板**: `/system/mail-template` +**邮件日志**: `/system/mail-log` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建 | `system:mail:create` | +| PUT | `/update` | 更新 | `system:mail:update` | +| DELETE | `/delete` | 删除 | `system:mail:delete` | +| GET | `/get` | 获取详情 | `system:mail:query` | +| GET | `/page` | 分页查询 | `system:mail:query` | + +### 1.11 短信管理 (SMS) + +**短信渠道**: `/system/sms-channel` +**短信模板**: `/system/sms-template` +**短信日志**: `/system/sms-log` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建 | `system:sms:create` | +| PUT | `/update` | 更新 | `system:sms:update` | +| DELETE | `/delete` | 删除 | `system:sms:delete` | +| GET | `/get` | 获取详情 | `system:sms:query` | +| GET | `/page` | 分页查询 | `system:sms:query` | +| POST | `/send-sms` | 发送短信 | `system:sms:send` | + +### 1.12 OAuth2 认证 + +**基础路径**: `/system/oauth2` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/token` | 获取访问令牌 | - | +| POST | `/revoke` | 撤销访问令牌 | - | +| POST | `/check-token` | 验证访问令牌 | - | + +### 1.13 租户管理 (Tenant) + +**基础路径**: `/system/tenant` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建租户 | `system:tenant:create` | +| PUT | `/update` | 更新租户 | `system:tenant:update` | +| DELETE | `/delete` | 删除租户 | `system:tenant:delete` | +| GET | `/get` | 获取租户详情 | `system:tenant:query` | +| GET | `/page` | 分页查询租户 | `system:tenant:query` | + +--- + +## 2. 支付管理模块 (Pay) + +### 2.1 支付订单 (PayOrder) + +**基础路径**: `/pay/order` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建支付订单 | `pay:order:create` | +| PUT | `/update` | 更新支付订单 | `pay:order:update` | +| GET | `/get` | 获取订单详情 | `pay:order:query` | +| GET | `/page` | 分页查询订单 | `pay:order:query` | +| POST | `/submit` | 提交支付 | `pay:order:submit` | + +### 2.2 支付退款 (PayRefund) + +**基础路径**: `/pay/refund` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建退款 | `pay:refund:create` | +| GET | `/get` | 获取退款详情 | `pay:refund:query` | +| GET | `/page` | 分页查询退款 | `pay:refund:query` | + +### 2.3 支付渠道 (PayChannel) + +**基础路径**: `/pay/channel` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建支付渠道 | `pay:channel:create` | +| PUT | `/update` | 更新支付渠道 | `pay:channel:update` | +| DELETE | `/delete` | 删除支付渠道 | `pay:channel:delete` | +| GET | `/get` | 获取渠道详情 | `pay:channel:query` | +| GET | `/page` | 分页查询渠道 | `pay:channel:query` | + +### 2.4 钱包管理 (PayWallet) + +**基础路径**: `/pay/wallet` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| GET | `/get` | 获取钱包详情 | `pay:wallet:query` | +| GET | `/page` | 分页查询钱包 | `pay:wallet:query` | +| POST | `/transfer` | 钱包转账 | `pay:wallet:transfer` | + +### 2.5 钱包充值 (PayWalletRecharge) + +**基础路径**: `/pay/wallet/recharge` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建充值订单 | `pay:wallet-recharge:create` | +| GET | `/get` | 获取充值详情 | `pay:wallet-recharge:query` | +| GET | `/page` | 分页查询充值 | `pay:wallet-recharge:query` | + +### 2.6 钱包交易记录 (PayWalletTransaction) + +**基础路径**: `/pay/wallet/transaction` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| GET | `/page` | 分页查询交易记录 | `pay:wallet-transaction:query` | + +### 2.7 转账管理 (PayTransfer) + +**基础路径**: `/pay/transfer` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建转账 | `pay:transfer:create` | +| GET | `/get` | 获取转账详情 | `pay:transfer:query` | +| GET | `/page` | 分页查询转账 | `pay:transfer:query` | + +--- + +## 3. 会员管理模块 (Member) + +### 3.1 会员用户 (MemberUser) + +**基础路径**: `/member/user` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| GET | `/get` | 获取会员详情 | `member:user:query` | +| GET | `/page` | 分页查询会员 | `member:user:query` | +| PUT | `/update` | 更新会员信息 | `member:user:update` | + +### 3.2 会员等级 (MemberLevel) + +**基础路径**: `/member/level` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建会员等级 | `member:level:create` | +| PUT | `/update` | 更新会员等级 | `member:level:update` | +| DELETE | `/delete` | 删除会员等级 | `member:level:delete` | +| GET | `/get` | 获取等级详情 | `member:level:query` | +| GET | `/page` | 分页查询等级 | `member:level:query` | + +### 3.3 会员积分 (MemberPoint) + +**基础路径**: `/member/point` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/add` | 增加积分 | `member:point:add` | +| POST | `/reduce` | 减少积分 | `member:point:reduce` | +| GET | `/record/page` | 分页查询积分记录 | `member:point:query` | + +### 3.4 会员签到 (MemberSignIn) + +**基础路径**: `/member/sign-in` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建签到配置 | `member:sign-in:create` | +| PUT | `/update` | 更新签到配置 | `member:sign-in:update` | +| GET | `/config/page` | 分页查询签到配置 | `member:sign-in:query` | +| GET | `/record/page` | 分页查询签到记录 | `member:sign-in:query` | + +### 3.5 会员标签 (MemberTag) + +**基础路径**: `/member/tag` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建会员标签 | `member:tag:create` | +| PUT | `/update` | 更新会员标签 | `member:tag:update` | +| DELETE | `/delete` | 删除会员标签 | `member:tag:delete` | +| GET | `/page` | 分页查询标签 | `member:tag:query` | + +### 3.6 会员分组 (MemberGroup) + +**基础路径**: `/member/group` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建会员分组 | `member:group:create` | +| PUT | `/update` | 更新会员分组 | `member:group:update` | +| DELETE | `/delete` | 删除会员分组 | `member:group:delete` | +| GET | `/page` | 分页查询分组 | `member:group:query` | + +### 3.7 收货地址 (Address) + +**基础路径**: `/member/address` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建收货地址 | `member:address:create` | +| PUT | `/update` | 更新收货地址 | `member:address:update` | +| DELETE | `/delete` | 删除收货地址 | `member:address:delete` | +| GET | `/get` | 获取地址详情 | `member:address:query` | +| GET | `/page` | 分页查询地址 | `member:address:query` | + +--- + +## 4. 商城管理模块 (Mall) + +### 4.1 商品管理 (Product) + +**商品SPU**: `/product/spu` +**商品SKU**: `/product/sku` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建商品 | `product:spu:create` | +| PUT | `/update` | 更新商品 | `product:spu:update` | +| DELETE | `/delete` | 删除商品 | `product:spu:delete` | +| GET | `/get` | 获取商品详情 | `product:spu:query` | +| GET | `/page` | 分页查询商品 | `product:spu:query` | +| PUT | `/update-status` | 更新商品状态 | `product:spu:update` | + +### 4.2 商品分类 (Category) + +**基础路径**: `/product/category` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建分类 | `product:category:create` | +| PUT | `/update` | 更新分类 | `product:category:update` | +| DELETE | `/delete` | 删除分类 | `product:category:delete` | +| GET | `/get` | 获取分类详情 | `product:category:query` | +| GET | `/list` | 获取分类列表 | `product:category:query` | + +### 4.3 商品品牌 (Brand) + +**基础路径**: `/product/brand` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建品牌 | `product:brand:create` | +| PUT | `/update` | 更新品牌 | `product:brand:update` | +| DELETE | `/delete` | 删除品牌 | `product:brand:delete` | +| GET | `/get` | 获取品牌详情 | `product:brand:query` | +| GET | `/page` | 分页查询品牌 | `product:brand:query` | + +### 4.4 购物车 (Cart) + +**基础路径**: `/product/cart` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/add` | 添加到购物车 | - | +| PUT | `/update-count` | 更新购物车数量 | - | +| DELETE | `/delete` | 删除购物车商品 | - | +| GET | `/list` | 获取购物车列表 | - | +| DELETE | `/clear` | 清空购物车 | - | + +### 4.5 订单管理 (Order) + +**基础路径**: `/trade/order` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建订单 | - | +| GET | `/get` | 获取订单详情 | - | +| GET | `/page` | 分页查询订单 | - | +| PUT | `/cancel` | 取消订单 | - | +| PUT | `/confirm` | 确认收货 | - | + +### 4.6 优惠活动 (Promotion) + +**基础路径**: `/promotion` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/activity/create` | 创建活动 | `promotion:activity:create` | +| PUT | `/activity/update` | 更新活动 | `promotion:activity:update` | +| DELETE | `/activity/delete` | 删除活动 | `promotion:activity:delete` | +| GET | `/activity/page` | 分页查询活动 | `promotion:activity:query` | + +--- + +## 5. 业务流程管理模块 (BPM) + +### 5.1 流程模型 (BpmModel) + +**基础路径**: `/bpm/model` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建流程模型 | `bpm:model:create` | +| PUT | `/update` | 更新流程模型 | `bpm:model:update` | +| DELETE | `/delete` | 删除流程模型 | `bpm:model:delete` | +| GET | `/get` | 获取模型详情 | `bpm:model:query` | +| GET | `/page` | 分页查询模型 | `bpm:model:query` | +| POST | `/deploy` | 部署流程模型 | `bpm:model:deploy` | + +### 5.2 流程定义 (BpmDefinition) + +**基础路径**: `/bpm/definition` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| GET | `/list` | 获取流程定义列表 | `bpm:definition:query` | +| GET | `/get` | 获取流程定义详情 | `bpm:definition:query` | + +### 5.3 流程实例 (BpmInstance) + +**基础路径**: `/bpm/instance` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建流程实例 | `bpm:instance:create` | +| GET | `/get` | 获取实例详情 | `bpm:instance:query` | +| GET | `/page` | 分页查询实例 | `bpm:instance:query` | +| POST | `/cancel` | 取消流程实例 | `bpm:instance:cancel` | + +### 5.4 流程任务 (BpmTask) + +**基础路径**: `/bpm/task` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| GET | `/todo-page` | 待办任务分页 | `bpm:task:query` | +| GET | `/done-page` | 已办任务分页 | `bpm:task:query` | +| POST | `/approve` | 审批任务 | `bpm:task:approve` | +| POST | `/reject` | 拒绝任务 | `bpm:task:reject` | +| POST | `/delegate` | 委派任务 | `bpm:task:delegate` | + +--- + +## 6. 企业资源计划模块 (ERP) + +### 6.1 产品管理 (ErpProduct) + +**基础路径**: `/erp/product` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建产品 | `erp:product:create` | +| PUT | `/update` | 更新产品 | `erp:product:update` | +| DELETE | `/delete` | 删除产品 | `erp:product:delete` | +| GET | `/get` | 获取产品详情 | `erp:product:query` | +| GET | `/page` | 分页查询产品 | `erp:product:query` | + +### 6.2 采购管理 (ErpPurchase) + +**基础路径**: `/erp/purchase` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建采购订单 | `erp:purchase:create` | +| PUT | `/update` | 更新采购订单 | `erp:purchase:update` | +| DELETE | `/delete` | 删除采购订单 | `erp:purchase:delete` | +| GET | `/get` | 获取采购详情 | `erp:purchase:query` | +| GET | `/page` | 分页查询采购 | `erp:purchase:query` | + +### 6.3 销售管理 (ErpSale) + +**基础路径**: `/erp/sale` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建销售订单 | `erp:sale:create` | +| PUT | `/update` | 更新销售订单 | `erp:sale:update` | +| DELETE | `/delete` | 删除销售订单 | `erp:sale:delete` | +| GET | `/get` | 获取销售详情 | `erp:sale:query` | +| GET | `/page` | 分页查询销售 | `erp:sale:query` | + +### 6.4 库存管理 (ErpStock) + +**基础路径**: `/erp/stock` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/in` | 入库 | `erp:stock:in` | +| POST | `/out` | 出库 | `erp:stock:out` | +| GET | `/page` | 分页查询库存 | `erp:stock:query` | + +--- + +## 7. 物联网模块 (IoT) + +### 7.1 设备管理 (IotDevice) + +**基础路径**: `/iot/device` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建设备 | `iot:device:create` | +| PUT | `/update` | 更新设备 | `iot:device:update` | +| DELETE | `/delete` | 删除设备 | `iot:device:delete` | +| GET | `/get` | 获取设备详情 | `iot:device:query` | +| GET | `/page` | 分页查询设备 | `iot:device:query` | +| POST | `/control` | 控制设备 | `iot:device:control` | + +### 7.2 设备数据 (IotData) + +**基础路径**: `/iot/data` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| GET | `/latest` | 获取最新数据 | `iot:data:query` | +| GET | `/history` | 获取历史数据 | `iot:data:query` | + +--- + +## 8. 人工智能模块 (AI) + +### 8.1 AI 聊天 (AiChat) + +**对话管理**: `/ai/chat/conversation` +**消息管理**: `/ai/chat/message` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/conversation/create` | 创建对话 | `ai:chat:create` | +| PUT | `/conversation/update` | 更新对话 | `ai:chat:update` | +| DELETE | `/conversation/delete` | 删除对话 | `ai:chat:delete` | +| GET | `/conversation/page` | 分页查询对话 | `ai:chat:query` | +| POST | `/message/send` | 发送消息(段式) | `ai:chat:send` | +| POST | `/message/send-stream` | 发送消息(流式) | `ai:chat:send` | +| GET | `/message/list-by-conversation-id` | 获取对话消息列表 | `ai:chat:query` | + +### 8.2 AI 绘画 (AiImage) + +**基础路径**: `/ai/image` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/draw` | 生成图片 | `ai:image:draw` | +| GET | `/my-page` | 获取我的绘图分页 | `ai:image:query` | +| GET | `/public-page` | 获取公开绘图分页 | `ai:image:query` | +| GET | `/get-my` | 获取我的绘图记录 | `ai:image:query` | +| DELETE | `/delete-my` | 删除我的绘画记录 | `ai:image:delete` | + +### 8.3 AI 知识库 (AiKnowledge) + +**知识库管理**: `/ai/knowledge` +**文档管理**: `/ai/knowledge/document` +**分段管理**: `/ai/knowledge/segment` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建知识库 | `ai:knowledge:create` | +| PUT | `/update` | 更新知识库 | `ai:knowledge:update` | +| DELETE | `/delete` | 删除知识库 | `ai:knowledge:delete` | +| GET | `/page` | 分页查询知识库 | `ai:knowledge:query` | +| POST | `/document/create` | 上传文档 | `ai:knowledge:upload` | +| POST | `/document/create-list` | 批量上传文档 | `ai:knowledge:upload` | +| PUT | `/document/update-status` | 更新文档状态 | `ai:knowledge:update` | +| GET | `/segment/page` | 分页查询分段 | `ai:knowledge:query` | +| POST | `/segment/search` | 搜索知识库 | `ai:knowledge:search` | + +### 8.4 AI 模型 (AiModel) + +**基础路径**: `/ai/model` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建模型 | `ai:model:create` | +| PUT | `/update` | 更新模型 | `ai:model:update` | +| DELETE | `/delete` | 删除模型 | `ai:model:delete` | +| GET | `/page` | 分页查询模型 | `ai:model:query` | + +### 8.5 AI 工具 (AiTool) + +**基础路径**: `/ai/tool` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建工具 | `ai:tool:create` | +| PUT | `/update` | 更新工具 | `ai:tool:update` | +| DELETE | `/delete` | 删除工具 | `ai:tool:delete` | +| GET | `/page` | 分页查询工具 | `ai:tool:query` | + +### 8.6 AI 工作流 (AiWorkflow) + +**基础路径**: `/ai/workflow` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建工作流 | `ai:workflow:create` | +| PUT | `/update` | 更新工作流 | `ai:workflow:update` | +| DELETE | `/delete` | 删除工作流 | `ai:workflow:delete` | +| GET | `/get` | 获取工作流详情 | `ai:workflow:query` | +| GET | `/page` | 分页查询工作流 | `ai:workflow:query` | +| POST | `/test` | 测试工作流 | `ai:workflow:test` | + +### 8.7 AI 写作 (AiWrite) + +**基础路径**: `/ai/write` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/generate` | 生成内容 | `ai:write:generate` | +| GET | `/page` | 分页查询写作记录 | `ai:write:query` | + +### 8.8 AI 思维导图 (AiMindMap) + +**基础路径**: `/ai/mindmap` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/generate` | 生成思维导图 | `ai:mindmap:generate` | +| GET | `/page` | 分页查询思维导图 | `ai:mindmap:query` | + +### 8.9 AI 音乐 (AiMusic) + +**基础路径**: `/ai/music` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/generate` | 生成音乐 | `ai:music:generate` | +| GET | `/page` | 分页查询音乐 | `ai:music:query` | +| PUT | `/update` | 更新音乐 | `ai:music:update` | + +--- + +## 9. 数字化服装模块 (Digital) + +### 9.1 服装管理 (DigitalCloth) + +**基础路径**: `/cloth` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/addRoom` | 添加房间 | - | +| POST | `/delRoom` | 删除房间 | - | +| POST | `/updateRoom` | 更新房间 | - | +| POST | `/getRoomList` | 获取房间列表 | - | +| POST | `/addRoomCloth` | 添加房间服装 | - | +| POST | `/delRoomCloth` | 删除房间服装 | - | +| POST | `/getRoomClothList` | 获取房间服装列表 | - | +| POST | `/buyLink` | 购买链接 | - | + +### 9.2 记录管理 (Records) + +**基础路径**: `/records` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建记录 | - | +| PUT | `/update` | 更新记录 | - | +| DELETE | `/delete` | 删除记录 | - | +| GET | `/page` | 分页查询记录 | - | + +### 9.3 在线记录 (OnRecord) + +**基础路径**: `/on-record` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建在线记录 | - | +| GET | `/page` | 分页查询在线记录 | - | + +### 9.4 换发管理 (TjSwapHair) + +**基础路径**: `/swap-hair` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/exchange` | 换发 | - | +| GET | `/page` | 分页查询换发记录 | - | + +### 9.5 三方图片 (SysTripleImage) + +**基础路径**: `/triple-image` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建三方图片 | - | +| PUT | `/update` | 更新三方图片 | - | +| DELETE | `/delete` | 删除三方图片 | - | +| GET | `/page` | 分页查询三方图片 | - | + +--- + +## 10. 报表模块 (Report) + +### 10.1 GoView 项目 (GoViewProject) + +**基础路径**: `/report/go-view/project` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建项目 | `report:go-view-project:create` | +| PUT | `/update` | 更新项目 | `report:go-view-project:update` | +| DELETE | `/delete` | 删除项目 | `report:go-view-project:delete` | +| GET | `/get` | 获取项目详情 | `report:go-view-project:query` | +| GET | `/my-page` | 获取我的项目分页 | `report:go-view-project:query` | + +### 10.2 GoView 数据 (GoViewData) + +**基础路径**: `/report/go-view/data` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/get-by-sql` | 通过SQL获取数据 | `report:go-view-data:query` | + +--- + +## 11. 基础设施模块 (Infra) + +### 11.1 文件管理 (File) + +**基础路径**: `/infra/file` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/upload` | 上传文件 | `infra:file:upload` | +| DELETE | `/delete` | 删除文件 | `infra:file:delete` | +| GET | `/get` | 获取文件详情 | `infra:file:query` | + +### 11.2 文件配置 (FileConfig) + +**基础路径**: `/infra/file/config` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建文件配置 | `infra:file-config:create` | +| PUT | `/update` | 更新文件配置 | `infra:file-config:update` | +| DELETE | `/delete` | 删除文件配置 | `infra:file-config:delete` | +| GET | `/page` | 分页查询文件配置 | `infra:file-config:query` | + +### 11.3 定时任务 (Job) + +**基础路径**: `/infra/job` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建定时任务 | `infra:job:create` | +| PUT | `/update` | 更新定时任务 | `infra:job:update` | +| DELETE | `/delete` | 删除定时任务 | `infra:job:delete` | +| GET | `/get` | 获取任务详情 | `infra:job:query` | +| GET | `/page` | 分页查询任务 | `infra:job:query` | +| PUT | `/trigger` | 触发任务 | `infra:job:trigger` | +| PUT | `/update-status` | 更新任务状态 | `infra:job:update` | + +### 11.4 任务日志 (JobLog) + +**基础路径**: `/infra/job-log` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| GET | `/get` | 获取日志详情 | `infra:job-log:query` | +| GET | `/page` | 分页查询日志 | `infra:job-log:query` | + +### 11.5 API 访问日志 (ApiAccessLog) + +**基础路径**: `/infra/api-access-log` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| GET | `/page` | 分页查询访问日志 | `infra:api-access-log:query` | + +### 11.6 API 错误日志 (ApiErrorLog) + +**基础路径**: `/infra/api-error-log` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| GET | `/page` | 分页查询错误日志 | `infra:api-error-log:query` | + +### 11.7 数据源配置 (DataSourceConfig) + +**基础路径**: `/infra/data-source-config` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create` | 创建数据源配置 | `infra:data-source-config:create` | +| PUT | `/update` | 更新数据源配置 | `infra:data-source-config:update` | +| DELETE | `/delete` | 删除数据源配置 | `infra:data-source-config:delete` | +| GET | `/page` | 分页查询数据源配置 | `infra:data-source-config:query` | + +### 11.8 系统配置 (Config) + +**基础路径**: `/infra/config` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| PUT | `/update` | 更新配置 | `infra:config:update` | +| GET | `/get` | 获取配置 | `infra:config:query` | + +### 11.9 代码生成 (Codegen) + +**基础路径**: `/infra/codegen` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| POST | `/create-list` | 创建代码生成配置 | `infra:codegen:create` | +| PUT | `/update` | 更新代码生成配置 | `infra:codegen:update` | +| DELETE | `/delete` | 删除代码生成配置 | `infra:codegen:delete` | +| GET | `/page` | 分页查询代码生成配置 | `infra:codegen:query` | +| POST | `/preview` | 预览代码 | `infra:codegen:preview` | +| POST | `/download` | 下载代码 | `infra:codegen:download` | + +### 11.10 Redis 管理 (Redis) + +**基础路径**: `/infra/redis` + +| 方法 | 路径 | 描述 | 权限 | +|------|------|------|------| +| GET | `/get` | 获取 Redis 键值 | `infra:redis:query` | +| DELETE | `/delete` | 删除 Redis 键 | `infra:redis:delete` | +| GET | `/keys` | 获取 Redis 键列表 | `infra:redis:query` | + +--- + +## 附录 + +### A. 通用错误码 + +| 错误码 | 描述 | +|--------|------| +| 0 | 成功 | +| 1 | 服务器内部错误 | +| 401 | 未授权 | +| 403 | 禁止访问 | +| 404 | 资源不存在 | +| 500 | 服务器错误 | + +### B. 权限说明 + +系统采用基于角色的权限控制(RBAC),每个 API 接口都需要相应的权限才能访问。权限格式为 `模块:功能:操作`,例如: +- `system:user:create` - 系统用户创建权限 +- `pay:order:query` - 支付订单查询权限 + +### C. 分页参数 + +所有分页接口支持以下通用参数: + +| 参数名 | 类型 | 必填 | 描述 | +|--------|------|------|------| +| pageNo | Integer | 是 | 页码,从 1 开始 | +| pageSize | Integer | 是 | 每页数量 | + +### D. 排序参数 + +分页接口支持排序参数: + +| 参数名 | 类型 | 必填 | 描述 | +|--------|------|------|------| +| sortField | String | 否 | 排序字段 | +| sortOrder | String | 否 | 排序方向:asc/desc | + +--- + +## 版本历史 + +| 版本 | 日期 | 说明 | +|------|------|------| +| 1.0.0 | 2026-01-03 | 初始版本 | + +--- + +**文档生成时间**: 2026-01-03 +**项目名称**: Ruoyi-Vue-Pro +**文档版本**: 1.0.0