# Implementation Plan: 随工水印相机 2.0.1 客户端

## Overview

基于现有的 WinForms + .NET 8 客户端项目，实现主页界面、工作记录管理、月报表功能，所有导出操作在客户端本地执行。

## Tasks

- [x] 1. 项目基础设施搭建
  - [x] 1.1 创建 Models 层数据模型
    - 创建 WorkRecordDto、MonthlyReportDto、StatisticsDto、ExportProgress、AppConfig 等模型类
    - 创建 API 响应包装类 ApiResponse<T>、PagedResult<T>
    - _Requirements: 2.5, 7.3_
  - [x] 1.2 创建 Services 层接口定义
    - 定义 IApiService、IExportService、IImageService、IConfigService、ILogService 接口
    - _Requirements: 6.3, 6.4, 10.3, 11.2, 12.2, 12.3_
  - [x] 1.3 实现 ConfigService 配置服务
    - 实现配置文件的读取和保存（JSON 格式）
    - 实现登录凭证的加密存储
    - _Requirements: 10.1, 12.1, 12.2_
  - [x] 1.4 编写 ConfigService 属性测试
    - **Property 12: 配置持久化**
    - **Validates: Requirements 12.2**
  - [x] 1.5 实现 LogService 日志服务
    - 实现日志记录（Info、Error、Warn）
    - 实现日志文件按日期分割
    - 实现日志导出功能
    - _Requirements: 12.3, 12.4_
  - [x] 1.6 编写 LogService 属性测试
    - **Property 13: 日志记录**
    - **Validates: Requirements 12.3**

- [x] 2. API 通信服务实现
  - [x] 2.1 实现 ApiService 基础功能
    - 实现 HttpClient 封装，支持 Token 认证
    - 实现请求重试机制（最多 3 次）
    - 实现 Token 自动刷新逻辑
    - _Requirements: 10.3, 10.4, 11.2_
  - [x] 2.2 编写 ApiService 属性测试
    - **Property 10: Token 自动刷新**
    - **Property 11: 请求重试机制**
    - **Validates: Requirements 10.3, 11.2**
  - [x] 2.3 实现 ApiService 业务接口
    - 实现登录接口 LoginAsync
    - 实现统计接口 GetStatisticsAsync
    - 实现工作记录 CRUD 接口
    - 实现月报表查询接口
    - 实现月份图片列表接口
    - _Requirements: 1.2, 2.2, 4.7, 5.2, 7.2, 9.1_

- [x] 3. Checkpoint - 基础服务完成
  - 确保所有测试通过，如有问题请询问用户

- [x] 4. 图片服务实现
  - [x] 4.1 实现 ImageService 下载功能
    - 实现单图下载 DownloadImageAsync
    - 实现批量并发下载 DownloadImagesAsync（使用 SemaphoreSlim 控制并发）
    - _Requirements: 6.4, 9.2_
  - [x] 4.2 编写 ImageService 并发下载属性测试
    - **Property 7: 并发下载控制**
    - **Validates: Requirements 6.4**
  - [x] 4.3 实现 ImageService 图片处理功能
    - 实现图片压缩 CompressImage（使用 SixLabors.ImageSharp）
    - 实现图片缩放 ResizeImage
    - _Requirements: 6.7_

- [x] 5. 导出服务实现
  - [x] 5.1 实现 ExportService 工作记录导出
    - 实现分页获取数据逻辑
    - 实现图片下载和临时存储
    - 实现 Excel 生成（使用 EPPlus）
    - 实现图片嵌入 Excel（水平排列，100x60 像素）
    - 实现进度回调和取消支持
    - _Requirements: 6.1, 6.2, 6.3, 6.5, 6.6, 6.7, 6.8, 6.9_
  - [x] 5.2 编写 ExportService 属性测试
    - **Property 5: 导出数据完整性**
    - **Property 6: 分页数据获取**
    - **Property 8: Excel 图片布局**
    - **Validates: Requirements 6.1, 6.2, 6.3, 6.6, 6.7**
  - [x] 5.3 实现 ExportService 月报表导出
    - 实现月报表 Excel 生成
    - _Requirements: 8.1, 8.2_
  - [x] 5.4 实现 ExportService 照片 ZIP 下载
    - 实现按目录结构下载图片
    - 实现 ZIP 打包（使用 System.IO.Compression）
    - 实现进度回调和取消支持
    - _Requirements: 9.1, 9.2, 9.3, 9.4, 9.5, 9.6_
  - [x] 5.5 编写 ExportService ZIP 目录结构属性测试
    - **Property 9: ZIP 目录结构**
    - **Validates: Requirements 9.2, 9.3**

- [x] 6. Checkpoint - 服务层完成
  - 确保所有测试通过，如有问题请询问用户

- [x] 7. 主页界面实现
  - [x] 7.1 创建 MainForm 主页窗体
    - 设计统计信息面板布局
    - 设计功能入口按钮布局
    - _Requirements: 1.1_
  - [x] 7.2 实现 MainForm 功能逻辑
    - 实现统计数据加载和显示
    - 实现导航到工作记录、月报表、数据迁移界面
    - 实现错误处理和重试
    - _Requirements: 1.2, 1.3, 1.4, 1.5, 1.6_

