课程审核

需求分析

根据模块需求分析，课程发布前要先审核，审核通过方可发布。下图是课程审核及发布的流程图：

为什么课程审核通过才可以发布呢？

这样做为了防止课程信息有违规情况，课程信息不完善对网站用户体验也不好，课程审核不仅起到监督作用，也是帮助教学机构规范使用平台的手段。

如何控制课程审核通过才可以发布课程呢？

在课程基本表course_base表设置课程审核状态字段，包括：未提交、已提交(未审核)、审核通过、审核不通过。

下边是课程状态的转化关系：

说明如下：

1、一门课程新增后它的审核状为”未提交“，发布状态为”未发布“。

2、课程信息编辑完成，教学机构人员执行”提交审核“操作。此时课程的审核状态为”已提交“。

3、当课程状态为已提交时运营平台人员对课程进行审核。

4、运营平台人员审核课程，结果有两个：审核通过、审核不通过。

5、课程审核过后不管状态是通过还是不通过，教学机构可以再次修改课程并提交审核，此时课程状态为”已提交“。此时运营平台人员再次审核课程。

6、课程审核通过，教学机构人员可以发布课程，发布成功后课程的发布状态为”已发布“。

7、课程发布后通过”下架“操作可以更改课程发布状态为”下架“

8、课程下架后通过”上架“操作可以再次发布课程，上架后课程发布状态为“发布”。

通过业务流程的分析，现在我们思考：

1、课程提交审核后还允许修改课程吗？

如果不允许修改是不合理的，因为提交审核后可以继续做下一个阶段的课程内容，比如添加课程计划，上传课程视频等。

如果允许修改那么课程审核时看到的课程内容从哪里来？如果也从课程基本信息表、课程营销表、课程计划表查询那么存在什么问题呢？如下图：

运营人员审核课程和教学机构编辑课程操作的数据是同一份，此时会导致冲突。比如：运营人员正在审核时教学机构把数据修改了。

为了解决这个问题，专门设计课程预发布表。

如下图：

提交课程审核，将课程信息汇总后写入课程预发布表，课程预发布表记录了教学机构在某个时间点要发布的课程信息。

课程审核人员从预发布表查询信息进行审核。

课程审核的同时可以对课程进行修改，修改的内容不会写入课程预发布表。

课程审核通过执行课程发布，将课程预发布表的信息写入课程发布表。

2、提交审核课程后，也修改了课程信息，可以再次提交审核吗？

这个问题在上边分析课程审核状态时已经有了答案，如下图：

提交审核课程后，必须等到课程审核完成才可以再次提交课程。

课程审核功能涉及教学机构提交审核，运营人员进行课程审核。在课堂上我们仅实现教学机构提交审核功能，课程审核的结果通过手动修改数据库来实现。

虽然课堂上不实现课程审核功能，完整的课程审核数据表设计需要理解。

提交审核将信息写入课程预发布表，课程预发布表结构如下：

更新课程基本信息表的课程审核状态为：已经提交

课程审核后更新课程基本信息表的审核状态、课程预发布表的审核状态，并将审核结果写入课程审核记录。

审核记录表结构如下：

接口定义

下边定义提交课程审核的接口，在课程发布Controller中定义接口如下：

package com.xuecheng.content.api;/*** @description 课程预览，发布* @author Mr.M* @date 2022/9/16 14:48* @version 1.0*/
@Controller()
public class CoursePublishController {@ResponseBody@PostMapping("/courseaudit/commit/{courseId}")public void commitAudit(@PathVariable("courseId") Long courseId){}}

接口开发

Dao开发

1、查询课程基本信息、课程营销信息、课程计划信息等课程相关信息，整合为课程预发布信息。

2、向课程预发布表course_publish_pre插入一条记录，如果已经存在则更新，审核状态为：已提交。

3、更新课程基本表course_base课程审核状态为：已提交。

约束：

1、对已提交审核的课程不允许提交审核。

2、本机构只允许提交本机构的课程。

3、没有上传图片不允许提交审核。

4、没有添加课程计划不允许提交审核。

使用代码生成器生成课程发布表、课程预发布表的PO、Mpper，并拷贝到相应的工程

