Files
hzdyjs/backend/ruoyi-modules/ruoyi-bzrkh/部署说明.md
T
2025-08-19 15:27:06 +08:00

4.1 KiB

班主任考核指标类型管理模块部署说明

1. 数据库准备

1.1 执行表结构创建脚本

-- 执行表结构创建脚本
source docs/设计文档/database/班主任考核管理/bmzr_assessment_tables.sql

1.2 执行字典数据脚本

-- 执行字典数据脚本
source docs/设计文档/database/班主任考核管理/bmzr_dict_data_mysql.sql

2. 后端代码部署

2.1 已创建的后端文件列表

  1. Domain实体类

    • backend/ruoyi-modules/ruoyi-bzrkh/src/main/java/org/dromara/bzrkh/domain/BmzrAssessmentIndicatorType.java
  2. VO类

    • backend/ruoyi-modules/ruoyi-bzrkh/src/main/java/org/dromara/bzrkh/domain/vo/BmzrAssessmentIndicatorTypeVo.java
  3. BO类

    • backend/ruoyi-modules/ruoyi-bzrkh/src/main/java/org/dromara/bzrkh/domain/bo/BmzrAssessmentIndicatorTypeBo.java
  4. Mapper接口

    • backend/ruoyi-modules/ruoyi-bzrkh/src/main/java/org/dromara/bzrkh/mapper/BmzrAssessmentIndicatorTypeMapper.java
  5. Service接口

    • backend/ruoyi-modules/ruoyi-bzrkh/src/main/java/org/dromara/bzrkh/service/IBmzrAssessmentIndicatorTypeService.java
  6. Service实现类

    • backend/ruoyi-modules/ruoyi-bzrkh/src/main/java/org/dromara/bzrkh/service/impl/BmzrAssessmentIndicatorTypeServiceImpl.java
  7. Controller

    • backend/ruoyi-modules/ruoyi-bzrkh/src/main/java/org/dromara/bzrkh/controller/BmzrAssessmentIndicatorTypeController.java

2.2 后端配置说明

确保 ruoyi-bzrkh 模块已正确配置并加载:

  1. 检查 backend/ruoyi-modules/pom.xml 中是否包含 ruoyi-bzrkh 模块
  2. 确保 Spring Boot 能够扫描到 org.dromara.bzrkh 包下的组件

3. 前端代码部署

3.1 已创建的前端文件列表

  1. API类型定义

    • web/src/api/bzrkh/assessmentIndicatorType/types.ts
  2. API调用文件

    • web/src/api/bzrkh/assessmentIndicatorType/index.ts
  3. Vue页面

    • web/src/views/bzrkh/assessmentIndicatorType/index.vue

3.2 前端配置说明

  1. 确保路由配置正确,能够访问到创建的Vue页面
  2. 检查API请求路径是否正确配置

4. 权限配置

4.1 权限字符列表

  • bzrkh:assessmentIndicatorType:list - 查询权限
  • bzrkh:assessmentIndicatorType:query - 详情权限
  • bzrkh:assessmentIndicatorType:add - 新增权限
  • bzrkh:assessmentIndicatorType:edit - 修改权限
  • bzrkh:assessmentIndicatorType:remove - 删除权限
  • bzrkh:assessmentIndicatorType:export - 导出权限

4.2 菜单配置

请参考 班主任考核指标类型管理权限配置.md 文件中的SQL脚本进行菜单和权限配置。

5. 字典配置说明

该模块使用以下字典:

  1. sys_item_enable - 状态字典(启用/停用)
  2. bmzr_indicator_type - 指标类型字典(已通过脚本创建)

6. 功能特性

6.1 实现的功能

  • ✅ 指标类型列表查询(支持分页、条件筛选)
  • ✅ 指标类型详情查看
  • ✅ 新增指标类型
  • ✅ 修改指标类型
  • ✅ 删除指标类型(逻辑删除)
  • ✅ 批量删除
  • ✅ 数据导出
  • ✅ 权限控制

6.2 数据校验

  • 指标类型编码唯一性校验
  • 必填字段验证
  • 字段长度限制

6.3 界面特性

  • 响应式设计
  • 搜索条件折叠/展开
  • 友好的删除确认提示
  • 完整的CRUD操作界面

7. 注意事项

  1. 权限配置:请确保在系统菜单管理中正确配置权限
  2. 字典数据:确保相关字典数据已正确导入
  3. 表结构:确保数据库表结构与代码实体类保持一致
  4. 多租户:该模块支持多租户,请注意租户隔离
  5. 逻辑删除:删除操作为逻辑删除,数据不会物理删除

8. 测试建议

  1. 测试CRUD基本功能
  2. 测试权限控制是否生效
  3. 测试数据校验规则
  4. 测试批量操作
  5. 测试搜索和分页功能
  6. 测试导出功能

9. 扩展说明

该模块为班主任考核管理系统的基础模块,后续可基于此模块扩展:

  • 考核指标管理
  • 考核方案管理
  • 考核计划管理
  • 考核评分管理

所有扩展模块都可以引用指标类型进行关联设计。