上传源代码版本

.trae/specs/dashboard_refactor/tasks.md

@@ -0,0 +1,67 @@
+# 数据看板查询逻辑重构 - 实现计划
+
+## [x] Task 1: 分析当前查询逻辑
+- **Priority**: P0
+- **Depends On**: None
+- **Description**:
+  - 分析当前数据看板的查询逻辑
+  - 了解现有的API接口
+  - 确定需要修改的部分
+- **Acceptance Criteria Addressed**: AC-1, AC-2
+- **Test Requirements**:
+  - `human-judgment` TR-1.1: 理解当前查询逻辑
+  - `human-judgment` TR-1.2: 识别需要修改的部分
+- **Notes**: 重点关注查询逻辑的起点和数据匹配方式
+
+## [x] Task 2: 设计新的查询逻辑
+- **Priority**: P0
+- **Depends On**: Task 1
+- **Description**:
+  - 设计从到货交接单开始的查询逻辑
+  - 确定如何以交接单号匹配提单号和主包号
+  - 设计统计计算方法
+- **Acceptance Criteria Addressed**: AC-1, AC-2, AC-3
+- **Test Requirements**:
+  - `human-judgment` TR-2.1: 验证查询逻辑设计
+  - `human-judgment` TR-2.2: 确保统计方法正确
+- **Notes**: 考虑如何处理一个交接单对应多个提单号或主包号的情况
+
+## [x] Task 3: 实现后端API修改
+- **Priority**: P0
+- **Depends On**: Task 2
+- **Description**:
+  - 修改后端API，实现从到货交接单开始的查询逻辑
+  - 确保API接口与前端兼容
+  - 优化查询性能
+- **Acceptance Criteria Addressed**: AC-1, AC-2, AC-4
+- **Test Requirements**:
+  - `programmatic` TR-3.1: 验证API功能
+  - `programmatic` TR-3.2: 测试性能
+- **Notes**: 考虑使用JOIN和索引优化查询
+
+## [x] Task 4: 测试修改后的功能
+- **Priority**: P1
+- **Depends On**: Task 3
+- **Description**:
+  - 测试提单号预报功能
+  - 测试大箱号预报功能
+  - 验证统计数据的准确性
+  - 测试性能
+- **Acceptance Criteria Addressed**: AC-1, AC-2, AC-3, AC-4
+- **Test Requirements**:
+  - `programmatic` TR-4.1: 功能测试
+  - `human-judgment` TR-4.2: 数据准确性验证
+- **Notes**: 使用测试数据验证功能
+
+## [x] Task 5: 编写文档
+- **Priority**: P1
+- **Depends On**: Task 4
+- **Description**:
+  - 编写修改说明文档
+  - 记录查询逻辑的变更
+  - 提供使用说明
+- **Acceptance Criteria Addressed**: AC-1, AC-2, AC-3, AC-4
+- **Test Requirements**:
+  - `human-judgment` TR-5.1: 文档完整性
+  - `human-judgment` TR-5.2: 文档可读性
+- **Notes**: 确保文档包含所有必要的信息