WorkCamera/tasks.md at master

1. 后端 COS 集成与配置

1.1 添加腾讯云 COS SDK 依赖
- 在 ZR.Common 项目中添加 Tencent.QCloud.Cos.Sdk NuGet 包
- Requirements: 1.1
1.2 创建 COS 配置模型
- 在 Infrastructure/Model/OptionsSetting.cs 中添加 TencentCOS 配置类
- 包含 AppId, Region, SecretId, SecretKey, BucketName, DomainUrl, MaxSize, DurationSecond, Prefixes
- Requirements: 1.1
1.3 更新 appsettings.json 配置
- 添加 TencentCOS 配置节
- Requirements: 1.1
1.4 创建 CosService 服务类
- 创建 ZR.Common/CosService.cs
- 实现 GetUploadUrls 方法生成预签名 URL
- 实现 GetTempCredentials 方法获取临时密钥
- Requirements: 1.1, 1.2, 1.3, 1.4, 1.5
1.5 编写 CosService 单元测试
- 测试 URL 生成逻辑
- 测试目录路径格式
- Requirements: 1.1, 1.2, 1.4, 1.5

2. COS 预签名 URL 接口

2.1 创建 COS 相关 DTO
- 在 ZR.Model/Business/Dto 中创建 CosUploadUrlsRequest.cs
- 创建 CosUploadUrlsResponse.cs
- Requirements: 1.1, 1.2
2.2 创建 CosController
- 在 ZR.Admin.WebApi/Controllers 中创建 CosController.cs
- 实现 POST /api/cos/getUploadUrls 接口
- 实现 GET /api/cos/getTempCredentials 接口
- Requirements: 1.1, 1.2, 1.3
2.3 编写属性测试 - URL 生成完整性
- Property 1: Pre-signed URL Generation Completeness
- Validates: Requirements 1.1, 1.2, 1.4, 1.5

3. Checkpoint - COS 集成验证

4. 工作记录 V3 接口

4.1 创建 V3 DTO
- 在 ZR.Model/Business/Dto 中创建 CamRecordWorkV3Dto.cs
- 包含 ImageUrls 字段替代 Image/Images
- Requirements: 3.1, 3.2
4.2 实现 V3 保存接口
- 在 CommonController.cs 中添加 AddCamWorkRecordV3 方法
- 路由: POST /addworkrecordv3
- 验证 COS URL 格式
- 复用现有数据库存储逻辑
- Requirements: 3.1, 3.2, 3.3, 3.4, 3.5
4.3 编写属性测试 - COS URL 验证
- Property 2: COS URL Validation
- Validates: Requirements 3.3
4.4 编写属性测试 - V3 记录保存完整性
- Property 3: V3 Record Save Integrity
- Validates: Requirements 3.1, 3.4

5. Checkpoint - V3 接口验证

6. 数据导出 API

6.1 创建导出查询 DTO
- 在 ZR.Model/Business/Dto 中创建 WorkRecordExportQueryDto.cs
- 创建 WorkRecordExportDto.cs
- Requirements: 4.1, 4.3, 4.4
6.2 创建导出 Service
- 在 ZR.Service/Business 中创建 WorkRecordExportService.cs
- 实现分页查询逻辑
- 实现过滤逻辑（日期、部门、人员、内容）
- Requirements: 4.1, 4.2, 4.3, 4.4
6.3 创建导出 Controller
- 在 ZR.Admin.WebApi/Controllers 中创建 WorkRecordExportController.cs
- 实现 GET /api/workrecord/export/list 接口
- 添加认证要求
- Requirements: 4.1, 4.2, 4.3, 4.4, 4.5
6.4 编写属性测试 - 分页一致性
- Property 4: Export Pagination Consistency
- Validates: Requirements 4.1, 4.2, 4.4
6.5 编写属性测试 - 过滤准确性
- Property 5: Export Filter Accuracy
- Validates: Requirements 4.3

