首页质量类查询修复与优化前端联调文档

修复 home 模块下质量类接口的若干问题，并优化查询性能。
本次改动**只涉及响应数值**，**接口路径、请求参数、响应字段名均未变化**。

涉及页面

• 首页 / 数据看板 - 质量分析模块
• 首页 / 数据看板 - 质量检验数量卡片
• 首页 / 数据看板 - 不合格预警
• 首页 / 数据看板 - 完成检验数趋势
• 首页 / 数据看板 - 不合格产品排名
• 首页 / 数据看板 - 原材料/过程/出厂检测合格率
• 首页 / 数据看板 - 质量统计 (周/月/季)

受影响接口一览

一、/home/qualityInspectionCount (语义变更，前端需关注)

变更原因

• 原实现把全表加载到内存进行求和，且 totalCountGrowthRate 用 截止今日累计 vs 截止昨日累计 计算，得到的实质是 today_only / yesterday_cumulative，无业务意义。
• 原实现对 checkTime 用 eq(checkTime, "yyyy-MM-dd")，若数据库 check_time 含非 0 时分秒会全部漏匹配，导致 todayPendingCount/todayCompletedCount 偶发为 0。

新口径

响应示例

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "totalCount": 12345.00,
    "totalCountGrowthRate": 8.50,
    "todayPendingCount": 12.00,
    "todayPendingCountGrowthRate": -20.00,
    "todayCompletedCount": 80.00,
    "todayCompletedCountGrowthRate": 15.50
  }
}

前端修改点

totalCountGrowthRate 的视觉提示文案建议从 "总检验数同比增长" 改为 "今日新增 vs 昨日新增"，避免误解为累计同比。

<el-tooltip content="今日单日检验数相对昨日单日检验数的增长率">
  <span>总检验数同比 {{ formatRate(data.totalCountGrowthRate) }}</span>
</el-tooltip>

methods: {
  formatRate(rate) {
    if (rate === null || rate === undefined) return '0%';
    const sign = rate > 0 ? '+' : '';
    return `${sign}${rate}%`;
  }
}

二、/home/unqualifiedProductRanking (口径变更，前端需关注)

变更原因

原实现拉取所有 inspect_state=1 的记录到内存做聚合排序，数据量大时存在 OOM 风险。

新口径

前端修改点

如果当前页面有 "全历史" 之类的文案，请改成 "近 30 天"。

<div class="card-title">不合格产品排名 <span class="sub">(近 30 天)</span></div>

三、日期上界统一改为右开区间 (语义未变，但补全数据)

commonDetection (rawMaterial / process / factoryDetection)、nonComplianceWarning、completedInspectionCount、qualityInspectionStatistics 之前都用 le(checkTime, endDate)。
当 check_time 是 datetime 列时，<= "yyyy-MM-dd" 等价于 <= "yyyy-MM-dd 00:00:00"，会漏掉当天 00:00:00 之后的所有记录。

后端已统一改为 lt(checkTime, endDate + 1 天)，**响应字段、字段语义不变**，只是当天数据不再丢失。

前端修改点

无需改动代码。但建议联调时核对：周/月/季视图最后一天是否出现以前缺失的检验记录。

四、其他内部优化 (前端无感)

• qualityInspectionCount 改用 SELECT COALESCE(SUM(quantity), 0) 聚合，单次 SQL 替代之前的 6 次全表 selectList。
• qualityInspectionStatistics 中 i.getInspectType() == 0 修复为 Objects.equals(...)，避免 Integer 自动装箱缓存范围外的等值误判。

注意事项

• qualityInspectionCount 的 totalCountGrowthRate 现在反映的是"日环比增长率"，业务侧文案与图表说明需同步调整。
• unqualifiedProductRanking 改为近 30 天后，**Top5 列表可能变化**，请通知业务确认。
• 上线后建议联调以下场景：
• check_time 为非 00:00:00 的检验记录是否被正确统计 (周/月视图最后一天)。
• 今日所有报检的"待完成 / 已完成"数据是否能实时反映到首页卡片。
• 若某接口需要保留旧的全历史口径 (例如导出、对账)，请单独提需求增加新接口，避免改回首页接口。