ruoyi-java/doc/京东订单统计控制功能说明.md

京东订单统计控制功能实现说明

功能概述

为京东订单系统添加了统计控制功能，允许用户通过开关控制订单是否参与"慢单"统计。

实现内容

1. 数据库层面

• 文件: sql/add_count_enabled_field.sql
• 操作: 为 jd_order 表添加 is_count_enabled 字段
• 字段说明:
  • 类型: TINYINT(1)
  • 默认值: 1 (参与统计)
  • 含义: 0=不参与统计，1=参与统计

2. 后端实体类更新

• 文件: ruoyi-system/src/main/java/com/ruoyi/jarvis/domain/JDOrder.java
• 新增字段: isCountEnabled (Integer类型)
• 注解: 添加了 @Excel 注解支持导出

3. 数据库映射更新

• 文件: ruoyi-system/src/main/resources/mapper/jarvis/JDOrderMapper.xml
• 更新内容:
  • 在 resultMap 中添加新字段映射
  • 在 selectJDOrderBase SQL中添加新字段查询
  • 在 insert 和 update 语句中添加新字段处理

4. 统计逻辑修改

• 文件: ruoyi-system/src/main/java/com/ruoyi/jarvis/service/impl/InstructionServiceImpl.java
• 修改位置:
  • 慢单 统计逻辑 (第244行)
  • 录单 导出逻辑 (第221行)
• 过滤条件: 添加 (o.getIsCountEnabled() == null || o.getIsCountEnabled() == 1) 过滤条件
• 说明: 只有 isCountEnabled 为 null 或 1 的订单才会参与统计

5. 前端界面更新

• 文件: ruoyi-vue/src/views/system/jdorder/orderList.vue
• 新增功能:
  • 在订单列表中添加"参与统计"列
  • 使用 el-switch 组件提供开关控制
  • 添加 handleCountEnabledChange 方法处理状态变化
  • 调用后端API实时更新数据库

6. API接口

• 文件: ruoyi-vue/src/api/system/jdorder.js
• 新增方法: updateJDOrder 用于更新订单信息
• 后端接口: 使用现有的 PUT /system/jdorder 接口

使用说明

操作步骤

1. 在京东订单列表页面，找到"参与统计"列
2. 点击开关可以切换订单的统计状态
3. 状态变化会实时保存到数据库
4. 在指令台发送"慢单"指令时，只会统计标记为"参与统计"的订单

状态说明

• 开关开启 (绿色): 订单参与统计，is_count_enabled = 1
• 开关关闭 (灰色): 订单不参与统计，is_count_enabled = 0

统计影响

• 当订单的 is_count_enabled 设置为 0 时，该订单将不会出现在"慢单"统计结果中
• 其他查询功能（如"慢搜"、"慢查"）不受影响，仍可查询所有订单
• 录单导出功能也会过滤掉不参与统计的订单

技术细节

默认值处理

• 新订单默认 is_count_enabled = 1 (参与统计)
• 现有订单通过SQL脚本统一设置为 1
• 前端显示时，null 值被视为参与统计

兼容性

• 向后兼容：现有订单默认参与统计
• 数据库字段有默认值，确保数据完整性
• 前端组件使用Element UI的Switch组件，用户体验良好

部署说明

数据库更新

1. 执行 sql/add_count_enabled_field.sql 脚本
2. 确认字段添加成功：DESCRIBE jd_order;

代码部署

1. 重新编译后端项目
2. 重新构建前端项目
3. 重启应用服务

验证步骤

1. 访问京东订单列表页面
2. 确认"参与统计"列显示正常
3. 测试开关功能是否正常
4. 在指令台测试"慢单"指令，确认过滤功能生效