7. Checkpoint - 导出 API 验证

8. 历史数据迁移 API

8.1 创建迁移相关 DTO
- 在 ZR.Model/Business/Dto 中创建 MigrationQueryDto.cs
- 创建 MigrationRecordDto.cs
- 创建 MigrationUpdateDto.cs
- Requirements: 10.1, 10.2, 10.3
8.2 创建迁移 Service
- 在 ZR.Service/Business 中创建 WorkRecordMigrationService.cs
- 实现待迁移记录查询（根据 URL 域名判断）
- 实现 URL 更新逻辑
- Requirements: 10.1, 10.2, 10.3, 10.4
8.3 创建迁移 Controller
- 在 ZR.Admin.WebApi/Controllers 中创建 WorkRecordMigrationController.cs
- 实现 GET /api/workrecord/migration/list 接口
- 实现 POST /api/workrecord/migration/update 接口
- Requirements: 10.1, 10.2, 10.3, 10.4
8.4 编写属性测试 - 迁移列表过滤
- Property 6: Migration List Filter
- Validates: Requirements 10.1, 10.2
8.5 编写属性测试 - 迁移 URL 更新完整性
- Property 7: Migration URL Update Integrity
- Validates: Requirements 10.3, 10.4

9. Checkpoint - 后端 API 完成验证

10. 前端 UniApp 上传改造

10.1 创建 COS 上传服务
- 在 uniapp/WorkCameraf/common 中创建 cosUpload.js
- 实现获取预签名 URL 方法
- 实现直传 COS 方法（PUT 请求）
- Requirements: 2.1, 2.2, 2.3, 2.4
10.2 修改 server.js 添加 V3 接口调用
- 添加 addWatermarkRecordV3 方法
- 调用 /addworkrecordv3 接口
- Requirements: 3.1, 3.2
10.3 修改上传流程
- 修改拍照后的上传逻辑
- 先获取预签名 URL
- 并发上传到 COS（最多 3 个并发）
- 上传成功后调用 V3 接口保存记录
- Requirements: 2.1, 2.2, 2.3, 2.4, 3.1

11. Checkpoint - 前端上传验证

12. CS 客户端项目搭建

12.1 创建 WinForms 项目
- 创建 WorkCameraExport 解决方案
- 配置 .NET 8 AOT 单文件发布
- 添加 EPPlus、SixLabors.ImageSharp 依赖
- Requirements: 5.1, 7.3, 7.4
12.2 创建 API 服务类
- 创建 Services/ApiService.cs
- 实现登录、查询、迁移等 API 调用
- Requirements: 5.1, 5.2, 4.1
12.3 创建 COS 服务类
- 创建 Services/CosService.cs
- 实现图片上传到 COS
- Requirements: 9.2

13. CS 客户端登录模块

13.1 创建登录窗体
- 创建 Forms/LoginForm.cs
- 包含服务器地址、用户名、密码输入
- 实现记住登录状态功能
- Requirements: 5.1, 5.2, 5.3, 5.4

14. CS 客户端导出模块

14.1 创建主窗体
- 创建 Forms/MainForm.cs
- 包含查询条件区域（日期、部门、人员、内容）
- 包含数据预览区域
- 包含导出进度区域
- Requirements: 6.1, 6.2, 6.3, 7.5
14.2 创建 Excel 服务类
- 创建 Services/ExcelService.cs
- 实现 Excel 生成逻辑
- 实现图片嵌入逻辑（100x60 像素，50% 压缩）
- Requirements: 7.3, 7.4
14.3 实现导出功能
- 实现分页获取数据
- 实现并发下载图片（最多 5 个并发）
- 实现进度显示
- 实现取消功能
- Requirements: 7.1, 7.2, 7.5, 7.6, 7.7

15. CS 客户端迁移模块

16. Final Checkpoint - 全功能验证

Implementation Plan: 随工水印相机 2.0