xgt/docs/API.md

XGT 系统接口列表

一、公共接口 (ruoyi-admin)

1. 认证相关 /auth

方法	路径	说明
POST	/auth/login	登录
POST	/auth/logout	登出
POST	/auth/register	注册
GET	/auth/tenant/list	租户列表
GET	/auth/code	验证码

2. 首页 /

方法	路径	说明
GET	/	欢迎页
GET	/banner	画册列表
GET	/banner/{id}	画册详情
GET	/prod	商品列表
GET	/prod/{id}	商品详情
GET	/tpSysUser	表现师列表
GET	/sysUser/{id}	用户详情
GET	/follow	关注列表
POST	/AddFollow	关注
DELETE	/delFollow	取消关注
POST	/isFollow	是否关注
GET	/tpWorks	作品列表
POST	/AddWorks	收藏作品
DELETE	/delWorks	取消收藏
POST	/isWorks	是否收藏
POST	/wx/jssdk	微信JSSDK签名

3. 首页统计 /

方法	路径	说明
GET	/indexSum	首页统计
GET	/rankingListKF	客服排行
GET	/rankingListKFSum	客服统计
GET	/rankingListJS	技术排行
GET	/rankingListJSSum	技术统计
GET	/deptRankingList	客服部排行
GET	/deptRankingList1	客服部排行(单)
GET	/deptRankingJSList	技术部排行
GET	/deptRankingJSList1	技术部排行(单)
GET	/khRankingList	客户下单排行
GET	/khRankingListSum	客户下单统计
GET	/kfDayList	客服数据分析(日)
GET	/wxDayList	微信好友分析(日)
GET	/wxDayList1	微信好友分析(日)
GET	/wxMonthList	微信好友分析(月)
GET	/ftDayList	技术部分图(日)
GET	/jsDayList	技术部月报
POST	/monthArrivedPer	月业绩统计
POST	/yearArrivedPer	年业绩统计
POST	/monthOrderType	订单类型统计
POST	/monthOrderSpace	订单空间统计
POST	/monthOrderStyle	订单风格统计
POST	/newOldOrderPer	新老客户占比
POST	/notifyCheckSign	银盛支付回调
POST	/updateOrder	更新订单部门状态

---

二、业务模块 (ruoyi-work)

订单模块 /work/order*

控制器	路径	说明
TpOrderController	/work/order	订单管理
CustomerOrderController	/work/customer/order	客户订单
SkillOrderController	/work/skill/order	技术订单
TpOrderBigController	/work/orderBig	大图订单
TpOrderSmallController	/work/orderSmall	小图订单
TpOrderCdController	/work/orderCd	拆单记录
TpOrderRecordController	/work/orderRecord	操作记录
TpOrderPayController	/work/orderPay	支付记录
TpOrderCommentController	/work/orderComment	订单评价
TpOrderModelController	/work/orderModel	订单模板

CustomerOrderController 详细接口

方法	路径	说明
GET	/work/customer/order/list	客户订单列表
GET	/work/customer/order/sum	客户订单统计
POST	/work/customer/order/export	导出客户订单
GET	/work/customer/order/{id}	客户订单详情
POST	/work/customer/order	新增客户订单
PUT	/work/customer/order	更新客户订单
DELETE	/work/customer/order/{ids}	删除客户订单
POST	/work/customer/order/assign	派单
POST	/work/customer/order/cancelAssign	取消派单
GET	/work/customer/order/queryOrderPay/{orderId}	查询支付信息
POST	/work/customer/order/pay	支付
GET	/work/customer/order/orderFallback/{orderId}	退款信息
POST	/work/customer/order/fallback	退款
GET	/work/customer/order/cdOrderInfo/{orderId}	拆单信息
POST	/work/customer/order/cdOrder	拆单
GET	/work/customer/order/gjOrderInfo/{orderId}	改价信息
POST	/work/customer/order/gjOrder	改价

