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
0b2419f1
Commit
0b2419f1
authored
Aug 10, 2026
by
王蔡翾
Browse files
消息中心,消息队列和websocket,以及请假注释
parent
1ea1a030
Changes
86
Hide whitespace changes
Inline
Side-by-side
practical-api/practical-business-api/src/main/java/com/platform/business/model/dto/AttendanceCheckInDTO.java
View file @
0b2419f1
...
...
@@ -3,6 +3,7 @@ package com.platform.business.model.dto;
import
io.swagger.annotations.ApiModelProperty
;
import
lombok.Data
;
/** 学员签到请求。学员身份和客户端 IP 均由服务端从登录态及请求中获取。 */
@Data
public
class
AttendanceCheckInDTO
{
...
...
practical-api/practical-business-api/src/main/java/com/platform/business/model/dto/AttendanceQueryDTO.java
View file @
0b2419f1
...
...
@@ -6,14 +6,26 @@ import lombok.Data;
import
java.util.Date
;
/** 出勤记录与统计的通用筛选条件。 */
@Data
public
class
AttendanceQueryDTO
{
@ApiModelProperty
(
"页码,从1开始"
)
private
Integer
pageNum
;
@ApiModelProperty
(
"每页记录数"
)
private
Integer
pageSize
;
@ApiModelProperty
(
"班级ID"
)
private
Integer
classId
;
@ApiModelProperty
(
"课程排课ID"
)
private
Integer
subjectId
;
@ApiModelProperty
(
"学员用户ID;学员端由服务端强制写入当前用户ID"
)
private
String
userId
;
@ApiModelProperty
(
"出勤状态:NORMAL/LATE/ABSENT/LEAVE"
)
private
String
status
;
@JsonFormat
(
pattern
=
"yyyy-MM-dd"
,
timezone
=
"GMT+8"
)
...
...
practical-api/practical-business-api/src/main/java/com/platform/business/model/dto/AttendanceStatusUpdateDTO.java
View file @
0b2419f1
...
...
@@ -3,6 +3,7 @@ package com.platform.business.model.dto;
import
io.swagger.annotations.ApiModelProperty
;
import
lombok.Data
;
/** 教师手动确认或调整单名学员出勤状态的请求。 */
@Data
public
class
AttendanceStatusUpdateDTO
{
...
...
practical-api/practical-business-api/src/main/java/com/platform/business/model/dto/LeaveApplyDTO.java
View file @
0b2419f1
...
...
@@ -7,6 +7,7 @@ import lombok.Data;
import
java.util.Date
;
import
java.util.List
;
/** 学员新增或修改请假申请的请求。关联课程由服务端按时间重叠规则自动计算。 */
@Data
public
class
LeaveApplyDTO
{
...
...
@@ -17,16 +18,22 @@ public class LeaveApplyDTO {
private
String
leaveType
;
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
@ApiModelProperty
(
value
=
"请假开始时间,不允许早于或等于当前时间"
,
required
=
true
)
private
Date
startTime
;
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
@ApiModelProperty
(
value
=
"请假结束时间,必须晚于开始时间"
,
required
=
true
)
private
Date
endTime
;
@ApiModelProperty
(
value
=
"请假原因,10至200个字符"
,
required
=
true
)
private
String
reason
;
@ApiModelProperty
(
"紧急联系人姓名;与联系电话同时填写或同时留空"
)
private
String
emergencyContactName
;
@ApiModelProperty
(
"紧急联系人手机号;与联系人姓名同时填写或同时留空"
)
private
String
emergencyContactPhone
;
@ApiModelProperty
(
"证明材料文件ID列表;病假至少需要一个,最多10个"
)
private
List
<
Integer
>
attachmentFileIds
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/dto/LeaveQueryDTO.java
View file @
0b2419f1
package
com.platform.business.model.dto
;
import
com.fasterxml.jackson.annotation.JsonFormat
;
import
io.swagger.annotations.ApiModelProperty
;
import
lombok.Data
;
import
java.util.Date
;
/** 请假申请列表的分页及筛选条件。人员范围由对应端的控制器强制限定。 */
@Data
public
class
LeaveQueryDTO
{
@ApiModelProperty
(
"请假申请ID,主要用于详情查询"
)
private
String
id
;
@ApiModelProperty
(
"页码,从1开始"
)
private
Integer
pageNum
;
@ApiModelProperty
(
"每页记录数"
)
private
Integer
pageSize
;
@ApiModelProperty
(
"申请状态:PENDING/APPROVED/REJECTED/WITHDRAWN"
)
private
String
status
;
@ApiModelProperty
(
"请假类型:SICK/PERSONAL/OTHER"
)
private
String
leaveType
;
@ApiModelProperty
(
"学员姓名或完整手机号的模糊查询关键词"
)
private
String
keyword
;
@ApiModelProperty
(
"学员用户ID;学员端由服务端覆盖"
)
private
String
studentId
;
@ApiModelProperty
(
"教师用户ID;教师端由服务端覆盖,用于限定关联课程"
)
private
String
teacherId
;
@JsonFormat
(
pattern
=
"yyyy-MM-dd"
,
timezone
=
"GMT+8"
)
@ApiModelProperty
(
"筛选区间开始日期,与请假时间有重叠即命中"
)
private
Date
startDate
;
@JsonFormat
(
pattern
=
"yyyy-MM-dd"
,
timezone
=
"GMT+8"
)
@ApiModelProperty
(
"筛选区间结束日期,与请假时间有重叠即命中"
)
private
Date
endDate
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/dto/LeaveReviewDTO.java
View file @
0b2419f1
...
...
@@ -3,12 +3,13 @@ package com.platform.business.model.dto;
import
io.swagger.annotations.ApiModelProperty
;
import
lombok.Data
;
/** 教师或管理员审批请假申请的请求。 */
@Data
public
class
LeaveReviewDTO
{
@ApiModelProperty
(
value
=
"APPROVED/REJECTED"
,
required
=
true
)
private
String
status
;
@ApiModelProperty
(
"审批意见"
)
@ApiModelProperty
(
"审批意见
,最多1000个字符
"
)
private
String
approvalOpinion
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/dto/NotificationEventDTO.java
0 → 100644
View file @
0b2419f1
package
com.platform.business.model.dto
;
import
lombok.Data
;
import
java.util.Date
;
import
java.util.List
;
/**
* RabbitMQ中传输的稳定消息事件。
*
* <p>该对象由事务发件箱保存为JSON,发布后由持久化消费者解析。字段变更应保持向后兼容,
* 避免发件箱中尚未发布的旧报文或队列积压报文无法反序列化。</p>
*/
@Data
public
class
NotificationEventDTO
{
/** 全链路唯一事件ID,是消费者幂等的主要依据。 */
private
String
eventId
;
/** 规范化后的消息类型。 */
private
String
messageType
;
/** 消息标题。 */
private
String
title
;
/** 列表和弹窗摘要。 */
private
String
summary
;
/** 完整正文。 */
private
String
content
;
/** 发送用户ID,系统消息可为空。 */
private
String
senderId
;
/** 发送人名称快照。 */
private
String
senderName
;
/** 来源业务类型。 */
private
String
businessType
;
/** 来源业务ID。 */
private
String
businessId
;
/** 前端站内跳转地址。 */
private
String
actionUrl
;
/** NORMAL、IMPORTANT或URGENT。 */
private
String
priority
;
/** 指定用户接收范围。 */
private
List
<
String
>
recipientUserIds
;
/** 指定角色接收范围。 */
private
List
<
String
>
recipientRoleNames
;
/** 指定班级接收范围。 */
private
List
<
Integer
>
recipientClassIds
;
/** 是否包含所有有效用户。 */
private
Boolean
broadcast
;
/** 事件创建时间,最终作为消息创建时间。 */
private
Date
createdAt
;
/** 消息过期时间。 */
private
Date
expiresAt
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/dto/NotificationMessageQueryDTO.java
0 → 100644
View file @
0b2419f1
package
com.platform.business.model.dto
;
import
lombok.Data
;
/**
* 当前用户消息列表筛选条件。
*
* <p>{@code userId} 即使由客户端传入也会在控制器中被登录用户ID覆盖,防止越权读取其他用户消息。</p>
*/
@Data
public
class
NotificationMessageQueryDTO
{
/** 页码,从1开始。 */
private
Integer
pageNum
;
/** 每页数量,控制器限制最大值为100。 */
private
Integer
pageSize
;
/** ALL、READ 或 UNREAD。 */
private
String
readStatus
;
/** 可选消息类型精确筛选。 */
private
String
messageType
;
/** 标题或摘要的模糊搜索关键词。 */
private
String
keyword
;
/** 服务端注入的当前登录用户ID,客户端值不可信。 */
private
String
userId
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/dto/NotificationPublishDTO.java
0 → 100644
View file @
0b2419f1
package
com.platform.business.model.dto
;
import
com.fasterxml.jackson.annotation.JsonFormat
;
import
lombok.Data
;
import
java.util.Date
;
import
java.util.List
;
/**
* 发布消息请求。
*
* <p>接收范围取指定用户、角色、班级和全员范围的并集,并在服务端去重。
* 管理端HTTP接口和内部业务服务均可复用该命令对象。</p>
*/
@Data
public
class
NotificationPublishDTO
{
/** 可选的业务幂等ID;为空时由服务生成。业务重试时建议复用同一eventId。 */
private
String
eventId
;
/** SYSTEM、EXAM、SCORE、LEAVE、COURSE、TEACHING_PLAN。 */
private
String
messageType
;
/** 消息标题,必填且最长200字符。 */
private
String
title
;
/** 列表和弹窗预览摘要,可为空。 */
private
String
summary
;
/** 完整正文,必填。 */
private
String
content
;
/** 来源业务类型,用于审计和跳转。 */
private
String
businessType
;
/** 来源业务记录ID。 */
private
String
businessId
;
/** 前端站内跳转地址。 */
private
String
actionUrl
;
/** NORMAL、IMPORTANT、URGENT。 */
private
String
priority
;
/** 明确指定的接收用户ID集合。 */
private
List
<
String
>
recipientUserIds
;
/** phone_role.role_name,例如“管理员”“教师”“学员”。 */
private
List
<
String
>
recipientRoleNames
;
/** 接收班级ID集合,最终解析为班级内学员用户。 */
private
List
<
Integer
>
recipientClassIds
;
/** true表示发送给全部未删除用户。 */
private
Boolean
broadcast
;
/** 为空或早于当前时间时立即发布;未来时间由事务发件箱定时发布。 */
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
scheduledAt
;
/** 可选消息过期时间,过期后不再出现在列表和未读数中。 */
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
expiresAt
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/dto/NotificationPushDTO.java
0 → 100644
View file @
0b2419f1
package
com.platform.business.model.dto
;
import
lombok.Data
;
import
java.util.Date
;
import
java.util.List
;
/**
* WebSocket节点消费的轻量推送报文。
*
* <p>节点间RabbitMQ报文会暂时携带{@code userIds}用于本地寻址;发送到浏览器前会清空该字段,
* 避免向客户端暴露同批次其他接收人的用户ID。完整正文始终通过有权限校验的详情接口读取。</p>
*/
@Data
public
class
NotificationPushDTO
{
/**
* 客户端事件类型:
* NOTIFICATION表示有新消息并展示弹窗;UNREAD_COUNT_CHANGED表示消息状态发生变化。
*/
private
String
eventType
;
/** 目标节点内需要推送的用户ID,仅在服务端节点间传输。 */
private
List
<
String
>
userIds
;
/** 消息正文ID,客户端据此去重并请求详情。 */
private
String
messageId
;
/** 消息类型,用于选择弹窗图标和颜色。 */
private
String
messageType
;
/** 弹窗标题。 */
private
String
title
;
/** 弹窗预览摘要。 */
private
String
summary
;
/** 优先级,用于决定展示强度。 */
private
String
priority
;
/** 点击弹窗后的站内地址。 */
private
String
actionUrl
;
/** 消息创建时间。 */
private
Date
createdAt
;
/**
* 是否需要重新查询未读数。
* 为true时客户端调用GET /message/unread/count,而不是在本地直接加减,避免并发消息导致角标误差。
*/
private
Boolean
refreshUnreadCount
;
/**
* 引起数量刷新的操作类型:NEW_MESSAGE、MARK_READ、MARK_ALL_READ、DELETE或CLEAR_READ。
* 该字段主要用于前端决定是否同时刷新当前消息列表,以及排查多端同步链路。
*/
private
String
changeType
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/entity/ClassSubjectAttendanceEntity.java
View file @
0b2419f1
...
...
@@ -5,57 +5,65 @@ import com.baomidou.mybatisplus.annotation.TableField;
import
com.baomidou.mybatisplus.annotation.TableId
;
import
com.baomidou.mybatisplus.annotation.TableName
;
import
com.fasterxml.jackson.annotation.JsonFormat
;
import
io.swagger.annotations.ApiModelProperty
;
import
lombok.Data
;
import
java.util.Date
;
/**
* @Author: wujipeng
* @Description: TODO
* @Date: 2026/8/3 11:30
* @Version: 1.0
*/
/** 单个课程排课下,单名学员的最终出勤记录。 */
@Data
@TableName
(
"class_subject_attendance"
)
public
class
ClassSubjectAttendanceEntity
{
@TableId
(
type
=
IdType
.
ASSIGN_ID
)
@ApiModelProperty
(
"出勤记录ID"
)
private
String
id
;
@TableField
(
"subject_id"
)
@ApiModelProperty
(
"课程排课ID"
)
private
Integer
subjectId
;
@TableField
(
"user_id"
)
@ApiModelProperty
(
"学员用户ID;系统不使用学号标识人员"
)
private
String
userId
;
@TableField
(
"check_in_time"
)
@ApiModelProperty
(
"实际签到时间;缺勤、请假时为空"
)
@JsonFormat
(
pattern
=
"HH:mm"
,
timezone
=
"GMT+8"
)
private
Date
checkInTime
;
@TableField
(
"status"
)
@ApiModelProperty
(
"出勤状态:NORMAL正常、LATE迟到、ABSENT缺勤、LEAVE请假"
)
private
String
status
;
@TableField
(
"check_in_method"
)
@ApiModelProperty
(
"记录方式:IP_CODE、IP_ONLY、TEACHER、SYSTEM、LEAVE或LEGACY"
)
private
String
checkInMethod
;
@TableField
(
"check_in_ip"
)
@ApiModelProperty
(
"服务端识别到的签到客户端IP;非学员签到记录可为空"
)
private
String
checkInIp
;
@TableField
(
"teacher_confirmed"
)
@ApiModelProperty
(
"是否经过教师或审批人手动确认"
)
private
Boolean
teacherConfirmed
;
@TableField
(
"confirmed_by"
)
@ApiModelProperty
(
"确认人用户ID;自动缺勤或学员自主签到时可为空"
)
private
String
confirmedBy
;
@TableField
(
"confirmed_at"
)
@ApiModelProperty
(
"人工确认或请假审批生效时间"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
confirmedAt
;
@TableField
(
"created_time"
)
@ApiModelProperty
(
"记录创建时间"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
createdTime
;
@TableField
(
"update_time"
)
@ApiModelProperty
(
"记录最后更新时间"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
updateTime
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/entity/ClassSubjectAttendanceSessionEntity.java
View file @
0b2419f1
...
...
@@ -5,6 +5,7 @@ import com.baomidou.mybatisplus.annotation.TableField;
import
com.baomidou.mybatisplus.annotation.TableId
;
import
com.baomidou.mybatisplus.annotation.TableName
;
import
com.fasterxml.jackson.annotation.JsonFormat
;
import
io.swagger.annotations.ApiModelProperty
;
import
lombok.Data
;
import
java.util.Date
;
...
...
@@ -17,41 +18,52 @@ import java.util.Date;
public
class
ClassSubjectAttendanceSessionEntity
{
@TableId
(
type
=
IdType
.
ASSIGN_ID
)
@ApiModelProperty
(
"签到会话ID"
)
private
String
id
;
@TableField
(
"subject_id"
)
@ApiModelProperty
(
"课程排课ID;每个排课只能创建一个签到会话"
)
private
Integer
subjectId
;
@TableField
(
"teacher_id"
)
@ApiModelProperty
(
"实际点击开始上课的教师用户ID"
)
private
String
teacherId
;
@TableField
(
"verification_code"
)
@ApiModelProperty
(
"首次开始上课生成的6位数字验证码;课程结束后可为空"
)
private
String
verificationCode
;
@TableField
(
"scheduled_start_time"
)
@ApiModelProperty
(
"根据排课日期和时段计算出的计划开始时间"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
scheduledStartTime
;
@TableField
(
"scheduled_end_time"
)
@ApiModelProperty
(
"根据排课日期和时段计算出的计划结束时间"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
scheduledEndTime
;
@TableField
(
"started_at"
)
@ApiModelProperty
(
"教师首次点击开始上课的实际时间"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
startedAt
;
@TableField
(
"code_expires_at"
)
@ApiModelProperty
(
"验证码截止时间,以计划开始时间加配置分钟数计算"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
codeExpiresAt
;
@TableField
(
"status"
)
@ApiModelProperty
(
"签到会话状态:ACTIVE进行中、ENDED已结束"
)
private
String
status
;
@TableField
(
"created_time"
)
@ApiModelProperty
(
"签到会话创建时间"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
createdTime
;
@TableField
(
"update_time"
)
@ApiModelProperty
(
"签到会话最后更新时间"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
updateTime
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/entity/NotificationMessageEntity.java
0 → 100644
View file @
0b2419f1
package
com.platform.business.model.entity
;
import
com.baomidou.mybatisplus.annotation.IdType
;
import
com.baomidou.mybatisplus.annotation.TableField
;
import
com.baomidou.mybatisplus.annotation.TableId
;
import
com.baomidou.mybatisplus.annotation.TableName
;
import
com.fasterxml.jackson.annotation.JsonFormat
;
import
lombok.Data
;
import
java.util.Date
;
/**
* 消息正文实体。
*
* <p>一条业务消息只保存一份正文,面向不同用户的已读、删除和送达状态统一存放在
* {@code notification_message_recipient} 表中。这样的拆表方式可以避免广播消息重复保存正文,
* 同时保证不同端、不同用户之间的操作状态互不影响。</p>
*/
@Data
@TableName
(
"notification_message"
)
public
class
NotificationMessageEntity
{
/** 消息主键,由应用生成32位UUID。 */
@TableId
(
type
=
IdType
.
ASSIGN_ID
)
private
String
id
;
/** 业务事件唯一标识,用于RabbitMQ重复投递时的消费幂等。 */
@TableField
(
"event_id"
)
private
String
eventId
;
/** 消息类型,例如SYSTEM、EXAM、SCORE、LEAVE、COURSE。 */
@TableField
(
"message_type"
)
private
String
messageType
;
/** 消息标题,用于消息列表和实时弹窗。 */
private
String
title
;
/** 消息摘要,用于列表预览;完整内容由详情接口读取。 */
private
String
summary
;
/** 完整消息正文,允许包含换行文本,但前端渲染时仍需进行HTML转义。 */
private
String
content
;
/** 发送人用户ID;系统自动消息可以为空。 */
@TableField
(
"sender_id"
)
private
String
senderId
;
/** 发送人展示名称,保存快照以避免用户改名影响历史消息。 */
@TableField
(
"sender_name"
)
private
String
senderName
;
/** 来源业务类型,例如EXAM_PUBLISH或LEAVE_REVIEW。 */
@TableField
(
"business_type"
)
private
String
businessType
;
/** 来源业务记录ID,便于从消息跳转并追踪业务数据。 */
@TableField
(
"business_id"
)
private
String
businessId
;
/** 前端点击消息后的站内跳转地址,不应保存外部不可信URL。 */
@TableField
(
"action_url"
)
private
String
actionUrl
;
/** 优先级:NORMAL普通、IMPORTANT重要、URGENT紧急。 */
private
String
priority
;
/** 消息创建时间,也是消息中心默认排序依据。 */
@TableField
(
"created_at"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
createdAt
;
/** 可选过期时间;过期消息不会出现在用户列表和未读数中。 */
@TableField
(
"expires_at"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
expiresAt
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/entity/NotificationMessageRecipientEntity.java
0 → 100644
View file @
0b2419f1
package
com.platform.business.model.entity
;
import
com.baomidou.mybatisplus.annotation.IdType
;
import
com.baomidou.mybatisplus.annotation.TableField
;
import
com.baomidou.mybatisplus.annotation.TableId
;
import
com.baomidou.mybatisplus.annotation.TableName
;
import
com.fasterxml.jackson.annotation.JsonFormat
;
import
lombok.Data
;
import
java.util.Date
;
/**
* 单个用户的消息状态实体。
*
* <p>{@code message_id + user_id} 在数据库中具有唯一索引,既保证同一用户不会收到重复记录,
* 也使RabbitMQ的至少一次投递可以安全重放。</p>
*/
@Data
@TableName
(
"notification_message_recipient"
)
public
class
NotificationMessageRecipientEntity
{
/** 接收状态记录主键。 */
@TableId
(
type
=
IdType
.
ASSIGN_ID
)
private
String
id
;
/** 关联的消息正文ID。 */
@TableField
(
"message_id"
)
private
String
messageId
;
/** 接收用户ID,所有查询和更新都必须同时限定该字段以实施数据隔离。 */
@TableField
(
"user_id"
)
private
String
userId
;
/** 是否已读;详情接口和显式已读接口会将其设置为true。 */
@TableField
(
"read_flag"
)
private
Boolean
readFlag
;
/** 首次标记已读的时间,重复操作不会覆盖。 */
@TableField
(
"read_at"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
readAt
;
/** 用户侧逻辑删除标志,不删除公共消息正文。 */
@TableField
(
"deleted_flag"
)
private
Boolean
deletedFlag
;
/** 用户删除该消息的时间。 */
@TableField
(
"deleted_at"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
deletedAt
;
/** 消息成功提交到该用户至少一个WebSocket连接的时间。 */
@TableField
(
"delivered_at"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
deliveredAt
;
/** 用户消息记录创建时间。 */
@TableField
(
"created_at"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
createdAt
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/entity/NotificationOutboxEntity.java
0 → 100644
View file @
0b2419f1
package
com.platform.business.model.entity
;
import
com.baomidou.mybatisplus.annotation.IdType
;
import
com.baomidou.mybatisplus.annotation.TableField
;
import
com.baomidou.mybatisplus.annotation.TableId
;
import
com.baomidou.mybatisplus.annotation.TableName
;
import
lombok.Data
;
import
java.util.Date
;
/**
* 事务发件箱实体。
*
* <p>业务服务在自身数据库事务中写入本表,而不是直接发送RabbitMQ。事务提交后,后台任务抢占记录并发送;
* 这样可以避免“业务提交成功但MQ发送失败”或“MQ发送成功但业务回滚”的双写不一致问题。</p>
*/
@Data
@TableName
(
"notification_outbox"
)
public
class
NotificationOutboxEntity
{
/** 发件箱记录主键。 */
@TableId
(
type
=
IdType
.
ASSIGN_ID
)
private
String
id
;
/** 全链路事件ID,与消息正文event_id一致并具有唯一约束。 */
@TableField
(
"event_id"
)
private
String
eventId
;
/** RabbitMQ Topic路由键,例如notification.exam。 */
@TableField
(
"routing_key"
)
private
String
routingKey
;
/** 序列化后的NotificationEventDTO完整报文。 */
private
String
payload
;
/** 状态:NEW、PUBLISHING、PUBLISHED、RETRY或FAILED。 */
private
String
status
;
/** 累计发布失败次数,用于指数退避和最终失败判定。 */
@TableField
(
"retry_count"
)
private
Integer
retryCount
;
/** 计划发布时间;未来时间可实现预约通知。 */
@TableField
(
"scheduled_at"
)
private
Date
scheduledAt
;
/** 失败后的下一次允许重试时间。 */
@TableField
(
"next_retry_at"
)
private
Date
nextRetryAt
;
/** 收到RabbitMQ Publisher Confirm的时间。 */
@TableField
(
"published_at"
)
private
Date
publishedAt
;
/** 最近一次发布失败摘要,长度由服务层限制为1000字符。 */
@TableField
(
"last_error"
)
private
String
lastError
;
/** 发件箱创建时间。 */
@TableField
(
"created_at"
)
private
Date
createdAt
;
/** 状态最后更新时间,也用于恢复长时间停留在PUBLISHING的记录。 */
@TableField
(
"updated_at"
)
private
Date
updatedAt
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/entity/StudentLeaveApplicationEntity.java
View file @
0b2419f1
...
...
@@ -5,61 +5,78 @@ import com.baomidou.mybatisplus.annotation.TableField;
import
com.baomidou.mybatisplus.annotation.TableId
;
import
com.baomidou.mybatisplus.annotation.TableName
;
import
com.fasterxml.jackson.annotation.JsonFormat
;
import
io.swagger.annotations.ApiModelProperty
;
import
lombok.Data
;
import
java.util.Date
;
/** 学员请假申请主记录;审批通过后会同步生成关联课程的请假出勤记录。 */
@Data
@TableName
(
"student_leave_application"
)
public
class
StudentLeaveApplicationEntity
{
@TableId
(
type
=
IdType
.
ASSIGN_ID
)
@ApiModelProperty
(
"请假申请ID"
)
private
String
id
;
@TableField
(
"student_id"
)
@ApiModelProperty
(
"申请学员用户ID;系统不使用学号标识人员"
)
private
String
studentId
;
@TableField
(
"leave_type"
)
@ApiModelProperty
(
"请假类型:SICK病假、PERSONAL事假、OTHER其他"
)
private
String
leaveType
;
@TableField
(
"start_time"
)
@ApiModelProperty
(
"请假开始时间"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
startTime
;
@TableField
(
"end_time"
)
@ApiModelProperty
(
"请假结束时间"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
endTime
;
@TableField
(
"reason"
)
@ApiModelProperty
(
"请假原因,10至200个字符"
)
private
String
reason
;
@TableField
(
"emergency_contact_name"
)
@ApiModelProperty
(
"紧急联系人姓名,可为空"
)
private
String
emergencyContactName
;
@TableField
(
"emergency_contact_phone"
)
@ApiModelProperty
(
"紧急联系人手机号,可为空"
)
private
String
emergencyContactPhone
;
@TableField
(
"status"
)
@ApiModelProperty
(
"申请状态:PENDING待审批、APPROVED已批准、REJECTED已拒绝、WITHDRAWN已撤回"
)
private
String
status
;
@TableField
(
"approver_id"
)
@ApiModelProperty
(
"最终审批人用户ID;待审批和已撤回时为空"
)
private
String
approverId
;
@TableField
(
"approver_role"
)
@ApiModelProperty
(
"最终审批人角色:TEACHER教师、ADMIN管理员"
)
private
String
approverRole
;
@TableField
(
"approval_opinion"
)
@ApiModelProperty
(
"审批意见,最多1000个字符"
)
private
String
approvalOpinion
;
@TableField
(
"applied_at"
)
@ApiModelProperty
(
"申请提交时间"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
appliedAt
;
@TableField
(
"reviewed_at"
)
@ApiModelProperty
(
"批准或拒绝时间"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
reviewedAt
;
@TableField
(
"updated_at"
)
@ApiModelProperty
(
"申请最后更新时间;修改或撤回时同步更新"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
updatedAt
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/entity/StudentLeaveAttachmentEntity.java
View file @
0b2419f1
...
...
@@ -4,23 +4,29 @@ import com.baomidou.mybatisplus.annotation.IdType;
import
com.baomidou.mybatisplus.annotation.TableField
;
import
com.baomidou.mybatisplus.annotation.TableId
;
import
com.baomidou.mybatisplus.annotation.TableName
;
import
io.swagger.annotations.ApiModelProperty
;
import
lombok.Data
;
import
java.util.Date
;
/** 请假申请与已上传证明材料之间的关联记录。 */
@Data
@TableName
(
"student_leave_attachment"
)
public
class
StudentLeaveAttachmentEntity
{
@TableId
(
type
=
IdType
.
ASSIGN_ID
)
@ApiModelProperty
(
"请假附件关联ID"
)
private
String
id
;
@TableField
(
"leave_id"
)
@ApiModelProperty
(
"请假申请ID"
)
private
String
leaveId
;
@TableField
(
"file_id"
)
@ApiModelProperty
(
"文件表bs_file中的文件ID"
)
private
Integer
fileId
;
@TableField
(
"created_time"
)
@ApiModelProperty
(
"附件关联创建时间"
)
private
Date
createdTime
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/entity/StudentLeaveSubjectEntity.java
View file @
0b2419f1
...
...
@@ -5,24 +5,30 @@ import com.baomidou.mybatisplus.annotation.TableField;
import
com.baomidou.mybatisplus.annotation.TableId
;
import
com.baomidou.mybatisplus.annotation.TableName
;
import
com.fasterxml.jackson.annotation.JsonFormat
;
import
io.swagger.annotations.ApiModelProperty
;
import
lombok.Data
;
import
java.util.Date
;
/** 请假申请与按时间重叠规则自动匹配课程之间的关联记录。 */
@Data
@TableName
(
"student_leave_subject"
)
public
class
StudentLeaveSubjectEntity
{
@TableId
(
type
=
IdType
.
ASSIGN_ID
)
@ApiModelProperty
(
"请假课程关联ID"
)
private
String
id
;
@TableField
(
"leave_id"
)
@ApiModelProperty
(
"请假申请ID"
)
private
String
leaveId
;
@TableField
(
"subject_id"
)
@ApiModelProperty
(
"关联的课程排课ID"
)
private
Integer
subjectId
;
@TableField
(
"created_time"
)
@ApiModelProperty
(
"课程关联创建时间"
)
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
createdTime
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/vo/AttendanceCourseStatisticsVO.java
View file @
0b2419f1
...
...
@@ -6,22 +6,38 @@ import lombok.Data;
import
java.math.BigDecimal
;
import
java.util.Date
;
/** 管理端按课程维度汇总的出勤统计。 */
@Data
public
class
AttendanceCourseStatisticsVO
{
/** 课程排课ID。 */
private
Integer
subjectId
;
/** 课程名称。 */
private
String
subjectName
;
/** 所属班级ID。 */
private
Integer
classId
;
/** 所属班级名称。 */
private
String
className
;
/** 授课教师用户ID。 */
private
String
teacherId
;
/** 授课教师姓名。 */
private
String
teacherName
;
/** 授课教师完整手机号。 */
private
String
teacherPhone
;
/** 课程日期。 */
@JsonFormat
(
pattern
=
"yyyy-MM-dd"
,
timezone
=
"GMT+8"
)
private
Date
subjectDate
;
/** 排课时段原始文本,例如09:00-12:00。 */
private
String
timeFrame
;
/** 应出勤人次,包含正常、迟到、缺勤和请假。 */
private
long
requiredCount
;
/** 正常签到人次。 */
private
long
normalCount
;
/** 迟到签到人次。 */
private
long
lateCount
;
/** 未签到并在课程结束后转为缺勤的人次。 */
private
long
absentCount
;
/** 已批准请假人次;统计出勤率时不计为出勤。 */
private
long
leaveCount
;
/** 出勤率百分比:(正常+迟到)/应出勤×100。 */
private
BigDecimal
attendanceRate
;
}
practical-api/practical-business-api/src/main/java/com/platform/business/model/vo/AttendanceRecordVO.java
View file @
0b2419f1
...
...
@@ -5,29 +5,49 @@ import lombok.Data;
import
java.util.Date
;
/** 三端共用的出勤记录展示对象,手机号均按完整号码返回。 */
@Data
public
class
AttendanceRecordVO
{
/** 出勤记录ID;课程尚未产生记录时可为空。 */
private
String
id
;
/** 课程排课ID。 */
private
Integer
subjectId
;
/** 课程名称。 */
private
String
subjectName
;
/** 班级ID。 */
private
Integer
classId
;
/** 班级名称。 */
private
String
className
;
/** 学员用户ID。 */
private
String
studentId
;
/** 学员姓名。 */
private
String
studentName
;
/** 学员完整手机号,替代学号展示。 */
private
String
studentPhone
;
/** 授课教师用户ID。 */
private
String
teacherId
;
/** 授课教师姓名。 */
private
String
teacherName
;
/** 授课教师完整手机号,替代教师号展示。 */
private
String
teacherPhone
;
/** 出勤状态:PENDING/NORMAL/LATE/ABSENT/LEAVE。 */
private
String
status
;
/** 记录方式:IP_CODE/IP_ONLY/TEACHER/SYSTEM/LEAVE/LEGACY。 */
private
String
checkInMethod
;
/** 学员签到时由服务端识别的客户端IP。 */
private
String
checkInIp
;
/** 是否经过教师或审批人确认。 */
private
Boolean
teacherConfirmed
;
/** 课程日期。 */
@JsonFormat
(
pattern
=
"yyyy-MM-dd"
,
timezone
=
"GMT+8"
)
private
Date
subjectDate
;
/** 排课时段原始文本。 */
private
String
timeFrame
;
/** 实际签到时间;缺勤、请假或待签到时为空。 */
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
checkInTime
;
/** 教师调整或请假审批确认时间。 */
@JsonFormat
(
pattern
=
"yyyy-MM-dd HH:mm:ss"
,
timezone
=
"GMT+8"
)
private
Date
confirmedAt
;
}
Prev
1
2
3
4
5
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