合并培训：集成课程主数据P0能力

RuoYi-Vue/ruoyi-admin/src/main/java/com/ruoyi/web/controller/train/TrainCourseController.java

@@ -1,13 +1,11 @@
 package com.ruoyi.web.controller.train;
 
 import java.util.List;
-import javax.servlet.http.HttpServletResponse;
 import org.springframework.security.access.prepost.PreAuthorize;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.PutMapping;
-import org.springframework.web.bind.annotation.DeleteMapping;
 import org.springframework.web.bind.annotation.PathVariable;
 import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
@@ -16,16 +14,17 @@ import com.ruoyi.common.annotation.Log;
 import com.ruoyi.common.core.controller.BaseController;
 import com.ruoyi.common.core.domain.AjaxResult;
 import com.ruoyi.common.enums.BusinessType;
+import com.ruoyi.common.utils.StringUtils;
 import com.ruoyi.train.domain.TrainCourse;
+import com.ruoyi.train.domain.vo.CourseDetailVO;
 import com.ruoyi.train.service.ITrainCourseService;
-import com.ruoyi.common.utils.poi.ExcelUtil;
 import com.ruoyi.common.core.page.TableDataInfo;
 
 /**
  * 课程信息Controller
- * 
+ *
  * @author ruoyi
- * @date 2026-09-08
+ * @date 2026-09-14
  */
 @RestController
 @RequestMapping("/train/course")
@@ -35,9 +34,9 @@ public class TrainCourseController extends BaseController
     private ITrainCourseService trainCourseService;
 
     /**
-     * 查询课程信息列表
+     * 查询课程信息列表 【P0】
      */
-    @PreAuthorize("@ss.hasPermi('system:course:list')")
+    @PreAuthorize("@ss.hasPermi('train:course:list')")
     @GetMapping("/list")
     public TableDataInfo list(TrainCourse trainCourse)
     {
@@ -47,58 +46,61 @@ public class TrainCourseController extends BaseController
     }
 
     /**
-     * 导出课程信息列表
+     * 获取课程信息详细信息 【P0】
+     * 返回结构：CourseDetailVO (包含课程基础字段与契约预留resources列表)
      */
-    @PreAuthorize("@ss.hasPermi('system:course:export')")
-    @Log(title = "课程信息", businessType = BusinessType.EXPORT)
-    @PostMapping("/export")
-    public void export(HttpServletResponse response, TrainCourse trainCourse)
-    {
-        List<TrainCourse> list = trainCourseService.selectTrainCourseList(trainCourse);
-        ExcelUtil<TrainCourse> util = new ExcelUtil<TrainCourse>(TrainCourse.class);
-        util.exportExcel(response, list, "课程信息数据");
-    }
-
-    /**
-     * 获取课程信息详细信息
-     */
-    @PreAuthorize("@ss.hasPermi('system:course:query')")
+    @PreAuthorize("@ss.hasPermi('train:course:query')")
     @GetMapping(value = "/{cId}")
     public AjaxResult getInfo(@PathVariable("cId") String cId)
     {
-        return success(trainCourseService.selectTrainCourseByCId(cId));
+        CourseDetailVO detailVO = trainCourseService.selectCourseDetailByCId(cId);
+        if (detailVO == null)
+        {
+            return AjaxResult.error(404, "课程不存在");
+        }
+        return success(detailVO);
     }
 
     /**
-     * 新增课程信息
+     * 新增课程信息 【P0】
      */
-    @PreAuthorize("@ss.hasPermi('system:course:add')")
+    @PreAuthorize("@ss.hasPermi('train:course:add')")
     @Log(title = "课程信息", businessType = BusinessType.INSERT)
     @PostMapping
     public AjaxResult add(@RequestBody TrainCourse trainCourse)
     {
+        if (StringUtils.isEmpty(trainCourse.getcName()))
+        {
+            return AjaxResult.error(400, "课程名称不能为空");
+        }
+        if (StringUtils.isNotEmpty(trainCourse.getcCode()) && !trainCourseService.checkCCodeUnique(trainCourse))
+        {
+            return AjaxResult.error(40003, "课程编码已存在");
+        }
+        if (trainCourse.getcDuration() != null && trainCourse.getcDuration() <= 0)
+        {
+            return AjaxResult.error(400, "课程学时必须为正整数");
+        }
         return toAjax(trainCourseService.insertTrainCourse(trainCourse));
     }
 
     /**
-     * 修改课程信息
+     * 修改课程信息 (API Contract 3.4 【P1】: PUT /train/course/{cId})
      */
-    @PreAuthorize("@ss.hasPermi('system:course:edit')")
+    @PreAuthorize("@ss.hasPermi('train:course:edit')")
     @Log(title = "课程信息", businessType = BusinessType.UPDATE)
-    @PutMapping
-    public AjaxResult edit(@RequestBody TrainCourse trainCourse)
+    @PutMapping("/{cId}")
+    public AjaxResult edit(@PathVariable("cId") String cId, @RequestBody TrainCourse trainCourse)
     {
+        trainCourse.setcId(cId);
+        if (StringUtils.isNotEmpty(trainCourse.getcCode()) && !trainCourseService.checkCCodeUnique(trainCourse))
+        {
+            return AjaxResult.error(40003, "课程编码已存在");
+        }
+        if (trainCourse.getcDuration() != null && trainCourse.getcDuration() <= 0)
+        {
+            return AjaxResult.error(400, "课程学时必须为正整数");
+        }
         return toAjax(trainCourseService.updateTrainCourse(trainCourse));
     }
-
-    /**
-     * 删除课程信息
-     */
-    @PreAuthorize("@ss.hasPermi('system:course:remove')")
-    @Log(title = "课程信息", businessType = BusinessType.DELETE)
-	@DeleteMapping("/{cIds}")
-    public AjaxResult remove(@PathVariable String[] cIds)
-    {
-        return toAjax(trainCourseService.deleteTrainCourseByCIds(cIds));
-    }
 }

RuoYi-Vue/ruoyi-train/src/main/java/com/ruoyi/train/domain/TrainCourse.java

@@ -2,14 +2,15 @@ package com.ruoyi.train.domain;
 
 import org.apache.commons.lang3.builder.ToStringBuilder;
 import org.apache.commons.lang3.builder.ToStringStyle;
