all-project/docs/需求文档/奖惩补贴需求/助学金模块产品需求设计.md

文档信息

• 文档名称: 助学金模块产品需求设计
• 版本: v1.0.0
• 日期: 2025-08-09
• 状态: 提案/待评审
• 作者: 项目组
• 所属模块: 奖惩补贴管理 · 助学金

---

一、背景与目标

• 背景: 学校需对家庭经济困难学生进行认定并开展资助发放管理，现有流程在线下进行，数据分散，统计困难。
• 目标: 构建统一的“贫困生认定”线上办理与审核平台，支持规范的数据采集、流程审批、材料留存与统计分析，提升办理效率与透明度。
• 范围: 本期覆盖“贫困生认定申请、审核、统计导出”，资助发放与公示等后续阶段不在本期范围。

---

二、名词解释与范围界定

• 贫困生认定: 对学生家庭经济困难状况进行分类认定的业务。
• 认定类型（群体）:
  • 特殊群体: 低保家庭学生、特困供养学生、孤儿、烈士子女、残疾学生、低保边缘家庭学生、脱贫家庭学生（原建档立卡）、其他经济困难农户、其他群体（临时救助）。
  • 证明要求: 需提供相应政府部门出具的证明。
  • 其他群体: 因遭受自然灾害、意外事件、重大疾病等情况导致家庭经济困难的学生。
  • 证明要求: 需提供学生所在街道（乡镇）级以上政府部门出具的相关证明，属于重大疾病导致家庭经济困难的还需要提供当年度医药费相关凭证。
• 申请自助类型: 1) 浙江省学生资助；2) 杭州第一技师学院学生资助。
• 附件说明: 申请表和调查表均为学生提交的纸质版文件照片，需清晰可识别。

---

三、角色与权限

• 班主任（申请发起人）: 查询并选择本班学生、填报认定申请、上传材料、提交/保存草稿、撤销申请、查看处理进度。
• 审核人员（资助管理员）: 审核列表查看、详情与附件在线预览、通过/驳回（填写意见）、查看历史记录。
• 系统管理员: 字典配置（认定类型、自助类型）、附件大小与格式配置、菜单与权限配置、数据导出范围控制。

权限建议（Sa-Token 权限码，供实现参考）：

• xg:scholarship:apply:list|query|add|edit|remove|cancel
• xg:scholarship:review:list|query|approve|reject
• xg:scholarship:stat:list|export
• xg:scholarship:config:dict|attach|menu

---

四、业务流程与状态

• 状态定义（与项目工作流标准对齐）：draft 草稿 → submitted 已提交 → waiting 待审核 → rejected 已驳回 → complete 已通过 → canceled 已撤销。
• 流程说明: 1) 班主任创建申请，可保存草稿或提交。 2) 提交后进入待审核，审核人员在平台查看详情与附件。 3) 审核通过：认定完成并归档；审核驳回：需填写驳回意见，申请退回申请人，允许修改后再次提交。 4) 申请人在待审核前可主动撤销。
• 审计要求: 全链路记录节点、操作人、时间、意见与附件版本号。

---

五、功能需求

5.1 认定申请（班主任）

• 学生选择：按学号/姓名检索，仅限本班学生；选择后自动带出学号、姓名、性别、学院、专业、班级等基础信息。
• 认定类型：选择"特殊群体/其他群体"并在下拉列表中选择具体类别（详见字典定义）。
  • 页面展示要求: 页面上必须展示每个群体的详细说明和证明要求，帮助班主任正确选择。
  • 特殊群体说明：需提供相应政府部门出具的证明
  • 其他群体说明：需提供街道（乡镇）级以上政府部门证明，重大疾病情况需额外提供当年度医药费凭证
• 申请自助类型：在"浙江省学生资助/杭州第一技师学院学生资助"中选择其一或多选（按政策可配置）。
• 附件上传：必须上传两个附件——申请表、调查表（均为学生提交纸质版文件的照片）；每个文件≤10MB，支持格式：jpg/jpeg/png/pdf/doc/docx（可配）。
• 表单字段：
  • 学年学期（如 2025-2026 学年第一学期）
  • 家庭经济情况摘要（文本，500字上限）
  • 认定类型（群体+具体类别）
  • 申请自助类型（多选/单选由配置决定）
  • 附件：申请表、调查表
• 操作：保存草稿、提交、主动撤销申请（待审核状态下班主任可主动取消申请）。
• 校验：
  • 必填项完整校验；
  • 两个附件必须同时具备；
  • 单文件大小≤10MB；
  • 同一学生同一学年不可重复认定（同类认定）；
  • 仅班主任可为本班学生发起。

5.2 审核处理（审核人员）

• 列表：支持按学院、专业、班级、性别、认定类型、申请自助类型、认定时间/学年、状态等过滤与排序。
• 详情：展示学生基础信息、认定申请信息、历史流转记录；附件支持在线预览（图片/PDF优先内嵌，Office 文件可下载）。
• 审核动作：
  • 通过：贫困生认定成功，进入"已通过complete"状态，记录审核时间与审核人。
  • 不通过打回：必须填写驳回原因，申请退回班主任并置为"已驳回rejected"状态，需要班主任重新修改后再次提交。
• 变更限制：待审核期间班主任不可编辑；驳回后方可编辑并再次提交；班主任也可主动取消申请。

5.3 统计与导出