客户模块 /work/client*

控制器	路径	说明
TpClientController	/work/client	客户管理
TpClientStaffController	/work/clientStaff	客服客户
TpClientFundController	/work/clientFund	客户资金

TpClientController 详细接口

方法	路径	说明
GET	/work/client/list	客户列表
GET	/work/client/listChart	客户订单统计
POST	/work/client/export	导出客户
GET	/work/client/{id}	客户详情
POST	/work/client	新增客户
PUT	/work/client	更新客户
DELETE	/work/client/{ids}	删除客户

员工模块 /work/staff*

控制器	路径	说明
TpStaffController	/work/staff	员工管理
TzUserController	/mall/user	用户管理
TpStaffPayController	/work/staffPay	员工薪资
TpIntegralDetailController	/work/integralDetail	积分明细

微信模块 /work/wechat*

控制器	路径	说明
TpWechatController	/work/wechat	微信管理
TpWechatUserController	/work/wechatUser	微信用户
TpWechatNumController	/work/wechatNum	微信好友数

TpWechatController 详细接口

方法	路径	说明
GET	/work/wechat/list	微信列表
GET	/work/wechat/wechatSum	微信统计
POST	/work/wechat/export	导出微信
GET	/work/wechat/{id}	微信详情
POST	/work/wechat	新增微信
PUT	/work/wechat	更新微信
POST	/work/wechat/editUser	更新用户
DELETE	/work/wechat/{ids}	删除微信

财务模块 /work/receipt*

控制器	路径	说明
TpReceiptController	/work/receipt	收款管理
TpRemittanceController	/work/remittance	汇款管理

TpReceiptController 详细接口

方法	路径	说明
GET	/work/receipt/list	收款列表
GET	/work/receipt/receiptSum	收款统计
POST	/work/receipt/export	导出收款
GET	/work/receipt/{id}	收款详情
POST	/work/receipt	新增收款
POST	/work/receipt/claim	认领汇款
POST	/work/receipt/back	退回汇款
DELETE	/work/receipt/{ids}	删除收款

统计数据 /work/dept*

控制器	路径	说明
TpDeptReportController	/work/deptReport	部门报表
TpDeptCostController	/work/deptCost	部门成本
TpYearController	/work/year	年度目标
TpMonthController	/work/month	月度目标

资源模块

控制器	路径	说明
TpProdController	/work/prod	商品管理
TpWorksController	/work/works	作品收藏
TpFollowController	/work/follow	关注管理
TpPanoramaController	/work/panorama	全景图
TpDesignQuotesController	/work/designQuotes	设计报价
TpFieldController	/work/field	领域管理
TpChangePriceController	/work/changePrice	改价配置
TzSharedAccountController	/work/sharedAccount	共享账号

TpPanoramaController 详细接口

方法	路径	说明
GET	/work/panorama/list	全景图列表
GET	/work/panorama/listByOrderId	根据订单ID查询全景图
POST	/work/panorama/export	导出全景图
GET	/work/panorama/{id}	全景图详情
POST	/work/panorama	新增全景图
PUT	/work/panorama	更新全景图
DELETE	/work/panorama/{ids}	删除全景图

---

三、通用CRUD接口格式

GET    /{path}/list          # 列表查询
POST   /{path}/export        # 导出数据
GET    /{path}/{id}         # 详情查询
POST   /{path}               # 新增
PUT    /{path}               # 更新
DELETE /{path}/{ids}         # 删除

---

四、接口统计

• ruoyi-admin: 5 个控制器 (HomeController, IndexController, LoginController, AuthController, CaptchaController)
• ruoyi-work: 34 个控制器
• 总计: 39 个控制器

---

五、订单状态流转

客户下单 → 客服派单 → 技术接单 → 设计制作 → 完成交付 → 客户评价
                                    ↓
                              申请退款 (可选)

六、用户身份

identity	说明
1	管理员
2	表现师/技术
3	客服