+import com.fasterxml.jackson.annotation.JsonProperty;
 import com.ruoyi.common.annotation.Excel;
 import com.ruoyi.common.core.domain.BaseEntity;
 
 /**
  * 课程信息对象 train_course
- * 
+ *
  * @author ruoyi
- * @date 2026-09-08
+ * @date 2026-09-14
  */
 public class TrainCourse extends BaseEntity
 {
@@ -18,6 +19,10 @@ public class TrainCourse extends BaseEntity
     /** 课程编号主键 */
     private String cId;
 
+    /** 课程统一业务编码 */
+    @Excel(name = "课程统一业务编码")
+    private String cCode;
+
     /** 课程名称 */
     @Excel(name = "课程名称")
     private String cName;
@@ -26,163 +31,190 @@ public class TrainCourse extends BaseEntity
     @Excel(name = "课程类型")
     private String cType;
 
-    /** 课程时长 (分钟) */
-    @Excel(name = "课程时长 (分钟)")
-    private Long cDuration;
+    /** 课程学时 */
+    @Excel(name = "课程学时")
+    private Integer cDuration;
 
     /** 教学目标 */
     @Excel(name = "教学目标")
     private String teachingObjective;
 
-    /** 课程内容 */
+    /** 课程内容/摘要 */
     @Excel(name = "课程内容")
     private String courseContent;
 
-    /** 配套文档，多个逗号分隔 */
-    @Excel(name = "配套文档，多个逗号分隔")
-    private String attachDoc;
+    /** 课程状态 (1:正常, 0:停用) */
+    @Excel(name = "课程状态", readConverterExp = "1=正常,0=停用")
+    private Integer status;
 
-    /** 配套视频地址 */
-    @Excel(name = "配套视频地址")
-    private String attachVideo;
+    /** 删除标志 (0:存在, 2:删除) */
+    private String delFlag;
 
-    /** 配套模型链接 */
-    @Excel(name = "配套模型链接")
-    private String attachModelLink;
-
-    /** 关联3D设备拆解模型、实训场景资源ID，多ID逗号分隔 */
-    @Excel(name = "关联3D设备拆解模型、实训场景资源ID，多ID逗号分隔")
-    private String modelResourceIds;
-
-    /** 创建人 (管理员 / 教师) */
-    @Excel(name = "创建人 (管理员 / 教师)")
-    private String createUser;
-
-    public void setcId(String cId) 
+    @JsonProperty("cId")
+    public void setcId(String cId)
     {
         this.cId = cId;
     }
 
-    public String getcId() 
+    @JsonProperty("cId")
+    public String getcId()
     {
         return cId;
     }
 
-    public void setcName(String cName) 
+    public void setCId(String cId)
+    {
+        this.cId = cId;
+    }
+
+    public String getCId()
+    {
+        return cId;
+    }
+
+    @JsonProperty("cCode")
+    public void setcCode(String cCode)
+    {
+        this.cCode = cCode;
+    }
+
+    @JsonProperty("cCode")
+    public String getcCode()
+    {
+        return cCode;
+    }
+
+    public void setCCode(String cCode)
+    {
+        this.cCode = cCode;
+    }
+
+    public String getCCode()
+    {
+        return cCode;
+    }
+
+    @JsonProperty("cName")
+    public void setcName(String cName)
     {
         this.cName = cName;
     }
 
-    public String getcName() 
+    @JsonProperty("cName")
+    public String getcName()
     {
         return cName;
     }
 
-    public void setcType(String cType) 
+    public void setCName(String cName)
+    {
+        this.cName = cName;
+    }
+
+    public String getCName()
+    {
+        return cName;
+    }
+
+    @JsonProperty("cType")
+    public void setcType(String cType)
     {
         this.cType = cType;
     }
 
-    public String getcType() 
+    @JsonProperty("cType")
+    public String getcType()
     {
         return cType;
     }
 
-    public void setcDuration(Long cDuration) 
+    public void setCType(String cType)
+    {
+        this.cType = cType;
+    }
+
+    public String getCType()
+    {
+        return cType;
+    }
+
+    @JsonProperty("cDuration")
+    public void setcDuration(Integer cDuration)
     {
         this.cDuration = cDuration;
     }
 
-    public Long getcDuration() 
+    @JsonProperty("cDuration")
+    public Integer getcDuration()
     {
         return cDuration;
     }
 
-    public void setTeachingObjective(String teachingObjective) 
+    public void setCDuration(Integer cDuration)
+    {
+        this.cDuration = cDuration;
+    }
+
+    public Integer getCDuration()
+    {
+        return cDuration;
+    }
+
+    public void setTeachingObjective(String teachingObjective)
     {
         this.teachingObjective = teachingObjective;
     }
 
-    public String getTeachingObjective() 
+    public String getTeachingObjective()
     {
         return teachingObjective;
     }
 
-    public void setCourseContent(String courseContent) 
+    public void setCourseContent(String courseContent)
     {
         this.courseContent = courseContent;
     }
 
-    public String getCourseContent() 
+    public String getCourseContent()
     {
         return courseContent;
     }
 
-    public void setAttachDoc(String attachDoc) 
+    public void setStatus(Integer status)
     {
-        this.attachDoc = attachDoc;
+        this.status = status;
     }
 
-    public String getAttachDoc() 
+    public Integer getStatus()
     {
-        return attachDoc;
+        return status;
     }
 
-    public void setAttachVideo(String attachVideo) 
+    public void setDelFlag(String delFlag)
     {
-        this.attachVideo = attachVideo;
+        this.delFlag = delFlag;
     }
 
-    public String getAttachVideo() 
+    public String getDelFlag()
     {
-        return attachVideo;
-    }
-
-    public void setAttachModelLink(String attachModelLink) 
-    {
-        this.attachModelLink = attachModelLink;
-    }
-
-    public String getAttachModelLink() 
-    {
-        return attachModelLink;
-    }
-
-    public void setModelResourceIds(String modelResourceIds) 
-    {
-        this.modelResourceIds = modelResourceIds;
-    }
-
-    public String getModelResourceIds() 
-    {
-        return modelResourceIds;
-    }
-
-    public void setCreateUser(String createUser) 
-    {
-        this.createUser = createUser;
-    }
-
-    public String getCreateUser() 
-    {
-        return createUser;
+        return delFlag;
     }
 
     @Override
     public String toString() {
         return new ToStringBuilder(this,ToStringStyle.MULTI_LINE_STYLE)
             .append("cId", getcId())
+            .append("cCode", getcCode())
             .append("cName", getcName())
             .append("cType", getcType())
             .append("cDuration", getcDuration())
             .append("teachingObjective", getTeachingObjective())
             .append("courseContent", getCourseContent())
-            .append("attachDoc", getAttachDoc())
-            .append("attachVideo", getAttachVideo())
-            .append("attachModelLink", getAttachModelLink())
-            .append("modelResourceIds", getModelResourceIds())
-            .append("createUser", getCreateUser())
+            .append("status", getStatus())
+            .append("delFlag", getDelFlag())
+            .append("createBy", getCreateBy())
             .append("createTime", getCreateTime())
+            .append("updateBy", getUpdateBy())
             .append("updateTime", getUpdateTime())
             .append("remark", getRemark())
             .toString();

RuoYi-Vue/ruoyi-train/src/main/java/com/ruoyi/train/domain/vo/CourseDetailVO.java

@@ -0,0 +1,298 @@
+package com.ruoyi.train.domain.vo;
+
+import java.io.Serializable;
+import java.util.Collections;
+import java.util.Date;
+import java.util.List;
+import com.fasterxml.jackson.annotation.JsonFormat;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.ruoyi.train.domain.TrainCourse;
+
+/**
+ * 课程详情视图对象 (API Contract: CourseDetailVO)
+ * 聚合返回课程基础信息及已绑定的教学资源列表
+ *
+ * @author ruoyi
+ * @date 2026-09-14
+ */
+public class CourseDetailVO implements Serializable
+{
+    private static final long serialVersionUID = 1L;
+
+    /** 课程编号主键 */
+    private String cId;
+
+    /** 课程统一业务编码 */
+    private String cCode;
+
+    /** 课程名称 */
+    private String cName;
+
+    /** 课程类型 */
+    private String cType;
+
+    /** 课程学时 */
+    private Integer cDuration;
+
+    /** 教学目标 */
+    private String teachingObjective;
+
+    /** 课程内容/摘要 */
+    private String courseContent;
+
+    /** 课程状态 (1:正常, 0:停用) */
+    private Integer status;
+
+    /** 备注 */
+    private String remark;
+
+    /** 创建者 */
+    private String createBy;
+
+    /** 创建时间 */
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+    private Date createTime;
+
+    /** 更新者 */
+    private String updateBy;
+
+    /** 更新时间 */
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+    private Date updateTime;
+
+    /**
+     * 已关联的教学资源列表
+     * 注：当前 ISSUE-01-03 未实现真实 Course<->Resource 查询；
+     * 绑定/解绑及真实关联能力属于 P1。为保证集合字段结构稳定，默认返回空列表 (empty list)。
+     */
+    private List<Object> resources;
+
+    public CourseDetailVO()
+    {
+    }
+
+    public static CourseDetailVO from(TrainCourse course)
+    {
+        if (course == null)
+        {
+            return null;
+        }
+        CourseDetailVO vo = new CourseDetailVO();
+        vo.setcId(course.getcId());
+        vo.setcCode(course.getcCode());
+        vo.setcName(course.getcName());
+        vo.setcType(course.getcType());
+        vo.setcDuration(course.getcDuration());
+        vo.setTeachingObjective(course.getTeachingObjective());
+        vo.setCourseContent(course.getCourseContent());
+        vo.setStatus(course.getStatus());
+        vo.setRemark(course.getRemark());
+        vo.setCreateBy(course.getCreateBy());
+        vo.setCreateTime(course.getCreateTime());
+        vo.setUpdateBy(course.getUpdateBy());
+        vo.setUpdateTime(course.getUpdateTime());
+        // 资源绑定/解绑能力属于 P1，当前返回空列表保持响应结构稳定
+        vo.setResources(Collections.emptyList());
+        return vo;
+    }
+
+    @JsonProperty("cId")
+    public String getcId()
+    {
+        return cId;
+    }
+
+    @JsonProperty("cId")
+    public void setcId(String cId)
+    {
+        this.cId = cId;
+    }
+
+    public String getCId()
+    {
+        return cId;
+    }
+
+    public void setCId(String cId)
+    {
+        this.cId = cId;
+    }
+
+    @JsonProperty("cCode")
+    public String getcCode()
+    {
+        return cCode;
+    }
+
+    @JsonProperty("cCode")
+    public void setcCode(String cCode)
+    {
+        this.cCode = cCode;
+    }
+
+    public String getCCode()
+    {
+        return cCode;
+    }
+
+    public void setCCode(String cCode)
+    {
+        this.cCode = cCode;
+    }
+
+    @JsonProperty("cName")
+    public String getcName()
+    {
+        return cName;
+    }
+
+    @JsonProperty("cName")
+    public void setcName(String cName)
+    {
+        this.cName = cName;
+    }
+
+    public String getCName()
+    {
+        return cName;
+    }
+
+    public void setCName(String cName)
+    {
+        this.cName = cName;
+    }
+
+    @JsonProperty("cType")
+    public String getcType()
+    {
+        return cType;
+    }
+
+    @JsonProperty("cType")
+    public void setcType(String cType)
+    {
+        this.cType = cType;
+    }
+
+    public String getCType()
+    {
+        return cType;
+    }
+
+    public void setCType(String cType)
+    {
+        this.cType = cType;
+    }
+
+    @JsonProperty("cDuration")
+    public Integer getcDuration()
+    {
+        return cDuration;
+    }
+
+    @JsonProperty("cDuration")
+    public void setcDuration(Integer cDuration)
+    {
+        this.cDuration = cDuration;
+    }
+
+    public Integer getCDuration()
+    {
+        return cDuration;
+    }
+
+    public void setCDuration(Integer cDuration)
+    {
+        this.cDuration = cDuration;
+    }
+
+    public String getTeachingObjective()
+    {
+        return teachingObjective;
+    }
+
+    public void setTeachingObjective(String teachingObjective)
+    {
+        this.teachingObjective = teachingObjective;
+    }
+
+    public String getCourseContent()
+    {
+        return courseContent;
+    }
+
+    public void setCourseContent(String courseContent)
+    {
+        this.courseContent = courseContent;
+    }
+
+    public Integer getStatus()
+    {
+        return status;
+    }
+
+    public void setStatus(Integer status)
+    {
+        this.status = status;
+    }
+
+    public String getRemark()
+    {
+        return remark;
+    }
+
+    public void setRemark(String remark)
+    {
+        this.remark = remark;
+    }
+
+    public String getCreateBy()
+    {
+        return createBy;
+    }
+
+    public void setCreateBy(String createBy)
+    {
+        this.createBy = createBy;
+    }
+
+    public Date getCreateTime()
+    {
+        return createTime;
+    }
+
+    public void setCreateTime(Date createTime)
+    {
+        this.createTime = createTime;
+    }
+
+    public String getUpdateBy()
+    {
+        return updateBy;
+    }
+
+    public void setUpdateBy(String updateBy)
+    {
+        this.updateBy = updateBy;
+    }
+
+    public Date getUpdateTime()
+    {
+        return updateTime;
+    }
+
+    public void setUpdateTime(Date updateTime)
+    {
+        this.updateTime = updateTime;
+    }
+
+    public List<Object> getResources()
+    {
+        return resources;
+    }
+
+    public void setResources(List<Object> resources)
+    {
+        this.resources = resources;
+    }
+}

RuoYi-Vue/ruoyi-train/src/main/java/com/ruoyi/train/mapper/TrainCourseMapper.java

@@ -5,15 +5,15 @@ import com.ruoyi.train.domain.TrainCourse;
 
 /**
  * 课程信息Mapper接口
- * 
+ *
  * @author ruoyi
  * @date 2026-09-08
  */
-public interface TrainCourseMapper 
+public interface TrainCourseMapper
 {
     /**
      * 查询课程信息
-     * 
+     *
      * @param cId 课程信息主键
      * @return 课程信息
      */
@@ -21,7 +21,7 @@ public interface TrainCourseMapper
 
     /**
      * 查询课程信息列表
-     * 
+     *
      * @param trainCourse 课程信息
      * @return 课程信息集合
      */
@@ -29,7 +29,7 @@ public interface TrainCourseMapper
 
     /**
      * 新增课程信息
-     * 
+     *
      * @param trainCourse 课程信息
      * @return 结果
      */
@@ -37,7 +37,7 @@ public interface TrainCourseMapper
 
     /**
      * 修改课程信息
-     * 
+     *
      * @param trainCourse 课程信息
      * @return 结果
      */
@@ -45,15 +45,31 @@ public interface TrainCourseMapper
 
     /**
      * 删除课程信息
-     * 
+     *
      * @param cId 课程信息主键
      * @return 结果
      */
     public int deleteTrainCourseByCId(String cId);
 
+    /**
+     * 校验课程统一业务编码是否唯一
+     *
+     * @param cCode 课程统一业务编码
+     * @return 课程信息
+     */
+    public TrainCourse checkCCodeUnique(String cCode);
+
+    /**
+     * 根据课程统一业务编码查询课程信息
+     *
+     * @param cCode 课程统一业务编码
+     * @return 课程信息
+     */
+    public TrainCourse selectTrainCourseByCCode(String cCode);
+
     /**
      * 批量删除课程信息
-     * 
+     *
      * @param cIds 需要删除的数据主键集合
      * @return 结果
      */

RuoYi-Vue/ruoyi-train/src/main/java/com/ruoyi/train/service/ITrainCourseService.java

@@ -2,18 +2,27 @@ package com.ruoyi.train.service;
 
 import java.util.List;
 import com.ruoyi.train.domain.TrainCourse;
+import com.ruoyi.train.domain.vo.CourseDetailVO;
 
 /**
  * 课程信息Service接口
- * 
+ *
  * @author ruoyi
  * @date 2026-09-08
  */
-public interface ITrainCourseService 
+public interface ITrainCourseService
 {
+    /**
+     * 查询课程详情视图 (CourseDetailVO)
+     *
+     * @param cId 课程信息主键
+     * @return 课程详情VO
+     */
+    public CourseDetailVO selectCourseDetailByCId(String cId);
+
     /**
      * 查询课程信息
-     * 
+     *
      * @param cId 课程信息主键
      * @return 课程信息
      */
@@ -21,7 +30,7 @@ public interface ITrainCourseService
 
     /**
      * 查询课程信息列表
-     * 
+     *
      * @param trainCourse 课程信息
      * @return 课程信息集合
      */
@@ -29,7 +38,7 @@ public interface ITrainCourseService
 
     /**
      * 新增课程信息
-     * 
+     *
      * @param trainCourse 课程信息
      * @return 结果
      */
@@ -37,7 +46,7 @@ public interface ITrainCourseService
 
     /**
      * 修改课程信息
-     * 
+     *
      * @param trainCourse 课程信息
      * @return 结果
      */
@@ -45,15 +54,31 @@ public interface ITrainCourseService
 
     /**
      * 批量删除课程信息
-     * 
+     *
      * @param cIds 需要删除的课程信息主键集合
      * @return 结果
      */
     public int deleteTrainCourseByCIds(String[] cIds);
 
+    /**
+     * 校验课程统一业务编码是否唯一
+     *
+     * @param trainCourse 课程信息
+     * @return 结果
+     */
+    public boolean checkCCodeUnique(TrainCourse trainCourse);
+
+    /**
+     * 根据课程统一业务编码查询课程信息
+     *
+     * @param cCode 课程统一业务编码
+     * @return 课程信息
+     */
+    public TrainCourse selectTrainCourseByCCode(String cCode);
+
     /**
      * 删除课程信息信息
-     * 
+     *
      * @param cId 课程信息主键
      * @return 结果
      */

RuoYi-Vue/ruoyi-train/src/main/java/com/ruoyi/train/service/impl/TrainCourseServiceImpl.java

@@ -1,28 +1,46 @@
 package com.ruoyi.train.service.impl;
 
 import java.util.List;
-import com.ruoyi.common.utils.DateUtils;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.stereotype.Service;
+import com.ruoyi.common.exception.ServiceException;
+import com.ruoyi.common.utils.DateUtils;
+import com.ruoyi.common.utils.SecurityUtils;
+import com.ruoyi.common.utils.StringUtils;
+import com.ruoyi.common.utils.uuid.IdUtils;
 import com.ruoyi.train.mapper.TrainCourseMapper;
 import com.ruoyi.train.domain.TrainCourse;
+import com.ruoyi.train.domain.vo.CourseDetailVO;
 import com.ruoyi.train.service.ITrainCourseService;
 
 /**
  * 课程信息Service业务层处理
- * 
+ *
  * @author ruoyi
- * @date 2026-09-08
+ * @date 2026-09-14
  */
 @Service
-public class TrainCourseServiceImpl implements ITrainCourseService 
+public class TrainCourseServiceImpl implements ITrainCourseService
 {
     @Autowired
     private TrainCourseMapper trainCourseMapper;
 
+    /**
+     * 查询课程详情视图 (CourseDetailVO)
+     *
+     * @param cId 课程信息主键
+     * @return 课程详情VO
+     */
+    @Override
+    public CourseDetailVO selectCourseDetailByCId(String cId)
+    {
+        TrainCourse course = trainCourseMapper.selectTrainCourseByCId(cId);
+        return CourseDetailVO.from(course);
+    }
+
     /**
      * 查询课程信息
-     * 
+     *
      * @param cId 课程信息主键
      * @return 课程信息
      */
@@ -34,7 +52,7 @@ public class TrainCourseServiceImpl implements ITrainCourseService
 
     /**
      * 查询课程信息列表
-     * 
+     *
      * @param trainCourse 课程信息
      * @return 课程信息
      */
@@ -46,33 +64,150 @@ public class TrainCourseServiceImpl implements ITrainCourseService
 
     /**
      * 新增课程信息
-     * 
+     *
      * @param trainCourse 课程信息
      * @return 结果
      */
     @Override
     public int insertTrainCourse(TrainCourse trainCourse)
     {
+        // 1. 课程名称校验
+        if (StringUtils.isEmpty(trainCourse.getcName()))
+        {
+            throw new ServiceException("课程名称不能为空", 400);
+        }
+        if (trainCourse.getcName().length() > 100)
+        {
+            throw new ServiceException("课程名称长度不能超过100个字符", 400);
+        }
+
+        // 2. 课程统一编码唯一性校验
+        if (StringUtils.isNotEmpty(trainCourse.getcCode()))
+        {
+            if (trainCourse.getcCode().length() > 50)
+            {
+                throw new ServiceException("课程编码长度不能超过50个字符", 400);
+            }
+            if (!checkCCodeUnique(trainCourse))
+            {
+                throw new ServiceException("课程编码已存在", 40003);
+            }
+        }
+
+        // 3. 课程学时正整数校验
+        if (trainCourse.getcDuration() != null && trainCourse.getcDuration() <= 0)
+        {
+            throw new ServiceException("课程学时必须为正整数", 400);
+        }
+
+        // 4. 生成 32 位无短横线 UUID 主键
+        if (StringUtils.isEmpty(trainCourse.getcId()))
+        {
+            trainCourse.setcId(IdUtils.fastSimpleUUID());
+        }
+
+        // 5. 初始默认状态与逻辑删除标志
+        if (trainCourse.getStatus() == null)
+        {
+            trainCourse.setStatus(1);
+        }
+        trainCourse.setDelFlag("0");
         trainCourse.setCreateTime(DateUtils.getNowDate());
+
+        try
+        {
+            trainCourse.setCreateBy(SecurityUtils.getUsername());
+        }
+        catch (Exception e)
+        {
+            // 兜底处理 (如无上下文或测试环境)
+        }
+
         return trainCourseMapper.insertTrainCourse(trainCourse);
     }
 
     /**
      * 修改课程信息
-     * 
+     *
      * @param trainCourse 课程信息
      * @return 结果
      */
     @Override
     public int updateTrainCourse(TrainCourse trainCourse)
     {
+        // 1. 课程名称校验
+        if (StringUtils.isNotEmpty(trainCourse.getcName()) && trainCourse.getcName().length() > 100)
+        {
+            throw new ServiceException("课程名称长度不能超过100个字符", 400);
+        }
+
+        // 2. 课程统一编码唯一性校验
+        if (StringUtils.isNotEmpty(trainCourse.getcCode()))
+        {
+            if (trainCourse.getcCode().length() > 50)
+            {
+                throw new ServiceException("课程编码长度不能超过50个字符", 400);
+            }
+            if (!checkCCodeUnique(trainCourse))
+            {
+                throw new ServiceException("课程编码已存在", 40003);
+            }
+        }
+
+        // 3. 课程学时正整数校验
+        if (trainCourse.getcDuration() != null && trainCourse.getcDuration() <= 0)
+        {
+            throw new ServiceException("课程学时必须为正整数", 400);
+        }
+
         trainCourse.setUpdateTime(DateUtils.getNowDate());
+        try
+        {
+            trainCourse.setUpdateBy(SecurityUtils.getUsername());
+        }
+        catch (Exception e)
+        {
+            // 兜底处理
+        }
         return trainCourseMapper.updateTrainCourse(trainCourse);
     }
 
+    /**
+     * 校验课程统一业务编码是否唯一
+     *
+     * @param trainCourse 课程信息
+     * @return 结果 (true: 唯一可用, false: 已存在重复)
+     */
+    @Override
+    public boolean checkCCodeUnique(TrainCourse trainCourse)
+    {
+        if (StringUtils.isEmpty(trainCourse.getcCode()))
+        {
+            return true;
+        }
+        TrainCourse info = trainCourseMapper.checkCCodeUnique(trainCourse.getcCode());
+        if (info != null && (StringUtils.isEmpty(trainCourse.getcId()) || !info.getcId().equals(trainCourse.getcId())))
+        {
+            return false;
+        }
+        return true;
+    }
+
+    /**
+     * 根据课程统一业务编码查询课程信息
+     *
+     * @param cCode 课程统一业务编码
+     * @return 课程信息
+     */
+    @Override
+    public TrainCourse selectTrainCourseByCCode(String cCode)
+    {
+        return trainCourseMapper.selectTrainCourseByCCode(cCode);
+    }
+
     /**
      * 批量删除课程信息
-     * 
+     *
      * @param cIds 需要删除的课程信息主键
      * @return 结果
      */
@@ -84,7 +219,7 @@ public class TrainCourseServiceImpl implements ITrainCourseService
 
     /**
      * 删除课程信息信息
-     * 
+     *
      * @param cId 课程信息主键
      * @return 结果
      */

RuoYi-Vue/ruoyi-train/src/main/resources/mapper/train/TrainCourseMapper.xml

@@ -3,99 +3,103 @@
 PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
 "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
 <mapper namespace="com.ruoyi.train.mapper.TrainCourseMapper">
-    
+
     <resultMap type="TrainCourse" id="TrainCourseResult">
         <result property="cId"    column="c_id"    />
+        <result property="cCode"    column="c_code"    />
         <result property="cName"    column="c_name"    />
         <result property="cType"    column="c_type"    />
         <result property="cDuration"    column="c_duration"    />
         <result property="teachingObjective"    column="teaching_objective"    />
         <result property="courseContent"    column="course_content"    />
-        <result property="attachDoc"    column="attach_doc"    />
-        <result property="attachVideo"    column="attach_video"    />
-        <result property="attachModelLink"    column="attach_model_link"    />
-        <result property="modelResourceIds"    column="model_resource_ids"    />
-        <result property="createUser"    column="create_user"    />
+        <result property="status"    column="status"    />
+        <result property="delFlag"    column="del_flag"    />
+        <result property="createBy"    column="create_by"    />
         <result property="createTime"    column="create_time"    />
+        <result property="updateBy"    column="update_by"    />
         <result property="updateTime"    column="update_time"    />
         <result property="remark"    column="remark"    />
     </resultMap>
 
     <sql id="selectTrainCourseVo">
-        select c_id, c_name, c_type, c_duration, teaching_objective, course_content, attach_doc, attach_video, attach_model_link, model_resource_ids, create_user, create_time, update_time, remark from train_course
+        select c_id, c_code, c_name, c_type, c_duration, teaching_objective, course_content, status, del_flag, create_by, create_time, update_by, update_time, remark from train_course
     </sql>
 
     <select id="selectTrainCourseList" parameterType="TrainCourse" resultMap="TrainCourseResult">
         <include refid="selectTrainCourseVo"/>
-        <where>  
-            <if test="cName != null  and cName != ''"> and c_name like concat('%', #{cName}, '%')</if>
-            <if test="cType != null  and cType != ''"> and c_type = #{cType}</if>
-            <if test="cDuration != null "> and c_duration = #{cDuration}</if>
-            <if test="teachingObjective != null  and teachingObjective != ''"> and teaching_objective = #{teachingObjective}</if>
-            <if test="courseContent != null  and courseContent != ''"> and course_content = #{courseContent}</if>
-            <if test="attachDoc != null  and attachDoc != ''"> and attach_doc = #{attachDoc}</if>
-            <if test="attachVideo != null  and attachVideo != ''"> and attach_video = #{attachVideo}</if>
-            <if test="attachModelLink != null  and attachModelLink != ''"> and attach_model_link = #{attachModelLink}</if>
-            <if test="modelResourceIds != null  and modelResourceIds != ''"> and model_resource_ids = #{modelResourceIds}</if>
-            <if test="createUser != null  and createUser != ''"> and create_user = #{createUser}</if>
+        <where>
+            del_flag = '0'
+            <if test="cCode != null and cCode != ''"> and c_code like concat('%', #{cCode}, '%')</if>
+            <if test="cName != null and cName != ''"> and c_name like concat('%', #{cName}, '%')</if>
+            <if test="cType != null and cType != ''"> and c_type = #{cType}</if>
+            <if test="cDuration != null"> and c_duration = #{cDuration}</if>
+            <if test="status != null"> and status = #{status}</if>
         </where>
+        order by create_time desc
     </select>
-    
+
     <select id="selectTrainCourseByCId" parameterType="String" resultMap="TrainCourseResult">
         <include refid="selectTrainCourseVo"/>
-        where c_id = #{cId}
+        where c_id = #{cId} and del_flag = '0'
+    </select>
+
+    <select id="checkCCodeUnique" parameterType="String" resultMap="TrainCourseResult">
+        <include refid="selectTrainCourseVo"/>
+        where c_code = #{cCode} and del_flag = '0' limit 1
+    </select>
+
+    <select id="selectTrainCourseByCCode" parameterType="String" resultMap="TrainCourseResult">
+        <include refid="selectTrainCourseVo"/>
+        where c_code = #{cCode} and del_flag = '0' limit 1
     </select>
 
     <insert id="insertTrainCourse" parameterType="TrainCourse">
         insert into train_course
         <trim prefix="(" suffix=")" suffixOverrides=",">
-            <if test="cId != null">c_id,</if>
+            <if test="cId != null and cId != ''">c_id,</if>
+            <if test="cCode != null and cCode != ''">c_code,</if>
             <if test="cName != null and cName != ''">c_name,</if>
-            <if test="cType != null">c_type,</if>
+            <if test="cType != null and cType != ''">c_type,</if>
             <if test="cDuration != null">c_duration,</if>
-            <if test="teachingObjective != null">teaching_objective,</if>
-            <if test="courseContent != null">course_content,</if>
-            <if test="attachDoc != null">attach_doc,</if>
-            <if test="attachVideo != null">attach_video,</if>
-            <if test="attachModelLink != null">attach_model_link,</if>
-            <if test="modelResourceIds != null">model_resource_ids,</if>
-            <if test="createUser != null and createUser != ''">create_user,</if>
+            <if test="teachingObjective != null and teachingObjective != ''">teaching_objective,</if>
+            <if test="courseContent != null and courseContent != ''">course_content,</if>
+            <if test="status != null">status,</if>
+            <if test="delFlag != null and delFlag != ''">del_flag,</if>
+            <if test="createBy != null and createBy != ''">create_by,</if>
             <if test="createTime != null">create_time,</if>
+            <if test="updateBy != null and updateBy != ''">update_by,</if>
             <if test="updateTime != null">update_time,</if>
-            <if test="remark != null">remark,</if>
+            <if test="remark != null and remark != ''">remark,</if>
          </trim>
         <trim prefix="values (" suffix=")" suffixOverrides=",">
-            <if test="cId != null">#{cId},</if>
+            <if test="cId != null and cId != ''">#{cId},</if>
+            <if test="cCode != null and cCode != ''">#{cCode},</if>
             <if test="cName != null and cName != ''">#{cName},</if>
-            <if test="cType != null">#{cType},</if>
+            <if test="cType != null and cType != ''">#{cType},</if>
             <if test="cDuration != null">#{cDuration},</if>
-            <if test="teachingObjective != null">#{teachingObjective},</if>
-            <if test="courseContent != null">#{courseContent},</if>
-            <if test="attachDoc != null">#{attachDoc},</if>
-            <if test="attachVideo != null">#{attachVideo},</if>
-            <if test="attachModelLink != null">#{attachModelLink},</if>
-            <if test="modelResourceIds != null">#{modelResourceIds},</if>
-            <if test="createUser != null and createUser != ''">#{createUser},</if>
+            <if test="teachingObjective != null and teachingObjective != ''">#{teachingObjective},</if>
+            <if test="courseContent != null and courseContent != ''">#{courseContent},</if>
+            <if test="status != null">#{status},</if>
+            <if test="delFlag != null and delFlag != ''">#{delFlag},</if>
+            <if test="createBy != null and createBy != ''">#{createBy},</if>
             <if test="createTime != null">#{createTime},</if>
+            <if test="updateBy != null and updateBy != ''">#{updateBy},</if>
             <if test="updateTime != null">#{updateTime},</if>
-            <if test="remark != null">#{remark},</if>
+            <if test="remark != null and remark != ''">#{remark},</if>
          </trim>
     </insert>
 
     <update id="updateTrainCourse" parameterType="TrainCourse">
         update train_course
         <trim prefix="SET" suffixOverrides=",">
+            <if test="cCode != null and cCode != ''">c_code = #{cCode},</if>
             <if test="cName != null and cName != ''">c_name = #{cName},</if>
             <if test="cType != null">c_type = #{cType},</if>
             <if test="cDuration != null">c_duration = #{cDuration},</if>
             <if test="teachingObjective != null">teaching_objective = #{teachingObjective},</if>
             <if test="courseContent != null">course_content = #{courseContent},</if>
-            <if test="attachDoc != null">attach_doc = #{attachDoc},</if>
-            <if test="attachVideo != null">attach_video = #{attachVideo},</if>
-            <if test="attachModelLink != null">attach_model_link = #{attachModelLink},</if>
-            <if test="modelResourceIds != null">model_resource_ids = #{modelResourceIds},</if>
-            <if test="createUser != null and createUser != ''">create_user = #{createUser},</if>
-            <if test="createTime != null">create_time = #{createTime},</if>
+            <if test="status != null">status = #{status},</if>
+            <if test="updateBy != null and updateBy != ''">update_by = #{updateBy},</if>
             <if test="updateTime != null">update_time = #{updateTime},</if>
             <if test="remark != null">remark = #{remark},</if>
         </trim>
@@ -103,13 +107,13 @@ PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
     </update>
 
     <delete id="deleteTrainCourseByCId" parameterType="String">
-        delete from train_course where c_id = #{cId}
+        update train_course set del_flag = '2' where c_id = #{cId}
     </delete>
 
     <delete id="deleteTrainCourseByCIds" parameterType="String">
-        delete from train_course where c_id in 
+        update train_course set del_flag = '2' where c_id in
         <foreach item="cId" collection="array" open="(" separator="," close=")">
             #{cId}
         </foreach>
     </delete>
-</mapper>
+</mapper>

build_ui/src/api/train/course.js

@@ -26,19 +26,11 @@ export function addCourse(data) {
   })
 }
 
-// 修改课程信息
+// 修改课程信息 (API Contract 3.4: PUT /train/course/{cId})
 export function updateCourse(data) {
   return request({
-    url: '/train/course',
+    url: '/train/course/' + data.cId,
     method: 'put',
     data: data
   })
 }
-
-// 删除课程信息
-export function delCourse(cId) {
-  return request({
-    url: '/train/course/' + cId,
-    method: 'delete'
-  })
-}

build_ui/src/views/train/course/index.vue

@@ -1,6 +1,14 @@
 <template>
   <div class="app-container">
-    <el-form :model="queryParams" ref="queryForm" size="small" :inline="true" v-show="showSearch" label-width="68px">
+    <el-form v-show="showSearch" ref="queryForm" :model="queryParams" size="small" :inline="true" label-width="68px">
+      <el-form-item label="课程编码" prop="cCode">
+        <el-input
+          v-model="queryParams.cCode"
+          placeholder="请输入课程统一业务编码"
+          clearable
+          @keyup.enter.native="handleQuery"
+        />
+      </el-form-item>
       <el-form-item label="课程名称" prop="cName">
         <el-input
           v-model="queryParams.cName"
@@ -9,21 +17,19 @@
           @keyup.enter.native="handleQuery"
         />
       </el-form-item>
-      <el-form-item label="课程时长 (分钟)" prop="cDuration">
+      <el-form-item label="课程类型" prop="cType">
         <el-input
-          v-model="queryParams.cDuration"
-          placeholder="请输入课程时长 (分钟)"
+          v-model="queryParams.cType"
+          placeholder="请输入课程类型"
           clearable
           @keyup.enter.native="handleQuery"
         />
       </el-form-item>
-      <el-form-item label="创建人 (管理员 / 教师)" prop="createUser">
-        <el-input
-          v-model="queryParams.createUser"
-          placeholder="请输入创建人 (管理员 / 教师)"
-          clearable
-          @keyup.enter.native="handleQuery"
-        />
+      <el-form-item label="状态" prop="status">
+        <el-select v-model="queryParams.status" placeholder="课程状态" clearable>
+          <el-option label="正常" :value="1" />
+          <el-option label="停用" :value="0" />
+        </el-select>
       </el-form-item>
       <el-form-item>
         <el-button type="primary" icon="el-icon-search" size="mini" @click="handleQuery">搜索</el-button>
@@ -34,79 +40,54 @@
     <el-row :gutter="10" class="mb8">
       <el-col :span="1.5">
         <el-button
+          v-hasPermi="['train:course:add']"
           type="primary"
           plain
           icon="el-icon-plus"
           size="mini"
           @click="handleAdd"
-          v-hasPermi="['train:course:add']"
         >新增</el-button>
       </el-col>
       <el-col :span="1.5">
         <el-button
+          v-hasPermi="['train:course:edit']"
           type="success"
           plain
           icon="el-icon-edit"
           size="mini"
           :disabled="single"
           @click="handleUpdate"
-          v-hasPermi="['train:course:edit']"
         >修改</el-button>
       </el-col>
-      <el-col :span="1.5">
-        <el-button
-          type="danger"
-          plain
-          icon="el-icon-delete"
-          size="mini"
-          :disabled="multiple"
-          @click="handleDelete"
-          v-hasPermi="['train:course:remove']"
-        >删除</el-button>
-      </el-col>
-      <el-col :span="1.5">
-        <el-button
-          type="warning"
-          plain
-          icon="el-icon-download"
-          size="mini"
-          @click="handleExport"
-          v-hasPermi="['train:course:export']"
-        >导出</el-button>
-      </el-col>
-      <right-toolbar :showSearch.sync="showSearch" @queryTable="getList"></right-toolbar>
+      <right-toolbar :show-search.sync="showSearch" @queryTable="getList" />
     </el-row>
 
     <el-table v-loading="loading" :data="courseList" @selection-change="handleSelectionChange">
       <el-table-column type="selection" width="55" align="center" />
-      <el-table-column label="课程编号主键" align="center" prop="cId" />
-      <el-table-column label="课程名称" align="center" prop="cName" />
-      <el-table-column label="课程类型" align="center" prop="cType" />
-      <el-table-column label="课程时长 (分钟)" align="center" prop="cDuration" />
-      <el-table-column label="教学目标" align="center" prop="teachingObjective" />
-      <el-table-column label="课程内容" align="center" prop="courseContent" />
-      <el-table-column label="配套文档，多个逗号分隔" align="center" prop="attachDoc" />
-      <el-table-column label="配套视频地址" align="center" prop="attachVideo" />
-      <el-table-column label="配套模型链接" align="center" prop="attachModelLink" />
-      <el-table-column label="关联3D设备拆解模型、实训场景资源ID，多ID逗号分隔" align="center" prop="modelResourceIds" />
-      <el-table-column label="创建人 (管理员 / 教师)" align="center" prop="createUser" />
-      <el-table-column label="备注" align="center" prop="remark" />
-      <el-table-column label="操作" align="center" class-name="small-padding fixed-width">
+      <el-table-column label="课程编码" align="center" prop="cCode" min-width="120" :show-overflow-tooltip="true" />
+      <el-table-column label="课程名称" align="center" prop="cName" min-width="140" :show-overflow-tooltip="true" />
+      <el-table-column label="课程类型" align="center" prop="cType" width="120" />
+      <el-table-column label="学时" align="center" prop="cDuration" width="80" />
+      <el-table-column label="教学目标" align="center" prop="teachingObjective" min-width="150" :show-overflow-tooltip="true" />
+      <el-table-column label="课程内容" align="center" prop="courseContent" min-width="160" :show-overflow-tooltip="true" />
+      <el-table-column label="状态" align="center" prop="status" width="90">
+        <template slot-scope="scope">
+          <el-tag :type="scope.row.status === 1 ? 'success' : 'info'">
+            {{ scope.row.status === 1 ? '正常' : '停用' }}
+          </el-tag>
+        </template>
+      </el-table-column>
+      <el-table-column label="备注" align="center" prop="remark" min-width="120" :show-overflow-tooltip="true" />
+      <el-table-column label="创建时间" align="center" prop="createTime" width="160" />
+      <el-table-column label="操作" align="center" class-name="small-padding fixed-width" width="100">
         <template slot-scope="scope">
           <el-button
+            v-hasPermi="['train:course:edit']"
             size="mini"
             type="text"
             icon="el-icon-edit"
             @click="handleUpdate(scope.row)"
-            v-hasPermi="['train:course:edit']"
           >修改</el-button>
-          <el-button
-            size="mini"
-            type="text"
-            icon="el-icon-delete"
-            @click="handleDelete(scope.row)"
-            v-hasPermi="['train:course:remove']"
-          >删除</el-button>
         </template>
       </el-table-column>
     </el-table>
@@ -120,37 +101,34 @@
     />
 
     <!-- 添加或修改课程信息对话框 -->
-    <el-dialog :title="title" :visible.sync="open" width="500px" append-to-body>
-      <el-form ref="form" :model="form" :rules="rules" label-width="80px">
-        <el-form-item label="课程名称" prop="cName">
-          <el-input v-model="form.cName" placeholder="请输入课程名称" />
+    <el-dialog :title="title" :visible.sync="open" width="600px" append-to-body>
+      <el-form ref="form" :model="form" :rules="rules" label-width="90px">
+        <el-form-item label="课程编码" prop="cCode">
+          <el-input v-model="form.cCode" placeholder="请输入课程统一业务编码 (如 KC-2026-001)" maxlength="50" />
         </el-form-item>
-        <el-form-item label="课程时长 (分钟)" prop="cDuration">
-          <el-input v-model="form.cDuration" placeholder="请输入课程时长 (分钟)" />
+        <el-form-item label="课程名称" prop="cName">
+          <el-input v-model="form.cName" placeholder="请输入课程名称" maxlength="100" />
+        </el-form-item>
+        <el-form-item label="课程类型" prop="cType">
+          <el-input v-model="form.cType" placeholder="请输入课程类型 (如 理论课/实操课)" maxlength="30" />
+        </el-form-item>
+        <el-form-item label="课程学时" prop="cDuration">
+          <el-input-number v-model="form.cDuration" :min="1" :max="9999" placeholder="请输入课程学时" style="width: 100%;" />
         </el-form-item>
         <el-form-item label="教学目标" prop="teachingObjective">
-          <el-input v-model="form.teachingObjective" type="textarea" placeholder="请输入内容" />
+          <el-input v-model="form.teachingObjective" type="textarea" :rows="3" placeholder="请输入教学目标" />
         </el-form-item>
-        <el-form-item label="课程内容">
-          <editor v-model="form.courseContent" :min-height="192"/>
+        <el-form-item label="课程内容" prop="courseContent">
+          <el-input v-model="form.courseContent" type="textarea" :rows="4" placeholder="请输入课程内容/摘要" />
         </el-form-item>
-        <el-form-item label="配套文档，多个逗号分隔" prop="attachDoc">
-          <el-input v-model="form.attachDoc" type="textarea" placeholder="请输入内容" />
-        </el-form-item>
-        <el-form-item label="配套视频地址" prop="attachVideo">
-          <el-input v-model="form.attachVideo" type="textarea" placeholder="请输入内容" />
-        </el-form-item>
-        <el-form-item label="配套模型链接" prop="attachModelLink">
-          <el-input v-model="form.attachModelLink" type="textarea" placeholder="请输入内容" />
-        </el-form-item>
-        <el-form-item label="关联3D设备拆解模型、实训场景资源ID，多ID逗号分隔" prop="modelResourceIds">
-          <el-input v-model="form.modelResourceIds" type="textarea" placeholder="请输入内容" />
-        </el-form-item>
-        <el-form-item label="创建人 (管理员 / 教师)" prop="createUser">
-          <el-input v-model="form.createUser" placeholder="请输入创建人 (管理员 / 教师)" />
+        <el-form-item label="状态" prop="status">
+          <el-radio-group v-model="form.status">
+            <el-radio :label="1">正常</el-radio>
+            <el-radio :label="0">停用</el-radio>
+          </el-radio-group>
         </el-form-item>
         <el-form-item label="备注" prop="remark">
-          <el-input v-model="form.remark" placeholder="请输入备注" />
+          <el-input v-model="form.remark" type="textarea" placeholder="请输入备注" maxlength="500" />
         </el-form-item>
       </el-form>
       <div slot="footer" class="dialog-footer">
@@ -162,11 +140,23 @@
 </template>
 
 <script>
-import { listCourse, getCourse, delCourse, addCourse, updateCourse } from "@/api/train/course"
+import { listCourse, getCourse, addCourse, updateCourse } from '@/api/train/course'
 
 export default {
-  name: "Course",
+  name: 'Course',
   data() {
+    const validateDuration = (rule, value, callback) => {
+      if (value !== undefined && value !== null && value !== '') {
+        const num = Number(value)
+        if (!Number.isInteger(num) || num <= 0) {
+          callback(new Error('课程学时必须为正整数'))
+        } else {
+          callback()
+        }
+      } else {
+        callback()
+      }
+    }
     return {
       // 遮罩层
       loading: true,
@@ -174,8 +164,6 @@ export default {
       ids: [],
       // 非单个禁用
       single: true,
-      // 非多个禁用
-      multiple: true,
       // 显示搜索条件
       showSearch: true,
       // 总条数
@@ -183,34 +171,33 @@ export default {
       // 课程信息表格数据
       courseList: [],
       // 弹出层标题
-      title: "",
+      title: '',
       // 是否显示弹出层
       open: false,
       // 查询参数
       queryParams: {
         pageNum: 1,
         pageSize: 10,
+        cCode: null,
         cName: null,
         cType: null,
-        cDuration: null,
-        teachingObjective: null,
-        courseContent: null,
-        attachDoc: null,
-        attachVideo: null,
-        attachModelLink: null,
-        modelResourceIds: null,
-        createUser: null,
+        status: null
       },
       // 表单参数
       form: {},
       // 表单校验
       rules: {
+        cCode: [
+          { required: true, message: '课程编码不能为空', trigger: 'blur' },
+          { max: 50, message: '课程编码长度不能超过50个字符', trigger: 'blur' }
+        ],
         cName: [
-          { required: true, message: "课程名称不能为空", trigger: "blur" }
-        ],
-        createUser: [
-          { required: true, message: "创建人 (管理员 / 教师)不能为空", trigger: "blur" }
+          { required: true, message: '课程名称不能为空', trigger: 'blur' },
+          { max: 100, message: '课程名称长度不能超过100个字符', trigger: 'blur' }
         ],
+        cDuration: [
+          { validator: validateDuration, trigger: 'blur' }
+        ]
       }
     }
   },
@@ -236,21 +223,16 @@ export default {
     reset() {
       this.form = {
         cId: null,
+        cCode: null,
         cName: null,
         cType: null,
         cDuration: null,
         teachingObjective: null,
         courseContent: null,
-        attachDoc: null,
-        attachVideo: null,
-        attachModelLink: null,
-        modelResourceIds: null,
-        createUser: null,
-        createTime: null,
-        updateTime: null,
+        status: 1,
         remark: null
       }
-      this.resetForm("form")
+      this.resetForm('form')
     },
     /** 搜索按钮操作 */
     handleQuery() {
@@ -259,20 +241,19 @@ export default {
     },
     /** 重置按钮操作 */
     resetQuery() {
-      this.resetForm("queryForm")
+      this.resetForm('queryForm')
       this.handleQuery()
     },
     // 多选框选中数据
     handleSelectionChange(selection) {
       this.ids = selection.map(item => item.cId)
-      this.single = selection.length!==1
-      this.multiple = !selection.length
+      this.single = selection.length !== 1
     },
     /** 新增按钮操作 */
     handleAdd() {
       this.reset()
       this.open = true
-      this.title = "添加课程信息"
+      this.title = '添加课程'
     },
     /** 修改按钮操作 */
     handleUpdate(row) {
@@ -280,45 +261,32 @@ export default {
       const cId = row.cId || this.ids
       getCourse(cId).then(response => {
         this.form = response.data
+        if (this.form.status === undefined || this.form.status === null) {
+          this.form.status = 1
+        }
         this.open = true
-        this.title = "修改课程信息"
+        this.title = '修改课程'
       })
     },
     /** 提交按钮 */
     submitForm() {
-      this.$refs["form"].validate(valid => {
+      this.$refs['form'].validate(valid => {
         if (valid) {
           if (this.form.cId != null) {
             updateCourse(this.form).then(response => {
-              this.$modal.msgSuccess("修改成功")
+              this.$modal.msgSuccess('修改成功')
               this.open = false
               this.getList()
             })
           } else {
             addCourse(this.form).then(response => {
-              this.$modal.msgSuccess("新增成功")
+              this.$modal.msgSuccess('新增成功')
               this.open = false
               this.getList()
             })
           }
         }
       })
-    },
-    /** 删除按钮操作 */
-    handleDelete(row) {
-      const cIds = row.cId || this.ids
-      this.$modal.confirm('是否确认删除课程信息编号为"' + cIds + '"的数据项？').then(function() {
-        return delCourse(cIds)
-      }).then(() => {
-        this.getList()
-        this.$modal.msgSuccess("删除成功")
-      }).catch(() => {})
-    },
-    /** 导出按钮操作 */
-    handleExport() {
-      this.download('train/course/export', {
-        ...this.queryParams
-      }, `course_${new Date().getTime()}.xlsx`)
     }
   }
 }

docs/development/issue-01-03-course.md

@@ -0,0 +1,195 @@
+# ISSUE-01-03 课程库基础资料管理 开发与验收文档 (A- / Final Cleanup 修订版)
+
+> **Issue ID:** `ISSUE-01-03`
+> **所属 Epic:** `EPIC-01 基础主数据必要集合`
+> **分支基线:** `feat/issue-01-03-course` (HEAD: `7fcaea29b8810546fd972ba0c9d366c71a357d63`)
+> **API Contract:** `api-v2-contract-v1.0.1` (commit: `4873e5f555ecfe7d1d21d313007c2c8f6f65d6b6`)
+> **Database:** Database V2 `train_course` (Kingbase ES8)
+> **责任范围:** 仅负责公共课程库基础资料管理能力，严禁跨模块/跨 Issue 越界
+
+---
+
+## 1. Issue 目标与业务定位
+
+维护铁路智慧培训基地标准公共课程库，为后续培训班引入本期课程（`ISSUE-02-02` `train_plan_course`）提供标准课程元数据与学时支持。
+
+- **业务目标：**
+  1. 维护课程统一业务编码 (`c_code`)、课程名称 (`c_name`)、课程类型 (`c_type`)、学时 (`c_duration`)、教学目标 (`teaching_objective`)、课程内容/摘要 (`course_content`) 等主数据。
+  2. 严格保障课程统一业务编码 (`c_code`) 全局唯一，防重拦截返回错误码 `40003 (COURSE_CODE_DUPLICATED)`。
+  3. 严格校验学时 (`c_duration`) 为正整数。
+  4. 支持按照课程编码、课程名称、课程类型、状态等多条件分页检索。
+- **业务模型边界：**
+  Course 是长期公共课程主数据。严禁把教师、班级计划、学员等关系直接固化在 Course 主表逻辑中。课程与培训计划之间的多对多关系由后续 `PlanCourse` 统一管理。
+- **明确不做什么：**
+  剔除历史遗留的多版本流转；剔除审批流；剔除已废弃的集中大文本附件；课程绑定/解绑教学资源与课程修改接口属于 P1。
+
+---
+
+## 2. API Contract 端点与收口状态 (P0 = 3, P1 = edit + resource binding/unbinding)
+
+严格遵从 `docs/api-v2/02_module_a_base_resource_api.md`：
+
+### 2.1 ISSUE-01-03 正式 P0 API (共 3 个)
+| 优先级 | HTTP Method | Path | 权限字符串 | 契约响应类型 | 说明 |
+|:---:|:---:|---|---|---|---|
+| **P0** | `GET` | `/train/course/list` | `train:course:list` | `TableDataInfo` | 分页查询课程库列表，默认按创建时间倒序 |
+| **P0** | `GET` | `/train/course/{cId}` | `train:course:query` | `AjaxResult<CourseDetailVO>` | 获取课程详情，聚合展示结构 |
+| **P0** | `POST` | `/train/course` | `train:course:add` | `AjaxResult` | 新增课程，编码查重与学时正整数校验 |
+
+### 2.2 正式 P1 关联 API
+| 优先级 | HTTP Method | Path | 权限字符串 | 状态与边界定位 |
+|:---:|:---:|---|---|---|
+| **P1** | `PUT` | `/train/course/{cId}` | `train:course:edit` | 【P1正式Contract保留】：已对齐 RESTful 路径，Controller 暴露该方法供前端单行修改使用 |
+| **P1** | `POST` | `/train/course/{cId}/resources` | `train:course:edit` | 【后续P1实现】：课程绑定教学资源，当前不在 ISSUE-01-03 范围 |
+| **P1** | `DELETE` | `/train/course/{cId}/resources/{resourceId}` | `train:course:edit` | 【后续P1实现】：课程解绑教学资源，当前不在 ISSUE-01-03 范围 |
+
+### 2.3 Contract 外 Endpoint 清理收口记录
+- **Contract外 DELETE (`DELETE /train/course/{cIds}`)**：**removed**。已从 `TrainCourseController` 完全删除，前端删除按钮与 `delCourse` 调用已一并移除。
+- **Contract外 export (`POST /train/course/export`)**：**removed**。已从 `TrainCourseController` 完全删除，前端导出按钮已移除。
+- **旧 PUT 无 ID 兼容路径 (`PUT /train/course`)**：**removed**。已从 `TrainCourseController` 完全删除，仅保留契约路径 `PUT /train/course/{cId}`。
+- **底层删除能力说明**：依据 `Persistence Capability != Public HTTP Contract` 原则，Mapper 与 Service 保留内部逻辑删除能力（软删除标记更新），供未来数据维护或系统级调用，但绝不在一期公共 HTTP Contract 面暴露。
+
+---
+
+## 3. 旧实现盘点与四态判断 (KEEP / MODIFY / REPLACE / DELETE)
+
+| 资产层级 | 现有路径 / 标识 | 状态 | 差异原因与处理策略 |
+|:---|:---|:---:|---|
+| **Entity** | `com.ruoyi.train.domain.TrainCourse` | **MODIFY** | 移除 5 个已弃用旧附件字段 (`attachDoc`, `attachVideo`, `attachModelLink`, `modelResourceIds`, `createUser`)；增加 `cCode`、`status`、`delFlag`。**彻底移除 resources 字段**（`TrainCourse.resources = removed`，恪守持久化实体纯洁性）。 |
+| **VO** | `com.ruoyi.train.domain.vo.CourseDetailVO` | **REPLACE/NEW** | 新建正式的 `CourseDetailVO`（`CourseDetailVO = retained`），承载详情返回数据及契约预留的 `resources` 集合。 |
+| **Mapper 接口** | `com.ruoyi.train.mapper.TrainCourseMapper` | **MODIFY** | 增加 `checkCCodeUnique(String cCode)` 和 `selectTrainCourseByCCode(String cCode)` 接口；保留内部软删除能力。 |
+| **Mapper XML** | `ruoyi-train/.../TrainCourseMapper.xml` | **MODIFY** | 移除已 DROP 的旧列；增加 `c_code`, `status`, `del_flag`, `create_by`, `update_by` 列映射；增加 `del_flag = '0'` 过滤；实现 `checkCCodeUnique` 查询与逻辑删除。 |
+| **Service 接口** | `com.ruoyi.train.service.ITrainCourseService` | **MODIFY** | 增加 `selectCourseDetailByCId(String cId)`、`checkCCodeUnique(TrainCourse course)` 声明。 |
+| **Service 实现** | `com.ruoyi.train.service.impl.TrainCourseServiceImpl` | **MODIFY** | 增强 `insertTrainCourse`：主键 32 位 UUID 自动分配、编码唯一性防重、学时正整数校验、默认 `status=1` 与 `delFlag='0'`；实现 `selectCourseDetailByCId` 组装返回 `CourseDetailVO`。 |
+| **Controller** | `TrainCourseController` | **MODIFY** | 物理 Endpoint 严格收敛至 4 个（3个P0 + 1个P1）；彻底删除 Contract 外 DELETE、export 及旧兼容 PUT；下线无用 import。 |
+| **前端 API** | `build_ui/src/api/train/course.js` | **MODIFY** | 删除 `delCourse`；保留 `listCourse`, `getCourse`, `addCourse`, `updateCourse` (指向 `PUT /train/course/{cId}`)。 |
+| **前端视图** | `build_ui/src/views/train/course/index.vue` | **MODIFY** | 彻底删除工具栏与表格操作列的“删除”和“导出”按钮；删除 `handleDelete` 和 `handleExport` 方法；严格校验课程编码必填与学时正整数；通过 ESLint 校验。 |
+
+---
+
+## 4. Generator 使用情况与并发策略 (Generator Pilot 已完成)
+
+- **策略声明：** 本 Issue Generator 策略为 `YES`。
+- **并发锁与串行规则遵从：**
+  - 技术负责人确认 Generator Infrastructure Patch 已合并入基线并正式释放：**`GENERATOR SLOT = COURSE`**。
+  - 本轮严格遵从操作纪律，**仅 Import `train_course` 单表**，严禁任何其他表。
+- **当前 Slot 状态：** **`GENERATOR SLOT = RELEASED / PILOT_COMPLETED`**。
+- **Pilot 真实执行记录：**
+  1. **待选表备份表隔离性校验：**
+     - 调用 `genTableService.selectDbTableList`，实测 `bak_v1_*` 匹配数量为 **0**，确认历史备份快照表在生成器界面中彻底不可见。
+  2. **单表严格导入：**
+     - 仅选择 `train_course` (课程信息表) 执行 `importGenTable`，成功写入 `gen_table` (生成 `table_id = 3`) 及 `gen_table_column` (共 14 列元数据)。
+  3. **主键列关键元数据核验：**
+     - 核验列：`c_id` (课程编号主键)
+     - 实测结果：`isPk = "1"`，`isIncrement = "0"`，`javaType = "String"`
+     - 结论：**PASS**，准确识别为非自增 VARCHAR(32) 字符串主键。
+  4. **代码预览与临时目录隔离：**
+     - 调用 `genTableService.previewCode(3L)`，所有生成文件被严格重定向写入临时沙箱目录：
+       `/tmp/railwaysystem-generator/issue-01-03-course/`
+     - **严禁直接覆盖现有源码**，当前工作区工程代码 100% 保持未被覆盖。
+
+---
+
+## 4.1 Generated vs Existing vs API Contract V1.0.1 三方比较与决策
+
+| 维度 / 文件 | Generated (代码生成器输出) | Existing (现有手工对齐实现) | API Contract V1.0.1 (正式契约) | 最终裁定与处理策略 |
+|:---|:---|:---|:---|:---|
+| **实体层 (Entity)**<br>`TrainCourse.java` | 包含 `cId`, `cName`, `cType`, `cDuration` (Long), `cCode`, `status`, `delFlag` 等纯表映射字段，继承 `BaseEntity`。无 `resources` 字段。 | 移除旧废弃附件字段；保留 `cId`, `cName`, `cCode`, `cType`, `cDuration` (Long), `status`, `delFlag`；**彻底移除 resources** (`TrainCourse.resources = removed`)。 | 实体与数据库表 1:1 映射。详情响应要求聚合 `resources` 集合。 | **KEEP Existing**<br>保持持久化实体与数据库表的 1:1 纯洁映射，严禁 Generator 覆盖。 |
+| **详情传输层 (VO)**<br>`CourseDetailVO.java` | **未生成** (若依生成器默认无 VO/DTO 分层机制，详情直接返回 Entity)。 | 新增 `CourseDetailVO`，明确承载详情响应及契约预留的 `resources: []` 列表。 | 课程详情响应类型必须为 `CourseDetailVO`，包含 `resources` 列表。 | **KEEP Existing**<br>架构级契约合规必需品，保留专用 VO，避免数据结构污染。 |
+| **Controller 端点**<br>`TrainCourseController.java` | Generated生成6个通用CRUD端点：<br>- `GET /system/course/list`<br>- `POST /system/course/export`<br>- `GET /system/course/{cId}`<br>- `POST /system/course`<br>- `PUT /system/course` (无ID路径)<br>- `DELETE /system/course/{cIds}` (批量物理删除) | 严格收敛至 4 个端点：<br>- `GET /train/course/list` (P0)<br>- `GET /train/course/{cId}` (P0，返回 VO)<br>- `POST /train/course` (P0，含防重校验)<br>- `PUT /train/course/{cId}` (P1，RESTful)<br>**彻底删除 DELETE 与 export**。 | 仅开放 3 个 P0 + 1 个 P1 端点；前缀为 `/train/course`；严格剔除契约外的 DELETE 与 export。 | **KEEP Existing**<br>Generated 包含严重违背契约的端点与错误路径前缀，坚决拒绝覆盖。 |
+| **Service 业务防御**<br>`TrainCourseServiceImpl.java` | 纯调用 Mapper 进行 CRUD，无业务防重逻辑，无正整数学时校验，未分配 UUID。 | - 自动分配 32 位 UUID 主键；<br>- 校验 `cCode` 唯一性，重复拦截返回 40003；<br>- 校验 `cDuration` 必须为正整数；<br>- 组装返回 `CourseDetailVO`。 | 编码重复拦截返回 `40003`；学时必须为正整数。 | **KEEP Existing**<br>Existing 承载了核心业务约束与安全防御规则，保留现有实现。 |
+| **Mapper 逻辑删除**<br>`TrainCourseMapper.xml` | 物理删除 `delete from train_course where c_id in (...)`；查询无 `del_flag = '0'` 过滤。 | 实现软删除标记更新；所有列表/详情查询均强制追加 `del_flag = '0'` 条件。 | 数据治理要求软删除防护，防止误删破坏关联培训计划。 | **KEEP Existing**<br>保留逻辑删除与防穿透过滤。 |
+| **前端 API 与视图**<br>`course.js`<br>`index.vue` | 包含 `delCourse`, `exportCourse`；页面包含删除、批量删除与导出按钮；缺少编码与学时定制校验。 | 彻底移除“删除”与“导出”按钮及对应 API；表单强制校验课程编码必填及学时正整数；通过 ESLint 校验。 | 契约收口移除删除与导出功能。 | **KEEP Existing**<br>前端已精准对齐契约并清理无用交互，保留现有实现。 |
+
+- **综合决策结论：**
+  本次 Generator Pilot 充分证明 Kingbase 代码生成器底层元数据读取、主键类型推导（`c_id` 准确推导为非自增 String 主键）及模板渲染能力已 100% 恢复正常并完全兼容。
+  但由于若依开箱即用模板缺乏契约收口、VO分层及业务防重防御，因此**坚决不覆盖现有手工精细化对齐的代码**，所有生成文件仅保留在 `/tmp/railwaysystem-generator/issue-01-03-course/` 备查。
+
+---
+
+## 5. DTO/VO 边界与 Course↔Resource 真实聚合说明
+
+1. **响应结构边界：**
+   - 课程详情的正式 Response 类型为 `CourseDetailVO`（位于 `com.ruoyi.train.domain.vo.CourseDetailVO`）。
+   - 持久化实体 `TrainCourse` 绝不承载非持久化的 `resources` 聚合字段，保持与表结构的 1:1 纯洁映射（`TrainCourse.resources = removed`）。
+   - Service 层通过 `selectCourseDetailByCId` 获取持久化实体后转换为 `CourseDetailVO` 返回给 Controller。
+2. **教学资源当前处理说明：**
+   - 根据正式 API Contract 3.2 节规定，`Response (CourseDetailVO)` 响应中包含教学资源列表集合字段。
+   - 为保证集合字段结构稳定，前端使用遍历时不发生空指针异常，`CourseDetailVO.resources` 返回 **empty list** (`Collections.emptyList()`)，而非 `null`。
+   - **真实关联状态声明：** 当前 ISSUE-01-03 未实现真实 Course↔Resource 查询；绑定/解绑及真实关联能力明确属于 P1。不得声称已经完成资源聚合。
+
+---
+
+## 6. 课程编码唯一性与错误码核对
+
+1. **数据库唯一约束：**
+   - 经只读核对 `RuoYi-Vue/sql/train/v2/005_constraints.sql` 第 24-25 行：
+     ```sql
+     ALTER TABLE train_course DROP CONSTRAINT IF EXISTS uq_course_code;
+     ALTER TABLE train_course ADD CONSTRAINT uq_course_code UNIQUE (c_code);
+     ```
+   - 结论：**YES**，Database V2 存在物理约束 `uq_course_code`，作为并发最终防线。Service 层 `checkCCodeUnique` 负责前置查重与友好提示。
+2. **错误码 40003：**
+   - 经核对 `docs/api-v2/10_permission_and_error_codes.md` 第 106 行：
+     `40003 | COURSE_CODE_DUPLICATED | 课程编码已存在 | 课程库`
+   - 结论：**来自冻结 Contract**。
+
+---
+
+## 7. 测试与构建验证
+
+### 7.1 后端 Maven 编译
+```bash
+mvn compile -DskipTests \
+  -f "/Users/wzb/Desktop/项目/RailwaySystem-worktrees/issue-01-03-course/RuoYi-Vue/pom.xml"
+```
+**结果：** `BUILD SUCCESS` (Reactor Summary 8 modules passed)
+
+### 7.2 后端 Controller 映射验证
+```bash
+git grep -nE '@(DeleteMapping|PostMapping|PutMapping)' \
+  -- RuoYi-Vue/ruoyi-admin/src/main/java/com/ruoyi/web/controller/train/TrainCourseController.java
+```
+**结果：**
+- Line 69: `@PostMapping` (`POST /train/course` 【P0】)
+- Line 92: `@PutMapping("/{cId}")` (`PUT /train/course/{cId}` 【P1】)
+确认无任何 Contract 外 Endpoint（无 DELETE，无 export，无旧路径兼容 PUT）。
+
+### 7.3 前端 ESLint 正式验证
+复用主工程配置命令：
+```bash
+cd "/Users/wzb/Desktop/项目/RailwaySystem-worktrees/issue-01-03-course/build_ui"
+
+"/Users/wzb/Desktop/项目/RailwaySystem/build_ui/node_modules/.bin/eslint" \
+  --resolve-plugins-relative-to \
+  "/Users/wzb/Desktop/项目/RailwaySystem/build_ui" \
+  --no-ignore \
+  src/api/train/course.js \
+  src/views/train/course/index.vue
+```
+**结果：**
+- 经过代码风格自动校准（单引号与组件属性顺序），命令退出码为 `0`，**PASS**（0 errors, 0 warnings）。
+
+---
+
+## 8. Acceptance Criteria 证据等级与运行时状态
+
+- **当前总体状态：** **`Runtime validation pending`**，**`Generator Pilot completed (PASS)`**。
+
+| AC 编号 | 验收项内容 | 当前证据等级 | 真实说明与验证方式 |
+|:---:|---|:---:|---|
+| **AC-01** | 正常新增课程落库并生成 32 位 c_id | **IMPLEMENTED_NOT_RUNTIME_VERIFIED** | 代码实现（自动生成 32 位 UUID、默认状态 1、删除标记 '0'）已完成，Maven 编译通过；**本轮红线绝对禁止数据库写入，等待后续正式运行时验收**。 |
+| **AC-02** | 提交重复课程编码拦截并返回 40003 | **IMPLEMENTED_NOT_RUNTIME_VERIFIED** | 代码层 Service/Controller 防重校验逻辑已实现，返回错误码 40003，底层依托 V2 `uq_course_code`；**等待后续正式运行时验收**。 |
+| **AC-03** | 学时必须为正整数 (<=0 拦截) | **STATIC_PASS** | 后端 Service/Controller 及前端表单 Validator 均已实现对 `<= 0` 学时的校验拦截，静态审查与编译通过。 |
+| **AC-04** | 课程列表分页过滤与详情契约 | **STATIC_PASS** | SQL 已实现 `del_flag = '0'` 过滤；详情接口已迁移为 `CourseDetailVO` 返回，静态审查与编译通过。 |
+
+---
+
+## 9. 数据库影响声明
+
+- **零 DDL / 零数据写入：**
+  - 未执行 `ALTER TABLE`、`DROP TABLE`、`CREATE TABLE`。
+  - 未修改 Database V2 既有结构。
+  - 未执行 `007_dicts.sql`。
+  - 未修改 `train_course` 真实业务数据。
+  - 严格保持 **零数据库写入**。