上传源代码版本

.trae/specs/label-scan-enhancements/spec.md

@@ -0,0 +1,69 @@
+
+# 标签扫描记录功能增强 - 产品需求文档
+
+## Overview
+- **Summary**: 修复批量查询界面标签扫描记录的时间筛选功能，将"标签扫描记录"重命名为"换单扫描记录"，并优化页面用户体验
+- **Purpose**: 解决标签扫描记录查询时创建时间范围筛选无效的问题，改善界面文字描述，提升用户操作的舒适性和美观度
+- **Target Users**: 使用批量查询界面的运营人员、管理人员和客服人员
+
+## Goals
+1. 修复标签扫描记录查询中的创建时间开始和结束筛选无效问题
+2. 将界面中的"标签扫描记录"相关文字更新为"换单扫描记录"
+3. 优化页面的视觉设计和用户体验，使数据加载更舒适
+
+## Non-Goals (Out of Scope)
+- 修改核心业务逻辑
+- 添加新的数据筛选条件（除时间筛选外）
+- 修改标签生成和替换的核心功能
+
+## Background & Context
+- 目前标签替换请求的时间筛选功能已修复
+- 标签扫描记录查询功能类似，但时间筛选存在同样问题
+- 用户反馈"标签扫描记录"的名称不够直观，希望更准确地反映业务含义
+- 页面整体视觉可以进一步优化，提升用户体验
+
+## Functional Requirements
+- **FR-1**: 修复标签扫描记录查询接口的时间筛选功能，支持按创建时间开始和结束范围筛选
+- **FR-2**: 将界面中所有"标签扫描记录"相关文字更新为"换单扫描记录"
+- **FR-3**: 优化页面布局、配色和加载效果，提升用户体验
+
+## Non-Functional Requirements
+- **NFR-1**: 查询性能保持不变或有所提升
+- **NFR-2**: 页面在主流浏览器（Chrome、Firefox、Safari、Edge）中正常显示
+- **NFR-3**: 响应式设计，支持不同屏幕尺寸
+
+## Constraints
+- **Technical**: 使用现有的技术栈（ASP.NET Core, SQLSugar, Bootstrap, Vanilla JS）
+- **Business**: 修改不能影响现有功能的稳定性
+- **Dependencies**: 依赖现有的标签扫描记录相关数据结构和服务
+
+## Assumptions
+1. 用户已具备使用现有批量查询界面的基本操作知识
+2. 后端数据结构和存储方式保持不变
+3. 现有代码库的架构和设计模式保持一致
+
+## Acceptance Criteria
+
+### AC-1: 时间筛选修复
+- **Given**: 用户在换单扫描记录查询界面输入了创建时间开始和/或结束时间
+- **When**: 用户点击查询按钮
+- **Then**: 查询结果只包含创建时间在指定范围内的记录
+- **Verification**: programmatic
+- **Notes**: 验证从前端到后端到数据库的完整流程
+
+### AC-2: 文字更新
+- **Given**: 用户访问批量查询界面
+- **When**: 用户切换到换单扫描记录标签
+- **Then**: 所有相关的界面元素（标签页标题、卡片标题、表单元素、提示文字等）都显示为"换单扫描记录"
+- **Verification**: human-judgment
+- **Notes**: 检查所有显示的文字内容
+
+### AC-3: 页面美观度提升
+- **Given**: 用户访问批量查询界面
+- **When**: 用户使用任意查询功能
+- **Then**: 页面视觉效果更加美观，数据加载过程更舒适
+- **Verification**: human-judgment
+- **Notes**: 评估整体视觉设计和用户体验的改进
+
+## Open Questions
+- 无