feat(volunteer): 新增志愿服务证明材料识别及年度证明功能

- 新增志愿证明材料识别功能，支持自动识别材料并回填关键信息 - 在志愿时长编辑页面添加材料识别按钮及识别结果展示 - 新增志愿服务证明模块，支持查询、生成及下载年度志愿服务证明PDF - 志愿时长列表及审核详情中新增“服务地点”字段显示 - 志愿时长导入功能支持“服务地点”字段，完善导入表头与数据映射 - 志愿时长详情、审核流程等界面优化，增加识别材料公章状态及流程节点提示 - 志愿时长待审核项支持用户撤回操作，撤回后记录被删除需重新录入 - 社团年度报告相关接口新增，实现社团年度报告生成及分页查询 - 调整相关样式与界面布局，提升用户体验与信息展示完整性
2026-11-06 12:04:32 +08:00
parent d82a3b5426
commit d8e7e2a2a8
21 changed files with 1980 additions and 103 deletions
@@ -137,7 +137,9 @@ src/views/system/{messageTemplate,messageLog}/

 | 项 | 说明 |
 | --- | --- |
-| 志愿证明 PDF | 当前只做数据汇总与提示，模板渲染与电子章在 P1 接入（需学校提供模板与印章图） |
+| 志愿证明 PDF | **已实现**：按年度汇总已通过审核的志愿时长，生成含志愿者姓名、学院、专业、班级、学号、活动名称、活动时间、活动地点、时长、数据来源、总时长的 PDF，自动加水印，不设电子章（正文留公章位）。接口 `/api/gxmu/volunteer/certificate/*` |
+| 社团年度数据报告 | **已实现**：按年度汇总活动、成员、场地数据，生成含核心指标、类别分布、月度趋势、成员构成图表与文字小结的 PDF。入口「社团与志愿 → 年度数据报告」(`/club/report`)，接口 `/api/gxmu/club/report/*`。文字小结可按需编辑后再生成 |
+| 志愿记录服务地点 | 新增 `gxmu_volunteer_record.service_place`，录入表单与导入模板均支持；证明材料「活动地点」列取此值 |
 | OCR 公章识别 | 字段已预留（`ocr_status` / `ocr_org` / `ocr_raw`），未接 OCR 服务；活动审批暂由人工核验材料 |
 | 审核流并行 | **已实现**，见下方「补充交付」 |
 | 学分自动获取 | 第二课堂/桂志愿暂无 API，先走 Excel 导入，`source` + `external_id` 已为后续对接预留 |