Service开发

在课程发布Service类中定义接口如下：

package com.xuecheng.content.service;/*** @description 课程预览、发布接口* @author Mr.M* @date 2022/9/16 14:59* @version 1.0*/
public interface CoursePublishService {/*** @description 提交审核* @param courseId  课程id* @return void* @author Mr.M* @date 2022/9/18 10:31*/public void commitAudit(Long companyId,Long courseId);}

接口实现如下：

package com.xuecheng.content.service.impl;/*** @description TODO* @author Mr.M* @date 2022/9/16 15:37* @version 1.0*/
@Service
public class CoursePublishServiceImpl implements CoursePublishService {@AutowiredCourseBaseInfoService courseBaseInfoService;@AutowiredTeachplanService teachplanService;@AutowiredCourseBaseMapper courseBaseMapper;@AutowiredCourseMarketMapper courseMarketMapper;@AutowiredCoursePublishPreMapper coursePublishPreMapper;@Transactional@Overridepublic void commitAudit(Long companyId, Long courseId) {//约束校验CourseBase courseBase = courseBaseMapper.selectById(courseId);//课程审核状态String auditStatus = courseBase.getAuditStatus();//当前审核状态为已提交不允许再次提交if("202003".equals(auditStatus)){XueChengPlusException.cast("当前为等待审核状态，审核完成可以再次提交。");}//本机构只允许提交本机构的课程if(!courseBase.getCompanyId().equals(companyId)){XueChengPlusException.cast("不允许提交其它机构的课程。");}//课程图片是否填写if(StringUtils.isEmpty(courseBase.getPic())){XueChengPlusException.cast("提交失败，请上传课程图片");}//添加课程预发布记录CoursePublishPre coursePublishPre = new CoursePublishPre();//课程基本信息加部分营销信息CourseBaseInfoDto courseBaseInfo = courseBaseInfoService.getCourseBaseInfo(courseId);BeanUtils.copyProperties(courseBaseInfo,coursePublishPre);//课程营销信息CourseMarket courseMarket = courseMarketMapper.selectById(courseId);//转为jsonString courseMarketJson = JSON.toJSONString(courseMarket);//将课程营销信息json数据放入课程预发布表coursePublishPre.setMarket(courseMarketJson);//查询课程计划信息List<TeachplanDto> teachplanTree = teachplanService.findTeachplanTree(courseId);if(teachplanTree.size()<=0){XueChengPlusException.cast("提交失败，还没有添加课程计划");}//转jsonString teachplanTreeString = JSON.toJSONString(teachplanTree);coursePublishPre.setTeachplan(teachplanTreeString);//设置预发布记录状态,已提交coursePublishPre.setStatus("202003");//教学机构idcoursePublishPre.setCompanyId(companyId);//提交时间coursePublishPre.setCreateDate(LocalDateTime.now());CoursePublishPre coursePublishPreUpdate = coursePublishPreMapper.selectById(courseId);if(coursePublishPreUpdate == null){//添加课程预发布记录coursePublishPreMapper.insert(coursePublishPre);}else{coursePublishPreMapper.updateById(coursePublishPre);}//更新课程基本表的审核状态courseBase.setAuditStatus("202003");courseBaseMapper.updateById(courseBase);}}

接口完善

完善接口层的代码

    @ResponseBody@PostMapping("/courseaudit/commit/{courseId}")public void commitAudit(@PathVariable("courseId") Long courseId){Long companyId = 1232141425L;coursePublishService.commitAudit(companyId,courseId);}

接口测试

使用前端提交课程审核：

1、找一门信息不全的课程，测试各各约束条件。

2、正常提交后，观察数据库中课程预发布表记录的内容是否完整。

3、测试审核过后再次提交，提交后观察数据库中课程预发布表记录的内容是否正确。

审核通过需手动修改数据库：

1、修改课程预发布表的状态为审核通过202004。

2、修改课程基本表的审核状态为审核通过202004。

3、课程发布表中就存在该课程数据了, 达到课程审核通过的效果

4、课程审核通过后, 点击发布按钮就能发布课程