"...java/com/git@gitlab.ruzhoukj.com:wujipeng/integration.git" did not exist on "42f628f311eddbd1ebfd93ec0913d5febdf10440"
Commit 6c687b75 authored by wujipeng's avatar wujipeng
Browse files

Merge remote-tracking branch 'origin/dev-v1.0' into dev-v1.0

parents 26d3f71b 6aa0dc38
...@@ -3,6 +3,7 @@ package com.platform.business.model.dto; ...@@ -3,6 +3,7 @@ package com.platform.business.model.dto;
import io.swagger.annotations.ApiModelProperty; import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
/** 学员签到请求。学员身份和客户端 IP 均由服务端从登录态及请求中获取。 */
@Data @Data
public class AttendanceCheckInDTO { public class AttendanceCheckInDTO {
......
...@@ -6,14 +6,26 @@ import lombok.Data; ...@@ -6,14 +6,26 @@ import lombok.Data;
import java.util.Date; import java.util.Date;
/** 出勤记录与统计的通用筛选条件。 */
@Data @Data
public class AttendanceQueryDTO { public class AttendanceQueryDTO {
@ApiModelProperty("页码,从1开始")
private Integer pageNum; private Integer pageNum;
@ApiModelProperty("每页记录数")
private Integer pageSize; private Integer pageSize;
@ApiModelProperty("班级ID")
private Integer classId; private Integer classId;
@ApiModelProperty("课程排课ID")
private Integer subjectId; private Integer subjectId;
@ApiModelProperty("学员用户ID;学员端由服务端强制写入当前用户ID")
private String userId; private String userId;
@ApiModelProperty("出勤状态:NORMAL/LATE/ABSENT/LEAVE")
private String status; private String status;
@JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
......
...@@ -3,6 +3,7 @@ package com.platform.business.model.dto; ...@@ -3,6 +3,7 @@ package com.platform.business.model.dto;
import io.swagger.annotations.ApiModelProperty; import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
/** 教师手动确认或调整单名学员出勤状态的请求。 */
@Data @Data
public class AttendanceStatusUpdateDTO { public class AttendanceStatusUpdateDTO {
......
...@@ -7,6 +7,7 @@ import lombok.Data; ...@@ -7,6 +7,7 @@ import lombok.Data;
import java.util.Date; import java.util.Date;
import java.util.List; import java.util.List;
/** 学员新增或修改请假申请的请求。关联课程由服务端按时间重叠规则自动计算。 */
@Data @Data
public class LeaveApplyDTO { public class LeaveApplyDTO {
...@@ -17,16 +18,22 @@ public class LeaveApplyDTO { ...@@ -17,16 +18,22 @@ public class LeaveApplyDTO {
private String leaveType; private String leaveType;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
@ApiModelProperty(value = "请假开始时间,不允许早于或等于当前时间", required = true)
private Date startTime; private Date startTime;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
@ApiModelProperty(value = "请假结束时间,必须晚于开始时间", required = true)
private Date endTime; private Date endTime;
@ApiModelProperty(value = "请假原因,10至200个字符", required = true)
private String reason; private String reason;
@ApiModelProperty("紧急联系人姓名;与联系电话同时填写或同时留空")
private String emergencyContactName; private String emergencyContactName;
@ApiModelProperty("紧急联系人手机号;与联系人姓名同时填写或同时留空")
private String emergencyContactPhone; private String emergencyContactPhone;
@ApiModelProperty("证明材料文件ID列表;病假至少需要一个,最多10个")
private List<Integer> attachmentFileIds; private List<Integer> attachmentFileIds;
} }
package com.platform.business.model.dto; package com.platform.business.model.dto;
import com.fasterxml.jackson.annotation.JsonFormat; import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
import java.util.Date; import java.util.Date;
/** 请假申请列表的分页及筛选条件。人员范围由对应端的控制器强制限定。 */
@Data @Data
public class LeaveQueryDTO { public class LeaveQueryDTO {
@ApiModelProperty("请假申请ID,主要用于详情查询")
private String id; private String id;
@ApiModelProperty("页码,从1开始")
private Integer pageNum; private Integer pageNum;
@ApiModelProperty("每页记录数")
private Integer pageSize; private Integer pageSize;
@ApiModelProperty("申请状态:PENDING/APPROVED/REJECTED/WITHDRAWN")
private String status; private String status;
@ApiModelProperty("请假类型:SICK/PERSONAL/OTHER")
private String leaveType; private String leaveType;
@ApiModelProperty("学员姓名或完整手机号的模糊查询关键词")
private String keyword; private String keyword;
@ApiModelProperty("学员用户ID;学员端由服务端覆盖")
private String studentId; private String studentId;
@ApiModelProperty("教师用户ID;教师端由服务端覆盖,用于限定关联课程")
private String teacherId; private String teacherId;
@JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
@ApiModelProperty("筛选区间开始日期,与请假时间有重叠即命中")
private Date startDate; private Date startDate;
@JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
@ApiModelProperty("筛选区间结束日期,与请假时间有重叠即命中")
private Date endDate; private Date endDate;
} }
...@@ -3,12 +3,13 @@ package com.platform.business.model.dto; ...@@ -3,12 +3,13 @@ package com.platform.business.model.dto;
import io.swagger.annotations.ApiModelProperty; import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
/** 教师或管理员审批请假申请的请求。 */
@Data @Data
public class LeaveReviewDTO { public class LeaveReviewDTO {
@ApiModelProperty(value = "APPROVED/REJECTED", required = true) @ApiModelProperty(value = "APPROVED/REJECTED", required = true)
private String status; private String status;
@ApiModelProperty("审批意见") @ApiModelProperty("审批意见,最多1000个字符")
private String approvalOpinion; private String approvalOpinion;
} }
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;
}
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;
}
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;
}
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;
}
...@@ -5,57 +5,65 @@ import com.baomidou.mybatisplus.annotation.TableField; ...@@ -5,57 +5,65 @@ import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId; import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName; import com.baomidou.mybatisplus.annotation.TableName;
import com.fasterxml.jackson.annotation.JsonFormat; import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
import java.util.Date; import java.util.Date;
/** /** 单个课程排课下,单名学员的最终出勤记录。 */
* @Author: wujipeng
* @Description: TODO
* @Date: 2026/8/3 11:30
* @Version: 1.0
*/
@Data @Data
@TableName("class_subject_attendance") @TableName("class_subject_attendance")
public class ClassSubjectAttendanceEntity { public class ClassSubjectAttendanceEntity {
@TableId(type = IdType.ASSIGN_ID) @TableId(type = IdType.ASSIGN_ID)
@ApiModelProperty("出勤记录ID")
private String id; private String id;
@TableField("subject_id") @TableField("subject_id")
@ApiModelProperty("课程排课ID")
private Integer subjectId; private Integer subjectId;
@TableField("user_id") @TableField("user_id")
@ApiModelProperty("学员用户ID;系统不使用学号标识人员")
private String userId; private String userId;
@TableField("check_in_time") @TableField("check_in_time")
@ApiModelProperty("实际签到时间;缺勤、请假时为空")
@JsonFormat(pattern = "HH:mm", timezone = "GMT+8") @JsonFormat(pattern = "HH:mm", timezone = "GMT+8")
private Date checkInTime; private Date checkInTime;
@TableField("status") @TableField("status")
@ApiModelProperty("出勤状态:NORMAL正常、LATE迟到、ABSENT缺勤、LEAVE请假")
private String status; private String status;
@TableField("check_in_method") @TableField("check_in_method")
@ApiModelProperty("记录方式:IP_CODE、IP_ONLY、TEACHER、SYSTEM、LEAVE或LEGACY")
private String checkInMethod; private String checkInMethod;
@TableField("check_in_ip") @TableField("check_in_ip")
@ApiModelProperty("服务端识别到的签到客户端IP;非学员签到记录可为空")
private String checkInIp; private String checkInIp;
@TableField("teacher_confirmed") @TableField("teacher_confirmed")
@ApiModelProperty("是否经过教师或审批人手动确认")
private Boolean teacherConfirmed; private Boolean teacherConfirmed;
@TableField("confirmed_by") @TableField("confirmed_by")
@ApiModelProperty("确认人用户ID;自动缺勤或学员自主签到时可为空")
private String confirmedBy; private String confirmedBy;
@TableField("confirmed_at") @TableField("confirmed_at")
@ApiModelProperty("人工确认或请假审批生效时间")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date confirmedAt; private Date confirmedAt;
@TableField("created_time") @TableField("created_time")
@ApiModelProperty("记录创建时间")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date createdTime; private Date createdTime;
@TableField("update_time") @TableField("update_time")
@ApiModelProperty("记录最后更新时间")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date updateTime; private Date updateTime;
} }
...@@ -5,6 +5,7 @@ import com.baomidou.mybatisplus.annotation.TableField; ...@@ -5,6 +5,7 @@ import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId; import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName; import com.baomidou.mybatisplus.annotation.TableName;
import com.fasterxml.jackson.annotation.JsonFormat; import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
import java.util.Date; import java.util.Date;
...@@ -17,41 +18,52 @@ import java.util.Date; ...@@ -17,41 +18,52 @@ import java.util.Date;
public class ClassSubjectAttendanceSessionEntity { public class ClassSubjectAttendanceSessionEntity {
@TableId(type = IdType.ASSIGN_ID) @TableId(type = IdType.ASSIGN_ID)
@ApiModelProperty("签到会话ID")
private String id; private String id;
@TableField("subject_id") @TableField("subject_id")
@ApiModelProperty("课程排课ID;每个排课只能创建一个签到会话")
private Integer subjectId; private Integer subjectId;
@TableField("teacher_id") @TableField("teacher_id")
@ApiModelProperty("实际点击开始上课的教师用户ID")
private String teacherId; private String teacherId;
@TableField("verification_code") @TableField("verification_code")
@ApiModelProperty("首次开始上课生成的6位数字验证码;课程结束后可为空")
private String verificationCode; private String verificationCode;
@TableField("scheduled_start_time") @TableField("scheduled_start_time")
@ApiModelProperty("根据排课日期和时段计算出的计划开始时间")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date scheduledStartTime; private Date scheduledStartTime;
@TableField("scheduled_end_time") @TableField("scheduled_end_time")
@ApiModelProperty("根据排课日期和时段计算出的计划结束时间")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date scheduledEndTime; private Date scheduledEndTime;
@TableField("started_at") @TableField("started_at")
@ApiModelProperty("教师首次点击开始上课的实际时间")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date startedAt; private Date startedAt;
@TableField("code_expires_at") @TableField("code_expires_at")
@ApiModelProperty("验证码截止时间,以计划开始时间加配置分钟数计算")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date codeExpiresAt; private Date codeExpiresAt;
@TableField("status") @TableField("status")
@ApiModelProperty("签到会话状态:ACTIVE进行中、ENDED已结束")
private String status; private String status;
@TableField("created_time") @TableField("created_time")
@ApiModelProperty("签到会话创建时间")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date createdTime; private Date createdTime;
@TableField("update_time") @TableField("update_time")
@ApiModelProperty("签到会话最后更新时间")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date updateTime; private Date updateTime;
} }
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;
}
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;
}
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;
}
...@@ -5,61 +5,78 @@ import com.baomidou.mybatisplus.annotation.TableField; ...@@ -5,61 +5,78 @@ import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId; import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName; import com.baomidou.mybatisplus.annotation.TableName;
import com.fasterxml.jackson.annotation.JsonFormat; import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
import java.util.Date; import java.util.Date;
/** 学员请假申请主记录;审批通过后会同步生成关联课程的请假出勤记录。 */
@Data @Data
@TableName("student_leave_application") @TableName("student_leave_application")
public class StudentLeaveApplicationEntity { public class StudentLeaveApplicationEntity {
@TableId(type = IdType.ASSIGN_ID) @TableId(type = IdType.ASSIGN_ID)
@ApiModelProperty("请假申请ID")
private String id; private String id;
@TableField("student_id") @TableField("student_id")
@ApiModelProperty("申请学员用户ID;系统不使用学号标识人员")
private String studentId; private String studentId;
@TableField("leave_type") @TableField("leave_type")
@ApiModelProperty("请假类型:SICK病假、PERSONAL事假、OTHER其他")
private String leaveType; private String leaveType;
@TableField("start_time") @TableField("start_time")
@ApiModelProperty("请假开始时间")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date startTime; private Date startTime;
@TableField("end_time") @TableField("end_time")
@ApiModelProperty("请假结束时间")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date endTime; private Date endTime;
@TableField("reason") @TableField("reason")
@ApiModelProperty("请假原因,10至200个字符")
private String reason; private String reason;
@TableField("emergency_contact_name") @TableField("emergency_contact_name")
@ApiModelProperty("紧急联系人姓名,可为空")
private String emergencyContactName; private String emergencyContactName;
@TableField("emergency_contact_phone") @TableField("emergency_contact_phone")
@ApiModelProperty("紧急联系人手机号,可为空")
private String emergencyContactPhone; private String emergencyContactPhone;
@TableField("status") @TableField("status")
@ApiModelProperty("申请状态:PENDING待审批、APPROVED已批准、REJECTED已拒绝、WITHDRAWN已撤回")
private String status; private String status;
@TableField("approver_id") @TableField("approver_id")
@ApiModelProperty("最终审批人用户ID;待审批和已撤回时为空")
private String approverId; private String approverId;
@TableField("approver_role") @TableField("approver_role")
@ApiModelProperty("最终审批人角色:TEACHER教师、ADMIN管理员")
private String approverRole; private String approverRole;
@TableField("approval_opinion") @TableField("approval_opinion")
@ApiModelProperty("审批意见,最多1000个字符")
private String approvalOpinion; private String approvalOpinion;
@TableField("applied_at") @TableField("applied_at")
@ApiModelProperty("申请提交时间")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date appliedAt; private Date appliedAt;
@TableField("reviewed_at") @TableField("reviewed_at")
@ApiModelProperty("批准或拒绝时间")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date reviewedAt; private Date reviewedAt;
@TableField("updated_at") @TableField("updated_at")
@ApiModelProperty("申请最后更新时间;修改或撤回时同步更新")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date updatedAt; private Date updatedAt;
} }
...@@ -4,23 +4,29 @@ import com.baomidou.mybatisplus.annotation.IdType; ...@@ -4,23 +4,29 @@ import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField; import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId; import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName; import com.baomidou.mybatisplus.annotation.TableName;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
import java.util.Date; import java.util.Date;
/** 请假申请与已上传证明材料之间的关联记录。 */
@Data @Data
@TableName("student_leave_attachment") @TableName("student_leave_attachment")
public class StudentLeaveAttachmentEntity { public class StudentLeaveAttachmentEntity {
@TableId(type = IdType.ASSIGN_ID) @TableId(type = IdType.ASSIGN_ID)
@ApiModelProperty("请假附件关联ID")
private String id; private String id;
@TableField("leave_id") @TableField("leave_id")
@ApiModelProperty("请假申请ID")
private String leaveId; private String leaveId;
@TableField("file_id") @TableField("file_id")
@ApiModelProperty("文件表bs_file中的文件ID")
private Integer fileId; private Integer fileId;
@TableField("created_time") @TableField("created_time")
@ApiModelProperty("附件关联创建时间")
private Date createdTime; private Date createdTime;
} }
...@@ -5,24 +5,30 @@ import com.baomidou.mybatisplus.annotation.TableField; ...@@ -5,24 +5,30 @@ import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId; import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName; import com.baomidou.mybatisplus.annotation.TableName;
import com.fasterxml.jackson.annotation.JsonFormat; import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
import java.util.Date; import java.util.Date;
/** 请假申请与按时间重叠规则自动匹配课程之间的关联记录。 */
@Data @Data
@TableName("student_leave_subject") @TableName("student_leave_subject")
public class StudentLeaveSubjectEntity { public class StudentLeaveSubjectEntity {
@TableId(type = IdType.ASSIGN_ID) @TableId(type = IdType.ASSIGN_ID)
@ApiModelProperty("请假课程关联ID")
private String id; private String id;
@TableField("leave_id") @TableField("leave_id")
@ApiModelProperty("请假申请ID")
private String leaveId; private String leaveId;
@TableField("subject_id") @TableField("subject_id")
@ApiModelProperty("关联的课程排课ID")
private Integer subjectId; private Integer subjectId;
@TableField("created_time") @TableField("created_time")
@ApiModelProperty("课程关联创建时间")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date createdTime; private Date createdTime;
} }
...@@ -6,22 +6,38 @@ import lombok.Data; ...@@ -6,22 +6,38 @@ import lombok.Data;
import java.math.BigDecimal; import java.math.BigDecimal;
import java.util.Date; import java.util.Date;
/** 管理端按课程维度汇总的出勤统计。 */
@Data @Data
public class AttendanceCourseStatisticsVO { public class AttendanceCourseStatisticsVO {
/** 课程排课ID。 */
private Integer subjectId; private Integer subjectId;
/** 课程名称。 */
private String subjectName; private String subjectName;
/** 所属班级ID。 */
private Integer classId; private Integer classId;
/** 所属班级名称。 */
private String className; private String className;
/** 授课教师用户ID。 */
private String teacherId; private String teacherId;
/** 授课教师姓名。 */
private String teacherName; private String teacherName;
/** 授课教师完整手机号。 */
private String teacherPhone; private String teacherPhone;
/** 课程日期。 */
@JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
private Date subjectDate; private Date subjectDate;
/** 排课时段原始文本,例如09:00-12:00。 */
private String timeFrame; private String timeFrame;
/** 应出勤人次,包含正常、迟到、缺勤和请假。 */
private long requiredCount; private long requiredCount;
/** 正常签到人次。 */
private long normalCount; private long normalCount;
/** 迟到签到人次。 */
private long lateCount; private long lateCount;
/** 未签到并在课程结束后转为缺勤的人次。 */
private long absentCount; private long absentCount;
/** 已批准请假人次;统计出勤率时不计为出勤。 */
private long leaveCount; private long leaveCount;
/** 出勤率百分比:(正常+迟到)/应出勤×100。 */
private BigDecimal attendanceRate; private BigDecimal attendanceRate;
} }
...@@ -5,29 +5,49 @@ import lombok.Data; ...@@ -5,29 +5,49 @@ import lombok.Data;
import java.util.Date; import java.util.Date;
/** 三端共用的出勤记录展示对象,手机号均按完整号码返回。 */
@Data @Data
public class AttendanceRecordVO { public class AttendanceRecordVO {
/** 出勤记录ID;课程尚未产生记录时可为空。 */
private String id; private String id;
/** 课程排课ID。 */
private Integer subjectId; private Integer subjectId;
/** 课程名称。 */
private String subjectName; private String subjectName;
/** 班级ID。 */
private Integer classId; private Integer classId;
/** 班级名称。 */
private String className; private String className;
/** 学员用户ID。 */
private String studentId; private String studentId;
/** 学员姓名。 */
private String studentName; private String studentName;
/** 学员完整手机号,替代学号展示。 */
private String studentPhone; private String studentPhone;
/** 授课教师用户ID。 */
private String teacherId; private String teacherId;
/** 授课教师姓名。 */
private String teacherName; private String teacherName;
/** 授课教师完整手机号,替代教师号展示。 */
private String teacherPhone; private String teacherPhone;
/** 出勤状态:PENDING/NORMAL/LATE/ABSENT/LEAVE。 */
private String status; private String status;
/** 记录方式:IP_CODE/IP_ONLY/TEACHER/SYSTEM/LEAVE/LEGACY。 */
private String checkInMethod; private String checkInMethod;
/** 学员签到时由服务端识别的客户端IP。 */
private String checkInIp; private String checkInIp;
/** 是否经过教师或审批人确认。 */
private Boolean teacherConfirmed; private Boolean teacherConfirmed;
/** 课程日期。 */
@JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
private Date subjectDate; private Date subjectDate;
/** 排课时段原始文本。 */
private String timeFrame; private String timeFrame;
/** 实际签到时间;缺勤、请假或待签到时为空。 */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date checkInTime; private Date checkInTime;
/** 教师调整或请假审批确认时间。 */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date confirmedAt; private Date confirmedAt;
} }
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment