LabelChange-server/.trae/specs/arrival_stats_sql/spec.md

到货信息统计 MySQL 语句分析

Overview

• Summary: 分析如何编写 MySQL 语句，在有提单号的情况下以提单号统计到货信息，无提单号的情况下以主包号统计到货信息
• Purpose: 提供一个统一的 SQL 语句，根据数据情况自动选择合适的分组依据
• Target Users: 开发人员、数据库管理员

Goals

• 分析到货信息统计的业务逻辑
• 提供统一的 MySQL 语句实现
• 确保统计结果的准确性
• 优化查询性能

Non-Goals (Out of Scope)

• 不修改现有代码
• 不涉及前端实现细节
• 不处理权限和安全问题

Background & Context

在物流系统中，到货信息统计是一个常见需求。通常情况下，我们会按提单号进行统计，但在某些情况下（如没有提单号时），需要按主包号进行统计。当前实现可能需要编写多个 SQL 语句来处理不同情况，我们需要一个统一的解决方案。

Functional Requirements

• FR-1: 当记录有提单号时，按提单号分组统计
• FR-2: 当记录没有提单号时，按主包号分组统计
• FR-3: 计算到货订单数量、无标签数据数量、已有标签率等统计数据
• FR-4: 支持按客户ID、日期范围等条件过滤

Non-Functional Requirements

• NFR-1: 性能优化，避免全表扫描
• NFR-2: 代码可读性和可维护性
• NFR-3: 数据准确性

Constraints

• Technical: 使用MySQL数据库
• Business: 无特殊业务约束
• Dependencies: 依赖 label_replace_requests 表

Assumptions

• 数据库表结构已正确创建
• 所有必要的索引已添加
• 数据量在合理范围内

Acceptance Criteria

AC-1: 基本统计功能

• Given: 存在带有提单号的记录
• When: 执行统计查询
• Then: 按提单号分组统计
• Verification: programmatic

AC-2: 无提单号情况

• Given: 存在没有提单号但有主包号的记录
• When: 执行统计查询
• Then: 按主包号分组统计
• Verification: programmatic

AC-3: 性能优化

• Given: 数据量较大（如10万条记录）
• When: 执行查询
• Then: 查询响应时间在可接受范围内（<5秒）
• Verification: programmatic

AC-4: 数据准确性

• Given: 存在测试数据
• When: 执行查询并与手动计算结果比较
• Then: 统计数据与手动计算一致
• Verification: human-judgment

Open Questions

• 如何处理既没有提单号也没有主包号的记录？
• 是否需要考虑性能优化的索引策略？