• 条件查询：支持学院、专业、班级、性别、认定类型（含群体与类别）、学年/时间段、申请自助类型、状态等组合筛选。
• 统计维度：按学院/专业/班级/性别/认定类别的数量与占比统计。
• 导出：导出筛选结果为 Excel（XLSX），字段包含：学年、学号、姓名、学院、专业、班级、性别、认定群体与类别、申请自助类型、状态、提交时间、审核时间、审核人。

5.4 通知与提醒（可选）

• 审核通过/驳回后向申请人（班主任）发送站内信或消息通知；通知模板可配置。

---

六、数据模型与字段

建议字段（与后端规范保持一致，含基础字段与多租户、逻辑删除）：

• 认定申请表（示例）
  • id（雪花ID，bigint）
  • tenant_id（租户ID）
  • academic_year（学年，如2025-2026）
  • term（学期，1/2，可选）
  • student_id、student_no、student_name、gender
  • college_id、college_name、major_id、major_name、class_id、class_name
  • recognition_group（特殊群体/其他群体）
  • recognition_category（具体类别，见字典）
  • self_service_types（数组/字典多选：省/校）
  • family_economy_summary（家庭经济情况摘要）
  • attach_application_form_url（申请表）
  • attach_survey_form_url（调查表）
  • status（draft/submitted/waiting/rejected/complete/canceled）
  • submitter_id、submitter_name
  • auditor_id、auditor_name、audit_time、audit_opinion
  • createBy、createTime、updateBy、updateTime（VO类时间字段需JSON格式化）
  • deleted（逻辑删除标记）

附件可统一走系统附件中心，保留附件id、原始文件名、大小、MIME、预览地址等。

---

七、字典与配置

• 字典：SCHOLARSHIP_RECOGNITION_CATEGORY
  • 特殊群体：低保家庭学生、特困供养学生、孤儿、烈士子女、残疾学生、低保边缘家庭学生、脱贫家庭学生（原建档立卡）、其他经济困难农户、其他群体（临时救助）。
  • 其他群体：自然灾害、意外事件、重大疾病等（可扩展）；必要时要求上传相应凭证说明。
• 字典：SCHOLARSHIP_SELF_SERVICE_TYPE
  • 浙江省学生资助、杭州第一技师学院学生资助。
• 配置项：
  • 附件必传项（申请表、调查表）启用/禁用（默认启用）
  • 单文件大小上限（默认 10MB）
  • 允许文件类型（默认 jpg、jpeg、png、pdf、doc、docx）
  • 自助类型是否允许多选（默认 单选，可配置）

---

八、菜单与导航（建议）

• 奖惩补贴管理
  • 助学金管理
  • 贫困生认定申请（班主任）
  • 认定审核（资助管理员）
  • 认定统计（导出）

菜单元信息需配置权限码、路由、组件路径、是否缓存、排序等，详见项目菜单规范。

---

九、页面与交互要点

• 申请表单：分区展示（学生信息/认定信息/附件上传），附件上传进度展示与删除替换。
  • 认定类型选择区域：必须清晰展示每个群体的说明和证明要求，帮助班主任正确选择。
  • 附件上传提示：明确说明附件为"学生提交纸质版文件的照片"，要求清晰可识别。
• 审核详情：左侧基础信息与申请信息，右侧流程记录与附件预览区；支持图片缩放、PDF翻页。
• 列表页：常用筛选项默认展开，保存常用筛选方案。
• 空态与错误：缺失附件/超限大小/格式不支持的即时校验与友好提示。
• 撤销申请确认：班主任主动取消申请时需要二次确认，避免误操作。

---

十、非功能与安全

• 认证与权限：所有接口需校验登录与权限；数据按租户隔离；班主任仅可操作本班学生数据。
• 日志与审计：操作日志、审批日志、错误日志完备；导出记录审计。
• 性能：列表分页；附件预览采用流式与缓存策略；导出支持异步任务（大数据量）。
• 可配置性：字典与附件限制可后台配置。

---

十一、验收标准（关键用例）

• 班主任能检索本班学生并一键带出基础信息。
• 认定类型选择页面正确展示群体说明和证明要求。
• 认定类型与自助类型可正常选择并持久化。
• 两个附件必传限制生效，单文件>10MB或格式不符时前后端均拦截。
• 附件上传页面明确提示为"纸质版文件照片"。
• 同一学生同一学年重复认定拦截（同类）。
• 班主任可主动取消待审核状态的申请，有二次确认。
• 审核人可在线预览附件，能通过（认定成功）或不通过打回并记录意见与时间。
• 审核不通过后班主任可重新修改并再次提交。
• 统计筛选与导出字段完整无误，导出与列表一致。

---

十二、里程碑与交付

• M1 原型与交互稿（docs/原型文件/ 学工/或模块目录下）
• M2 数据字典与菜单配置
• M3 开发与联调（含附件预览）
• M4 自测与修复
• M5 验收与上线

---

十三、风险与边界

• 政策变化导致认定类别调整：通过字典快速扩展。
• Office 附件在线预览兼容性：优先PDF与图片内嵌，其余下载。
• 学生基础信息准确性依赖主数据同步，请在同步中台保证及时性。

---

附录：校验清单（摘要）

• 必填：学年、学生、认定群体与类别、申请自助类型、两项附件。
• 附件大小：≤10MB/单文件；类型限制；病毒扫描（若有）。
• 权限：班主任仅操作本班；审核操作需对应权限码。