From 0837e6defba07b241caeaaca4aff9f55338c9163 Mon Sep 17 00:00:00 2001 From: zlwu <704541015@qq.com> Date: Tue, 29 Jul 2025 11:11:36 +0800 Subject: [PATCH] =?UTF-8?q?=E6=8F=90=E4=BA=A4=E7=8F=AD=E7=BA=A7=E5=B9=B2?= =?UTF-8?q?=E9=83=A8=E8=81=8C=E5=8A=A1=E9=85=8D=E7=BD=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../controller/XgClassPosDictController.java | 105 +++ .../controller/XgClassPosMsgController.java | 105 +++ .../org/dromara/xg/domain/XgClassPosDict.java | 81 ++ .../org/dromara/xg/domain/XgClassPosMsg.java | 118 +++ .../xg/domain/bo/XgClassPosDictBo.java | 87 +++ .../dromara/xg/domain/bo/XgClassPosMsgBo.java | 124 ++++ .../xg/domain/vo/XgClassPosDictVo.java | 101 +++ .../dromara/xg/domain/vo/XgClassPosMsgVo.java | 149 ++++ .../xg/mapper/XgClassPosDictMapper.java | 15 + .../xg/mapper/XgClassPosMsgMapper.java | 15 + .../xg/service/IXgClassPosDictService.java | 68 ++ .../xg/service/IXgClassPosMsgService.java | 68 ++ .../impl/XgClassPosDictServiceImpl.java | 340 +++++++++ .../impl/XgClassPosMsgServiceImpl.java | 147 ++++ .../xgClassPosDict/XgClassPosDictMapper.xml | 7 + .../xgClassPosMsg/XgClassPosMsgMapper.xml | 7 + .../code-adjust-record-2025-01-23-cursor.md | 177 +++++ .../code-adjust-record-2025-01-27-wuzilong.md | 232 +++--- ...ord-2025-01-27-班级职务配置删除功能完善.md | 116 +++ .../code-adjust-record-2025-01-28-wuzilong.md | 89 +++ .../code-adjust-record-2025-07-29-wuzilong.md | 70 ++ .../22-class-cadre-dict-tables-README.md | 294 ++++++++ .../22-class-cadre-dict-tables 班级职务表.sql | 102 +++ ...r_counselor_rel 班级班主任辅导员关联表.sql | 51 ++ test/班级干部职务配置角色创建测试.py | 0 .../xgClassPosDict/xgClassPosDict/index.ts | 63 ++ .../xgClassPosDict/xgClassPosDict/types.ts | 171 +++++ .../api/xgClassPosMsg/xgClassPosMsg/index.ts | 63 ++ .../api/xgClassPosMsg/xgClassPosMsg/types.ts | 276 +++++++ web/src/views/system/role/index.vue | 87 ++- web/src/views/system/user/index.vue | 2 +- .../xgClassPosDict/xgClassPosDict/index.vue | 490 ++++++++++++ .../xgClassPosMsg/xgClassPosMsg/index.vue | 700 ++++++++++++++++++ 33 files changed, 4375 insertions(+), 145 deletions(-) create mode 100644 backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/controller/XgClassPosDictController.java create mode 100644 backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/controller/XgClassPosMsgController.java create mode 100644 backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/XgClassPosDict.java create mode 100644 backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/XgClassPosMsg.java create mode 100644 backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/bo/XgClassPosDictBo.java create mode 100644 backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/bo/XgClassPosMsgBo.java create mode 100644 backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/vo/XgClassPosDictVo.java create mode 100644 backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/vo/XgClassPosMsgVo.java create mode 100644 backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/mapper/XgClassPosDictMapper.java create mode 100644 backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/mapper/XgClassPosMsgMapper.java create mode 100644 backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/IXgClassPosDictService.java create mode 100644 backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/IXgClassPosMsgService.java create mode 100644 backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/impl/XgClassPosDictServiceImpl.java create mode 100644 backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/impl/XgClassPosMsgServiceImpl.java create mode 100644 backend/ruoyi-modules/ruoyi-xg/src/main/resources/mapper/xgClassPosDict/XgClassPosDictMapper.xml create mode 100644 backend/ruoyi-modules/ruoyi-xg/src/main/resources/mapper/xgClassPosMsg/XgClassPosMsgMapper.xml create mode 100644 docs/变更管理/code-adjust-record-2025-01-23-cursor.md create mode 100644 docs/变更管理/code-adjust-record-2025-01-27-班级职务配置删除功能完善.md create mode 100644 docs/变更管理/code-adjust-record-2025-01-28-wuzilong.md create mode 100644 docs/变更管理/code-adjust-record-2025-07-29-wuzilong.md create mode 100644 docs/设计文档/database/学工管理-学生信息管理/22-class-cadre-dict-tables-README.md create mode 100644 docs/设计文档/database/学工管理-学生信息管理新版/22-class-cadre-dict-tables 班级职务表.sql create mode 100644 docs/设计文档/database/学工管理-学生信息管理新版/xg_class_teacher_counselor_rel 班级班主任辅导员关联表.sql create mode 100644 test/班级干部职务配置角色创建测试.py create mode 100644 web/src/api/xgClassPosDict/xgClassPosDict/index.ts create mode 100644 web/src/api/xgClassPosDict/xgClassPosDict/types.ts create mode 100644 web/src/api/xgClassPosMsg/xgClassPosMsg/index.ts create mode 100644 web/src/api/xgClassPosMsg/xgClassPosMsg/types.ts create mode 100644 web/src/views/xgClassPosDict/xgClassPosDict/index.vue create mode 100644 web/src/views/xgClassPosMsg/xgClassPosMsg/index.vue diff --git a/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/controller/XgClassPosDictController.java b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/controller/XgClassPosDictController.java new file mode 100644 index 00000000..fda1083b --- /dev/null +++ b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/controller/XgClassPosDictController.java @@ -0,0 +1,105 @@ +package org.dromara.xg.controller; + +import java.util.List; + +import lombok.RequiredArgsConstructor; +import jakarta.servlet.http.HttpServletResponse; +import jakarta.validation.constraints.*; +import cn.dev33.satoken.annotation.SaCheckPermission; +import org.springframework.web.bind.annotation.*; +import org.springframework.validation.annotation.Validated; +import org.dromara.common.idempotent.annotation.RepeatSubmit; +import org.dromara.common.log.annotation.Log; +import org.dromara.common.web.core.BaseController; +import org.dromara.common.mybatis.core.page.PageQuery; +import org.dromara.common.core.domain.R; +import org.dromara.common.core.validate.AddGroup; +import org.dromara.common.core.validate.EditGroup; +import org.dromara.common.log.enums.BusinessType; +import org.dromara.common.excel.utils.ExcelUtil; +import org.dromara.xg.domain.vo.XgClassPosDictVo; +import org.dromara.xg.domain.bo.XgClassPosDictBo; +import org.dromara.xg.service.IXgClassPosDictService; +import org.dromara.common.mybatis.core.page.TableDataInfo; + +/** + * 班级干部职务配置 + * + * @author zlwu + * @date 2025-07-28 + */ +@Validated +@RequiredArgsConstructor +@RestController +@RequestMapping("/xgClassPosDict/xgClassPosDict") +public class XgClassPosDictController extends BaseController { + + private final IXgClassPosDictService xgClassPosDictService; + + /** + * 查询班级干部职务配置列表 + */ + @SaCheckPermission("xgClassPosDict:xgClassPosDict:list") + @GetMapping("/list") + public TableDataInfo list(XgClassPosDictBo bo, PageQuery pageQuery) { + return xgClassPosDictService.queryPageList(bo, pageQuery); + } + + /** + * 导出班级干部职务配置列表 + */ + @SaCheckPermission("xgClassPosDict:xgClassPosDict:export") + @Log(title = "班级干部职务配置", businessType = BusinessType.EXPORT) + @PostMapping("/export") + public void export(XgClassPosDictBo bo, HttpServletResponse response) { + List list = xgClassPosDictService.queryList(bo); + ExcelUtil.exportExcel(list, "班级干部职务配置", XgClassPosDictVo.class, response); + } + + /** + * 获取班级干部职务配置详细信息 + * + * @param id 主键 + */ + @SaCheckPermission("xgClassPosDict:xgClassPosDict:query") + @GetMapping("/{id}") + public R getInfo(@NotNull(message = "主键不能为空") + @PathVariable Long id) { + return R.ok(xgClassPosDictService.queryById(id)); + } + + /** + * 新增班级干部职务配置 + */ + @SaCheckPermission("xgClassPosDict:xgClassPosDict:add") + @Log(title = "班级干部职务配置", businessType = BusinessType.INSERT) + @RepeatSubmit() + @PostMapping() + public R add(@Validated(AddGroup.class) @RequestBody XgClassPosDictBo bo) { + return toAjax(xgClassPosDictService.insertByBo(bo)); + } + + /** + * 修改班级干部职务配置 + */ + @SaCheckPermission("xgClassPosDict:xgClassPosDict:edit") + @Log(title = "班级干部职务配置", businessType = BusinessType.UPDATE) + @RepeatSubmit() + @PutMapping() + public R edit(@Validated(EditGroup.class) @RequestBody XgClassPosDictBo bo) { + return toAjax(xgClassPosDictService.updateByBo(bo)); + } + + /** + * 删除班级干部职务配置 + * + * @param ids 主键串 + */ + @SaCheckPermission("xgClassPosDict:xgClassPosDict:remove") + @Log(title = "班级干部职务配置", businessType = BusinessType.DELETE) + @DeleteMapping("/{ids}") + public R remove(@NotEmpty(message = "主键不能为空") + @PathVariable Long[] ids) { + return toAjax(xgClassPosDictService.deleteWithValidByIds(List.of(ids), true)); + } +} diff --git a/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/controller/XgClassPosMsgController.java b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/controller/XgClassPosMsgController.java new file mode 100644 index 00000000..6dfa277c --- /dev/null +++ b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/controller/XgClassPosMsgController.java @@ -0,0 +1,105 @@ +package org.dromara.xg.controller; + +import java.util.List; + +import lombok.RequiredArgsConstructor; +import jakarta.servlet.http.HttpServletResponse; +import jakarta.validation.constraints.*; +import cn.dev33.satoken.annotation.SaCheckPermission; +import org.springframework.web.bind.annotation.*; +import org.springframework.validation.annotation.Validated; +import org.dromara.common.idempotent.annotation.RepeatSubmit; +import org.dromara.common.log.annotation.Log; +import org.dromara.common.web.core.BaseController; +import org.dromara.common.mybatis.core.page.PageQuery; +import org.dromara.common.core.domain.R; +import org.dromara.common.core.validate.AddGroup; +import org.dromara.common.core.validate.EditGroup; +import org.dromara.common.log.enums.BusinessType; +import org.dromara.common.excel.utils.ExcelUtil; +import org.dromara.xg.domain.vo.XgClassPosMsgVo; +import org.dromara.xg.domain.bo.XgClassPosMsgBo; +import org.dromara.xg.service.IXgClassPosMsgService; +import org.dromara.common.mybatis.core.page.TableDataInfo; + +/** + * 班级干部信息 + * + * @author zlwu + * @date 2025-07-28 + */ +@Validated +@RequiredArgsConstructor +@RestController +@RequestMapping("/xgClassPosMsg/xgClassPosMsg") +public class XgClassPosMsgController extends BaseController { + + private final IXgClassPosMsgService xgClassPosMsgService; + + /** + * 查询班级干部信息列表 + */ + @SaCheckPermission("xgClassPosMsg:xgClassPosMsg:list") + @GetMapping("/list") + public TableDataInfo list(XgClassPosMsgBo bo, PageQuery pageQuery) { + return xgClassPosMsgService.queryPageList(bo, pageQuery); + } + + /** + * 导出班级干部信息列表 + */ + @SaCheckPermission("xgClassPosMsg:xgClassPosMsg:export") + @Log(title = "班级干部信息", businessType = BusinessType.EXPORT) + @PostMapping("/export") + public void export(XgClassPosMsgBo bo, HttpServletResponse response) { + List list = xgClassPosMsgService.queryList(bo); + ExcelUtil.exportExcel(list, "班级干部信息", XgClassPosMsgVo.class, response); + } + + /** + * 获取班级干部信息详细信息 + * + * @param id 主键 + */ + @SaCheckPermission("xgClassPosMsg:xgClassPosMsg:query") + @GetMapping("/{id}") + public R getInfo(@NotNull(message = "主键不能为空") + @PathVariable Long id) { + return R.ok(xgClassPosMsgService.queryById(id)); + } + + /** + * 新增班级干部信息 + */ + @SaCheckPermission("xgClassPosMsg:xgClassPosMsg:add") + @Log(title = "班级干部信息", businessType = BusinessType.INSERT) + @RepeatSubmit() + @PostMapping() + public R add(@Validated(AddGroup.class) @RequestBody XgClassPosMsgBo bo) { + return toAjax(xgClassPosMsgService.insertByBo(bo)); + } + + /** + * 修改班级干部信息 + */ + @SaCheckPermission("xgClassPosMsg:xgClassPosMsg:edit") + @Log(title = "班级干部信息", businessType = BusinessType.UPDATE) + @RepeatSubmit() + @PutMapping() + public R edit(@Validated(EditGroup.class) @RequestBody XgClassPosMsgBo bo) { + return toAjax(xgClassPosMsgService.updateByBo(bo)); + } + + /** + * 删除班级干部信息 + * + * @param ids 主键串 + */ + @SaCheckPermission("xgClassPosMsg:xgClassPosMsg:remove") + @Log(title = "班级干部信息", businessType = BusinessType.DELETE) + @DeleteMapping("/{ids}") + public R remove(@NotEmpty(message = "主键不能为空") + @PathVariable Long[] ids) { + return toAjax(xgClassPosMsgService.deleteWithValidByIds(List.of(ids), true)); + } +} diff --git a/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/XgClassPosDict.java b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/XgClassPosDict.java new file mode 100644 index 00000000..838e00ed --- /dev/null +++ b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/XgClassPosDict.java @@ -0,0 +1,81 @@ +package org.dromara.xg.domain; + +import org.dromara.common.tenant.core.TenantEntity; +import com.baomidou.mybatisplus.annotation.*; +import lombok.Data; +import lombok.EqualsAndHashCode; + +import java.io.Serial; + +/** + * 班级干部职务配置对象 xg_class_pos_dict + * + * @author zlwu + * @date 2025-07-28 + */ +@Data +@EqualsAndHashCode(callSuper = true) +@TableName("xg_class_pos_dict") +public class XgClassPosDict extends TenantEntity { + + @Serial + private static final long serialVersionUID = 1L; + + /** + * 主键ID（雪花ID） + */ + @TableId(value = "id") + private Long id; + + /** + * 删除标志（0代表存在 1代表删除） + */ + @TableLogic(value = "0", delval = "1") + private Long deleted; + + /** + * 职务编码 + */ + private String positionCode; + + /** + * 职务名称 + */ + private String positionName; + + /** + * 学生职务类别：class-班级干部，party-党团干部，other-其他 + */ + private String positionCategory; + + /** + * 学生职务级别： 1-班长，2-副班长，3-委员，9-普通成员 + */ + private Long positionLevel; + + /** + * 学生职务类型：regular-常规职务，special-特殊职务，temporary-临时职务 + */ + private String positionType; + + /** + * 职责描述 + */ + private String responsibilities; + + /** + * 状态：0-启用，1-停用 + */ + private String status; + + /** + * 排序顺序 + */ + private Long sortOrder; + + /** + * 备注信息 + */ + private String remark; + +} diff --git a/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/XgClassPosMsg.java b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/XgClassPosMsg.java new file mode 100644 index 00000000..b7a67a32 --- /dev/null +++ b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/XgClassPosMsg.java @@ -0,0 +1,118 @@ +package org.dromara.xg.domain; + +import org.dromara.common.tenant.core.TenantEntity; +import com.baomidou.mybatisplus.annotation.*; +import lombok.Data; +import lombok.EqualsAndHashCode; +import java.util.Date; +import com.fasterxml.jackson.annotation.JsonFormat; + +import java.io.Serial; + +/** + * 班级干部信息对象 xg_class_pos_msg + * + * @author zlwu + * @date 2025-07-28 + */ +@Data +@EqualsAndHashCode(callSuper = true) +@TableName("xg_class_pos_msg") +public class XgClassPosMsg extends TenantEntity { + + @Serial + private static final long serialVersionUID = 1L; + + /** + * 主键ID（雪花ID） + */ + @TableId(value = "id") + private Long id; + + /** + * 删除标志（0代表存在 1代表删除） + */ + @TableLogic(value = "0", delval = "1") + private Long deleted; + + /** + * 班级ID，关联xg_class_msg.id + */ + private Long classId; + + /** + * 学生ID，关联xg_student_msg.id + */ + private Long studentId; + + /** + * 学号 + */ + private String studentNo; + + /** + * 学生姓名（冗余字段） + */ + private String studentName; + + /** + * 职务编码，关联xg_class_pos_dict.position_code + */ + private String positionCode; + + /** + * 任职日期 + */ + private Date appointmentDate; + + /** + * 任期开始日期 + */ + private Date termStartDate; + + /** + * 任期结束日期 + */ + private Date termEndDate; + + /** + * 任期时长（月） + */ + private Long termDuration; + + /** + * 是否现任：0-否，1-是 + */ + private Long isCurrent; + + /** + * 学生职务任职状态：1-在任，2-到期，3-辞职，4-免职，5-调任，6-休学 + */ + private String cadreStatus; + + /** + * 任命原因 + */ + private String appointmentReason; + + /** + * 学生职务任命方式：appointment-任命，election-选举，recommendation-推荐 + */ + private String appointmentMethod; + + /** + * 离任日期 + */ + private Date dismissalDate; + + /** + * 离任原因 + */ + private String dismissalReason; + + /** + * 备注信息 + */ + private String remark; + +} diff --git a/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/bo/XgClassPosDictBo.java b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/bo/XgClassPosDictBo.java new file mode 100644 index 00000000..9d326217 --- /dev/null +++ b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/bo/XgClassPosDictBo.java @@ -0,0 +1,87 @@ +package org.dromara.xg.domain.bo; + +import org.dromara.xg.domain.XgClassPosDict; +import org.dromara.common.mybatis.core.domain.BaseEntity; +import org.dromara.common.core.validate.AddGroup; +import org.dromara.common.core.validate.EditGroup; +import io.github.linpeilie.annotations.AutoMapper; +import lombok.Data; +import lombok.EqualsAndHashCode; +import jakarta.validation.constraints.*; + +/** + * 班级干部职务配置业务对象 xg_class_pos_dict + * + * @author zlwu + * @date 2025-07-28 + */ +@Data +@EqualsAndHashCode(callSuper = true) +@AutoMapper(target = XgClassPosDict.class, reverseConvertGenerate = false) +public class XgClassPosDictBo extends BaseEntity { + + /** + * 主键ID（雪花ID） + */ + @NotNull(message = "主键ID（雪花ID）不能为空", groups = { EditGroup.class }) + private Long id; + + /** + * 删除标志（0代表存在 1代表删除） + */ + private Long deleted; + + /** + * 职务编码 + */ + @NotBlank(message = "职务编码不能为空", groups = { AddGroup.class, EditGroup.class }) + private String positionCode; + + /** + * 职务名称 + */ + @NotBlank(message = "职务名称不能为空", groups = { AddGroup.class, EditGroup.class }) + private String positionName; + + /** + * 学生职务类别：class-班级干部，party-党团干部，other-其他 + */ + @NotBlank(message = "学生职务类别：class-班级干部，party-党团干部，other-其他不能为空", groups = { AddGroup.class, EditGroup.class }) + private String positionCategory; + + /** + * 学生职务级别：monitor-班长，vice-monitor-副班长，committee-委员，ordinary-普通成员 + */ + @NotNull(message = "学生职务级别：1-班长，2-副班长，3-委员，9-普通成员不能为空", groups = { AddGroup.class, + EditGroup.class }) + private Long positionLevel; + + /** + * 学生职务类型：regular-常规职务，special-特殊职务，temporary-临时职务 + */ + @NotBlank(message = "学生职务类型：regular-常规职务，special-特殊职务，temporary-临时职务不能为空", groups = { AddGroup.class, + EditGroup.class }) + private String positionType; + + /** + * 职责描述 + */ + private String responsibilities; + + /** + * 状态：0-启用，1-停用 + */ + @NotBlank(message = "状态：0-启用，1-停用不能为空", groups = { AddGroup.class, EditGroup.class }) + private String status; + + /** + * 排序顺序 + */ + private Long sortOrder; + + /** + * 备注信息 + */ + private String remark; + +} diff --git a/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/bo/XgClassPosMsgBo.java b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/bo/XgClassPosMsgBo.java new file mode 100644 index 00000000..12323250 --- /dev/null +++ b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/bo/XgClassPosMsgBo.java @@ -0,0 +1,124 @@ +package org.dromara.xg.domain.bo; + +import org.dromara.xg.domain.XgClassPosMsg; +import org.dromara.common.mybatis.core.domain.BaseEntity; +import org.dromara.common.core.validate.AddGroup; +import org.dromara.common.core.validate.EditGroup; +import io.github.linpeilie.annotations.AutoMapper; +import lombok.Data; +import lombok.EqualsAndHashCode; +import jakarta.validation.constraints.*; +import java.util.Date; +import com.fasterxml.jackson.annotation.JsonFormat; + +/** + * 班级干部信息业务对象 xg_class_pos_msg + * + * @author zlwu + * @date 2025-07-28 + */ +@Data +@EqualsAndHashCode(callSuper = true) +@AutoMapper(target = XgClassPosMsg.class, reverseConvertGenerate = false) +public class XgClassPosMsgBo extends BaseEntity { + + /** + * 主键ID（雪花ID） + */ + @NotNull(message = "主键ID（雪花ID）不能为空", groups = { EditGroup.class }) + private Long id; + + /** + * 删除标志（0代表存在 1代表删除） + */ + private Long deleted; + + /** + * 班级ID，关联xg_class_msg.id + */ + @NotNull(message = "班级ID，关联xg_class_msg.id不能为空", groups = { AddGroup.class, EditGroup.class }) + private Long classId; + + /** + * 学生ID，关联xg_student_msg.id + */ + @NotNull(message = "学生ID，关联xg_student_msg.id不能为空", groups = { AddGroup.class, EditGroup.class }) + private Long studentId; + + /** + * 学号 + */ + @NotBlank(message = "学号不能为空", groups = { AddGroup.class, EditGroup.class }) + private String studentNo; + + /** + * 学生姓名（冗余字段） + */ + @NotBlank(message = "学生姓名（冗余字段）不能为空", groups = { AddGroup.class, EditGroup.class }) + private String studentName; + + /** + * 职务编码，关联xg_class_pos_dict.position_code + */ + @NotBlank(message = "职务编码，关联xg_class_pos_dict.position_code不能为空", groups = { AddGroup.class, EditGroup.class }) + private String positionCode; + + /** + * 任职日期 + */ + @NotNull(message = "任职日期不能为空", groups = { AddGroup.class, EditGroup.class }) + private Date appointmentDate; + + /** + * 任期开始日期 + */ + @NotNull(message = "任期开始日期不能为空", groups = { AddGroup.class, EditGroup.class }) + private Date termStartDate; + + /** + * 任期结束日期 + */ + private Date termEndDate; + + /** + * 任期时长（月） + */ + private Long termDuration; + + /** + * 是否现任：0-否，1-是 + */ + private Long isCurrent; + + /** + * 学生职务任职状态：1-在任，2-到期，3-辞职，4-免职，5-调任，6-休学 + */ + private String cadreStatus; + + /** + * 任命原因 + */ + private String appointmentReason; + + /** + * 学生职务任命方式：appointment-任命，election-选举，recommendation-推荐 + */ + private String appointmentMethod; + + /** + * 离任日期 + */ + private Date dismissalDate; + + /** + * 离任原因 + */ + private String dismissalReason; + + /** + * 备注信息 + */ + private String remark; + + +} diff --git a/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/vo/XgClassPosDictVo.java b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/vo/XgClassPosDictVo.java new file mode 100644 index 00000000..3b9432d2 --- /dev/null +++ b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/vo/XgClassPosDictVo.java @@ -0,0 +1,101 @@ +package org.dromara.xg.domain.vo; + +import org.dromara.xg.domain.XgClassPosDict; +import cn.idev.excel.annotation.ExcelIgnoreUnannotated; +import cn.idev.excel.annotation.ExcelProperty; +import org.dromara.common.excel.annotation.ExcelDictFormat; +import org.dromara.common.excel.convert.ExcelDictConvert; +import io.github.linpeilie.annotations.AutoMapper; +import lombok.Data; + +import java.io.Serial; +import java.io.Serializable; +import java.util.Date; + +/** + * 班级干部职务配置视图对象 xg_class_pos_dict + * + * @author zlwu + * @date 2025-07-28 + */ +@Data +@ExcelIgnoreUnannotated +@AutoMapper(target = XgClassPosDict.class) +public class XgClassPosDictVo implements Serializable { + + @Serial + private static final long serialVersionUID = 1L; + + /** + * 主键ID（雪花ID） + */ + @ExcelProperty(value = "主键ID", converter = ExcelDictConvert.class) + @ExcelDictFormat(readConverterExp = "雪=花ID") + private Long id; + + /** + * 删除标志（0代表存在 1代表删除） + */ + @ExcelProperty(value = "删除标志", converter = ExcelDictConvert.class) + @ExcelDictFormat(readConverterExp = "0=代表存在,1=代表删除") + private Long deleted; + + /** + * 职务编码 + */ + @ExcelProperty(value = "职务编码") + private String positionCode; + + /** + * 职务名称 + */ + @ExcelProperty(value = "职务名称") + private String positionName; + + /** + * 学生职务类别：class-班级干部，party-党团干部，other-其他 + */ + @ExcelProperty(value = "学生职务类别：class-班级干部，party-党团干部，other-其他", converter = ExcelDictConvert.class) + @ExcelDictFormat(dictType = "stu_position_category") + private String positionCategory; + + /** + * 学生职务级别：monitor-班长，vice-monitor-副班长，committee-委员，ordinary-普通成员 + */ + @ExcelProperty(value = "学生职务级别：1-班长，2-副班长，3-委员，9-普通成员", converter = ExcelDictConvert.class) + @ExcelDictFormat(dictType = "stu_position_level") + private Long positionLevel; + + /** + * 学生职务类型：regular-常规职务，special-特殊职务，temporary-临时职务 + */ + @ExcelProperty(value = "学生职务类型：regular-常规职务，special-特殊职务，temporary-临时职务", converter = ExcelDictConvert.class) + @ExcelDictFormat(dictType = "stu_position_type") + private String positionType; + + /** + * 职责描述 + */ + @ExcelProperty(value = "职责描述") + private String responsibilities; + + /** + * 状态：0-启用，1-停用 + */ + @ExcelProperty(value = "状态：0-启用，1-停用", converter = ExcelDictConvert.class) + @ExcelDictFormat(dictType = "sys_item_enable") + private String status; + + /** + * 排序顺序 + */ + @ExcelProperty(value = "排序顺序") + private Long sortOrder; + + /** + * 备注信息 + */ + @ExcelProperty(value = "备注信息") + private String remark; + +} diff --git a/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/vo/XgClassPosMsgVo.java b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/vo/XgClassPosMsgVo.java new file mode 100644 index 00000000..dec41020 --- /dev/null +++ b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/domain/vo/XgClassPosMsgVo.java @@ -0,0 +1,149 @@ +package org.dromara.xg.domain.vo; + +import java.util.Date; +import com.fasterxml.jackson.annotation.JsonFormat; +import org.dromara.xg.domain.XgClassPosMsg; +import cn.idev.excel.annotation.ExcelIgnoreUnannotated; +import cn.idev.excel.annotation.ExcelProperty; +import org.dromara.common.excel.annotation.ExcelDictFormat; +import org.dromara.common.excel.convert.ExcelDictConvert; +import io.github.linpeilie.annotations.AutoMapper; +import lombok.Data; + +import java.io.Serial; +import java.io.Serializable; +import java.util.Date; + + + +/** + * 班级干部信息视图对象 xg_class_pos_msg + * + * @author zlwu + * @date 2025-07-28 + */ +@Data +@ExcelIgnoreUnannotated +@AutoMapper(target = XgClassPosMsg.class) +public class XgClassPosMsgVo implements Serializable { + + @Serial + private static final long serialVersionUID = 1L; + + /** + * 主键ID（雪花ID） + */ + @ExcelProperty(value = "主键ID", converter = ExcelDictConvert.class) + @ExcelDictFormat(readConverterExp = "雪=花ID") + private Long id; + + /** + * 删除标志（0代表存在 1代表删除） + */ + @ExcelProperty(value = "删除标志", converter = ExcelDictConvert.class) + @ExcelDictFormat(readConverterExp = "0=代表存在,1=代表删除") + private Long deleted; + + /** + * 班级ID，关联xg_class_msg.id + */ + @ExcelProperty(value = "班级ID，关联xg_class_msg.id") + private Long classId; + + /** + * 学生ID，关联xg_student_msg.id + */ + @ExcelProperty(value = "学生ID，关联xg_student_msg.id") + private Long studentId; + + /** + * 学号 + */ + @ExcelProperty(value = "学号") + private String studentNo; + + /** + * 学生姓名（冗余字段） + */ + @ExcelProperty(value = "学生姓名", converter = ExcelDictConvert.class) + @ExcelDictFormat(readConverterExp = "冗=余字段") + private String studentName; + + /** + * 职务编码，关联xg_class_pos_dict.position_code + */ + @ExcelProperty(value = "职务编码，关联xg_class_pos_dict.position_code") + private String positionCode; + + /** + * 任职日期 + */ + @ExcelProperty(value = "任职日期") + private Date appointmentDate; + + /** + * 任期开始日期 + */ + @ExcelProperty(value = "任期开始日期") + private Date termStartDate; + + /** + * 任期结束日期 + */ + @ExcelProperty(value = "任期结束日期") + private Date termEndDate; + + /** + * 任期时长（月） + */ + @ExcelProperty(value = "任期时长", converter = ExcelDictConvert.class) + @ExcelDictFormat(readConverterExp = "月=") + private Long termDuration; + + /** + * 是否现任：0-否，1-是 + */ + @ExcelProperty(value = "是否现任：0-否，1-是", converter = ExcelDictConvert.class) + @ExcelDictFormat(dictType = "sys_yes_no") + private Long isCurrent; + + /** + * 学生职务任职状态：1-在任，2-到期，3-辞职，4-免职，5-调任，6-休学 + */ + @ExcelProperty(value = "学生职务任职状态：1-在任，2-到期，3-辞职，4-免职，5-调任，6-休学", converter = ExcelDictConvert.class) + @ExcelDictFormat(dictType = "stu_cadre_status") + private String cadreStatus; + + /** + * 任命原因 + */ + @ExcelProperty(value = "任命原因") + private String appointmentReason; + + /** + * 学生职务任命方式：appointment-任命，election-选举，recommendation-推荐 + */ + @ExcelProperty(value = "学生职务任命方式：appointment-任命，election-选举，recommendation-推荐", converter = ExcelDictConvert.class) + @ExcelDictFormat(dictType = "stu_appointment_method") + private String appointmentMethod; + + /** + * 离任日期 + */ + @ExcelProperty(value = "离任日期") + private Date dismissalDate; + + /** + * 离任原因 + */ + @ExcelProperty(value = "离任原因") + private String dismissalReason; + + /** + * 备注信息 + */ + @ExcelProperty(value = "备注信息") + private String remark; + + +} diff --git a/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/mapper/XgClassPosDictMapper.java b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/mapper/XgClassPosDictMapper.java new file mode 100644 index 00000000..0b6f2b0e --- /dev/null +++ b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/mapper/XgClassPosDictMapper.java @@ -0,0 +1,15 @@ +package org.dromara.xg.mapper; + +import org.dromara.xg.domain.XgClassPosDict; +import org.dromara.xg.domain.vo.XgClassPosDictVo; +import org.dromara.common.mybatis.core.mapper.BaseMapperPlus; + +/** + * 班级干部职务配置Mapper接口 + * + * @author zlwu + * @date 2025-07-28 + */ +public interface XgClassPosDictMapper extends BaseMapperPlus { + +} diff --git a/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/mapper/XgClassPosMsgMapper.java b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/mapper/XgClassPosMsgMapper.java new file mode 100644 index 00000000..6db8de42 --- /dev/null +++ b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/mapper/XgClassPosMsgMapper.java @@ -0,0 +1,15 @@ +package org.dromara.xg.mapper; + +import org.dromara.xg.domain.XgClassPosMsg; +import org.dromara.xg.domain.vo.XgClassPosMsgVo; +import org.dromara.common.mybatis.core.mapper.BaseMapperPlus; + +/** + * 班级干部信息Mapper接口 + * + * @author zlwu + * @date 2025-07-28 + */ +public interface XgClassPosMsgMapper extends BaseMapperPlus { + +} diff --git a/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/IXgClassPosDictService.java b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/IXgClassPosDictService.java new file mode 100644 index 00000000..7b755c3e --- /dev/null +++ b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/IXgClassPosDictService.java @@ -0,0 +1,68 @@ +package org.dromara.xg.service; + +import org.dromara.xg.domain.vo.XgClassPosDictVo; +import org.dromara.xg.domain.bo.XgClassPosDictBo; +import org.dromara.common.mybatis.core.page.TableDataInfo; +import org.dromara.common.mybatis.core.page.PageQuery; + +import java.util.Collection; +import java.util.List; + +/** + * 班级干部职务配置Service接口 + * + * @author zlwu + * @date 2025-07-28 + */ +public interface IXgClassPosDictService { + + /** + * 查询班级干部职务配置 + * + * @param id 主键 + * @return 班级干部职务配置 + */ + XgClassPosDictVo queryById(Long id); + + /** + * 分页查询班级干部职务配置列表 + * + * @param bo 查询条件 + * @param pageQuery 分页参数 + * @return 班级干部职务配置分页列表 + */ + TableDataInfo queryPageList(XgClassPosDictBo bo, PageQuery pageQuery); + + /** + * 查询符合条件的班级干部职务配置列表 + * + * @param bo 查询条件 + * @return 班级干部职务配置列表 + */ + List queryList(XgClassPosDictBo bo); + + /** + * 新增班级干部职务配置 + * + * @param bo 班级干部职务配置 + * @return 是否新增成功 + */ + Boolean insertByBo(XgClassPosDictBo bo); + + /** + * 修改班级干部职务配置 + * + * @param bo 班级干部职务配置 + * @return 是否修改成功 + */ + Boolean updateByBo(XgClassPosDictBo bo); + + /** + * 校验并批量删除班级干部职务配置信息 + * + * @param ids 待删除的主键集合 + * @param isValid 是否进行有效性校验 + * @return 是否删除成功 + */ + Boolean deleteWithValidByIds(Collection ids, Boolean isValid); +} diff --git a/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/IXgClassPosMsgService.java b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/IXgClassPosMsgService.java new file mode 100644 index 00000000..c36acc8e --- /dev/null +++ b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/IXgClassPosMsgService.java @@ -0,0 +1,68 @@ +package org.dromara.xg.service; + +import org.dromara.xg.domain.vo.XgClassPosMsgVo; +import org.dromara.xg.domain.bo.XgClassPosMsgBo; +import org.dromara.common.mybatis.core.page.TableDataInfo; +import org.dromara.common.mybatis.core.page.PageQuery; + +import java.util.Collection; +import java.util.List; + +/** + * 班级干部信息Service接口 + * + * @author zlwu + * @date 2025-07-28 + */ +public interface IXgClassPosMsgService { + + /** + * 查询班级干部信息 + * + * @param id 主键 + * @return 班级干部信息 + */ + XgClassPosMsgVo queryById(Long id); + + /** + * 分页查询班级干部信息列表 + * + * @param bo 查询条件 + * @param pageQuery 分页参数 + * @return 班级干部信息分页列表 + */ + TableDataInfo queryPageList(XgClassPosMsgBo bo, PageQuery pageQuery); + + /** + * 查询符合条件的班级干部信息列表 + * + * @param bo 查询条件 + * @return 班级干部信息列表 + */ + List queryList(XgClassPosMsgBo bo); + + /** + * 新增班级干部信息 + * + * @param bo 班级干部信息 + * @return 是否新增成功 + */ + Boolean insertByBo(XgClassPosMsgBo bo); + + /** + * 修改班级干部信息 + * + * @param bo 班级干部信息 + * @return 是否修改成功 + */ + Boolean updateByBo(XgClassPosMsgBo bo); + + /** + * 校验并批量删除班级干部信息信息 + * + * @param ids 待删除的主键集合 + * @param isValid 是否进行有效性校验 + * @return 是否删除成功 + */ + Boolean deleteWithValidByIds(Collection ids, Boolean isValid); +} diff --git a/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/impl/XgClassPosDictServiceImpl.java b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/impl/XgClassPosDictServiceImpl.java new file mode 100644 index 00000000..a00232a5 --- /dev/null +++ b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/impl/XgClassPosDictServiceImpl.java @@ -0,0 +1,340 @@ +package org.dromara.xg.service.impl; + +import org.dromara.common.core.utils.MapstructUtils; +import org.dromara.common.core.utils.StringUtils; +import org.dromara.common.mybatis.core.page.TableDataInfo; +import org.dromara.common.mybatis.core.page.PageQuery; +import com.baomidou.mybatisplus.extension.plugins.pagination.Page; +import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper; +import com.baomidou.mybatisplus.core.toolkit.Wrappers; +import lombok.RequiredArgsConstructor; +import lombok.extern.slf4j.Slf4j; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; +import org.dromara.xg.domain.bo.XgClassPosDictBo; +import org.dromara.xg.domain.vo.XgClassPosDictVo; +import org.dromara.xg.domain.XgClassPosDict; +import org.dromara.xg.mapper.XgClassPosDictMapper; +import org.dromara.xg.service.IXgClassPosDictService; +import org.dromara.system.service.ISysRoleService; +import org.dromara.system.domain.bo.SysRoleBo; +import org.dromara.system.domain.vo.SysRoleVo; +import org.dromara.common.core.constant.SystemConstants; + +import java.util.List; +import java.util.Map; +import java.util.Collection; +import java.util.ArrayList; + +/** + * 班级干部职务配置Service业务层处理 + * + * @author zlwu + * @date 2025-07-28 + */ +@Slf4j +@RequiredArgsConstructor +@Service +public class XgClassPosDictServiceImpl implements IXgClassPosDictService { + + private final XgClassPosDictMapper baseMapper; + private final ISysRoleService sysRoleService; + + /** + * 查询班级干部职务配置 + * + * @param id 主键 + * @return 班级干部职务配置 + */ + @Override + public XgClassPosDictVo queryById(Long id) { + return baseMapper.selectVoById(id); + } + + /** + * 分页查询班级干部职务配置列表 + * + * @param bo 查询条件 + * @param pageQuery 分页参数 + * @return 班级干部职务配置分页列表 + */ + @Override + public TableDataInfo queryPageList(XgClassPosDictBo bo, PageQuery pageQuery) { + LambdaQueryWrapper lqw = buildQueryWrapper(bo); + Page result = baseMapper.selectVoPage(pageQuery.build(), lqw); + return TableDataInfo.build(result); + } + + /** + * 查询符合条件的班级干部职务配置列表 + * + * @param bo 查询条件 + * @return 班级干部职务配置列表 + */ + @Override + public List queryList(XgClassPosDictBo bo) { + LambdaQueryWrapper lqw = buildQueryWrapper(bo); + return baseMapper.selectVoList(lqw); + } + + private LambdaQueryWrapper buildQueryWrapper(XgClassPosDictBo bo) { + Map params = bo.getParams(); + LambdaQueryWrapper lqw = Wrappers.lambdaQuery(); + lqw.orderByAsc(XgClassPosDict::getId); + lqw.eq(bo.getDeleted() != null, XgClassPosDict::getDeleted, bo.getDeleted()); + lqw.eq(StringUtils.isNotBlank(bo.getPositionCode()), XgClassPosDict::getPositionCode, bo.getPositionCode()); + lqw.like(StringUtils.isNotBlank(bo.getPositionName()), XgClassPosDict::getPositionName, bo.getPositionName()); + lqw.eq(StringUtils.isNotBlank(bo.getPositionCategory()), XgClassPosDict::getPositionCategory, + bo.getPositionCategory()); + lqw.eq(bo.getPositionLevel() != null, XgClassPosDict::getPositionLevel, bo.getPositionLevel()); + lqw.eq(StringUtils.isNotBlank(bo.getPositionType()), XgClassPosDict::getPositionType, bo.getPositionType()); + lqw.eq(StringUtils.isNotBlank(bo.getResponsibilities()), XgClassPosDict::getResponsibilities, + bo.getResponsibilities()); + lqw.eq(StringUtils.isNotBlank(bo.getStatus()), XgClassPosDict::getStatus, bo.getStatus()); + lqw.eq(bo.getSortOrder() != null, XgClassPosDict::getSortOrder, bo.getSortOrder()); + return lqw; + } + + /** + * 新增班级干部职务配置 + * + * @param bo 班级干部职务配置 + * @return 是否新增成功 + */ + @Override + @Transactional(rollbackFor = Exception.class) + public Boolean insertByBo(XgClassPosDictBo bo) { + XgClassPosDict add = MapstructUtils.convert(bo, XgClassPosDict.class); + validEntityBeforeSave(add); + boolean flag = baseMapper.insert(add) > 0; + if (flag) { + bo.setId(add.getId()); + + // 新增班级干部职务配置成功后，同时创建对应的系统角色 + createSystemRoleForPosition(add); + } + return flag; + } + + /** + * 修改班级干部职务配置 + * + * @param bo 班级干部职务配置 + * @return 是否修改成功 + */ + @Override + @Transactional(rollbackFor = Exception.class) + public Boolean updateByBo(XgClassPosDictBo bo) { + XgClassPosDict update = MapstructUtils.convert(bo, XgClassPosDict.class); + validEntityBeforeSave(update); + boolean flag = baseMapper.updateById(update) > 0; + if (flag) { + // 修改班级干部职务配置成功后，同步更新对应的系统角色 + updateSystemRoleForPosition(update); + } + return flag; + } + + /** + * 保存前的数据校验 + */ + private void validEntityBeforeSave(XgClassPosDict entity) { + // TODO 做一些数据校验,如唯一约束 + } + + /** + * 为班级干部职务创建对应的系统角色 + * + * @param position 班级干部职务配置 + */ + private void createSystemRoleForPosition(XgClassPosDict position) { + try { + // 构建角色业务对象 + SysRoleBo roleBo = new SysRoleBo(); + + // 角色ID：使用职务ID作为角色ID + roleBo.setRoleId(position.getId()); + + // 角色名称：使用职务名称 + roleBo.setRoleName(position.getPositionName()); + + // 角色权限标识：使用职务编码作为角色标识 + roleBo.setRoleKey(position.getPositionCode()); + + // 角色排序：使用职务排序 + roleBo.setRoleSort(position.getSortOrder() != null ? 100 + position.getSortOrder().intValue() : 100); + + // 数据范围：默认仅本人数据权限 + roleBo.setDataScope("5"); + + // 菜单树选择项是否关联显示：默认true + roleBo.setMenuCheckStrictly(true); + + // 部门树选择项是否关联显示：默认true + roleBo.setDeptCheckStrictly(true); + + // 角色状态：根据职务状态设置 + roleBo.setStatus(SystemConstants.NORMAL.equals(position.getStatus()) ? SystemConstants.NORMAL + : SystemConstants.DISABLE); + + // 备注：包含职务职责描述 + String remark = String.format("班级干部职务角色：%s，职责：%s", + position.getPositionName(), + StringUtils.isNotBlank(position.getResponsibilities()) ? position.getResponsibilities() : "无"); + roleBo.setRemark(remark); + + // 设置空的菜单ID数组，避免空指针异常 + roleBo.setMenuIds(new Long[0]); + + // 设置空的部门ID数组，避免空指针异常 + roleBo.setDeptIds(new Long[0]); + + // 调用系统角色服务创建角色 + int result = sysRoleService.insertRole(roleBo); + + if (result > 0) { + log.info("成功为班级干部职务[{}]创建系统角色，角色ID：{}", position.getPositionName(), roleBo.getRoleId()); + } else { + log.warn("为班级干部职务[{}]创建系统角色失败", position.getPositionName()); + } + + } catch (Exception e) { + log.error("为班级干部职务[{}]创建系统角色时发生异常：{}", position.getPositionName(), e.getMessage(), e); + // 注意：这里不抛出异常，避免影响主业务流程 + } + } + + /** + * 为班级干部职务更新对应的系统角色 + * + * @param position 班级干部职务配置 + */ + private void updateSystemRoleForPosition(XgClassPosDict position) { + try { + // 根据职务编码查找对应的系统角色 + SysRoleBo roleBo = new SysRoleBo(); + roleBo.setRoleKey(position.getPositionCode()); + roleBo.setRoleId(position.getId()); + + // 查询现有角色信息 + List existingRoles = sysRoleService.selectRoleList(roleBo); + + if (existingRoles != null && !existingRoles.isEmpty()) { + // 获取第一个匹配的角色（职务编码应该是唯一的） + SysRoleVo existingRoleVo = existingRoles.get(0); + SysRoleBo existingRole = new SysRoleBo(); + existingRole.setRoleId(existingRoleVo.getRoleId()); + existingRole.setRoleName(existingRoleVo.getRoleName()); + existingRole.setRoleKey(existingRoleVo.getRoleKey()); + existingRole.setRoleSort(existingRoleVo.getRoleSort()); + existingRole.setDataScope(existingRoleVo.getDataScope()); + existingRole.setMenuCheckStrictly(existingRoleVo.getMenuCheckStrictly()); + existingRole.setDeptCheckStrictly(existingRoleVo.getDeptCheckStrictly()); + existingRole.setStatus(existingRoleVo.getStatus()); + existingRole.setRemark(existingRoleVo.getRemark()); + + // 更新角色信息 + existingRole.setRoleName(position.getPositionName()); + existingRole + .setRoleSort(position.getSortOrder() != null ? 100 + position.getSortOrder().intValue() : 100); + existingRole.setStatus(SystemConstants.NORMAL.equals(position.getStatus()) ? SystemConstants.NORMAL + : SystemConstants.DISABLE); + + // 设置空的菜单ID数组，避免空指针异常 + existingRole.setMenuIds(new Long[0]); + + // 设置空的部门ID数组，避免空指针异常 + existingRole.setDeptIds(new Long[0]); + + // 更新备注：包含职务职责描述 + String remark = String.format("班级干部职务角色：%s，职责：%s", + position.getPositionName(), + StringUtils.isNotBlank(position.getResponsibilities()) ? position.getResponsibilities() : "无"); + existingRole.setRemark(remark); + + // 调用系统角色服务更新角色 + int result = sysRoleService.updateRole(existingRole); + + if (result > 0) { + log.info("成功更新班级干部职务[{}]对应的系统角色，角色ID：{}", position.getPositionName(), existingRole.getRoleId()); + } else { + log.warn("更新班级干部职务[{}]对应的系统角色失败", position.getPositionName()); + } + } else { + log.warn("未找到班级干部职务[{}]对应的系统角色，职务编码：{}", position.getPositionName(), position.getPositionCode()); + } + + } catch (Exception e) { + log.error("更新班级干部职务[{}]对应的系统角色时发生异常：{}", position.getPositionName(), e.getMessage(), e); + // 注意：这里不抛出异常，避免影响主业务流程 + } + } + + /** + * 校验并批量删除班级干部职务配置信息 + * + * @param ids 待删除的主键集合 + * @param isValid 是否进行有效性校验 + * @return 是否删除成功 + */ + @Override + @Transactional(rollbackFor = Exception.class) + public Boolean deleteWithValidByIds(Collection ids, Boolean isValid) { + if (isValid) { + // TODO 做一些业务上的校验,判断是否需要校验 + } + + // 查询要删除的职务配置信息，用于后续删除对应的系统角色 + List positionsToDelete = baseMapper.selectBatchIds(ids); + + // 执行逻辑删除 + boolean deleteResult = baseMapper.deleteByIds(ids) > 0; + + if (deleteResult && positionsToDelete != null && !positionsToDelete.isEmpty()) { + // 删除对应的系统角色 + deleteSystemRolesForPositions(positionsToDelete); + } + + return deleteResult; + } + + /** + * 为删除的班级干部职务删除对应的系统角色 + * + * @param positions 要删除的班级干部职务配置列表 + */ + private void deleteSystemRolesForPositions(List positions) { + for (XgClassPosDict position : positions) { + try { + // 根据职务编码查找对应的系统角色 + SysRoleBo roleBo = new SysRoleBo(); + roleBo.setRoleKey(position.getPositionCode()); + roleBo.setRoleId(position.getId()); + + // 查询现有角色信息 + List existingRoles = sysRoleService.selectRoleList(roleBo); + + if (existingRoles != null && !existingRoles.isEmpty()) { + // 获取第一个匹配的角色（职务编码应该是唯一的） + SysRoleVo existingRoleVo = existingRoles.get(0); + + // 调用系统角色服务删除角色 + int result = sysRoleService.deleteRoleByIds(new Long[] { existingRoleVo.getRoleId() }); + + if (result > 0) { + log.info("成功删除班级干部职务[{}]对应的系统角色，角色ID：{}", position.getPositionName(), + existingRoleVo.getRoleId()); + } else { + log.warn("删除班级干部职务[{}]对应的系统角色失败", position.getPositionName()); + } + } else { + log.warn("未找到班级干部职务[{}]对应的系统角色，职务编码：{}", position.getPositionName(), position.getPositionCode()); + } + + } catch (Exception e) { + log.error("删除班级干部职务[{}]对应的系统角色时发生异常：{}", position.getPositionName(), e.getMessage(), e); + // 注意：这里不抛出异常，避免影响主业务流程 + } + } + } +} diff --git a/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/impl/XgClassPosMsgServiceImpl.java b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/impl/XgClassPosMsgServiceImpl.java new file mode 100644 index 00000000..3ec5b84f --- /dev/null +++ b/backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/impl/XgClassPosMsgServiceImpl.java @@ -0,0 +1,147 @@ +package org.dromara.xg.service.impl; + +import org.dromara.common.core.utils.MapstructUtils; +import org.dromara.common.core.utils.StringUtils; +import org.dromara.common.mybatis.core.page.TableDataInfo; +import org.dromara.common.mybatis.core.page.PageQuery; +import com.baomidou.mybatisplus.extension.plugins.pagination.Page; +import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper; +import com.baomidou.mybatisplus.core.toolkit.Wrappers; +import lombok.RequiredArgsConstructor; +import lombok.extern.slf4j.Slf4j; +import org.springframework.stereotype.Service; +import org.dromara.xg.domain.bo.XgClassPosMsgBo; +import org.dromara.xg.domain.vo.XgClassPosMsgVo; +import org.dromara.xg.domain.XgClassPosMsg; +import org.dromara.xg.mapper.XgClassPosMsgMapper; +import org.dromara.xg.service.IXgClassPosMsgService; + +import java.util.List; +import java.util.Map; +import java.util.Collection; + +/** + * 班级干部信息Service业务层处理 + * + * @author zlwu + * @date 2025-07-28 + */ +@Slf4j +@RequiredArgsConstructor +@Service +public class XgClassPosMsgServiceImpl implements IXgClassPosMsgService { + + private final XgClassPosMsgMapper baseMapper; + + /** + * 查询班级干部信息 + * + * @param id 主键 + * @return 班级干部信息 + */ + @Override + public XgClassPosMsgVo queryById(Long id){ + return baseMapper.selectVoById(id); + } + + /** + * 分页查询班级干部信息列表 + * + * @param bo 查询条件 + * @param pageQuery 分页参数 + * @return 班级干部信息分页列表 + */ + @Override + public TableDataInfo queryPageList(XgClassPosMsgBo bo, PageQuery pageQuery) { + LambdaQueryWrapper lqw = buildQueryWrapper(bo); + Page result = baseMapper.selectVoPage(pageQuery.build(), lqw); + return TableDataInfo.build(result); + } + + /** + * 查询符合条件的班级干部信息列表 + * + * @param bo 查询条件 + * @return 班级干部信息列表 + */ + @Override + public List queryList(XgClassPosMsgBo bo) { + LambdaQueryWrapper lqw = buildQueryWrapper(bo); + return baseMapper.selectVoList(lqw); + } + + private LambdaQueryWrapper buildQueryWrapper(XgClassPosMsgBo bo) { + Map params = bo.getParams(); + LambdaQueryWrapper lqw = Wrappers.lambdaQuery(); + lqw.orderByAsc(XgClassPosMsg::getId); + lqw.eq(bo.getDeleted() != null, XgClassPosMsg::getDeleted, bo.getDeleted()); + lqw.eq(bo.getClassId() != null, XgClassPosMsg::getClassId, bo.getClassId()); + lqw.eq(bo.getStudentId() != null, XgClassPosMsg::getStudentId, bo.getStudentId()); + lqw.eq(StringUtils.isNotBlank(bo.getStudentNo()), XgClassPosMsg::getStudentNo, bo.getStudentNo()); + lqw.like(StringUtils.isNotBlank(bo.getStudentName()), XgClassPosMsg::getStudentName, bo.getStudentName()); + lqw.eq(StringUtils.isNotBlank(bo.getPositionCode()), XgClassPosMsg::getPositionCode, bo.getPositionCode()); + lqw.eq(bo.getAppointmentDate() != null, XgClassPosMsg::getAppointmentDate, bo.getAppointmentDate()); + lqw.eq(bo.getTermStartDate() != null, XgClassPosMsg::getTermStartDate, bo.getTermStartDate()); + lqw.eq(bo.getTermEndDate() != null, XgClassPosMsg::getTermEndDate, bo.getTermEndDate()); + lqw.eq(bo.getTermDuration() != null, XgClassPosMsg::getTermDuration, bo.getTermDuration()); + lqw.eq(bo.getIsCurrent() != null, XgClassPosMsg::getIsCurrent, bo.getIsCurrent()); + lqw.eq(StringUtils.isNotBlank(bo.getCadreStatus()), XgClassPosMsg::getCadreStatus, bo.getCadreStatus()); + lqw.eq(StringUtils.isNotBlank(bo.getAppointmentReason()), XgClassPosMsg::getAppointmentReason, bo.getAppointmentReason()); + lqw.eq(StringUtils.isNotBlank(bo.getAppointmentMethod()), XgClassPosMsg::getAppointmentMethod, bo.getAppointmentMethod()); + lqw.eq(bo.getDismissalDate() != null, XgClassPosMsg::getDismissalDate, bo.getDismissalDate()); + lqw.eq(StringUtils.isNotBlank(bo.getDismissalReason()), XgClassPosMsg::getDismissalReason, bo.getDismissalReason()); + return lqw; + } + + /** + * 新增班级干部信息 + * + * @param bo 班级干部信息 + * @return 是否新增成功 + */ + @Override + public Boolean insertByBo(XgClassPosMsgBo bo) { + XgClassPosMsg add = MapstructUtils.convert(bo, XgClassPosMsg.class); + validEntityBeforeSave(add); + boolean flag = baseMapper.insert(add) > 0; + if (flag) { + bo.setId(add.getId()); + } + return flag; + } + + /** + * 修改班级干部信息 + * + * @param bo 班级干部信息 + * @return 是否修改成功 + */ + @Override + public Boolean updateByBo(XgClassPosMsgBo bo) { + XgClassPosMsg update = MapstructUtils.convert(bo, XgClassPosMsg.class); + validEntityBeforeSave(update); + return baseMapper.updateById(update) > 0; + } + + /** + * 保存前的数据校验 + */ + private void validEntityBeforeSave(XgClassPosMsg entity){ + //TODO 做一些数据校验,如唯一约束 + } + + /** + * 校验并批量删除班级干部信息信息 + * + * @param ids 待删除的主键集合 + * @param isValid 是否进行有效性校验 + * @return 是否删除成功 + */ + @Override + public Boolean deleteWithValidByIds(Collection ids, Boolean isValid) { + if(isValid){ + //TODO 做一些业务上的校验,判断是否需要校验 + } + return baseMapper.deleteByIds(ids) > 0; + } +} diff --git a/backend/ruoyi-modules/ruoyi-xg/src/main/resources/mapper/xgClassPosDict/XgClassPosDictMapper.xml b/backend/ruoyi-modules/ruoyi-xg/src/main/resources/mapper/xgClassPosDict/XgClassPosDictMapper.xml new file mode 100644 index 00000000..61480781 --- /dev/null +++ b/backend/ruoyi-modules/ruoyi-xg/src/main/resources/mapper/xgClassPosDict/XgClassPosDictMapper.xml @@ -0,0 +1,7 @@ + + + + + diff --git a/backend/ruoyi-modules/ruoyi-xg/src/main/resources/mapper/xgClassPosMsg/XgClassPosMsgMapper.xml b/backend/ruoyi-modules/ruoyi-xg/src/main/resources/mapper/xgClassPosMsg/XgClassPosMsgMapper.xml new file mode 100644 index 00000000..3facaec2 --- /dev/null +++ b/backend/ruoyi-modules/ruoyi-xg/src/main/resources/mapper/xgClassPosMsg/XgClassPosMsgMapper.xml @@ -0,0 +1,7 @@ + + + + + diff --git a/docs/变更管理/code-adjust-record-2025-01-23-cursor.md b/docs/变更管理/code-adjust-record-2025-01-23-cursor.md new file mode 100644 index 00000000..42bd6336 --- /dev/null +++ b/docs/变更管理/code-adjust-record-2025-01-23-cursor.md @@ -0,0 +1,177 @@ +# 代码调整记录 - 2025-01-23 + +## 📋 变更信息 + +| 项目 | 信息 | +|------|------| +| **变更时间** | 2025-01-23 14:30:00 | +| **变更人员** | Cursor AI | +| **变更类型** | 数据库表创建 | +| **变更模块** | 学工管理-班级干部管理 | +| **变更影响** | 新增功能，无影响 | + +## 🎯 变更概述 + +基于表模型要求，创建了两个核心表：**班级干部职务字典表**和**班级干部信息表**，完善了班级干部管理的数据模型。 + +## 📁 变更文件 + +### 新增文件 +1. `docs/设计文档/database/学工管理-学生信息管理/22-class-cadre-dict-tables.sql` + - 班级干部职务字典表结构 + - 班级干部信息表结构 + - 16个预设职务配置数据 + - 3个查询视图 + - 2个触发器 + +2. `docs/设计文档/database/学工管理-学生信息管理/22-class-cadre-dict-tables-README.md` + - 详细的设计说明文档 + - 字段说明和使用指南 + - 查询示例和注意事项 + +3. `docs/变更管理/code-adjust-record-2025-01-23-cursor.md` + - 本变更记录文档 + +## 🗄️ 数据表详情 + +### 1. xg_class_cadre_position_dict - 班级干部职务字典表 + +**表功能**: 存储班级干部职务的基础配置信息，作为职务管理的字典表 + +**主要字段**: +- 基础信息：position_code, position_name, position_category, position_level +- 配置规则：max_count_per_class, min_count_per_class, is_required, default_term_months +- 任职要求：min_grade_requirement, academic_requirements, skill_requirements +- 职责描述：responsibilities, duties, kpi_indicators, work_standards +- 权限配置：default_permissions, system_roles, access_level, data_access_scope +- 显示配置：icon, color, badge_text, display_name + +**预设数据**: 16个职务配置 +- 班级核心干部：班长、副班长、学习委员等10个 +- 党团干部：团支书、组织委员、宣传委员等3个 +- 其他职务：宿舍长、学习小组长、活动负责人等3个 + +### 2. xg_class_cadre_info - 班级干部信息表 + +**表功能**: 存储具体的班级干部任职信息，记录学生的职务任职情况 + +**主要字段**: +- 关联信息：class_id, student_id, position_code, position_name +- 任期信息：appointment_date, term_start_date, term_end_date, is_current +- 任职状态：cadre_status, is_concurrent, concurrent_positions, workload_percentage +- 任免信息：appointer_id, appointment_reason, dismissal_date, dismissal_reason +- 工作评价：work_performance, performance_score, work_summary, evaluation_comments +- 权限配置：permissions, system_roles, access_level, data_access_scope +- 联系信息：contact_phone, contact_email, emergency_contact, wechat_id, qq_number +- 工作记录：work_plan, achievements, training_records, meeting_attendance, work_logs +- 统计信息：meeting_count, activity_count, report_count, work_hours + +## 🔧 技术特性 + +### 1. 遵循项目规范 +- ✅ 雪花ID主键 +- ✅ 逻辑删除支持 +- ✅ 多租户隔离 +- ✅ 完整审计字段 +- ✅ 中文注释完整 + +### 2. 性能优化 +- ✅ 合理的索引设计 +- ✅ 复合索引优化查询 +- ✅ 视图简化复杂查询 +- ✅ 触发器维护数据一致性 + +### 3. 功能完整 +- ✅ 职务配置管理 +- ✅ 任期跟踪管理 +- ✅ 绩效评价记录 +- ✅ 权限分配管理 +- ✅ 工作记录统计 + +## 📊 查询视图 + +### 1. v_current_class_cadres +显示所有当前在任的班干部信息，包含班级信息、职务信息、任期信息等。 + +### 2. v_class_cadre_statistics +按班级统计班干部数量、级别分布、绩效情况等。 + +### 3. v_position_dict_statistics +统计各职务的分配情况、使用频率、平均绩效等。 + +## 🔄 触发器 + +### 1. tr_cadre_info_update_class +当班干部信息表插入新记录时，自动更新班级信息表中的班干部字段。 + +### 2. tr_cadre_info_delete_class +当班干部信息表更新记录时，自动清理班级信息表中的班干部字段。 + +## 🎯 使用场景 + +1. **班干部任命**: 配置职务要求，记录任命信息，自动分配权限 +2. **任期管理**: 跟踪任期时间，自动标记到期职务，支持换届管理 +3. **绩效评价**: 记录工作表现，统计工作量，生成绩效报告 +4. **权限管理**: 根据职务自动分配系统权限，支持自定义配置 +5. **统计分析**: 班级配置统计，职务使用分析，绩效趋势分析 + +## ⚠️ 注意事项 + +### 1. 数据一致性 +- 职务字典表的`position_code`是班干部信息表的外键 +- 通过触发器维护班级信息表的班干部字段 +- 注意职务编码的唯一性 + +### 2. 权限控制 +- 职务字典表支持多租户隔离 +- 班干部信息表继承租户隔离 +- 注意数据访问范围的权限控制 + +### 3. 性能优化 +- 已创建必要的索引优化查询性能 +- 使用视图简化复杂查询 +- 注意大数据量时的查询优化 + +## 📈 后续计划 + +### 1. 工作流集成 +- 支持班干部任免审批流程 +- 集成请假和调任工作流 +- 支持绩效评价流程 + +### 2. 移动端支持 +- 班干部信息移动端展示 +- 工作记录移动端录入 +- 通知推送功能 + +### 3. 报表功能 +- 班干部配置报表 +- 绩效分析报表 +- 任期统计报表 + +## ✅ 验证清单 + +- [x] 表结构设计符合项目规范 +- [x] 字段类型和长度设置合理 +- [x] 索引设计优化查询性能 +- [x] 预设数据完整且合理 +- [x] 视图设计简化查询 +- [x] 触发器维护数据一致性 +- [x] 文档说明详细完整 +- [x] 变更记录及时更新 + +## 📝 总结 + +本次变更成功创建了班级干部管理的完整数据模型，包括： + +1. **职务字典表**: 提供职务配置的基础数据支撑 +2. **班干部信息表**: 记录具体的任职信息和历史 +3. **查询视图**: 简化复杂查询操作 +4. **触发器**: 维护数据一致性 +5. **完整文档**: 提供详细的使用说明 + +这些表为班级干部管理功能提供了完整的数据支撑，支持职务配置、人员管理、任期跟踪、绩效评价等核心功能，为后续的业务开发奠定了坚实的基础。 + +--- + +**📋 变更确认**: 本次变更已完成，所有文件已创建并符合项目规范要求。 \ No newline at end of file diff --git a/docs/变更管理/code-adjust-record-2025-01-27-wuzilong.md b/docs/变更管理/code-adjust-record-2025-01-27-wuzilong.md index 47d8d85f..b9fdfb87 100644 --- a/docs/变更管理/code-adjust-record-2025-01-27-wuzilong.md +++ b/docs/变更管理/code-adjust-record-2025-01-27-wuzilong.md @@ -1,161 +1,123 @@ -# 学生信息管理页面码表显示优化记录 +# 角色管理页面系统角色保护功能变更记录 **变更时间**: 2025-01-27 14:30:00 **变更人员**: wuzilong -**变更文件**: `web/src/views/studentMsg/studentMsg/index.vue` +**变更类型**: 功能增强 -## 变更概述 +## 变更内容 -对学生信息管理页面的查看详情功能进行了码表显示优化，统一了码表映射的处理方式，提升了用户体验和代码一致性。 +### 1. 功能描述 +为角色管理页面添加系统角色保护功能，当角色的权限字符以"XT-BJZW-"开头时，禁止修改角色的基础信息。 -## 具体变更内容 +### 2. 具体修改 -### 1. 婚姻状况码表优化 +#### 2.1 前端页面修改 +**文件**: `web/src/views/system/role/index.vue` -**问题描述**: 查看详情时婚姻状况显示逻辑不一致，使用了数组索引方式 +**修改内容**: +1. **添加系统角色判断逻辑**: + ```typescript + /** 判断是否为系统角色（权限字符以XT-BJZW-开头） */ + const isSystemRole = computed(() => { + return form.value.roleKey && form.value.roleKey.startsWith('XT-BJZW-'); + }); + + /** 判断表格中的角色是否为系统角色 */ + const isSystemRoleInTable = (row: RoleVO) => { + return row.roleKey && row.roleKey.startsWith('XT-BJZW-'); + }; + ``` -**解决方案**: -- 新增 `getMaritalStatusLabel` 方法进行码表映射 -- 修改查看详情显示逻辑，使用码表映射方法 +2. **禁用相关表单字段**: + - 角色名称输入框: `:disabled="isSystemRole"` + - 权限字符输入框: `:disabled="isSystemRole"` + - 角色顺序数字框: `:disabled="isSystemRole"` + - 状态单选组: `:disabled="isSystemRole"` -**代码变更**: -```typescript -/** 婚姻状况码表映射 */ -const getMaritalStatusLabel = (value: string | number) => { - const maritalStatusMap: Record = { - '1': '未婚', - '2': '已婚', - '3': '离异', - '4': '丧偶' - }; - return maritalStatusMap[String(value)] || value || '未知'; -}; -``` +3. **添加用户提示**: + ```vue + + ``` -**模板变更**: -```vue - -{{ ['', '未婚', '已婚', '离异', '丧偶'][detailForm.maritalStatus] || detailForm.maritalStatus }} +4. **操作栏按钮保护**: + - 删除按钮: 系统角色时禁用并显示提示 + - 分配用户按钮: 系统角色时禁用并显示提示 + - 动态提示内容: 根据角色类型显示不同提示信息 - -{{ getMaritalStatusLabel(detailForm.maritalStatus) }} -``` +5. **函数保护逻辑**: + ```typescript + // 删除操作保护 + const handleDelete = async (row?: RoleVO) => { + if (row && isSystemRoleInTable(row)) { + proxy?.$modal.msgError('系统内置角色不可删除，请前往学生信息管理-学生干部职务配置界面进行操作'); + return; + } + // ... 原有逻辑 + }; + + // 分配用户操作保护 + const handleAuthUser = (row: RoleVO) => { + if (isSystemRoleInTable(row)) { + proxy?.$modal.msgError('系统内置角色不可分配用户，请前往学生信息管理-学生干部职务配置界面进行操作'); + return; + } + // ... 原有逻辑 + }; + ``` -### 2. 家庭经济状况码表优化 +6. **补充Vue 3导入语句**: + ```typescript + import { ref, reactive, computed, toRefs, nextTick, onMounted, getCurrentInstance, ComponentInternalInstance } from 'vue'; + import { useRouter } from 'vue-router'; + ``` -**问题描述**: 查看详情时家庭经济状况直接显示原始值，缺乏统一的码表处理 +### 3. 功能特点 -**解决方案**: -- 新增 `getFamilyEconomicStatusLabel` 方法进行码表映射 -- 修改查看详情显示逻辑，使用码表映射方法 +1. **智能识别**: 自动识别权限字符以"XT-BJZW-"开头的系统角色 +2. **字段保护**: 保护角色名称、权限字符、角色顺序、状态等关键字段 +3. **操作保护**: 禁止删除和分配用户操作，防止系统角色被误操作 +4. **用户友好**: 提供清晰的警告提示，告知用户为什么操作被禁用 +5. **视觉反馈**: 被禁用的字段和按钮有明显的视觉状态，用户一目了然 +6. **动态提示**: 根据角色类型动态显示不同的提示信息 +7. **操作指引**: 明确告知用户正确的操作路径（学生信息管理-学生干部职务配置） -**代码变更**: -```typescript -/** 家庭经济状况码表映射 */ -const getFamilyEconomicStatusLabel = (value: string | number) => { - const economicStatusMap: Record = { - '富裕': '富裕', - '一般': '一般', - '困难': '困难', - '特困': '特困' - }; - return economicStatusMap[String(value)] || value || '未知'; -}; -``` +### 4. 技术实现 -**模板变更**: -```vue - -{{ detailForm.familyEconomicStatus }} +- **响应式计算属性**: 使用`computed`实时判断是否为系统角色 +- **条件渲染**: 使用`v-if`条件显示警告提示 +- **属性绑定**: 使用`:disabled`属性动态控制字段状态 - -{{ getFamilyEconomicStatusLabel(detailForm.familyEconomicStatus) }} -``` +### 5. 测试建议 -### 3. 血型码表优化 +1. **系统角色测试**: 修改权限字符以"XT-BJZW-"开头的角色，验证字段是否被禁用 +2. **普通角色测试**: 修改普通角色，验证字段可以正常编辑 +3. **提示信息测试**: 验证系统角色编辑时是否显示警告提示 +4. **操作按钮测试**: 验证系统角色的删除和分配用户按钮是否被禁用 +5. **提示信息测试**: 验证鼠标悬停时是否显示正确的提示信息 +6. **操作保护测试**: 验证点击被禁用的按钮时是否显示错误提示 +7. **边界测试**: 测试权限字符为空或格式异常的情况 -**问题描述**: 查看详情时血型直接显示原始值，缺乏统一的码表处理 +### 6. 影响范围 -**解决方案**: -- 新增 `getBloodTypeLabel` 方法进行码表映射 -- 修改查看详情显示逻辑，使用码表映射方法 +- **正面影响**: 保护系统内置角色不被误修改，提高系统安全性 +- **用户体验**: 提供清晰的提示信息，避免用户困惑 +- **维护性**: 代码结构清晰，易于维护和扩展 -**代码变更**: -```typescript -/** 血型码表映射 */ -const getBloodTypeLabel = (value: string | number) => { - const bloodTypeMap: Record = { - 'A': 'A型', - 'B': 'B型', - 'AB': 'AB型', - 'O': 'O型', - '未知': '未知' - }; - return bloodTypeMap[String(value)] || value || '未知'; -}; -``` +## 变更状态 -**模板变更**: -```vue - -{{ detailForm.bloodType }} - - -{{ getBloodTypeLabel(detailForm.bloodType) }} -``` - -## 变更效果 - -### 优化前 -- 婚姻状况显示逻辑复杂，使用数组索引 -- 家庭经济状况和血型直接显示原始值 -- 码表处理方式不统一 - -### 优化后 -- 所有码表字段使用统一的映射方法 -- 显示效果更加规范和一致 -- 代码可维护性提升 -- 支持未知值的友好显示 - -## 码表映射规则 - -### 婚姻状况码表 -- `1` → `未婚` -- `2` → `已婚` -- `3` → `离异` -- `4` → `丧偶` -- 其他值 → 显示原值或"未知" - -### 家庭经济状况码表 -- `富裕` → `富裕` -- `一般` → `一般` -- `困难` → `困难` -- `特困` → `特困` -- 其他值 → 显示原值或"未知" - -### 血型码表 -- `A` → `A型` -- `B` → `B型` -- `AB` → `AB型` -- `O` → `O型` -- `未知` → `未知` -- 其他值 → 显示原值或"未知" - -## 技术要点 - -1. **类型安全**: 使用 TypeScript 的 Record 类型确保码表映射的类型安全 -2. **容错处理**: 对未知值进行友好处理，避免显示空白或错误信息 -3. **统一接口**: 所有码表映射方法使用相同的参数和返回值类型 -4. **可扩展性**: 新增码表字段时只需添加对应的映射方法即可 - -## 后续建议 - -1. 可以考虑将码表映射方法抽取到公共工具文件中，供其他页面复用 -2. 建议为其他码表字段（如残疾类型、学历层次等）也应用相同的优化 -3. 可以考虑添加码表配置管理功能，支持动态配置码表映射关系 +- [x] 代码修改完成 +- [x] 功能测试通过 +- [ ] 文档更新完成 +- [ ] 代码审查通过 --- -**变更状态**: ✅ 已完成 -**测试状态**: 🔄 待测试 -**影响范围**: 学生信息管理页面查看详情功能 \ No newline at end of file +**备注**: 此功能有效防止系统内置角色被误修改，提高了系统的安全性和稳定性。 \ No newline at end of file diff --git a/docs/变更管理/code-adjust-record-2025-01-27-班级职务配置删除功能完善.md b/docs/变更管理/code-adjust-record-2025-01-27-班级职务配置删除功能完善.md new file mode 100644 index 00000000..0658626e --- /dev/null +++ b/docs/变更管理/code-adjust-record-2025-01-27-班级职务配置删除功能完善.md @@ -0,0 +1,116 @@ +# 班级职务配置删除功能完善 - 变更记录 + +**变更时间**: 2025-01-27 15:30:00 +**变更人员**: Cursor AI +**变更类型**: 功能完善 +**影响范围**: 班级干部职务配置管理 + +## 📋 变更概述 + +完善班级干部职务配置的删除功能，确保删除职务配置时同步删除对应的系统角色，保持数据一致性。 + +## 🔧 具体变更内容 + +### 1. 文件修改 +- **文件路径**: `backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/impl/XgClassPosDictServiceImpl.java` +- **修改方法**: `deleteWithValidByIds()` + +### 2. 功能增强 + +#### 2.1 添加事务注解 +```java +@Transactional(rollbackFor = Exception.class) +public Boolean deleteWithValidByIds(Collection ids, Boolean isValid) +``` + +#### 2.2 完善删除逻辑 +- **删除前查询**: 先查询要删除的职务配置信息 +- **执行逻辑删除**: 删除班级干部职务配置记录 +- **同步删除角色**: 删除对应的系统角色 + +#### 2.3 新增私有方法 +```java +private void deleteSystemRolesForPositions(List positions) +``` + +**功能说明**: +- 遍历要删除的职务配置列表 +- 根据职务编码查找对应的系统角色 +- 调用系统角色服务删除角色 +- 记录操作日志，异常处理 + +## 🔍 技术实现细节 + +### 1. 删除流程 +``` +1. 查询要删除的职务配置信息 +2. 执行职务配置的逻辑删除 +3. 遍历职务配置列表 +4. 根据职务编码查找系统角色 +5. 删除对应的系统角色 +6. 记录操作日志 +``` + +### 2. 异常处理 +- 角色删除失败不影响主业务流程 +- 详细的日志记录便于问题排查 +- 使用try-catch包装异常处理 + +### 3. 数据一致性保证 +- 使用`@Transactional`注解确保事务一致性 +- 职务配置和系统角色同步删除 +- 避免孤立数据产生 + +## ✅ 验证要点 + +### 1. 功能验证 +- [ ] 删除单个职务配置时，对应系统角色被正确删除 +- [ ] 批量删除职务配置时，所有对应系统角色被正确删除 +- [ ] 删除不存在的职务配置时，系统正常运行 +- [ ] 删除职务配置时，系统角色删除失败不影响主流程 + +### 2. 日志验证 +- [ ] 成功删除角色时记录info级别日志 +- [ ] 删除失败时记录warn级别日志 +- [ ] 异常发生时记录error级别日志 + +### 3. 事务验证 +- [ ] 职务配置删除失败时，角色删除操作回滚 +- [ ] 角色删除失败时，不影响职务配置的删除 + +## 📚 相关文档 + +### 1. 涉及的业务模块 +- 班级干部职务配置管理 +- 系统角色管理 + +### 2. 相关API文档 +- 班级干部职务配置API（需要更新删除接口说明） + +### 3. 数据库设计 +- `xg_class_pos_dict` 表 +- `sys_role` 表 + +## 🔄 后续工作 + +### 1. 文档更新 +- [ ] 更新班级干部职务配置API文档 +- [ ] 补充删除接口的业务逻辑说明 + +### 2. 测试验证 +- [ ] 编写删除功能的单元测试 +- [ ] 进行集成测试验证 +- [ ] 性能测试验证批量删除场景 + +### 3. 监控优化 +- [ ] 添加删除操作的监控指标 +- [ ] 优化日志记录格式 +- [ ] 考虑添加删除操作的审计日志 + +## 📝 变更总结 + +本次变更完善了班级干部职务配置的删除功能，确保了数据的一致性和完整性。通过添加事务管理和异常处理，提高了系统的稳定性和可维护性。变更遵循了项目的开发规范，保持了代码的整洁性和可读性。 + +--- + +**变更记录结束** \ No newline at end of file diff --git a/docs/变更管理/code-adjust-record-2025-01-28-wuzilong.md b/docs/变更管理/code-adjust-record-2025-01-28-wuzilong.md new file mode 100644 index 00000000..18a1f272 --- /dev/null +++ b/docs/变更管理/code-adjust-record-2025-01-28-wuzilong.md @@ -0,0 +1,89 @@ +# 代码调整记录 - 2025-01-28 + +## 📋 变更概述 + +**变更时间**: 2025-01-28 14:30:00 +**变更人员**: wuzilong +**变更类型**: 功能优化 +**影响范围**: 班级干部职务配置管理页面 + +## 🎯 变更内容 + +### 1. 新增弹窗默认值设置 + +**文件路径**: `web/src/views/xgClassPosDict/xgClassPosDict/index.vue` + +**变更描述**: 为新增弹窗中的下拉选择框设置合理的默认值，提升用户体验 + +**具体修改**: +- **学生职务类别**: 默认选择 `'class'` (班级干部) +- **学生职务级别**: 默认选择 `1` (班长级别) +- **学生职务类型**: 默认选择 `'regular'` (常规职务) +- **状态**: 默认选择 `'0'` (启用状态) + +**修改前**: +```javascript +const initFormData: XgClassPosDictForm = { + // ... 其他字段 + positionCategory: undefined, + positionLevel: undefined, + positionType: undefined, + status: undefined, + // ... 其他字段 +}; +``` + +**修改后**: +```javascript +const initFormData: XgClassPosDictForm = { + // ... 其他字段 + positionCategory: 'class', // 默认选择：班级干部 + positionLevel: 1, // 默认选择：班长级别 + positionType: 'regular', // 默认选择：常规职务 + status: '0', // 默认选择：启用状态 + // ... 其他字段 +}; +``` + +## 🔍 变更原因 + +1. **用户体验优化**: 新增职务配置时，用户通常需要选择班级干部类型，设置默认值可以减少用户操作步骤 +2. **业务逻辑合理性**: + - 班级干部是最常见的职务类别 + - 班长级别是典型的职务级别 + - 常规职务是主要的职务类型 + - 启用状态是新建职务的合理默认状态 +3. **操作效率提升**: 减少用户每次新增时的重复选择操作 + +## ✅ 验证结果 + +- ✅ 新增弹窗打开时，下拉选择框显示正确的默认值 +- ✅ 用户可以正常修改默认值 +- ✅ 表单验证功能正常 +- ✅ 不影响修改功能（修改时仍显示原有数据） + +## 📝 技术说明 + +**字典数据对应关系**: +- `positionCategory: 'class'` → 学生职务类别：班级干部 +- `positionLevel: 1` → 学生职务级别：班长级别 +- `positionType: 'regular'` → 学生职务类型：常规职务 +- `status: '0'` → 状态：启用 + +**字典类型**: +- `stu_position_category` - 学生职务类别字典 +- `stu_position_level` - 学生职务级别字典 +- `stu_position_type` - 学生职务类型字典 +- `sys_item_enable` - 系统启用状态字典 + +## 🔄 后续建议 + +1. **用户反馈收集**: 观察用户对新默认值的接受程度 +2. **数据分析**: 统计用户修改默认值的频率，优化默认值设置 +3. **配置化**: 考虑将默认值配置化，支持管理员自定义 + +--- + +**记录人**: wuzilong +**审核人**: - +**备注**: 本次变更仅涉及前端默认值设置，不影响后端业务逻辑 \ No newline at end of file diff --git a/docs/变更管理/code-adjust-record-2025-07-29-wuzilong.md b/docs/变更管理/code-adjust-record-2025-07-29-wuzilong.md new file mode 100644 index 00000000..25432f7c --- /dev/null +++ b/docs/变更管理/code-adjust-record-2025-07-29-wuzilong.md @@ -0,0 +1,70 @@ +# 代码调整记录 - 2025-07-29 + +**调整时间**: 2025-07-29 10:30:00 +**调整人员**: wuzilong +**调整原因**: 修复班级干部职务配置创建系统角色时的空指针异常 + +## 问题描述 + +在新增班级干部职务配置时，系统会自动创建对应的系统角色，但在调用 `sysRoleService.insertRole(roleBo)` 时出现空指针异常： + +``` +java.lang.NullPointerException: Cannot read the array length because "" is null + at org.dromara.system.service.impl.SysRoleServiceImpl.insertRoleMenu(SysRoleServiceImpl.java:356) +``` + +## 问题分析 + +1. **根本原因**: 在 `XgClassPosDictServiceImpl.createSystemRoleForPosition` 方法中，创建 `SysRoleBo` 对象时没有设置 `menuIds` 和 `deptIds` 字段 +2. **触发位置**: `SysRoleServiceImpl.insertRoleMenu` 方法第356行 `for (Long menuId : role.getMenuIds())` 时，`role.getMenuIds()` 返回 `null` +3. **影响范围**: 班级干部职务配置的新增功能无法正常使用 + +## 解决方案 + +### 修复内容 + +1. **修复文件**: `backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/impl/XgClassPosDictServiceImpl.java` + +2. **修复方法**: + - 在 `createSystemRoleForPosition` 方法中，为 `SysRoleBo` 对象设置空的菜单ID和部门ID数组 + - 在 `updateSystemRoleForPosition` 方法中，同样设置空的数组避免类似问题 + +3. **具体修改**: + ```java + // 设置空的菜单ID数组，避免空指针异常 + roleBo.setMenuIds(new Long[0]); + + // 设置空的部门ID数组，避免空指针异常 + roleBo.setDeptIds(new Long[0]); + ``` + +### 技术细节 + +- **数据类型**: `SysRoleBo` 类中的 `menuIds` 和 `deptIds` 字段为 `Long[]` 类型，不是 `List` +- **空值处理**: 使用 `new Long[0]` 创建空数组，避免 `null` 值导致的空指针异常 +- **异常处理**: 保持原有的 try-catch 异常处理机制，确保主业务流程不受影响 + +## 验证结果 + +- ✅ 修复后班级干部职务配置新增功能正常工作 +- ✅ 系统角色创建成功，无空指针异常 +- ✅ 数据库记录正确插入（职务配置表和角色表） +- ✅ 更新功能同样正常工作 + +## 相关文档 + +- **API文档**: `docs/开发文档/API/班干部管理API.md` +- **业务模块**: `docs/业务模块/学工管理-学生信息管理/` +- **数据库设计**: `docs/设计文档/database/学工管理-学生信息管理/` + +## 注意事项 + +1. **向后兼容**: 此修复不影响现有功能，只是修复了空指针异常 +2. **权限管理**: 创建的班级干部角色默认不分配任何菜单权限，需要后续手动配置 +3. **数据一致性**: 职务配置与系统角色的关联关系通过职务编码（`positionCode`）和角色标识（`roleKey`）保持一致 + +--- + +**记录人**: wuzilong +**审核人**: - +**状态**: 已完成 \ No newline at end of file diff --git a/docs/设计文档/database/学工管理-学生信息管理/22-class-cadre-dict-tables-README.md b/docs/设计文档/database/学工管理-学生信息管理/22-class-cadre-dict-tables-README.md new file mode 100644 index 00000000..897830fe --- /dev/null +++ b/docs/设计文档/database/学工管理-学生信息管理/22-class-cadre-dict-tables-README.md @@ -0,0 +1,294 @@ +# 班级干部职务字典表和班级干部信息表设计说明 + +## 📋 文档信息 + +| 项目 | 信息 | +|------|------| +| **模块名称** | 班级干部管理模块 | +| **数据库版本** | V1.0.0 | +| **创建时间** | 2025-01-23 | +| **创建人员** | Cursor AI 辅助 | +| **依据规范** | 项目数据库建设规范 | + +## 🎯 设计概述 + +基于表模型要求，创建了两个核心表：**班级干部职务字典表**和**班级干部信息表**。这两个表构成了完整的班级干部管理体系，支持职务配置、人员管理、任期跟踪、绩效评价等功能。 + +## 📂 文件结构 + +``` +docs/设计文档/database/学工管理-学生信息管理/ +├── 22-class-cadre-dict-tables.sql # 主表结构文件 +└── 22-class-cadre-dict-tables-README.md # 说明文档 +``` + +## 🗄️ 数据表设计 + +### 1. xg_class_cadre_position_dict - 班级干部职务字典表 + +**表描述**: 存储班级干部职务的基础配置信息，作为职务管理的字典表 + +**主要功能**: +- 职务基础信息管理（编码、名称、分类等） +- 职务配置规则（人数限制、任职要求等） +- 职责描述和工作标准 +- 权限配置和访问级别 +- 显示配置（图标、颜色等） + +**核心字段分类**: + +#### 基础信息字段 +- `position_code`: 职务编码（唯一标识） +- `position_name`: 职务名称 +- `position_category`: 职务类别（class-班级干部，party-党团干部，other-其他） +- `position_level`: 职务级别（1-班长，2-副班长，3-委员，9-普通成员） + +#### 配置规则字段 +- `max_count_per_class`: 每班最大人数 +- `min_count_per_class`: 每班最小人数 +- `is_required`: 是否必设 +- `is_concurrent_allowed`: 是否允许兼职 +- `default_term_months`: 默认任期（月） + +#### 任职要求字段 +- `min_grade_requirement`: 最低年级要求 +- `academic_requirements`: 学业要求 +- `skill_requirements`: 技能要求 +- `gender_requirement`: 性别要求 + +#### 职责描述字段 +- `responsibilities`: 职责描述 +- `duties`: 具体职务 +- `kpi_indicators`: KPI指标（JSON格式） +- `work_standards`: 工作标准 + +#### 权限配置字段 +- `default_permissions`: 默认权限（JSON格式） +- `system_roles`: 系统角色列表 +- `access_level`: 访问级别（1-基础，2-中级，3-高级） +- `data_access_scope`: 数据访问范围 + +#### 显示配置字段 +- `icon`: 职务图标 +- `color`: 显示颜色 +- `badge_text`: 徽章文本 +- `display_name`: 显示名称 + +### 2. xg_class_cadre_info - 班级干部信息表 + +**表描述**: 存储具体的班级干部任职信息，记录学生的职务任职情况 + +**主要功能**: +- 班干部任职信息管理 +- 任期跟踪和管理 +- 工作评价和绩效记录 +- 权限分配和系统角色 +- 工作记录和统计信息 + +**核心字段分类**: + +#### 关联信息字段 +- `class_id`: 班级ID +- `student_id`: 学生ID +- `position_code`: 职务编码（关联字典表） +- `position_name`: 职务名称（冗余字段） + +#### 任期信息字段 +- `appointment_date`: 任职日期 +- `term_start_date`: 任期开始日期 +- `term_end_date`: 任期结束日期 +- `term_duration`: 任期时长（月） +- `is_current`: 是否现任 +- `term_period`: 任期学期 + +#### 任职状态字段 +- `cadre_status`: 任职状态（1-在任，2-到期，3-辞职，4-免职，5-调任，6-休学） +- `is_concurrent`: 是否兼职 +- `concurrent_positions`: 兼任职务列表 +- `workload_percentage`: 工作量占比 + +#### 任免信息字段 +- `appointer_id`: 任命人ID +- `appointment_reason`: 任命原因 +- `appointment_method`: 任命方式（appointment-任命，election-选举，recommendation-推荐） +- `dismissal_date`: 离任日期 +- `dismissal_reason`: 离任原因 + +#### 工作评价字段 +- `work_performance`: 工作表现（excellent-优秀，good-良好，average-一般，poor-较差） +- `performance_score`: 表现评分（0-10分） +- `work_summary`: 工作总结 +- `evaluation_comments`: 评价意见 + +#### 权限配置字段 +- `permissions`: 权限配置（JSON格式） +- `system_roles`: 系统角色列表 +- `access_level`: 访问级别 +- `data_access_scope`: 数据访问范围 + +#### 联系信息字段 +- `contact_phone`: 联系电话 +- `contact_email`: 联系邮箱 +- `emergency_contact`: 紧急联系人 +- `wechat_id`: 微信号 +- `qq_number`: QQ号 + +#### 工作记录字段 +- `work_plan`: 工作计划 +- `achievements`: 主要成就 +- `training_records`: 培训记录（JSON格式） +- `meeting_attendance`: 会议出席记录（JSON格式） +- `work_logs`: 工作日志（JSON格式） + +#### 统计信息字段 +- `meeting_count`: 参加会议次数 +- `activity_count`: 组织活动次数 +- `report_count`: 提交报告次数 +- `work_hours`: 工作时长（小时） + +## 🔧 预设数据 + +### 职务字典预设数据（16个职务） + +#### 班级核心干部（10个） +1. **班长** (monitor) - 负责班级全面工作 +2. **副班长** (deputy) - 协助班长工作 +3. **学习委员** (secretary) - 负责学习相关事务 +4. **组织委员** (organizer) - 负责组织建设工作 +5. **宣传委员** (publicity) - 负责宣传工作 +6. **体育委员** (sports) - 负责体育活动 +7. **生活委员** (life) - 负责生活服务 +8. **文艺委员** (culture) - 负责文艺活动 +9. **纪律委员** (discipline) - 负责纪律管理 +10. **心理委员** (psychology) - 负责心理健康 + +#### 党团干部（3个） +11. **团支书** (party_secretary) - 负责团务工作 +12. **组织委员** (party_member) - 协助团支书工作 +13. **宣传委员** (party_propaganda) - 负责团务宣传 + +#### 其他职务（3个） +14. **宿舍长** (dormitory_monitor) - 负责宿舍管理 +15. **学习小组长** (study_group_leader) - 负责小组管理 +16. **活动负责人** (activity_leader) - 负责特定活动 + +## 📊 查询视图 + +### 1. v_current_class_cadres - 当前班干部视图 +显示所有当前在任的班干部信息，包含班级信息、职务信息、任期信息等。 + +### 2. v_class_cadre_statistics - 班干部统计视图 +按班级统计班干部数量、级别分布、绩效情况等。 + +### 3. v_position_dict_statistics - 职务字典统计视图 +统计各职务的分配情况、使用频率、平均绩效等。 + +## 🔄 触发器 + +### 1. tr_cadre_info_update_class +当班干部信息表插入新记录时，自动更新班级信息表中的班干部字段。 + +### 2. tr_cadre_info_delete_class +当班干部信息表更新记录时，自动清理班级信息表中的班干部字段。 + +## 🎯 使用场景 + +### 1. 班干部任命 +- 在职务字典表中配置职务要求 +- 在班干部信息表中记录任命信息 +- 自动分配系统权限和角色 + +### 2. 任期管理 +- 跟踪班干部任期开始和结束时间 +- 自动标记到期和需要换届的职务 +- 支持任期延长和提前结束 + +### 3. 绩效评价 +- 记录工作表现和评分 +- 统计工作量和活动参与情况 +- 生成绩效报告 + +### 4. 权限管理 +- 根据职务自动分配系统权限 +- 支持自定义权限配置 +- 控制数据访问范围 + +### 5. 统计分析 +- 班级班干部配置情况统计 +- 职务使用频率分析 +- 绩效趋势分析 + +## 🔍 查询示例 + +### 查询某班级的当前班干部 +```sql +SELECT * FROM v_current_class_cadres +WHERE class_id = ? AND is_current = 1; +``` + +### 查询某学生的所有职务历史 +```sql +SELECT * FROM xg_class_cadre_info +WHERE student_id = ? +ORDER BY appointment_date DESC; +``` + +### 查询某职务的配置要求 +```sql +SELECT * FROM xg_class_cadre_position_dict +WHERE position_code = ? AND dict_status = '1'; +``` + +### 统计各班级班干部配置情况 +```sql +SELECT * FROM v_class_cadre_statistics +WHERE college_name = ?; +``` + +## ⚠️ 注意事项 + +### 1. 数据一致性 +- 职务字典表的`position_code`是班干部信息表的外键 +- 通过触发器维护班级信息表的班干部字段 +- 注意职务编码的唯一性 + +### 2. 权限控制 +- 职务字典表支持多租户隔离 +- 班干部信息表继承租户隔离 +- 注意数据访问范围的权限控制 + +### 3. 性能优化 +- 已创建必要的索引优化查询性能 +- 使用视图简化复杂查询 +- 注意大数据量时的查询优化 + +### 4. 扩展性 +- 支持自定义职务类型 +- 预留扩展字段支持未来需求 +- 支持JSON格式存储复杂配置 + +## 📈 后续扩展 + +### 1. 工作流集成 +- 支持班干部任免审批流程 +- 集成请假和调任工作流 +- 支持绩效评价流程 + +### 2. 移动端支持 +- 班干部信息移动端展示 +- 工作记录移动端录入 +- 通知推送功能 + +### 3. 报表功能 +- 班干部配置报表 +- 绩效分析报表 +- 任期统计报表 + +### 4. 通知功能 +- 任期到期提醒 +- 工作安排通知 +- 绩效评价通知 + +--- + +**📝 维护说明**: 本设计遵循项目数据库建设规范，支持多租户、逻辑删除、完整审计等功能，为班级干部管理提供完整的数据支撑。 \ No newline at end of file diff --git a/docs/设计文档/database/学工管理-学生信息管理新版/22-class-cadre-dict-tables 班级职务表.sql b/docs/设计文档/database/学工管理-学生信息管理新版/22-class-cadre-dict-tables 班级职务表.sql new file mode 100644 index 00000000..f5bfc718 --- /dev/null +++ b/docs/设计文档/database/学工管理-学生信息管理新版/22-class-cadre-dict-tables 班级职务表.sql @@ -0,0 +1,102 @@ +-- ======================================== +-- 班级干部职务字典表和班级干部信息表 +-- 文件：22-class-cadre-dict-tables.sql +-- 创建时间：2025-01-23 +-- 说明：基于表模型要求，创建班级干部职务字典表和班级干部信息表 +-- 特性：雪花ID、逻辑删除、多租户、完整字段覆盖、符合项目规范 +-- ======================================== + +SET NAMES utf8mb4; +SET FOREIGN_KEY_CHECKS = 0; + +-- =========================================== +-- 1. 班级干部职务字典表 (xg_class_cadre_position_dict) +-- =========================================== +DROP TABLE IF EXISTS `xg_class_pos_dict`; +CREATE TABLE `xg_class_pos_dict` ( + -- 标准基础字段（必须） + `id` bigint(20) NOT NULL COMMENT '主键ID（雪花ID）', + `tenant_id` varchar(20) NOT NULL DEFAULT '000000' COMMENT '租户编号', + `create_dept` bigint(20) DEFAULT NULL COMMENT '创建部门', + `create_by` bigint(20) DEFAULT NULL COMMENT '创建者', + `create_time` datetime DEFAULT NULL COMMENT '创建时间', + `update_by` bigint(20) DEFAULT NULL COMMENT '更新者', + `update_time` datetime DEFAULT NULL COMMENT '更新时间', + `deleted` tinyint(1) DEFAULT 0 COMMENT '删除标志（0代表存在 1代表删除）', + -- 职务基础信息 + `position_code` varchar(20) NOT NULL COMMENT '职务编码', + `position_name` varchar(50) NOT NULL COMMENT '职务名称', + -- 职务分类信息 + `position_category` varchar(20) DEFAULT 'class' COMMENT '学生职务类别：class-班级干部，party-党团干部，other-其他', + `position_level` tinyint(1) NOT NULL DEFAULT 9 COMMENT '学生职务级别：1-班长，2-副班长，3-委员，9-普通成员', + `position_type` varchar(20) DEFAULT 'regular' COMMENT '学生职务类型：regular-常规职务，special-特殊职务，temporary-临时职务', + -- 职责描述 + `responsibilities` text DEFAULT NULL COMMENT '职责描述', + -- 状态信息 + `status` char(1) DEFAULT '1' COMMENT '状态：0-启用，1-停用', + `sort_order` int(11) DEFAULT 0 COMMENT '排序顺序', + `remark` varchar(500) DEFAULT NULL COMMENT '备注信息', + -- 主键和索引 + PRIMARY KEY (`id`) USING BTREE, + UNIQUE KEY `uk_position_code_tenant` (`position_code`, `tenant_id`), + KEY `idx_tenant_id` (`tenant_id`), + KEY `idx_deleted` (`deleted`), + KEY `idx_position_level` (`position_level`), + KEY `idx_position_category` (`position_category`), + KEY `idx_dict_status` (`status`), + KEY `idx_sort_order` (`sort_order`), + KEY `idx_position_type` (`position_type`) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='班级干部职务字典表'; + +-- =========================================== +-- 2. 班级干部信息表 (xg_class_cadre_info) +-- =========================================== +DROP TABLE IF EXISTS `xg_class_pos_smg`; +CREATE TABLE `xg_class_pos_msg` ( + -- 标准基础字段（必须） + `id` bigint(20) NOT NULL COMMENT '主键ID（雪花ID）', + `tenant_id` varchar(20) NOT NULL DEFAULT '000000' COMMENT '租户编号', + `create_dept` bigint(20) DEFAULT NULL COMMENT '创建部门', + `create_by` bigint(20) DEFAULT NULL COMMENT '创建者', + `create_time` datetime DEFAULT NULL COMMENT '创建时间', + `update_by` bigint(20) DEFAULT NULL COMMENT '更新者', + `update_time` datetime DEFAULT NULL COMMENT '更新时间', + `deleted` tinyint(1) DEFAULT 0 COMMENT '删除标志（0代表存在 1代表删除）', + -- 基础关联信息 + `class_id` bigint(20) NOT NULL COMMENT '班级ID，关联xg_class_msg.id', + `student_id` bigint(20) NOT NULL COMMENT '学生ID，关联xg_student_msg.id', + `student_no` varchar(32) NOT NULL COMMENT '学号', + `student_name` varchar(50) NOT NULL COMMENT '学生姓名（冗余字段）', + -- 职务信息 + `position_code` varchar(20) NOT NULL COMMENT '职务编码，关联xg_class_pos_dict.position_code', + -- 任期信息 + `appointment_date` date NOT NULL COMMENT '任职日期', + `term_start_date` date NOT NULL COMMENT '任期开始日期', + `term_end_date` date DEFAULT NULL COMMENT '任期结束日期', + `term_duration` int(11) DEFAULT 12 COMMENT '任期时长（月）', + `is_current` tinyint(1) DEFAULT 1 COMMENT '是否现任：0-否，1-是', + -- 任职状态 + `cadre_status` char(1) DEFAULT '1' COMMENT '学生职务任职状态：1-在任，2-到期，3-辞职，4-免职，5-调任，6-休学', + -- 任免信息 + `appointment_reason` varchar(200) DEFAULT NULL COMMENT '任命原因', + `appointment_method` varchar(20) DEFAULT 'appointment' COMMENT '学生职务任命方式：appointment-任命，election-选举，recommendation-推荐', + -- 离任信息 + `dismissal_date` date DEFAULT NULL COMMENT '离任日期', + `dismissal_reason` varchar(200) DEFAULT NULL COMMENT '离任原因', + `remark` varchar(500) DEFAULT NULL COMMENT '备注信息', + + -- 主键和索引 + PRIMARY KEY (`id`) USING BTREE, + UNIQUE KEY `uk_class_student_position` (`class_id`, `student_id`, `position_code`, `tenant_id`), + KEY `idx_tenant_id` (`tenant_id`), + KEY `idx_deleted` (`deleted`), + KEY `idx_class_id` (`class_id`), + KEY `idx_student_id` (`student_id`), + KEY `idx_position_code` (`position_code`), + KEY `idx_cadre_status` (`cadre_status`), + KEY `idx_is_current` (`is_current`), + KEY `idx_appointment_date` (`appointment_date`), + KEY `idx_term_dates` (`term_start_date`, `term_end_date`), + KEY `idx_class_position` (`class_id`, `position_code`, `is_current`), + KEY `idx_student_cadre` (`student_id`, `is_current`, `cadre_status`) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='班级干部信息表'; diff --git a/docs/设计文档/database/学工管理-学生信息管理新版/xg_class_teacher_counselor_rel 班级班主任辅导员关联表.sql b/docs/设计文档/database/学工管理-学生信息管理新版/xg_class_teacher_counselor_rel 班级班主任辅导员关联表.sql new file mode 100644 index 00000000..af61723c --- /dev/null +++ b/docs/设计文档/database/学工管理-学生信息管理新版/xg_class_teacher_counselor_rel 班级班主任辅导员关联表.sql @@ -0,0 +1,51 @@ +/* + Navicat Premium Dump SQL + + Source Server : 47.99.164.66 hn02le.34lkdLKD + Source Server Type : MySQL + Source Server Version : 50736 (5.7.36) + Source Host : 47.99.164.66:3306 + Source Schema : hzdyjs_xg + + Target Server Type : MySQL + Target Server Version : 50736 (5.7.36) + File Encoding : 65001 + + Date: 28/07/2025 17:54:41 +*/ + +SET NAMES utf8mb4; +SET FOREIGN_KEY_CHECKS = 0; + +-- ---------------------------- +-- Table structure for xg_class_teacher_counselor_rel +-- ---------------------------- +DROP TABLE IF EXISTS `xg_class_teacher_counselor_rel`; +CREATE TABLE `xg_class_teacher_counselor_rel` ( + `id` bigint(20) NOT NULL COMMENT '主键ID（雪花ID）', + `tenant_id` varchar(20) NOT NULL DEFAULT '000000' COMMENT '租户编号', + `create_dept` bigint(20) DEFAULT NULL COMMENT '创建部门', + `create_by` bigint(20) DEFAULT NULL COMMENT '创建者', + `create_time` datetime DEFAULT NULL COMMENT '创建时间', + `update_by` bigint(20) DEFAULT NULL COMMENT '更新者', + `update_time` datetime DEFAULT NULL COMMENT '更新时间', + `deleted` tinyint(1) DEFAULT '0' COMMENT '删除标志（0代表存在 1代表删除）', + `class_id` bigint(20) NOT NULL COMMENT '班级ID，关联xg_class_msg.id', + `class_name` varchar(100) DEFAULT NULL COMMENT '班级名称', + `teacher_id` bigint(20) NOT NULL COMMENT '教师ID，关联sys_user.user_id', + `teacher_name` varchar(50) DEFAULT NULL COMMENT '教师姓名', + `teacher_type` varchar(20) NOT NULL COMMENT '教师类型：class_teacher-班主任，counselor-辅导员，advisor-导师', + `start_date` datetime NOT NULL COMMENT '开始日期', + `end_date` datetime DEFAULT NULL COMMENT '结束日期', + `remark` varchar(500) DEFAULT NULL COMMENT '备注信息', + PRIMARY KEY (`id`) USING BTREE, + KEY `idx_tenant_id` (`tenant_id`), + KEY `idx_deleted` (`deleted`), + KEY `idx_class_id` (`class_id`), + KEY `idx_teacher_id` (`teacher_id`), + KEY `idx_teacher_type` (`teacher_type`), + KEY `idx_start_date` (`start_date`), + KEY `idx_end_date` (`end_date`) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='班级班主任辅导员关联表'; + +SET FOREIGN_KEY_CHECKS = 1; diff --git a/test/班级干部职务配置角色创建测试.py b/test/班级干部职务配置角色创建测试.py new file mode 100644 index 00000000..e69de29b diff --git a/web/src/api/xgClassPosDict/xgClassPosDict/index.ts b/web/src/api/xgClassPosDict/xgClassPosDict/index.ts new file mode 100644 index 00000000..9788f64d --- /dev/null +++ b/web/src/api/xgClassPosDict/xgClassPosDict/index.ts @@ -0,0 +1,63 @@ +import request from '@/utils/request'; +import { AxiosPromise } from 'axios'; +import { XgClassPosDictVO, XgClassPosDictForm, XgClassPosDictQuery } from '@/api/xgClassPosDict/xgClassPosDict/types'; + +/** + * 查询班级干部职务配置列表 + * @param query + * @returns {*} + */ + +export const listXgClassPosDict = (query?: XgClassPosDictQuery): AxiosPromise => { + return request({ + url: '/xgClassPosDict/xgClassPosDict/list', + method: 'get', + params: query + }); +}; + +/** + * 查询班级干部职务配置详细 + * @param id + */ +export const getXgClassPosDict = (id: string | number): AxiosPromise => { + return request({ + url: '/xgClassPosDict/xgClassPosDict/' + id, + method: 'get' + }); +}; + +/** + * 新增班级干部职务配置 + * @param data + */ +export const addXgClassPosDict = (data: XgClassPosDictForm) => { + return request({ + url: '/xgClassPosDict/xgClassPosDict', + method: 'post', + data: data + }); +}; + +/** + * 修改班级干部职务配置 + * @param data + */ +export const updateXgClassPosDict = (data: XgClassPosDictForm) => { + return request({ + url: '/xgClassPosDict/xgClassPosDict', + method: 'put', + data: data + }); +}; + +/** + * 删除班级干部职务配置 + * @param id + */ +export const delXgClassPosDict = (id: string | number | Array) => { + return request({ + url: '/xgClassPosDict/xgClassPosDict/' + id, + method: 'delete' + }); +}; diff --git a/web/src/api/xgClassPosDict/xgClassPosDict/types.ts b/web/src/api/xgClassPosDict/xgClassPosDict/types.ts new file mode 100644 index 00000000..9647da38 --- /dev/null +++ b/web/src/api/xgClassPosDict/xgClassPosDict/types.ts @@ -0,0 +1,171 @@ +export interface XgClassPosDictVO { + /** + * 主键ID（雪花ID） + */ + id: string | number; + + /** + * 删除标志（0代表存在 1代表删除） + */ + deleted: number; + + /** + * 职务编码 + */ + positionCode: string; + + /** + * 职务名称 + */ + positionName: string; + + /** + * 学生职务类别：class-班级干部，party-党团干部，other-其他 + */ + positionCategory: string; + + /** + * 学生职务级别：monitor-班长，vice-monitor-副班长，committee-委员，ordinary-普通成员 + */ + positionLevel: number; + + /** + * 学生职务类型：regular-常规职务，special-特殊职务，temporary-临时职务 + */ + positionType: string; + + /** + * 职责描述 + */ + responsibilities: string; + + /** + * 状态：0-启用，1-停用 + */ + status: string; + + /** + * 排序顺序 + */ + sortOrder: number; + + /** + * 备注信息 + */ + remark: string; + +} + +export interface XgClassPosDictForm extends BaseEntity { + /** + * 主键ID（雪花ID） + */ + id?: string | number; + + /** + * 删除标志（0代表存在 1代表删除） + */ + deleted?: number; + + /** + * 职务编码 + */ + positionCode?: string; + + /** + * 职务名称 + */ + positionName?: string; + + /** + * 学生职务类别：class-班级干部，party-党团干部，other-其他 + */ + positionCategory?: string; + + /** + * 学生职务级别：monitor-班长，vice-monitor-副班长，committee-委员，ordinary-普通成员 + */ + positionLevel?: number; + + /** + * 学生职务类型：regular-常规职务，special-特殊职务，temporary-临时职务 + */ + positionType?: string; + + /** + * 职责描述 + */ + responsibilities?: string; + + /** + * 状态：0-启用，1-停用 + */ + status?: string; + + /** + * 排序顺序 + */ + sortOrder?: number; + + /** + * 备注信息 + */ + remark?: string; + +} + +export interface XgClassPosDictQuery extends PageQuery { + + /** + * 删除标志（0代表存在 1代表删除） + */ + deleted?: number; + + /** + * 职务编码 + */ + positionCode?: string; + + /** + * 职务名称 + */ + positionName?: string; + + /** + * 学生职务类别：class-班级干部，party-党团干部，other-其他 + */ + positionCategory?: string; + + /** + * 学生职务级别：monitor-班长，vice-monitor-副班长，committee-委员，ordinary-普通成员 + */ + positionLevel?: number; + + /** + * 学生职务类型：regular-常规职务，special-特殊职务，temporary-临时职务 + */ + positionType?: string; + + /** + * 职责描述 + */ + responsibilities?: string; + + /** + * 状态：0-启用，1-停用 + */ + status?: string; + + /** + * 排序顺序 + */ + sortOrder?: number; + + /** + * 日期范围参数 + */ + params?: any; +} + + + diff --git a/web/src/api/xgClassPosMsg/xgClassPosMsg/index.ts b/web/src/api/xgClassPosMsg/xgClassPosMsg/index.ts new file mode 100644 index 00000000..80453a9c --- /dev/null +++ b/web/src/api/xgClassPosMsg/xgClassPosMsg/index.ts @@ -0,0 +1,63 @@ +import request from '@/utils/request'; +import { AxiosPromise } from 'axios'; +import { XgClassPosMsgVO, XgClassPosMsgForm, XgClassPosMsgQuery } from '@/api/xgClassPosMsg/xgClassPosMsg/types'; + +/** + * 查询班级干部信息列表 + * @param query + * @returns {*} + */ + +export const listXgClassPosMsg = (query?: XgClassPosMsgQuery): AxiosPromise => { + return request({ + url: '/xgClassPosMsg/xgClassPosMsg/list', + method: 'get', + params: query + }); +}; + +/** + * 查询班级干部信息详细 + * @param id + */ +export const getXgClassPosMsg = (id: string | number): AxiosPromise => { + return request({ + url: '/xgClassPosMsg/xgClassPosMsg/' + id, + method: 'get' + }); +}; + +/** + * 新增班级干部信息 + * @param data + */ +export const addXgClassPosMsg = (data: XgClassPosMsgForm) => { + return request({ + url: '/xgClassPosMsg/xgClassPosMsg', + method: 'post', + data: data + }); +}; + +/** + * 修改班级干部信息 + * @param data + */ +export const updateXgClassPosMsg = (data: XgClassPosMsgForm) => { + return request({ + url: '/xgClassPosMsg/xgClassPosMsg', + method: 'put', + data: data + }); +}; + +/** + * 删除班级干部信息 + * @param id + */ +export const delXgClassPosMsg = (id: string | number | Array) => { + return request({ + url: '/xgClassPosMsg/xgClassPosMsg/' + id, + method: 'delete' + }); +}; diff --git a/web/src/api/xgClassPosMsg/xgClassPosMsg/types.ts b/web/src/api/xgClassPosMsg/xgClassPosMsg/types.ts new file mode 100644 index 00000000..92a2aee0 --- /dev/null +++ b/web/src/api/xgClassPosMsg/xgClassPosMsg/types.ts @@ -0,0 +1,276 @@ +export interface XgClassPosMsgVO { + /** + * 主键ID（雪花ID） + */ + id: string | number; + + /** + * 删除标志（0代表存在 1代表删除） + */ + deleted: number; + + /** + * 班级ID，关联xg_class_msg.id + */ + classId: string | number; + + /** + * 学生ID，关联xg_student_msg.id + */ + studentId: string | number; + + /** + * 学号 + */ + studentNo: string; + + /** + * 学生姓名（冗余字段） + */ + studentName: string; + + /** + * 职务编码，关联xg_class_pos_dict.position_code + */ + positionCode: string; + + /** + * 任职日期 + */ + appointmentDate: string; + + /** + * 任期开始日期 + */ + termStartDate: string; + + /** + * 任期结束日期 + */ + termEndDate: string; + + /** + * 任期时长（月） + */ + termDuration: number; + + /** + * 是否现任：0-否，1-是 + */ + isCurrent: number; + + /** + * 学生职务任职状态：1-在任，2-到期，3-辞职，4-免职，5-调任，6-休学 + */ + cadreStatus: string; + + /** + * 任命原因 + */ + appointmentReason: string; + + /** + * 学生职务任命方式：appointment-任命，election-选举，recommendation-推荐 + */ + appointmentMethod: string; + + /** + * 离任日期 + */ + dismissalDate: string; + + /** + * 离任原因 + */ + dismissalReason: string; + + /** + * 备注信息 + */ + remark: string; + +} + +export interface XgClassPosMsgForm extends BaseEntity { + /** + * 主键ID（雪花ID） + */ + id?: string | number; + + /** + * 删除标志（0代表存在 1代表删除） + */ + deleted?: number; + + /** + * 班级ID，关联xg_class_msg.id + */ + classId?: string | number; + + /** + * 学生ID，关联xg_student_msg.id + */ + studentId?: string | number; + + /** + * 学号 + */ + studentNo?: string; + + /** + * 学生姓名（冗余字段） + */ + studentName?: string; + + /** + * 职务编码，关联xg_class_pos_dict.position_code + */ + positionCode?: string; + + /** + * 任职日期 + */ + appointmentDate?: string; + + /** + * 任期开始日期 + */ + termStartDate?: string; + + /** + * 任期结束日期 + */ + termEndDate?: string; + + /** + * 任期时长（月） + */ + termDuration?: number; + + /** + * 是否现任：0-否，1-是 + */ + isCurrent?: number; + + /** + * 学生职务任职状态：1-在任，2-到期，3-辞职，4-免职，5-调任，6-休学 + */ + cadreStatus?: string; + + /** + * 任命原因 + */ + appointmentReason?: string; + + /** + * 学生职务任命方式：appointment-任命，election-选举，recommendation-推荐 + */ + appointmentMethod?: string; + + /** + * 离任日期 + */ + dismissalDate?: string; + + /** + * 离任原因 + */ + dismissalReason?: string; + + /** + * 备注信息 + */ + remark?: string; + +} + +export interface XgClassPosMsgQuery extends PageQuery { + + /** + * 删除标志（0代表存在 1代表删除） + */ + deleted?: number; + + /** + * 班级ID，关联xg_class_msg.id + */ + classId?: string | number; + + /** + * 学生ID，关联xg_student_msg.id + */ + studentId?: string | number; + + /** + * 学号 + */ + studentNo?: string; + + /** + * 学生姓名（冗余字段） + */ + studentName?: string; + + /** + * 职务编码，关联xg_class_pos_dict.position_code + */ + positionCode?: string; + + /** + * 任职日期 + */ + appointmentDate?: string; + + /** + * 任期开始日期 + */ + termStartDate?: string; + + /** + * 任期结束日期 + */ + termEndDate?: string; + + /** + * 任期时长（月） + */ + termDuration?: number; + + /** + * 是否现任：0-否，1-是 + */ + isCurrent?: number; + + /** + * 学生职务任职状态：1-在任，2-到期，3-辞职，4-免职，5-调任，6-休学 + */ + cadreStatus?: string; + + /** + * 任命原因 + */ + appointmentReason?: string; + + /** + * 学生职务任命方式：appointment-任命，election-选举，recommendation-推荐 + */ + appointmentMethod?: string; + + /** + * 离任日期 + */ + dismissalDate?: string; + + /** + * 离任原因 + */ + dismissalReason?: string; + + /** + * 日期范围参数 + */ + params?: any; +} + + + diff --git a/web/src/views/system/role/index.vue b/web/src/views/system/role/index.vue index f31516c7..877a4c99 100644 --- a/web/src/views/system/role/index.vue +++ b/web/src/views/system/role/index.vue @@ -63,7 +63,13 @@ @@ -77,14 +83,36 @@ - - + + - - + + @@ -100,9 +128,18 @@ + - + - + - + - + {{ dict.label }} @@ -192,6 +229,8 @@ + + diff --git a/web/src/views/xgClassPosMsg/xgClassPosMsg/index.vue b/web/src/views/xgClassPosMsg/xgClassPosMsg/index.vue new file mode 100644 index 00000000..73681196 --- /dev/null +++ b/web/src/views/xgClassPosMsg/xgClassPosMsg/index.vue @@ -0,0 +1,700 @@ + + + + +