- [x] 8. 图片查看器实现
  - [x] 8.1 创建 ImageViewerForm 图片查看器窗体
    - 设计图片显示区域
    - 设计导航按钮（上一张、下一张）
    - _Requirements: 3.3_
  - [x] 8.2 实现 ImageViewerForm 功能逻辑
    - 实现图片加载和显示
    - 实现图片轮播切换（左右箭头、循环）
    - 实现图片缩放（鼠标滚轮）
    - 实现图片拖拽移动
    - _Requirements: 3.4, 3.5, 3.6_
  - [x] 8.3 编写图片轮播索引属性测试
    - **Property 2: 图片轮播索引边界**
    - **Validates: Requirements 3.6**

- [x] 9. 工作记录管理界面实现
  - [x] 9.1 创建 WorkRecordForm 工作记录窗体
    - 设计查询条件面板
    - 设计数据列表（DataGridView）
    - 设计工具栏按钮
    - 设计分页控件
    - _Requirements: 2.1, 2.4_
  - [x] 9.2 实现 WorkRecordForm 查询功能
    - 实现查询条件绑定
    - 实现查询和重置
    - 实现分页加载
    - _Requirements: 2.2, 2.3, 2.4_
  - [x] 9.3 实现 WorkRecordForm 列表显示
    - 实现数据绑定和显示
    - 实现多图缩略图显示（最多 3 张 + 徽章）
    - 实现多选功能
    - _Requirements: 2.5, 3.1, 3.2_
  - [x] 9.4 编写图片显示数量属性测试
    - **Property 1: 图片显示数量限制**
    - **Validates: Requirements 3.1, 3.2**
  - [x] 9.5 实现 WorkRecordForm 导出功能
    - 实现导出全部
    - 实现导出所选
    - 实现进度显示和取消
    - _Requirements: 6.1, 6.2, 6.8, 6.9, 6.10_

- [x] 10. 工作记录编辑功能实现
  - [x] 10.1 创建 WorkRecordEditForm 编辑弹窗
    - 设计表单布局（所有可编辑字段）
    - 设计图片上传区域
    - _Requirements: 4.3_
  - [x] 10.2 实现 WorkRecordEditForm 图片上传功能
    - 实现拖拽上传
    - 实现点击选择多文件
    - 实现图片预览
    - 实现图片删除
    - 实现数量限制（最多 15 张，单张 10MB）
    - _Requirements: 4.4, 4.5, 4.6_
  - [x] 10.3 编写图片上传数量属性测试
    - **Property 3: 图片上传数量限制**
    - **Property 4: 图片删除后列表更新**
    - **Validates: Requirements 4.5, 4.6**
  - [x] 10.4 实现 WorkRecordEditForm 表单提交
    - 实现新增记录
    - 实现编辑记录
    - 实现表单验证
    - 实现错误处理
    - _Requirements: 4.1, 4.2, 4.7, 4.8_
  - [x] 10.5 实现 WorkRecordForm 删除功能
    - 实现删除确认对话框
    - 实现删除 API 调用
    - 实现错误处理
    - _Requirements: 5.1, 5.2, 5.3_

- [x] 11. Checkpoint - 工作记录功能完成
  - 确保所有测试通过，如有问题请询问用户

- [x] 12. 月报表界面实现
  - [x] 12.1 创建 MonthReportForm 月报表窗体
    - 设计查询条件面板（人员名称、月份）
    - 设计数据列表
    - 设计工具栏按钮
    - _Requirements: 7.1_
  - [x] 12.2 实现 MonthReportForm 查询功能
    - 实现查询和重置
    - 实现数据显示
    - _Requirements: 7.2, 7.3_
  - [x] 12.3 实现 MonthReportForm 导出功能
    - 实现 Excel 导出
    - 实现照片 ZIP 下载
    - 实现进度显示和取消
    - _Requirements: 8.1, 8.2, 8.3, 9.1, 9.5, 9.6, 9.7_

- [x] 13. 通用功能实现
  - [x] 13.1 实现登录状态管理
    - 实现记住登录功能
    - 实现自动登录
    - 实现登录失效提示
    - _Requirements: 10.1, 10.2, 10.4_
  - [x] 13.2 实现网络异常处理
    - 实现网络断开检测和提示
    - 实现断点续传支持
    - _Requirements: 11.1, 11.3_
  - [x] 13.3 创建 SettingsForm 设置界面
    - 设计设置项布局
    - 实现设置保存
    - _Requirements: 12.1, 12.2_

- [x] 14. 后端 API 支持
  - [x] 14.1 实现统计接口
    - 创建 /api/workrecord/statistics 接口
    - 返回本月记录数、图片数、人员数、今日新增、总量、待迁移数
    - _Requirements: 1.2_
  - [x] 14.2 实现月份图片列表接口
    - 创建 /api/workrecord/monthImages 接口
    - 返回指定月份的所有图片 URL 及相关信息
    - _Requirements: 9.1_

- [x] 15. Final Checkpoint - 全部功能完成
  - 确保所有测试通过
  - 进行集成测试
  - 如有问题请询问用户

## Notes

- All tasks are required for complete implementation
- Each task references specific requirements for traceability
- Checkpoints ensure incremental validation
- Property tests validate universal correctness properties
- Unit tests validate specific examples and edge cases
- 使用 C# / .NET 8 开发
- 使用 EPPlus 生成 Excel
- 使用 SixLabors.ImageSharp 处理图片
- 使用 System.IO.Compression 打包 ZIP