wuzhen update2

2025-08-12 16:52:10 +08:00
commit 2272bb7eb1
@@ -0,0 +1,197 @@
+### 文档信息
+- **文档名称**: 助学金模块产品需求设计
+- **版本**: 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/单文件；类型限制；病毒扫描（若有）。
+- 权限：班主任仅操作本班；审核操作需对应权限码。 
@@ -0,0 +1,607 @@
+# 勤工俭学管理系统产品需求分析书
+
+## 📋 文档信息
+
+| 项目 | 信息 |
+|------|------|
+| **文档名称** | 勤工俭学管理系统产品需求分析书 |
+| **项目名称** | 校园管理系统 - 勤工俭学模块 |
+| **文档版本** | v1.0 |
+| **创建日期** | 2025-01-03 |
+| **最后更新** | 2025-01-03 |
+| **需求来源** | 勤工俭学用户原始需求.md |
+
+---
+
+## 🎯 项目概述
+
+### 1.1 产品背景
+勤工俭学管理系统是校园管理系统的重要组成部分，旨在为高校提供完整的勤工助学岗位管理、学生申请、审核流程的数字化解决方案。系统支持二级学院和学生处的分级审核机制，规范勤工俭学的全流程管理。
+
+### 1.2 产品目标
+- **🎯 提升效率**: 实现勤工俭学岗位管理的数字化、流程化
+- **📊 规范管理**: 建立标准的岗位发布、申请、审核流程
+- **🔍 透明公开**: 提供岗位信息公开展示和申请状态跟踪
+- **⚖️ 权限分级**: 支持二级学院和学生处的分级审核管理
+- **📱 多端访问**: 支持Web端和移动端的便捷使用
+
+### 1.3 产品定位
+面向高校勤工助学管理的综合性平台，覆盖岗位发布方（二级学院）、申请方（学生）、审核方（二级学院负责人、学生处负责人）的全角色需求。
+
+---
+
+## 👥 用户角色分析
+
+### 2.1 核心用户角色
+
+#### 🎓 **学生用户**
+**角色描述**: 需要通过勤工俭学获得经济资助的在校学生
+**核心需求**:
+- 浏览和搜索适合的勤工俭学岗位
+- 在线申请心仪的岗位
+- 跟踪申请状态和结果
+- 查看工作时间和薪资信息
+
+**使用场景**:
+- 经济困难学生寻找兼职工作
+- 希望通过勤工俭学锻炼能力
+- 需要了解岗位要求和待遇信息
+
+#### 🏛️ **二级学院管理员**
+**角色描述**: 负责本学院勤工俭学岗位发布和初审的工作人员
+**核心需求**:
+- 发布和管理本学院的勤工俭学岗位
+- 设置岗位发布范围（本学院/全校）
+- 审核学生的岗位申请
+- 管理岗位的有效期和需求人数
+
+**使用场景**:
+- 根据学院需要发布新岗位
+- 定期更新岗位信息
+- 处理学生申请的初审工作
+
+#### 📋 **二级学院审核负责人**
+**角色描述**: 负责审核本学院学生勤工俭学申请的领导或负责人
+**核心需求**:
+- 审核学生的岗位申请
+- 查看申请人的基本信息和条件
+- 决定申请通过或驳回
+- 查看审核统计数据
+
+**使用场景**:
+- 定期审核待处理的申请
+- 根据岗位要求评估申请人条件
+- 控制岗位的录用质量
+
+#### 🏫 **学生处审核负责人**
+**角色描述**: 负责全校勤工俭学申请终审的学生处工作人员
+**核心需求**:
+- 终审已通过二级学院审核的申请
+- 统筹全校勤工俭学岗位分配
+- 查看全校勤工俭学统计数据
+- 管理特殊情况的申请处理
+
+**使用场景**:
+- 对重要岗位进行最终审核
+- 协调跨学院的岗位申请
+- 处理申请争议和特殊情况
+
+### 2.2 用户权限矩阵
+
+| 功能模块 | 学生 | 学院管理员 | 学院审核负责人 | 学生处负责人 |
+|---------|------|------------|----------------|--------------|
+| **岗位浏览** | ✅ 查看 | ✅ 查看 | ✅ 查看 | ✅ 查看 |
+| **岗位管理** | ❌ | ✅ 增删改 | ✅ 查看本学院 | ✅ 查看全部 |
+| **岗位申请** | ✅ 申请 | ❌ | ❌ | ❌ |
+| **初审管理** | ❌ | ❌ | ✅ 本学院 | ❌ |
+| **终审管理** | ❌ | ❌ | ❌ | ✅ 全校 |
+| **数据统计** | ✅ 个人 | ✅ 本学院 | ✅ 本学院 | ✅ 全校 |
+
+---
+
+## 🔧 功能需求分析
+
+### 3.1 功能架构图
+
+```
+勤工俭学管理系统
+├── 岗位管理模块
+│   ├── 岗位发布
+│   ├── 岗位维护
+│   └── 岗位查询
+├── 申请管理模块
+│   ├── 在线申请
+│   ├── 申请查询
+│   └── 申请撤回
+├── 审核管理模块
+│   ├── 二级学院审核
+│   ├── 学生处审核
+│   └── 审核记录
+└── 统计报表模块
+    ├── 岗位统计
+    ├── 申请统计
+    └── 审核统计
+```
+
+### 3.2 详细功能需求
+
+#### 🏢 **模块一：勤工俭学岗位维护**
+
+**功能描述**: 二级学院管理员负责岗位的全生命周期管理
+
+**子功能列表**:
+
+##### 3.2.1 岗位新增
+**功能说明**: 创建新的勤工俭学岗位
+**输入信息**:
+- 🏷️ **岗位名称** `必填` - 岗位的标题和名称
+- 🎯 **岗位发布范围** `必填` - 选择项：
+  - `本学院` - 仅本学院学生可见和申请
+  - `全校` - 所有学生可见和申请
+- 👥 **需求人数** `必填` - 本岗位计划招录的学生数量
+- ⏰ **工作时间** `必填` - 工作时间安排描述
+- 📅 **岗位有效期** `必填` - 岗位的起止日期
+- 📝 **岗位要求** `必填` - 对申请学生的条件要求
+- 💰 **薪资情况** `必填` - 薪资标准和发放方式
+- 👨‍🏫 **联系老师** `必填` - 负责该岗位的联系人
+- 📞 **联系电话** `必填` - 联系方式
+
+**业务规则**:
+- 岗位有效期不能早于当前日期
+- 需求人数必须大于0
+- 同一学院内岗位名称不能重复
+- 联系电话需要格式验证
+
+**输出结果**: 岗位创建成功，生成唯一岗位编号
+
+##### 3.2.2 岗位查询展示
+**功能说明**: 根据权限展示相关岗位信息
+**查询条件**:
+- 📍 **按学院筛选** - 学院管理员只能看到本学院岗位
+- 📅 **按有效期筛选** - 有效/即将到期/已过期
+- 🔍 **按岗位名称搜索** - 模糊搜索
+- 👥 **按招录状态筛选** - 招录中/已满员/已结束
+
+**展示信息**:
+- 岗位基本信息（名称、要求、薪资等）
+- 当前申请人数/需求人数
+- 岗位状态（招录中/已满员等）
+- 操作按钮（编辑/删除/查看详情）
+
+##### 3.2.3 岗位修改
+**功能说明**: 修改已发布的岗位信息
+**可修改字段**: 除岗位编号外的所有字段
+**业务规则**:
+- 已有学生申请的岗位修改需要特别提示
+- 缩减需求人数时，需要处理超出部分的申请
+- 修改岗位要求时，需要重新评估已申请学生的条件
+
+##### 3.2.4 岗位删除
+**功能说明**: 删除不再需要的岗位
+**业务规则**:
+- 有学生申请的岗位不能直接删除
+- 删除前需要确认操作
+- 删除后相关申请记录需要妥善处理
+
+#### 🎓 **模块二：勤工俭学岗位申请**
+
+**功能描述**: 学生用户申请勤工俭学岗位
+
+##### 3.2.5 岗位浏览
+**功能说明**: 学生查看可申请的岗位
+**可见岗位范围**:
+- ✅ 本学院发布的所有岗位
+- ✅ 其他学院发布的全校范围岗位
+- ❌ 其他学院发布的本学院范围岗位
+
+**展示信息**:
+- 岗位详细信息
+- 当前申请状态
+- 岗位剩余名额
+- 申请截止时间
+
+##### 3.2.6 在线申请
+**功能说明**: 学生提交岗位申请
+**申请流程**:
+1. 选择心仪岗位
+2. 确认个人信息
+3. 填写申请理由
+4. 提交申请
+
+**业务规则**:
+- 每个岗位学生只能申请一次
+- 申请时需要满足岗位设定的条件限制
+- 岗位已满员或过期不能申请
+- 学生同时申请的岗位数量可能有限制
+
+##### 3.2.7 申请状态查询
+**功能说明**: 学生查看自己的申请状态
+**状态类型**:
+- 🟡 **已提交** - 等待二级学院审核
+- 🔵 **二级学院审核中** - 学院负责人审核中
+- 🟠 **待学生处审核** - 已通过学院审核，等待学生处审核
+- 🟢 **审核通过** - 申请成功
+- 🔴 **审核不通过** - 申请被驳回
+- ⚪ **已撤回** - 学生主动撤回申请
+
+**查询功能**:
+- 按状态筛选申请
+- 查看审核意见和时间
+- 查看岗位详细信息
+
+#### 🏛️ **模块三：勤工俭学岗位申请审核（二级学院）**
+
+**功能描述**: 二级学院负责人审核本学院学生的岗位申请
+
+##### 3.2.8 待审核申请列表
+**功能说明**: 展示需要审核的申请
+**筛选条件**:
+- 按申请时间排序
+- 按岗位分类
+- 按学生年级专业筛选
+- 按紧急程度标记
+
+**展示信息**:
+- 申请学生基本信息
+- 申请岗位信息
+- 申请时间
+- 学生条件匹配度
+
+##### 3.2.9 申请审核处理
+**功能说明**: 对申请进行审核决策
+**审核操作**:
+- ✅ **通过审核** - 申请状态变为"待学生处审核"
+- ❌ **驳回申请** - 申请状态变为"审核不通过"，需要填写驳回理由
+
+**审核依据**:
+- 学生是否满足岗位要求
+- 学生学习成绩和表现
+- 岗位剩余名额情况
+- 学生经济困难程度
+
+##### 3.2.10 审核记录管理
+**功能说明**: 查看和管理审核历史
+**记录内容**:
+- 审核时间和审核人
+- 审核决策和理由
+- 申请人信息和岗位信息
+- 审核结果统计
+
+#### 🏫 **模块四：勤工俭学岗位申请审核（学生处）**
+
+**功能描述**: 学生处负责人进行最终审核
+
+##### 3.2.11 终审申请列表
+**功能说明**: 展示已通过二级学院审核的申请
+**筛选条件**:
+- 按学院分类
+- 按岗位类型分类
+- 按申请时间排序
+- 按优先级标记
+
+##### 3.2.12 终审处理
+**功能说明**: 进行最终审核决策
+**审核操作**:
+- ✅ **终审通过** - 申请状态变为"审核通过"，完成整个流程
+- ❌ **终审驳回** - 申请状态变为"审核不通过"，需要填写驳回理由
+
+**审核重点**:
+- 跨学院岗位的协调
+- 特殊岗位的资质要求
+- 全校勤工俭学名额统筹
+- 政策合规性检查
+
+---
+
+## 🔄 业务流程设计
+
+### 4.1 岗位发布流程
+
+```
+开始 → 学院管理员登录 → 填写岗位信息 → 设置发布范围 → 
+保存岗位 → 岗位生效 → 学生可见并申请 → 结束
+```
+
+**关键节点**:
+- **岗位信息验证**: 确保必填字段完整性
+- **发布范围设置**: 决定岗位的可见性
+- **岗位生效**: 岗位在有效期内对学生开放
+
+### 4.2 学生申请流程
+
+```
+开始 → 学生登录 → 浏览岗位 → 选择岗位 → 检查申请条件 → 
+提交申请 → 等待审核 → 结束
+```
+
+**关键节点**:
+- **条件检查**: 验证学生是否满足岗位要求
+- **重复申请检查**: 防止学生重复申请同一岗位
+- **申请提交**: 生成申请记录并进入审核流程
+
+### 4.3 两级审核流程
+
+```
+学生提交申请 → 二级学院审核 → 审核通过？
+                    ↓               ↓
+                审核不通过 ←——————— No
+                    ↓
+                 结束流程
+                    ↓
+                   Yes
+                    ↓
+            学生处终审 → 终审通过？
+                    ↓               ↓
+                审核通过 ←——————— Yes
+                    ↓
+                 结束流程
+                    ↓
+                   No
+                    ↓
+                审核不通过 → 结束流程
+```
+
+**审核节点说明**:
+- **二级学院审核**: 主要评估学生条件和岗位匹配度
+- **学生处终审**: 主要进行政策合规性和统筹协调
+- **驳回处理**: 任何节点驳回都需要提供明确理由
+
+### 4.4 状态流转图
+
+```
+草稿 → 已提交 → 二级学院审核中 → 待学生处审核 → 审核通过
+  ↑        ↓           ↓              ↓
+  └——————————————————————————————————————→ 审核不通过
+```
+
+**状态说明**:
+- **草稿**: 学生暂存但未提交的申请
+- **已提交**: 学生正式提交，等待二级学院审核
+- **二级学院审核中**: 二级学院负责人审核中
+- **待学生处审核**: 已通过二级学院审核，等待学生处终审
+- **审核通过**: 完成所有审核，学生可以开始工作
+- **审核不通过**: 任何阶段被驳回的申请
+
+---
+
+## 💾 数据模型设计
+
+### 5.1 核心数据实体
+
+#### 📋 **岗位信息表 (jcbt_work_study_position)**
+
+| 字段名 | 字段类型 | 长度 | 必填 | 说明 |
+|--------|----------|------|------|------|
+| id | bigint | 20 | ✅ | 主键ID（雪花ID） |
+| position_name | varchar | 100 | ✅ | 岗位名称 |
+| position_scope | varchar | 20 | ✅ | 发布范围（COLLEGE/UNIVERSITY） |
+| required_count | int | - | ✅ | 需求人数 |
+| work_time | varchar | 200 | ✅ | 工作时间 |
+| start_date | date | - | ✅ | 岗位有效期开始 |
+| end_date | date | - | ✅ | 岗位有效期结束 |
+| position_requirements | text | - | ✅ | 岗位要求 |
+| salary_info | varchar | 200 | ✅ | 薪资情况 |
+| contact_teacher | varchar | 50 | ✅ | 联系老师 |
+| contact_phone | varchar | 20 | ✅ | 联系电话 |
+| college_id | bigint | 20 | ✅ | 发布学院ID |
+| status | varchar | 20 | ✅ | 岗位状态 |
+| current_count | int | - | ✅ | 当前申请通过人数 |
+| create_by | bigint | 20 | ✅ | 创建者 |
+| create_time | datetime | - | ✅ | 创建时间 |
+| update_by | bigint | 20 | ✅ | 更新者 |
+| update_time | datetime | - | ✅ | 更新时间 |
+| deleted | tinyint | 1 | ✅ | 逻辑删除标记 |
+| tenant_id | varchar | 20 | ✅ | 租户ID |
+
+#### 📝 **申请信息表 (jcbt_work_study_application)**
+
+| 字段名 | 字段类型 | 长度 | 必填 | 说明 |
+|--------|----------|------|------|------|
+| id | bigint | 20 | ✅ | 主键ID（雪花ID） |
+| position_id | bigint | 20 | ✅ | 岗位ID |
+| student_id | bigint | 20 | ✅ | 学生ID |
+| student_name | varchar | 50 | ✅ | 学生姓名 |
+| student_number | varchar | 20 | ✅ | 学号 |
+| college_id | bigint | 20 | ✅ | 学生所在学院ID |
+| major | varchar | 100 | ✅ | 专业 |
+| grade | varchar | 10 | ✅ | 年级 |
+| phone | varchar | 20 | ✅ | 联系电话 |
+| application_reason | text | - | ✅ | 申请理由 |
+| status | varchar | 20 | ✅ | 申请状态 |
+| college_review_status | varchar | 20 | ❌ | 学院审核状态 |
+| college_review_time | datetime | - | ❌ | 学院审核时间 |
+| college_reviewer_id | bigint | 20 | ❌ | 学院审核人ID |
+| college_review_comment | text | - | ❌ | 学院审核意见 |
+| final_review_status | varchar | 20 | ❌ | 学生处审核状态 |
+| final_review_time | datetime | - | ❌ | 学生处审核时间 |
+| final_reviewer_id | bigint | 20 | ❌ | 学生处审核人ID |
+| final_review_comment | text | - | ❌ | 学生处审核意见 |
+| create_by | bigint | 20 | ✅ | 创建者 |
+| create_time | datetime | - | ✅ | 创建时间 |
+| update_by | bigint | 20 | ✅ | 更新者 |
+| update_time | datetime | - | ✅ | 更新时间 |
+| deleted | tinyint | 1 | ✅ | 逻辑删除标记 |
+| tenant_id | varchar | 20 | ✅ | 租户ID |
+
+### 5.2 枚举定义
+
+#### 📋 **岗位状态枚举 (PositionStatusEnum)**
+```java
+public enum PositionStatusEnum {
+    DRAFT("DRAFT", "草稿"),
+    PUBLISHED("PUBLISHED", "已发布"),
+    RECRUITING("RECRUITING", "招录中"),
+    FULL("FULL", "已满员"),
+    EXPIRED("EXPIRED", "已过期"),
+    SUSPENDED("SUSPENDED", "已暂停");
+}
+```
+
+#### 📝 **申请状态枚举 (ApplicationStatusEnum)**
+```java
+public enum ApplicationStatusEnum {
+    DRAFT("DRAFT", "草稿"),
+    SUBMITTED("SUBMITTED", "已提交"),
+    COLLEGE_REVIEWING("COLLEGE_REVIEWING", "学院审核中"),
+    COLLEGE_PASSED("COLLEGE_PASSED", "学院审核通过"),
+    FINAL_REVIEWING("FINAL_REVIEWING", "学生处审核中"),
+    APPROVED("APPROVED", "审核通过"),
+    REJECTED("REJECTED", "审核不通过"),
+    WITHDRAWN("WITHDRAWN", "已撤回");
+}
+```
+
+---
+
+## 🚀 技术实现方案
+
+### 6.1 技术架构
+
+#### 🏗️ **总体架构**
+```
+┌─────────────────────────────────────────────────┐
+│                前端展示层                       │
+│  Vue 3 + TypeScript + Element Plus             │
+├─────────────────────────────────────────────────┤
+│                网关层                           │
+│  Spring Cloud Gateway + Sa-Token               │
+├─────────────────────────────────────────────────┤
+│                业务服务层                       │
+│  Spring Boot 3.4.6 + MyBatis-Plus             │
+├─────────────────────────────────────────────────┤
+│                数据存储层                       │
+│  MySQL 8.0 + Redis 6.0                        │
+└─────────────────────────────────────────────────┘
+```
+
+#### 🔧 **核心技术栈**
+- **前端框架**: Vue 3.5.13 + TypeScript 5.8.3
+- **UI组件库**: Element Plus + Art Design Pro
+- **后端框架**: Spring Boot 3.4.6 + MyBatis-Plus
+- **数据库**: MySQL 8.0
+- **缓存**: Redis 6.0
+- **权限认证**: Sa-Token
+- **文档工具**: Swagger 3.x
+
+### 6.2 关键业务逻辑
+
+#### 🔄 **岗位状态自动更新逻辑**
+```java
+@Scheduled(cron = "0 0 1 * * ?") // 每天凌晨1点执行
+public void updatePositionStatus() {
+    // 1. 更新过期岗位状态
+    // 2. 更新满员岗位状态  
+    // 3. 发送状态变更通知
+}
+```
+
+#### 🎯 **申请条件检查逻辑**
+```java
+public boolean checkApplicationConditions(Long studentId, Long positionId) {
+    // 1. 检查学生是否已申请该岗位
+    // 2. 检查岗位是否还有名额
+    // 3. 检查岗位是否在有效期内
+    // 4. 检查学生是否满足岗位要求
+    // 5. 检查学生当前申请岗位数量限制
+}
+```
+
+---
+
+## 📋 项目实施计划
+
+### 7.1 开发阶段规划
+
+#### 🏗️ **第一阶段：基础框架搭建（1周）**
+- [ ] 项目初始化和环境配置
+- [ ] 数据库表结构设计和创建
+- [ ] 基础框架代码生成
+- [ ] 权限体系集成
+
+#### 🔧 **第二阶段：岗位管理模块（2周）**
+- [ ] 岗位CRUD基础功能
+- [ ] 岗位发布范围控制
+- [ ] 岗位状态管理
+- [ ] 岗位信息展示优化
+
+#### 🎓 **第三阶段：申请管理模块（2周）**
+- [ ] 学生申请功能
+- [ ] 申请状态跟踪
+- [ ] 申请条件校验
+- [ ] 申请撤回功能
+
+#### 🏛️ **第四阶段：审核管理模块（2周）**
+- [ ] 二级学院审核功能
+- [ ] 学生处终审功能
+- [ ] 审核记录管理
+- [ ] 审核统计报表
+
+#### 🎨 **第五阶段：界面优化和测试（1周）**
+- [ ] 前端界面优化
+- [ ] 移动端适配
+- [ ] 功能测试
+- [ ] 性能优化
+
+### 7.2 里程碑计划
+
+| 里程碑 | 时间节点 | 主要成果 | 验收标准 |
+|--------|----------|----------|----------|
+| **M1** | 第1周末 | 基础框架完成 | ✅ 环境搭建完成<br>✅ 数据库结构就绪<br>✅ 基础代码生成 |
+| **M2** | 第3周末 | 岗位管理模块 | ✅ 岗位CRUD功能<br>✅ 权限控制正常<br>✅ 界面展示完整 |
+| **M3** | 第5周末 | 申请管理模块 | ✅ 申请流程通畅<br>✅ 条件校验有效<br>✅ 状态跟踪准确 |
+| **M4** | 第7周末 | 审核管理模块 | ✅ 两级审核流程<br>✅ 审核记录完整<br>✅ 统计数据准确 |
+| **M5** | 第8周末 | 项目交付 | ✅ 功能测试通过<br>✅ 性能达标<br>✅ 文档完整 |
+
+---
+
+## 📚 附录
+
+### 8.1 术语表
+
+| 术语 | 英文 | 定义 |
+|------|------|------|
+| **勤工俭学** | Work-Study Program | 学生通过参与学校提供的工作岗位获得经济资助的项目 |
+| **二级学院** | Secondary College | 高校内的院系级别管理单位 |
+| **学生处** | Student Affairs Office | 负责学生事务管理的学校行政部门 |
+| **岗位范围** | Position Scope | 岗位的可见和申请范围（本学院/全校） |
+| **两级审核** | Two-Level Review | 二级学院初审 + 学生处终审的审核机制 |
+
+### 8.2 参考文档
+
+- **原始需求**: [勤工俭学用户原始需求.md](./勤工俭学用户原始需求.md)
+- **技术规范**: [后端开发规范文档](../../.cursor/cursorrules-backend.md)
+- **前端规范**: [前端开发规范文档](../../.cursor/cursorrules-frontend.md)
+- **数据库规范**: [数据库设计规范文档](../../设计文档/database/mysql-database-standard.md)
+
+### 8.3 版本历史
+
+| 版本 | 日期 | 修改内容 | 修改人 |
+|------|------|----------|--------|
+| v1.0 | 2025-01-03 | 初始版本创建 | Cursor AI |
+
+---
+
+## ✅ 文档总结
+
+### 🎯 **核心价值**
+本产品需求分析书基于用户原始需求，系统性地分析了勤工俭学管理系统的完整业务流程，为开发团队提供了清晰的产品方向和技术实现指导。
+
+### 📋 **主要成果**
+1. **4个核心用户角色** 的需求分析和权限设计
+2. **4个主要功能模块** 的详细设计
+3. **完整的业务流程** 和状态流转机制
+4. **标准的数据模型** 和API接口设计
+5. **详细的项目实施计划** 和里程碑设置
+
+### 🚀 **下一步行动**
+1. 技术团队评审和确认需求
+2. 数据库表结构设计和创建
+3. 按照开发计划启动编码工作
+4. 定期评审和调整实施进度
+
+---
+
+**📝 文档状态**: ✅ 完成  
+**📅 创建时间**: 2025-01-03  
+**🔄 更新频率**: 根据需求变更及时更新  
+**👥 维护团队**: 产品团队 + 开发团队 
@@ -0,0 +1,19 @@
+1、勤工俭学岗位维护
+
+用户可以新增岗位，岗位信息包括，岗位名称，岗位发布范围（学院岗位职能本学院学生看到和申请，全校岗位可以被所有学生看到和申请），需求人数，工作时间，岗位有效期，岗位要求，薪资情况，联系老师，联系电话等信息；
+
+用户可以看到自己所在二级学院发布的所有岗位，并且可以修改和删除；
+
+2、勤工俭学岗位申请
+
+学生用户可以申请自己可以看到的所有岗位，并且可以查看自己的岗位申请是否通过，
+
+学生申请时，受到岗位上设定的条件限制
+
+3、勤工俭学岗位申请审核（二级学院)
+
+二级学院负责人审核学生的岗位申请，如果申请通过，则申请状态变为待学生处审核，申请不通过，则打回给申请人
+
+4、勤工俭学岗位申请审核（学生处)
+
+已经通过二级学院审核的申请由学生处负责人进行审核，如果审核通过，则审批完成，如果审核不通过，则打回给申请人