4.5 KiB
4.5 KiB
退单功能使用说明
🎯 功能概述
退单管理功能允许管理员和代理用户对链接进行退单操作，提供了完整的退单流程管理和状态追踪。
📁 文件结构
src/
├── views/refund/
│ └── RefundManagement.vue # 退单管理页面
├── api/
│ └── links.js # 退单相关API接口
├── router/
│ └── index.js # 路由配置
├── layouts/
│ └── AdminLayout.vue # 管理后台布局（包含退单菜单）
└── utils/
└── permission.js # 权限配置
🔑 权限配置
新增权限
REFUND_MANAGE- 退单管理权限REFUND_EXECUTE- 退单执行权限REFUND_VIEW- 退单查看权限
角色权限分配
- 管理员 (ADMIN): 拥有所有退单权限
- 代理 (AGENT): 拥有查看和执行退单权限
🚀 功能特性
1. 链接查询
- 支持按链接编号搜索
- 支持按状态筛选
- 实时显示链接详细信息
2. 退单操作
- 智能判断是否可以执行退单
- 支持的退单状态：
NEW、USING、LOGGED_IN - 不支持的状态：
REFUNDED、EXPIRED、COMPLETED
3. 安全确认
- 退单前二次确认对话框
- 显示链接详细信息确认
- 防止误操作
4. 状态追踪
- 实时更新链接状态
- 记录退单时间
- 显示操作历史
🎨 页面功能
搜索区域
- 链接编号输入框: 输入要查询的链接编号
- 状态筛选器: 选择特定状态的链接
- 查询按钮: 执行搜索操作
- 重置按钮: 清空搜索条件
链接信息卡片
显示找到的链接详细信息：
- 链接编号
- 当前状态（带状态标签）
- 创建时间和更新时间
- 代理ID和关联设备
- 总点数和当前点数
- 退单时间（如果已退单）
操作按钮
- 执行退单: 当链接状态允许时显示，点击后弹出确认对话框
- 已退单: 当链接已经退单时显示的禁用状态
- 不允许退单: 当链接状态不允许退单时显示的提示
使用说明
提供了详细的帮助信息：
- 可退单的状态说明
- 不可退单的状态说明
- 退单流程介绍
- 注意事项提醒
🔧 API接口
新增接口函数
refundLink(codeNo)
执行退单操作
- 参数:
codeNo- 链接编号 - 返回: Promise 对象
- HTTP方法: POST
- 路径:
/api/link/{codeNo}/refund
getLinkStatus(codeNo)
查询链接状态
- 参数:
codeNo- 链接编号 - 返回: Promise 对象，包含链接详细信息
- HTTP方法: GET
- 路径:
/api/link/{codeNo}/status
🎯 使用步骤
1. 访问退单管理页面
- 登录管理后台
- 在左侧菜单中点击 "退单管理"
2. 查询链接
- 在搜索框中输入链接编号
- （可选）选择状态筛选
- 点击 "查询" 按钮
3. 执行退单
- 确认链接信息正确
- 点击 "执行退单" 按钮
- 在确认对话框中确认操作
- 等待退单完成
⚠️ 注意事项
- 权限要求: 只有管理员和代理用户可以访问退单功能
- 状态限制: 只有特定状态的链接才能执行退单
- 不可逆操作: 退单操作一旦执行无法撤销
- 代理限制: 代理用户只能退单自己创建的链接
- 外部接口: 系统会调用外部脚本接口，即使失败也会更新本地状态
🎨 界面特性
响应式设计
- 支持桌面端和移动端访问
- 自适应不同屏幕尺寸
- 移动端优化的交互体验
状态标签
- 新建: 蓝色标签
- 使用中: 橙色标签
- 已登录: 蓝色标签
- 已完成: 绿色标签
- 已退单: 灰色标签
- 已过期: 红色标签
深色主题支持
- 自动适配系统深色主题
- 保持良好的视觉对比度
- 所有组件都支持深色模式
🚨 错误处理
常见错误及解决方案
-
链接不存在
- 检查链接编号是否正确
- 确认链接是否已被删除
-
无权限查看
- 确认用户角色权限
- 代理用户只能查看自己的链接
-
退单失败
- 检查链接当前状态
- 确认网络连接正常
- 联系技术支持
-
网络错误
- 检查网络连接
- 刷新页面重试
- 联系技术支持
📞 技术支持
如果在使用过程中遇到问题，请联系技术支持团队：
- 提供具体的错误信息
- 说明操作步骤
- 提供链接编号（如适用）
最后更新时间: 2024年1月