Skip to content
GitLab
Menu
Projects
Groups
Snippets
Loading...
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
Menu
Open sidebar
邬吉朋
practical_train
Commits
7ada3155
Commit
7ada3155
authored
Aug 11, 2026
by
wujipeng
Browse files
Merge remote-tracking branch 'origin/dev-v1.0' into dev-v1.0
parents
04355d28
a6e34844
Changes
23
Expand all
Show whitespace changes
Inline
Side-by-side
practical-api/practical-business-api/src/main/java/com/platform/business/model/dto/EvaluationBatchRevokeDTO.java
0 → 100644
View file @
7ada3155
package
com.platform.business.model.dto
;
import
io.swagger.annotations.ApiModelProperty
;
import
lombok.Data
;
import
java.util.List
;
/** 管理端批量撤回评价任务请求。 */
@Data
public
class
EvaluationBatchRevokeDTO
{
@ApiModelProperty
(
value
=
"待撤回任务ID列表"
,
required
=
true
)
private
List
<
String
>
taskIds
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/dto/EvaluationSubmitDTO.java
0 → 100644
View file @
7ada3155
package
com.platform.business.model.dto
;
import
io.swagger.annotations.ApiModelProperty
;
import
lombok.Data
;
/** 学员提交七个必填维度及一项选填建议。 */
@Data
public
class
EvaluationSubmitDTO
{
@ApiModelProperty
(
value
=
"教学态度:GOOD/FAIR/OK/POOR"
,
required
=
true
)
private
String
teachingAttitude
;
@ApiModelProperty
(
value
=
"教学内容:GOOD/FAIR/OK/POOR"
,
required
=
true
)
private
String
teachingContent
;
@ApiModelProperty
(
value
=
"教学方法:GOOD/FAIR/OK/POOR"
,
required
=
true
)
private
String
teachingMethod
;
@ApiModelProperty
(
value
=
"教学手段:GOOD/FAIR/OK/POOR"
,
required
=
true
)
private
String
teachingMeans
;
@ApiModelProperty
(
value
=
"讲解示范:GOOD/FAIR/OK/POOR"
,
required
=
true
)
private
String
demonstration
;
@ApiModelProperty
(
value
=
"巡回指导:GOOD/FAIR/OK/POOR"
,
required
=
true
)
private
String
guidance
;
@ApiModelProperty
(
value
=
"课时完成情况:GOOD/FAIR/OK/POOR"
,
required
=
true
)
private
String
classHourCompletion
;
@ApiModelProperty
(
"意见与建议,选填,最长1000字符"
)
private
String
comment
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/dto/EvaluationTaskCreateDTO.java
0 → 100644
View file @
7ada3155
package
com.platform.business.model.dto
;
import
io.swagger.annotations.ApiModelProperty
;
import
lombok.Data
;
/** 管理员发起学员评议任务请求。 */
@Data
public
class
EvaluationTaskCreateDTO
{
@ApiModelProperty
(
value
=
"班级课程ID(class_subject.id)"
,
required
=
true
)
private
Integer
subjectId
;
@ApiModelProperty
(
value
=
"评价截止日期/时间;日期会按当天23:59:59处理"
,
required
=
true
,
example
=
"2026-08-14"
)
private
String
deadline
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/dto/EvaluationTaskQueryDTO.java
0 → 100644
View file @
7ada3155
package
com.platform.business.model.dto
;
import
com.fasterxml.jackson.annotation.JsonFormat
;
import
io.swagger.annotations.ApiModelProperty
;
import
lombok.Data
;
import
java.util.Date
;
/**
* 评价任务分页及导出筛选条件。
*
* <p>学员端只使用 status、pageNum 和 pageSize,且服务端会强制追加当前登录学员ID;
* 管理端可使用全部条件。</p>
*/
@Data
public
class
EvaluationTaskQueryDTO
{
@ApiModelProperty
(
"课程名称,支持模糊匹配"
)
private
String
courseName
;
@ApiModelProperty
(
"班级ID"
)
private
Integer
classId
;
@ApiModelProperty
(
"授课教师用户ID"
)
private
String
teacherId
;
@ApiModelProperty
(
"上课日期范围起点"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd"
,
timezone
=
"GMT+8"
)
private
Date
startDate
;
@ApiModelProperty
(
"上课日期范围终点"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd"
,
timezone
=
"GMT+8"
)
private
Date
endDate
;
@ApiModelProperty
(
"PENDING、COMPLETED、EXPIRED、REVOKED"
)
private
String
status
;
@ApiModelProperty
(
"课程类型,例如理论或实训"
)
private
String
type
;
private
Integer
pageNum
;
private
Integer
pageSize
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/entity/EvaluationRecordEntity.java
0 → 100644
View file @
7ada3155
package
com.platform.business.model.entity
;
import
com.baomidou.mybatisplus.annotation.IdType
;
import
com.baomidou.mybatisplus.annotation.TableId
;
import
com.baomidou.mybatisplus.annotation.TableName
;
import
lombok.Data
;
import
java.util.Date
;
/**
* 单个目标学员的评价记录。
*
* <p>管理员发起任务时即为班级内每位有效学员建立一行 PENDING 记录。这样既能准确计算
* 待评/已评人数,也能确保后来转入班级的学员不会被错误加入历史任务。</p>
*/
@Data
@TableName
(
"evaluation_record"
)
public
class
EvaluationRecordEntity
{
@TableId
(
value
=
"id"
,
type
=
IdType
.
INPUT
)
private
String
id
;
private
String
taskId
;
private
String
studentId
;
/** PENDING 或 SUBMITTED;提交成功后禁止再次修改。 */
private
String
status
;
private
String
teachingAttitude
;
private
String
teachingContent
;
private
String
teachingMethod
;
private
String
teachingMeans
;
private
String
demonstration
;
private
String
guidance
;
private
String
classHourCompletion
;
/** 意见与建议,选填,最长1000字符。 */
private
String
comment
;
private
Date
submittedAt
;
private
Date
createdTime
;
private
Date
updateTime
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/entity/EvaluationTaskEntity.java
0 → 100644
View file @
7ada3155
package
com.platform.business.model.entity
;
import
com.baomidou.mybatisplus.annotation.IdType
;
import
com.baomidou.mybatisplus.annotation.TableId
;
import
com.baomidou.mybatisplus.annotation.TableName
;
import
lombok.Data
;
import
java.util.Date
;
/**
* 学员评议任务主表。
*
* <p>任务只保存课程ID和状态等过程数据;课程、班级、教师名称由查询时关联业务表获取,
* 防止同一份展示信息被重复维护。目标学员则由评价记录表在发起时形成快照。</p>
*/
@Data
@TableName
(
"evaluation_task"
)
public
class
EvaluationTaskEntity
{
/** 雪花算法字符串ID,和项目现有业务主键风格保持一致。 */
@TableId
(
value
=
"id"
,
type
=
IdType
.
INPUT
)
private
String
id
;
/** 对应一节具体课程,同一课程只能发起一个有效评价任务。 */
private
Integer
subjectId
;
/** PENDING、COMPLETED、EXPIRED、REVOKED。 */
private
String
status
;
/** 学员最晚可提交时间,精确到秒。 */
private
Date
deadline
;
/** 发起任务的管理员用户ID。 */
private
String
createdBy
;
private
Date
createdTime
;
/** 状态或其他业务字段最后更新时间。 */
private
Date
updateTime
;
/** 管理员撤回任务的时间,未撤回时为空。 */
private
Date
revokedAt
;
/** 执行撤回的管理员用户ID,未撤回时为空。 */
private
String
revokedBy
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/vo/EvaluationDimensionStatisticsVO.java
0 → 100644
View file @
7ada3155
package
com.platform.business.model.vo
;
import
lombok.Data
;
/** 管理端单个评分维度的四档数量及占比。 */
@Data
public
class
EvaluationDimensionStatisticsVO
{
/** 与提交DTO字段一致的稳定英文键。 */
private
String
dimensionKey
;
private
String
dimensionName
;
private
Integer
goodCount
;
private
Integer
fairCount
;
private
Integer
okCount
;
private
Integer
poorCount
;
private
Integer
submittedCount
;
/** GOOD=4、FAIR=3、OK=2、POOR=1计算出的平均分,暂无提交时为0。 */
private
Double
averageScore
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/vo/EvaluationRecordVO.java
0 → 100644
View file @
7ada3155
package
com.platform.business.model.vo
;
import
com.fasterxml.jackson.annotation.JsonFormat
;
import
lombok.Data
;
import
java.util.Date
;
/** 管理员查看的实名学员评价明细。 */
@Data
public
class
EvaluationRecordVO
{
private
String
id
;
private
String
taskId
;
private
String
studentId
;
private
String
studentName
;
private
String
phoneNumber
;
private
String
status
;
private
String
teachingAttitude
;
private
String
teachingContent
;
private
String
teachingMethod
;
private
String
teachingMeans
;
private
String
demonstration
;
private
String
guidance
;
private
String
classHourCompletion
;
private
String
comment
;
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
submittedAt
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/vo/EvaluationTaskDetailVO.java
0 → 100644
View file @
7ada3155
package
com.platform.business.model.vo
;
import
lombok.Data
;
import
lombok.EqualsAndHashCode
;
import
java.util.List
;
/** 管理端任务详情,包含实名评价明细和七维度汇总。 */
@Data
@EqualsAndHashCode
(
callSuper
=
true
)
public
class
EvaluationTaskDetailVO
extends
EvaluationTaskVO
{
private
List
<
EvaluationRecordVO
>
records
;
private
List
<
EvaluationDimensionStatisticsVO
>
dimensionStatistics
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/vo/EvaluationTaskVO.java
0 → 100644
View file @
7ada3155
package
com.platform.business.model.vo
;
import
com.fasterxml.jackson.annotation.JsonFormat
;
import
lombok.Data
;
import
java.util.Date
;
/** 管理端评价任务列表和任务基础详情。 */
@Data
public
class
EvaluationTaskVO
{
private
String
id
;
private
Integer
subjectId
;
private
String
courseName
;
private
Integer
classId
;
private
String
className
;
/** 原型中的课次信息,对应 class_subject.subject_times。 */
private
Integer
subjectTimes
;
private
String
teacherId
;
private
String
teacherName
;
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
courseDate
;
private
String
timeFrame
;
private
String
type
;
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
deadline
;
private
String
status
;
private
Integer
totalCount
;
private
Integer
pendingCount
;
private
Integer
submittedCount
;
/** 已评人数 / 总人数,返回0到100之间的百分比。 */
private
Double
completionRate
;
private
String
createdBy
;
private
String
creatorName
;
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
createdTime
;
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
revokedAt
;
private
String
revokedBy
;
private
String
revokerName
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/vo/StudentEvaluationTaskVO.java
0 → 100644
View file @
7ada3155
package
com.platform.business.model.vo
;
import
com.fasterxml.jackson.annotation.JsonFormat
;
import
lombok.Data
;
import
java.util.Date
;
/**
* 学员端“我的评价”列表及本人评价详情。
*
* <p>该对象不包含其他学员信息和汇总结果。已提交时仅返回当前学员自己的内容。</p>
*/
@Data
public
class
StudentEvaluationTaskVO
{
private
String
taskId
;
private
Integer
subjectId
;
private
String
courseName
;
private
String
teacherName
;
private
String
className
;
private
Integer
subjectTimes
;
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
courseDate
;
private
String
timeFrame
;
private
String
type
;
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
deadline
;
/** 任务最终状态;撤回任务不会出现在学员列表中。 */
private
String
taskStatus
;
private
String
recordStatus
;
private
String
teachingAttitude
;
private
String
teachingContent
;
private
String
teachingMethod
;
private
String
teachingMeans
;
private
String
demonstration
;
private
String
guidance
;
private
String
classHourCompletion
;
private
String
comment
;
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
submittedAt
;
}
practical-business/src/main/java/com/platform/business/constant/EvaluationConstants.java
0 → 100644
View file @
7ada3155
package
com.platform.business.constant
;
import
java.util.Arrays
;
import
java.util.Collections
;
import
java.util.HashSet
;
import
java.util.Set
;
/**
* 学员评议模块常量。
*
* <p>状态值和评分值会同时写入数据库、出现在接口报文中,因此集中定义,避免各层使用
* 不一致的大小写或中文值。数据库建表 SQL 中的字段注释也与本类保持一致。</p>
*/
public
final
class
EvaluationConstants
{
/** 任务尚可提交评价。 */
public
static
final
String
TASK_PENDING
=
"PENDING"
;
/** 任务下全部目标学员均已提交。 */
public
static
final
String
TASK_COMPLETED
=
"COMPLETED"
;
/** 到达截止时间后仍未全部完成。 */
public
static
final
String
TASK_EXPIRED
=
"EXPIRED"
;
/** 管理员主动撤回。 */
public
static
final
String
TASK_REVOKED
=
"REVOKED"
;
/** 学员尚未提交。 */
public
static
final
String
RECORD_PENDING
=
"PENDING"
;
/** 学员已提交,提交后不可修改。 */
public
static
final
String
RECORD_SUBMITTED
=
"SUBMITTED"
;
/** 原型中的四档评分值。 */
public
static
final
String
SCORE_GOOD
=
"GOOD"
;
public
static
final
String
SCORE_FAIR
=
"FAIR"
;
public
static
final
String
SCORE_OK
=
"OK"
;
public
static
final
String
SCORE_POOR
=
"POOR"
;
/** 允许写入的全部评分值,用于统一校验七个必填维度。 */
public
static
final
Set
<
String
>
ALLOWED_SCORES
=
Collections
.
unmodifiableSet
(
new
HashSet
<>(
Arrays
.
asList
(
SCORE_GOOD
,
SCORE_FAIR
,
SCORE_OK
,
SCORE_POOR
)));
/** 允许用于任务列表筛选的全部任务状态。 */
public
static
final
Set
<
String
>
ALLOWED_TASK_STATUSES
=
Collections
.
unmodifiableSet
(
new
HashSet
<>(
Arrays
.
asList
(
TASK_PENDING
,
TASK_COMPLETED
,
TASK_EXPIRED
,
TASK_REVOKED
)));
private
EvaluationConstants
()
{
}
}
practical-business/src/main/java/com/platform/business/controller/EvaluationController.java
0 → 100644
View file @
7ada3155
package
com.platform.business.controller
;
import
com.platform.business.model.dto.EvaluationBatchRevokeDTO
;
import
com.platform.business.model.dto.EvaluationSubmitDTO
;
import
com.platform.business.model.dto.EvaluationTaskCreateDTO
;
import
com.platform.business.model.dto.EvaluationTaskQueryDTO
;
import
com.platform.business.model.entity.UserEntity
;
import
com.platform.business.model.vo.EvaluationTaskDetailVO
;
import
com.platform.business.model.vo.EvaluationTaskVO
;
import
com.platform.business.model.vo.StudentEvaluationTaskVO
;
import
com.platform.business.service.AuthenticatedUserService
;
import
com.platform.business.service.EvaluationService
;
import
com.platform.controller.BaseController
;
import
com.platform.model.resp.Result
;
import
com.platform.page.TableDataInfo
;
import
io.swagger.annotations.Api
;
import
io.swagger.annotations.ApiOperation
;
import
org.springframework.web.bind.annotation.GetMapping
;
import
org.springframework.web.bind.annotation.PathVariable
;
import
org.springframework.web.bind.annotation.PostMapping
;
import
org.springframework.web.bind.annotation.PutMapping
;
import
org.springframework.web.bind.annotation.RequestBody
;
import
org.springframework.web.bind.annotation.RequestMapping
;
import
org.springframework.web.bind.annotation.RequestParam
;
import
org.springframework.web.bind.annotation.RestController
;
import
javax.annotation.Resource
;
import
javax.servlet.http.HttpServletRequest
;
import
javax.servlet.http.HttpServletResponse
;
import
java.util.List
;
/**
* 学员评议两端接口。
*
* <p>教师端没有对应原型,本控制器不提供任何教师查询入口。学员身份始终从JWT解析,客户端
* 无法通过传入studentId查看或提交他人评价;所有管理端接口均额外校验管理员角色。</p>
*/
@Api
(
tags
=
"学员评议"
)
@RestController
@RequestMapping
(
"/evaluation"
)
public
class
EvaluationController
extends
BaseController
{
@Resource
private
EvaluationService
evaluationService
;
@Resource
private
AuthenticatedUserService
authenticatedUserService
;
@ApiOperation
(
"学员端-分页查询本人的待评价、已评价和已过期任务"
)
@PostMapping
(
"/student/page"
)
public
TableDataInfo
studentPage
(
@RequestBody
(
required
=
false
)
EvaluationTaskQueryDTO
query
,
HttpServletRequest
request
)
{
UserEntity
student
=
authenticatedUserService
.
current
(
request
);
EvaluationTaskQueryDTO
safeQuery
=
query
==
null
?
new
EvaluationTaskQueryDTO
()
:
query
;
startEvaluationPage
(
safeQuery
);
return
getDataTable
(
evaluationService
.
queryStudentTasks
(
safeQuery
,
student
.
getId
()));
}
@ApiOperation
(
"学员端-查看本人评价表单或已提交内容"
)
@GetMapping
(
"/student/{taskId}"
)
public
Result
<
StudentEvaluationTaskVO
>
studentDetail
(
@PathVariable
String
taskId
,
HttpServletRequest
request
)
{
UserEntity
student
=
authenticatedUserService
.
current
(
request
);
return
Result
.
data
(
evaluationService
.
studentDetail
(
taskId
,
student
.
getId
()));
}
@ApiOperation
(
"学员端-提交评价(七个维度必填且仅可提交一次)"
)
@PostMapping
(
"/student/{taskId}/submit"
)
public
Result
<
StudentEvaluationTaskVO
>
submit
(
@PathVariable
String
taskId
,
@RequestBody
EvaluationSubmitDTO
body
,
HttpServletRequest
request
)
{
UserEntity
student
=
authenticatedUserService
.
current
(
request
);
return
Result
.
data
(
evaluationService
.
submit
(
taskId
,
body
,
student
.
getId
()));
}
@ApiOperation
(
"管理端-发起评价任务并推送给班级当前有效学员"
)
@PostMapping
(
"/admin/task"
)
public
Result
<
EvaluationTaskVO
>
createTask
(
@RequestBody
EvaluationTaskCreateDTO
body
,
HttpServletRequest
request
)
{
UserEntity
admin
=
requireAdmin
(
request
);
return
Result
.
data
(
evaluationService
.
createTask
(
body
,
admin
.
getId
(),
admin
.
getNickName
()));
}
@ApiOperation
(
"管理端-分页筛选评价任务"
)
@PostMapping
(
"/admin/page"
)
public
TableDataInfo
adminPage
(
@RequestBody
(
required
=
false
)
EvaluationTaskQueryDTO
query
,
HttpServletRequest
request
)
{
requireAdmin
(
request
);
EvaluationTaskQueryDTO
safeQuery
=
query
==
null
?
new
EvaluationTaskQueryDTO
()
:
query
;
startEvaluationPage
(
safeQuery
);
return
getDataTable
(
evaluationService
.
queryAdminTasks
(
safeQuery
));
}
@ApiOperation
(
"管理端-查看实名评价明细和七维度统计"
)
@GetMapping
(
"/admin/{taskId}"
)
public
Result
<
EvaluationTaskDetailVO
>
adminDetail
(
@PathVariable
String
taskId
,
@RequestParam
(
required
=
false
)
String
studentName
,
HttpServletRequest
request
)
{
requireAdmin
(
request
);
return
Result
.
data
(
evaluationService
.
adminDetail
(
taskId
,
studentName
));
}
@ApiOperation
(
"管理端-撤回一个待评价任务"
)
@PutMapping
(
"/admin/{taskId}/revoke"
)
public
Result
<
Boolean
>
revoke
(
@PathVariable
String
taskId
,
HttpServletRequest
request
)
{
UserEntity
admin
=
requireAdmin
(
request
);
return
Result
.
data
(
evaluationService
.
revoke
(
taskId
,
admin
.
getId
()));
}
@ApiOperation
(
"管理端-批量撤回待评价任务"
)
@PutMapping
(
"/admin/batch-revoke"
)
public
Result
<
Integer
>
batchRevoke
(
@RequestBody
EvaluationBatchRevokeDTO
body
,
HttpServletRequest
request
)
{
UserEntity
admin
=
requireAdmin
(
request
);
List
<
String
>
taskIds
=
body
==
null
?
null
:
body
.
getTaskIds
();
return
Result
.
data
(
evaluationService
.
batchRevoke
(
taskIds
,
admin
.
getId
()));
}
@ApiOperation
(
"管理端-按筛选条件导出评价任务汇总Excel"
)
@PostMapping
(
"/admin/export"
)
public
void
exportTasks
(
@RequestBody
(
required
=
false
)
EvaluationTaskQueryDTO
query
,
HttpServletRequest
request
,
HttpServletResponse
response
)
{
requireAdmin
(
request
);
evaluationService
.
exportAdminTasks
(
query
,
response
);
}
@ApiOperation
(
"管理端-导出单个任务实名明细及维度统计Excel"
)
@GetMapping
(
"/admin/{taskId}/export"
)
public
void
exportDetail
(
@PathVariable
String
taskId
,
HttpServletRequest
request
,
HttpServletResponse
response
)
{
requireAdmin
(
request
);
evaluationService
.
exportTaskDetail
(
taskId
,
response
);
}
/** 评价列表缺省第1页、每页10条,并限制异常的大页请求。 */
private
void
startEvaluationPage
(
EvaluationTaskQueryDTO
query
)
{
int
pageNum
=
query
.
getPageNum
()
==
null
||
query
.
getPageNum
()
<
1
?
1
:
query
.
getPageNum
();
int
pageSize
=
query
.
getPageSize
()
==
null
||
query
.
getPageSize
()
<
1
?
10
:
query
.
getPageSize
();
startPage
(
pageNum
,
Math
.
min
(
pageSize
,
100
));
}
/** 统一完成JWT用户解析和管理员角色校验。 */
private
UserEntity
requireAdmin
(
HttpServletRequest
request
)
{
UserEntity
user
=
authenticatedUserService
.
current
(
request
);
authenticatedUserService
.
requireAdmin
(
user
);
return
user
;
}
}
practical-business/src/main/java/com/platform/business/mapper/EvaluationRecordMapper.java
0 → 100644
View file @
7ada3155
package
com.platform.business.mapper
;
import
com.baomidou.mybatisplus.core.mapper.BaseMapper
;
import
com.platform.business.model.entity.EvaluationRecordEntity
;
import
com.platform.business.model.vo.EvaluationRecordVO
;
import
org.apache.ibatis.annotations.Mapper
;
import
org.apache.ibatis.annotations.Param
;
import
java.util.Date
;
import
java.util.List
;
/** 目标学员快照、评价提交和管理端实名明细的数据访问接口。 */
@Mapper
public
interface
EvaluationRecordMapper
extends
BaseMapper
<
EvaluationRecordEntity
>
{
/** 一次性写入一个班级的目标学员快照。 */
int
batchInsert
(
@Param
(
"records"
)
List
<
EvaluationRecordEntity
>
records
);
/** 学员提交前锁定本人的评价行,确保同一账号并发提交只有一次成功。 */
EvaluationRecordEntity
selectByTaskAndStudentForUpdate
(
@Param
(
"taskId"
)
String
taskId
,
@Param
(
"studentId"
)
String
studentId
);
/**
* 仅更新PENDING记录。虽然调用方已经持有行锁,SQL仍保留状态条件作为最后一道幂等保护。
*/
int
submitPending
(
@Param
(
"record"
)
EvaluationRecordEntity
record
,
@Param
(
"now"
)
Date
now
);
/** 管理端查询任务全部目标学员;可按姓名模糊筛选。 */
List
<
EvaluationRecordVO
>
queryTaskRecords
(
@Param
(
"taskId"
)
String
taskId
,
@Param
(
"studentName"
)
String
studentName
);
}
practical-business/src/main/java/com/platform/business/mapper/EvaluationTaskMapper.java
0 → 100644
View file @
7ada3155
package
com.platform.business.mapper
;
import
com.baomidou.mybatisplus.core.mapper.BaseMapper
;
import
com.platform.business.model.dto.EvaluationTaskQueryDTO
;
import
com.platform.business.model.entity.EvaluationTaskEntity
;
import
com.platform.business.model.vo.EvaluationTaskVO
;
import
com.platform.business.model.vo.StudentEvaluationTaskVO
;
import
org.apache.ibatis.annotations.Mapper
;
import
org.apache.ibatis.annotations.Param
;
import
java.util.Date
;
import
java.util.List
;
/** 评价任务查询、状态流转和目标学员快照的数据访问接口。 */
@Mapper
public
interface
EvaluationTaskMapper
extends
BaseMapper
<
EvaluationTaskEntity
>
{
/** 管理端按原型筛选条件查询全部任务及实时完成进度。 */
List
<
EvaluationTaskVO
>
queryAdminTasks
(
EvaluationTaskQueryDTO
query
);
/** 学员端仅查询已经分配给当前登录学员且未撤回的任务。 */
List
<
StudentEvaluationTaskVO
>
queryStudentTasks
(
@Param
(
"query"
)
EvaluationTaskQueryDTO
query
,
@Param
(
"studentId"
)
String
studentId
);
/** 查询管理端单个任务基础信息及实时人数统计。 */
EvaluationTaskVO
selectTaskView
(
@Param
(
"taskId"
)
String
taskId
);
/** 查询当前学员自己的单条任务;taskId和studentId必须同时匹配。 */
StudentEvaluationTaskVO
selectStudentTask
(
@Param
(
"taskId"
)
String
taskId
,
@Param
(
"studentId"
)
String
studentId
);
/**
* 锁定任务主记录。提交与撤回都先获取该锁,从而串行化两种互斥操作,
* 防止学员提交成功的同时管理员又把同一任务撤回。
*/
EvaluationTaskEntity
selectByIdForUpdate
(
@Param
(
"taskId"
)
String
taskId
);
/** 将已过截止时间的待评价任务批量推进为EXPIRED。 */
int
expireDueTasks
(
@Param
(
"now"
)
Date
now
);
/** 提交入口发现本任务已到期时,仅推进当前任务,避免额外扩大锁范围。 */
int
expirePendingTask
(
@Param
(
"taskId"
)
String
taskId
,
@Param
(
"now"
)
Date
now
);
/** 仅当任务仍为PENDING时撤回,返回0表示状态已被并发改变。 */
int
revokePending
(
@Param
(
"taskId"
)
String
taskId
,
@Param
(
"operatorId"
)
String
operatorId
,
@Param
(
"now"
)
Date
now
);
/** 最后一位学员提交后,把没有待评价记录的任务推进为COMPLETED。 */
int
completeIfAllSubmitted
(
@Param
(
"taskId"
)
String
taskId
,
@Param
(
"now"
)
Date
now
);
/** 发起任务时读取班级当前所有未删除学员,后续写入评价记录形成快照。 */
List
<
String
>
selectActiveStudentIdsByClassId
(
@Param
(
"classId"
)
Integer
classId
);
}
practical-business/src/main/java/com/platform/business/service/AuthenticatedUserService.java
View file @
7ada3155
...
@@ -55,7 +55,8 @@ public class AuthenticatedUserService {
...
@@ -55,7 +55,8 @@ public class AuthenticatedUserService {
List
<
SysPhoneRoleEntity
>
roles
=
phoneRoleService
.
queryByPhone
(
user
.
getPhoneNumber
());
List
<
SysPhoneRoleEntity
>
roles
=
phoneRoleService
.
queryByPhone
(
user
.
getPhoneNumber
());
boolean
admin
=
roles
!=
null
&&
roles
.
stream
().
anyMatch
(
role
->
"管理员"
.
equals
(
role
.
getRoleName
()));
boolean
admin
=
roles
!=
null
&&
roles
.
stream
().
anyMatch
(
role
->
"管理员"
.
equals
(
role
.
getRoleName
()));
if
(!
admin
)
{
if
(!
admin
)
{
throw
new
BusinessException
(
"只有管理员可以发布平台消息"
);
// 本方法同时被消息中心、请假、评议等管理端模块复用,因此使用通用权限提示。
throw
new
BusinessException
(
"只有管理员可以访问管理端接口"
);
}
}
}
}
...
...
practical-business/src/main/java/com/platform/business/service/EvaluationService.java
0 → 100644
View file @
7ada3155
package
com.platform.business.service
;
import
com.platform.business.model.dto.EvaluationSubmitDTO
;
import
com.platform.business.model.dto.EvaluationTaskCreateDTO
;
import
com.platform.business.model.dto.EvaluationTaskQueryDTO
;
import
com.platform.business.model.vo.EvaluationTaskDetailVO
;
import
com.platform.business.model.vo.EvaluationTaskVO
;
import
com.platform.business.model.vo.StudentEvaluationTaskVO
;
import
javax.servlet.http.HttpServletResponse
;
import
java.util.List
;
/** 学员端和管理端学员评议应用服务。 */
public
interface
EvaluationService
{
/** 管理员发起任务,并向本次固化的目标学员推送待评价消息。 */
EvaluationTaskVO
createTask
(
EvaluationTaskCreateDTO
request
,
String
adminId
,
String
adminName
);
/** 管理端按原型条件查询全部评价任务。 */
List
<
EvaluationTaskVO
>
queryAdminTasks
(
EvaluationTaskQueryDTO
query
);
/** 管理端查看任务实名明细;studentName为空时返回全部目标学员。 */
EvaluationTaskDetailVO
adminDetail
(
String
taskId
,
String
studentName
);
/** 管理员撤回一个仍处于待评价状态的任务。 */
boolean
revoke
(
String
taskId
,
String
adminId
);
/** 管理员以全有或全无的事务方式批量撤回待评价任务。 */
int
batchRevoke
(
List
<
String
>
taskIds
,
String
adminId
);
/** 学员端查询只分配给本人的待评价、已评价或已过期记录。 */
List
<
StudentEvaluationTaskVO
>
queryStudentTasks
(
EvaluationTaskQueryDTO
query
,
String
studentId
);
/** 学员查看本人的评价表单或已提交内容,不返回其他人的任何数据。 */
StudentEvaluationTaskVO
studentDetail
(
String
taskId
,
String
studentId
);
/** 学员一次性提交七个必填维度,成功后不可修改。 */
StudentEvaluationTaskVO
submit
(
String
taskId
,
EvaluationSubmitDTO
request
,
String
studentId
);
/** 按当前管理端筛选条件导出任务汇总Excel。 */
void
exportAdminTasks
(
EvaluationTaskQueryDTO
query
,
HttpServletResponse
response
);
/** 导出单个任务的实名评价明细和七维度统计Excel。 */
void
exportTaskDetail
(
String
taskId
,
HttpServletResponse
response
);
}
practical-business/src/main/java/com/platform/business/service/impl/EvaluationServiceImpl.java
0 → 100644
View file @
7ada3155
This diff is collapsed.
Click to expand it.
practical-business/src/main/resources/com/platform/business/mapper/EvaluationRecordMapper.xml
0 → 100644
View file @
7ada3155
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper
namespace=
"com.platform.business.mapper.EvaluationRecordMapper"
>
<insert
id=
"batchInsert"
>
insert into evaluation_record (
id, task_id, student_id, status, created_time, update_time
) values
<foreach
collection=
"records"
item=
"record"
separator=
","
>
(#{record.id}, #{record.taskId}, #{record.studentId}, #{record.status},
#{record.createdTime}, #{record.updateTime})
</foreach>
</insert>
<select
id=
"selectByTaskAndStudentForUpdate"
resultType=
"com.platform.business.model.entity.EvaluationRecordEntity"
>
select id, task_id, student_id, status,
teaching_attitude, teaching_content, teaching_method, teaching_means,
demonstration, guidance, class_hour_completion, comment,
submitted_at, created_time, update_time
from evaluation_record
where task_id = #{taskId} and student_id = #{studentId}
for update
</select>
<update
id=
"submitPending"
>
update evaluation_record
set status = 'SUBMITTED',
teaching_attitude = #{record.teachingAttitude},
teaching_content = #{record.teachingContent},
teaching_method = #{record.teachingMethod},
teaching_means = #{record.teachingMeans},
demonstration = #{record.demonstration},
guidance = #{record.guidance},
class_hour_completion = #{record.classHourCompletion},
comment = #{record.comment},
submitted_at = #{now},
update_time = #{now}
where id = #{record.id} and status = 'PENDING'
</update>
<select
id=
"queryTaskRecords"
resultType=
"com.platform.business.model.vo.EvaluationRecordVO"
>
select r.id,
r.task_id as taskId,
r.student_id as studentId,
u.nick_name as studentName,
u.phone_number as phoneNumber,
r.status,
r.teaching_attitude as teachingAttitude,
r.teaching_content as teachingContent,
r.teaching_method as teachingMethod,
r.teaching_means as teachingMeans,
r.demonstration,
r.guidance,
r.class_hour_completion as classHourCompletion,
r.comment,
r.submitted_at as submittedAt
from evaluation_record r
inner join user u on u.id = r.student_id
where r.task_id = #{taskId}
<if
test=
"studentName != null and studentName.trim() != ''"
>
and u.nick_name like concat('%', #{studentName}, '%')
</if>
order by case when r.status = 'SUBMITTED' then 0 else 1 end,
r.submitted_at desc, u.nick_name asc, r.id asc
</select>
</mapper>
practical-business/src/main/resources/com/platform/business/mapper/EvaluationTaskMapper.xml
0 → 100644
View file @
7ada3155
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper
namespace=
"com.platform.business.mapper.EvaluationTaskMapper"
>
<!-- 公共展示字段:任务自身、课程/班级/教师信息以及记录表实时统计。 -->
<sql
id=
"taskViewColumns"
>
t.id,
t.subject_id as subjectId,
cs.subject_name as courseName,
cs.class_id as classId,
c.name as className,
cs.subject_times as subjectTimes,
cs.teacher_id as teacherId,
teacher.nick_name as teacherName,
cs.date as courseDate,
cs.time_frame as timeFrame,
cs.type,
t.deadline,
t.status,
coalesce(stat.total_count, 0) as totalCount,
case when t.status = 'REVOKED' then 0
else coalesce(stat.pending_count, 0) end as pendingCount,
coalesce(stat.submitted_count, 0) as submittedCount,
case when coalesce(stat.total_count, 0) = 0 then 0
else round(stat.submitted_count * 100.0 / stat.total_count, 2) end as completionRate,
t.created_by as createdBy,
creator.nick_name as creatorName,
t.created_time as createdTime,
t.revoked_at as revokedAt,
t.revoked_by as revokedBy,
revoker.nick_name as revokerName
</sql>
<sql
id=
"taskViewJoins"
>
inner join class_subject cs on cs.id = t.subject_id
inner join class c on c.id = cs.class_id
left join user teacher on teacher.id = cs.teacher_id
left join user creator on creator.id = t.created_by
left join user revoker on revoker.id = t.revoked_by
left join (
select task_id,
count(*) as total_count,
sum(case when status = 'PENDING' then 1 else 0 end) as pending_count,
sum(case when status = 'SUBMITTED' then 1 else 0 end) as submitted_count
from evaluation_record
group by task_id
) stat on stat.task_id = t.id
</sql>
<select
id=
"queryAdminTasks"
resultType=
"com.platform.business.model.vo.EvaluationTaskVO"
>
select
<include
refid=
"taskViewColumns"
/>
from evaluation_task t
<include
refid=
"taskViewJoins"
/>
<where>
<if
test=
"courseName != null and courseName.trim() != ''"
>
and cs.subject_name like concat('%', #{courseName}, '%')
</if>
<if
test=
"classId != null"
>
and cs.class_id = #{classId}
</if>
<if
test=
"teacherId != null and teacherId.trim() != ''"
>
and cs.teacher_id = #{teacherId}
</if>
<if
test=
"startDate != null"
>
and cs.date
>
= #{startDate}
</if>
<if
test=
"endDate != null"
>
and cs.date
<
date_add(#{endDate}, interval 1 day)
</if>
<if
test=
"status != null and status.trim() != ''"
>
and t.status = #{status}
</if>
<if
test=
"type != null and type.trim() != ''"
>
and cs.type = #{type}
</if>
</where>
order by t.created_time desc, t.id desc
</select>
<select
id=
"queryStudentTasks"
resultType=
"com.platform.business.model.vo.StudentEvaluationTaskVO"
>
select t.id as taskId,
t.subject_id as subjectId,
cs.subject_name as courseName,
teacher.nick_name as teacherName,
c.name as className,
cs.subject_times as subjectTimes,
cs.date as courseDate,
cs.time_frame as timeFrame,
cs.type,
t.deadline,
t.status as taskStatus,
r.status as recordStatus,
r.teaching_attitude as teachingAttitude,
r.teaching_content as teachingContent,
r.teaching_method as teachingMethod,
r.teaching_means as teachingMeans,
r.demonstration,
r.guidance,
r.class_hour_completion as classHourCompletion,
r.comment,
r.submitted_at as submittedAt
from evaluation_record r
inner join evaluation_task t on t.id = r.task_id
inner join class_subject cs on cs.id = t.subject_id
inner join class c on c.id = cs.class_id
left join user teacher on teacher.id = cs.teacher_id
where r.student_id = #{studentId}
and t.status != 'REVOKED'
<if
test=
"query != null and query.status != null and query.status.trim() != ''"
>
<choose>
<!-- 学员端“已评价”取本人提交状态,不要求整个班级均已完成。 -->
<when
test=
"query.status == 'COMPLETED'"
>
and r.status = 'SUBMITTED'
</when>
<when
test=
"query.status == 'EXPIRED'"
>
and r.status = 'PENDING' and t.status = 'EXPIRED'
</when>
<otherwise>
and r.status = 'PENDING' and t.status = 'PENDING'
</otherwise>
</choose>
</if>
order by case when t.status = 'PENDING' and r.status = 'PENDING' then 0
when r.status = 'SUBMITTED' then 1 else 2 end,
t.deadline asc, t.created_time desc
</select>
<select
id=
"selectTaskView"
resultType=
"com.platform.business.model.vo.EvaluationTaskVO"
>
select
<include
refid=
"taskViewColumns"
/>
from evaluation_task t
<include
refid=
"taskViewJoins"
/>
where t.id = #{taskId}
</select>
<select
id=
"selectStudentTask"
resultType=
"com.platform.business.model.vo.StudentEvaluationTaskVO"
>
select t.id as taskId,
t.subject_id as subjectId,
cs.subject_name as courseName,
teacher.nick_name as teacherName,
c.name as className,
cs.subject_times as subjectTimes,
cs.date as courseDate,
cs.time_frame as timeFrame,
cs.type,
t.deadline,
t.status as taskStatus,
r.status as recordStatus,
r.teaching_attitude as teachingAttitude,
r.teaching_content as teachingContent,
r.teaching_method as teachingMethod,
r.teaching_means as teachingMeans,
r.demonstration,
r.guidance,
r.class_hour_completion as classHourCompletion,
r.comment,
r.submitted_at as submittedAt
from evaluation_record r
inner join evaluation_task t on t.id = r.task_id
inner join class_subject cs on cs.id = t.subject_id
inner join class c on c.id = cs.class_id
left join user teacher on teacher.id = cs.teacher_id
where r.task_id = #{taskId}
and r.student_id = #{studentId}
and t.status != 'REVOKED'
</select>
<select
id=
"selectByIdForUpdate"
resultType=
"com.platform.business.model.entity.EvaluationTaskEntity"
>
select id, subject_id, status, deadline, created_by, created_time, update_time, revoked_at, revoked_by
from evaluation_task
where id = #{taskId}
for update
</select>
<update
id=
"expireDueTasks"
>
update evaluation_task
set status = 'EXPIRED', update_time = #{now}
where status = 'PENDING' and deadline
<
= #{now}
</update>
<update
id=
"expirePendingTask"
>
update evaluation_task
set status = 'EXPIRED', update_time = #{now}
where id = #{taskId} and status = 'PENDING' and deadline
<
= #{now}
</update>
<update
id=
"revokePending"
>
update evaluation_task
set status = 'REVOKED', revoked_at = #{now}, revoked_by = #{operatorId}, update_time = #{now}
where id = #{taskId} and status = 'PENDING'
</update>
<update
id=
"completeIfAllSubmitted"
>
update evaluation_task t
set status = 'COMPLETED', update_time = #{now}
where t.id = #{taskId}
and t.status = 'PENDING'
and not exists (
select 1 from evaluation_record r
where r.task_id = t.id and r.status = 'PENDING'
)
</update>
<select
id=
"selectActiveStudentIdsByClassId"
resultType=
"java.lang.String"
>
select distinct cs.user_id
from class_student cs
inner join user u on u.id = cs.user_id
where cs.class_id = #{classId}
and (u.del_flag is null or u.del_flag = 0)
order by cs.user_id
</select>
</mapper>
Prev
1
2
Next
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment