# 随工水印相机导出工具 (WorkCameraExport)

Windows 桌面应用程序，用于管理和导出工作现场拍摄的水印照片记录。

## 功能特性

### 工作记录管理
- 查询、浏览工作记录（支持按日期、部门、地址、内容、人员等筛选）
- 编辑工作记录信息
- 查看记录关联的照片

### 数据导出
- 导出工作记录到 Excel（含嵌入图片）
- 按月份下载照片并打包成 ZIP
- ZIP 按目录结构分类：当日照片、参与人员、工作内容、部门

### 月报表
- 生成月度工作统计报表
- 导出月报表 Excel

### 其他功能
- 用户登录 / 自动登录
- 网络状态监控
- 图片下载压缩处理
- 历史数据迁移

## 技术栈

- .NET 8 Windows Forms
- EPPlus（Excel 生成）
- SixLabors.ImageSharp（图片处理）
- 腾讯云 COS SDK（云存储）

## 项目结构

```
WorkCameraExport/
├── Forms/              # 窗体界面
│   ├── LoginForm       # 登录窗体
│   ├── HomeForm        # 主页（统计信息）
│   ├── WorkRecordForm  # 工作记录管理
│   ├── MonthReportForm # 月报表
│   ├── MigrationForm   # 数据迁移
│   ├── SettingsForm    # 设置
│   └── ImageViewerForm # 图片查看器
├── Services/           # 业务服务
│   ├── ApiService      # API 调用
│   ├── ExportService   # 导出服务
│   ├── ImageService    # 图片处理
│   ├── ExcelService    # Excel 生成
│   ├── ConfigService   # 配置管理
│   ├── LogService      # 日志服务
│   └── CosService      # 腾讯云 COS
├── Models/             # 数据模型
└── Properties/         # 项目属性
```

## 开发环境

- Visual Studio 2022
- .NET 8 SDK
- Windows 10/11

## 构建与发布

```bash
# 构建
dotnet build

# 发布单文件可执行程序
dotnet publish -c Release
```

## 配置说明

应用配置文件位于用户目录下，首次运行时自动创建。

主要配置项：
- 服务器地址
- 图片下载并发数
- 图片压缩质量
- 自动清理临时文件

## 工作记录导出流程

### 1. 导出全部数据

```
点击"导出全部" → 构建查询条件 → 分页获取所有数据 → 下载图片 → 生成 Excel
     ↓
WorkRecordForm.ExportAllAsync()
     ↓
ExportService.ExportWorkRecordsAsync(query, outputPath, progress)
     ↓
FetchAllRecordsAsync()  // 分页获取数据
     ↓
循环调用 API: GET /business/CamWorkrecord/list?pageNum=X&pageSize=50&...
     ↓
DownloadImagesAsync()  // 并发下载图片
     ↓
ExcelService.ExportWorkRecordsToExcelAsync()  // 生成 Excel
```

### 2. 导出选中数据

```
勾选记录 → 点击"导出选中" → 逐个获取记录详情 → 下载图片 → 生成 Excel
     ↓
WorkRecordForm.ExportSelectedAsync(ids)
     ↓
ExportService.ExportWorkRecordsByIdsAsync(ids, outputPath, progress)
     ↓
循环调用 API: GET /business/CamWorkrecord/{id}  // 获取每条记录详情
     ↓
DownloadImagesAsync()  // 并发下载图片
     ↓
ExcelService.ExportWorkRecordsToExcelAsync()  // 生成 Excel
```

### API 接口汇总

| 接口 | 方法 | 说明 |
|------|------|------|
| `/business/CamWorkrecord/list` | GET | 分页查询工作记录列表 |
| `/business/CamWorkrecord/{id}` | GET | 获取单条工作记录详情 |
| `/business/CamWorkrecord` | POST | 新增工作记录 |
| `/business/CamWorkrecord` | PUT | 更新工作记录 |
| `/business/CamWorkrecord/{id}` | DELETE | 删除工作记录 |
| `/business/CamWorkers/list` | GET | 获取月报表数据 |
| `/api/workrecord/monthImages` | GET | 获取指定月份的所有图片 |
| `/api/workrecord/statistics` | GET | 获取统计信息 |
| `/api/cos/getTempCredentials` | GET | 获取 COS 临时密钥 |
| `/api/workrecord/migration/list` | GET | 查询待迁移记录 |
| `/api/workrecord/migration/update` | POST | 更新迁移后的 URL |

### 查询参数说明

工作记录查询 (`/business/CamWorkrecord/list`):
- `pageNum` - 页码
- `pageSize` - 每页数量
- `startDate` - 开始日期
- `endDate` - 结束日期
- `deptName` - 部门名称
- `address` - 地址
- `content` - 工作内容
- `workerName` - 人员名称
- `statusName` - 状态

月报表查询 (`/business/CamWorkers/list`):
- `yearMonth` - 月份 (YYYY-MM)
- `workerName` - 人员名称

---

## 月报表功能流程

### 1. 查询月报表

```
用户选择月份 → 调用 API 获取数据 → 显示到表格
     ↓
MonthReportForm.LoadDataAsync()
     ↓
ApiService.GetMonthlyReportAsync(query)
     ↓
返回 List<MonthlyReportDto>（月份、部门、人员、工作天数）
```

### 2. 导出月报表 Excel

```
点击"导出 Excel" → 生成文件名 → 调用导出服务 → 保存文件
     ↓
MonthReportForm.ExportExcelAsync()
     ↓
ExportService.ExportMonthlyReportAsync(data, outputPath)
     ↓
ExcelService.ExportMonthlyReportToExcelAsync()
     ↓
生成 Excel（序号、时间、部门、人员、工作天数）
     ↓
保存到 PathService.ExportDirectory
```

### 3. 下载照片 ZIP

```
点击"下载照片" → 获取月份图片列表 → 并发下载图片 → 按目录结构保存 → 打包 ZIP
     ↓
MonthReportForm.DownloadPhotosZipAsync()
     ↓
ExportService.DownloadPhotosZipAsync(yearMonth, outputPath, progress)
     ↓
ApiService.GetMonthImagesAsync(yearMonth)  // 获取图片列表
     ↓
ImageService.DownloadImageAsync()  // 逐个下载
     ↓
CreateDirectoryStructure()  // 创建目录结构
     ↓
ZipFile.CreateFromDirectory()  // 打包
```

### ZIP 目录结构

```
workfiles/
└── {yyyyMM}/
    └── {yyyyMMdd}/
        ├── 当日照片/          # 当天所有照片
        ├── 参与人员/
        │   ├── {人员A}/       # 按人员分类
        │   └── {人员B}/
        ├── 工作内容/
        │   └── {工作内容}/    # 按工作内容分类
        └── 部门/
            └── {部门名称}/    # 按部门分类
```

### 数据模型

| 模型 | 用途 |
|------|------|
| MonthReportQueryDto | 查询条件（月份、人员名称） |
| MonthlyReportDto | 月报表数据（月份、部门、人员、工作天数） |
| MonthImageDto | 月份图片（记录ID、日期、部门、内容、人员、图片URL列表） |

## 版本历史

- v2.0.0 - 当前版本