# 数据看板查询逻辑分析 - MySQL语句分析

## Overview
- **Summary**: 分析数据看板查询的MySQL语句实现，包括标签替换请求的获取、过滤、分组和统计逻辑
- **Purpose**: 帮助排查数据看板查询逻辑的问题，提供MySQL语句的等价实现
- **Target Users**: 开发人员、数据库管理员

## Goals
- 分析数据看板查询的完整流程
- 提供MySQL等价语句
- 识别潜在的性能问题
- 提供优化建议

## Non-Goals (Out of Scope)
- 不修改现有代码
- 不涉及前端实现细节
- 不处理权限和安全问题

## Background & Context
数据看板通过 `DashboardController.GetDashboardData` 接口获取数据，该接口调用 `LabelReplaceService.GetDashboardDataAsync` 方法。当前实现使用内存过滤和分组，可能在数据量较大时存在性能问题。

## Functional Requirements
- **FR-1**: 支持按提单号或大箱号查询
- **FR-2**: 支持按客户ID过滤
- **FR-3**: 支持按日期范围过滤
- **FR-4**: 计算到货订单数量、无标签数据数量、已有标签率、换单完成数量、未换单完成数量
- **FR-5**: 获取到货时间

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

## Constraints
- **Technical**: 使用MySQL数据库，SqlSugar ORM框架
- **Business**: 无特殊业务约束
- **Dependencies**: 依赖 `label_replace_requests`、`label_scan_history`、`arrival_handover_forms` 表

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

## Acceptance Criteria

### AC-1: 基本查询功能
- **Given**: 提供查询参数（类型、提单号/大箱号、日期范围、客户ID）
- **When**: 调用数据看板查询接口
- **Then**: 返回正确的统计数据
- **Verification**: `programmatic`

### AC-2: 性能优化
- **Given**: 数据量较大（如10万条记录）
- **When**: 执行查询
- **Then**: 查询响应时间在可接受范围内（<5秒）
- **Verification**: `programmatic`

### AC-3: 数据准确性
- **Given**: 存在测试数据
- **When**: 执行查询并与手动计算结果比较
- **Then**: 统计数据与手动计算一致
- **Verification**: `human-judgment`

## Open Questions
- [ ] 到货时间的获取逻辑是否完整？
- [ ] 扫描记录的查询是否需要进一步优化？
- [ ] 是否需要添加更多索引以提高性能？