Commit 65288165 authored by 王蔡翾's avatar 王蔡翾
Browse files

出勤管理,请假管理,实验室管理

parent 903ab81c
package com.platform.business.model.dto;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
@Data
public class AttendanceCheckInDTO {
@ApiModelProperty(value = "课程排课ID", required = true)
private Integer subjectId;
@ApiModelProperty(value = "教师提供的6位验证码;课程开始超过15分钟后可不传")
private String verificationCode;
}
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 AttendanceQueryDTO {
private Integer pageNum;
private Integer pageSize;
private Integer classId;
private Integer subjectId;
private String userId;
private String status;
@JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
@ApiModelProperty("开始日期")
private Date startDate;
@JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
@ApiModelProperty("结束日期")
private Date endDate;
}
package com.platform.business.model.dto;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
@Data
public class AttendanceStatusUpdateDTO {
@ApiModelProperty(value = "课程排课ID", required = true)
private Integer subjectId;
@ApiModelProperty(value = "学员用户ID", required = true)
private String studentId;
@ApiModelProperty(value = "NORMAL/LATE/ABSENT", required = true)
private String status;
}
package com.platform.business.model.dto;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import java.util.Date;
import java.util.List;
@Data
public class LeaveApplyDTO {
@ApiModelProperty("修改时传请假申请ID,新增时不传")
private String id;
@ApiModelProperty(value = "SICK/PERSONAL/OTHER", required = true)
private String leaveType;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date startTime;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date endTime;
private String reason;
private String emergencyContactName;
private String emergencyContactPhone;
private List<Integer> attachmentFileIds;
}
package com.platform.business.model.dto;
import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;
import java.util.Date;
@Data
public class LeaveQueryDTO {
private String id;
private Integer pageNum;
private Integer pageSize;
private String status;
private String leaveType;
private String keyword;
private String studentId;
private String teacherId;
@JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
private Date startDate;
@JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
private Date endDate;
}
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("审批意见")
private String approvalOpinion;
}
package com.platform.business.model.dto;
import lombok.Data;
/** 学员创建预约参数。 */
@Data
public class TrainingRoomBookingCreateDTO {
/** 需要预约的实训室ID。 */
private String roomId;
/** 预约日期,格式为yyyy-MM-dd,只允许今天至后天。 */
private String bookingDate;
/** 固定时段编码,取值范围为1至5。 */
private Integer slotCode;
/** 机位编号,从1开始。 */
private Integer seatNo;
/** 学员预约备注,最多500个字符。 */
private String note;
}
package com.platform.business.model.dto;
import com.platform.business.model.entity.TrainingRoomBookingEntity;
import lombok.Data;
import lombok.EqualsAndHashCode;
/** 预约分页查询参数。 */
@Data
@EqualsAndHashCode(callSuper = true)
public class TrainingRoomBookingDTO extends TrainingRoomBookingEntity {
/** 当前页码,默认第1页。 */
private int pageNum;
/** 每页条数,默认20条,最大100条。 */
private int pageSize;
/** 预约编号、学员姓名、学号或机位的模糊搜索关键字。 */
private String keyword;
}
package com.platform.business.model.dto;
import com.platform.business.model.entity.TrainingRoomEntity;
import lombok.Data;
import lombok.EqualsAndHashCode;
/** 实训室管理及分页查询参数。 */
@Data
@EqualsAndHashCode(callSuper = true)
public class TrainingRoomDTO extends TrainingRoomEntity {
/** 当前页码,默认第1页。 */
private int pageNum;
/** 每页条数,默认20条,最大100条。 */
private int pageSize;
/** 实训室名称或位置的模糊搜索关键字。 */
private String keyword;
/** 学员端动态状态筛选:free、busy、full。 */
private String availabilityStatus;
}
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;
/**
* 一次排课对应一个签到会话。验证码只在首次开始上课时生成一次。
*/
@Data
@TableName("class_subject_attendance_session")
public class ClassSubjectAttendanceSessionEntity {
@TableId(type = IdType.ASSIGN_ID)
private String id;
@TableField("subject_id")
private Integer subjectId;
@TableField("teacher_id")
private String teacherId;
@TableField("verification_code")
private String verificationCode;
@TableField("scheduled_start_time")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date scheduledStartTime;
@TableField("scheduled_end_time")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date scheduledEndTime;
@TableField("started_at")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date startedAt;
@TableField("code_expires_at")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date codeExpiresAt;
@TableField("status")
private String status;
@TableField("created_time")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date createdTime;
@TableField("update_time")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
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;
@Data
@TableName("student_leave_application")
public class StudentLeaveApplicationEntity {
@TableId(type = IdType.ASSIGN_ID)
private String id;
@TableField("student_id")
private String studentId;
@TableField("leave_type")
private String leaveType;
@TableField("start_time")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date startTime;
@TableField("end_time")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date endTime;
@TableField("reason")
private String reason;
@TableField("emergency_contact_name")
private String emergencyContactName;
@TableField("emergency_contact_phone")
private String emergencyContactPhone;
@TableField("status")
private String status;
@TableField("approver_id")
private String approverId;
@TableField("approver_role")
private String approverRole;
@TableField("approval_opinion")
private String approvalOpinion;
@TableField("applied_at")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date appliedAt;
@TableField("reviewed_at")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date reviewedAt;
@TableField("updated_at")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date updatedAt;
}
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;
@Data
@TableName("student_leave_attachment")
public class StudentLeaveAttachmentEntity {
@TableId(type = IdType.ASSIGN_ID)
private String id;
@TableField("leave_id")
private String leaveId;
@TableField("file_id")
private Integer fileId;
@TableField("created_time")
private Date createdTime;
}
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;
@Data
@TableName("student_leave_subject")
public class StudentLeaveSubjectEntity {
@TableId(type = IdType.ASSIGN_ID)
private String id;
@TableField("leave_id")
private String leaveId;
@TableField("subject_id")
private Integer subjectId;
@TableField("created_time")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date createdTime;
}
package com.platform.business.model.entity;
import com.baomidou.mybatisplus.annotation.FieldFill;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableLogic;
import com.baomidou.mybatisplus.annotation.TableName;
import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;
import java.util.Date;
/** 实训室预约记录。取消和完成记录均保留,用于审计和历史查询。 */
@Data
@TableName("training_room_booking")
public class TrainingRoomBookingEntity {
/** 预约记录字符串雪花ID。 */
@TableId(value = "id", type = IdType.ASSIGN_ID)
private String id;
/** 面向前端展示的预约编号。 */
@TableField("booking_no")
private String bookingNo;
/** 预约关联的实训室ID。 */
@TableField("room_id")
private String roomId;
/** 预约学员ID,关联user.id。 */
@TableField("student_id")
private String studentId;
/** 预约时保存的学员姓名快照。 */
@TableField("student_name")
private String studentName;
/** 原型中的学号暂使用 UserEntity.id 快照。 */
@TableField("student_no")
private String studentNo;
/** 预约时所属班级名称快照,多个班级使用中文顿号连接。 */
@TableField("class_name")
private String className;
/** 预约日期,格式 yyyy-MM-dd。 */
@TableField("booking_date")
private String bookingDate;
/** 固定时段编码:1至5。 */
@TableField("slot_code")
private Integer slotCode;
/** 根据预约日期和固定时段计算出的计划开始时间。 */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
@TableField("start_time")
private Date startTime;
/** 根据预约日期和固定时段计算出的计划结束时间。 */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
@TableField("end_time")
private Date endTime;
/** 预约的机位编号。 */
@TableField("seat_no")
private Integer seatNo;
/** 学员填写的预约备注。 */
private String note;
/** booked、using、done、canceled。 */
private String status;
/** booked/using 时为1,done/canceled 时为NULL,用于数据库唯一约束。 */
@TableField("active_flag")
private Integer activeFlag;
/** 实际开始时间;自动开始时写入。 */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
@TableField("actual_start_time")
private Date actualStartTime;
/** 实际结束时间;自动结束、提前签退或管理员结束时写入。 */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
@TableField("actual_end_time")
private Date actualEndTime;
/** 取消预约的操作时间。 */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
@TableField("cancel_time")
private Date cancelTime;
/** 执行取消操作的用户ID。 */
@TableField("cancel_by")
private String cancelBy;
/** 逻辑删除标记:0正常,1删除;业务取消通过status记录。 */
@TableLogic(value = "0", delval = "1")
@TableField("del_flag")
private Integer delFlag;
/** 预约创建时间。 */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
@TableField(value = "create_time", fill = FieldFill.INSERT)
private Date createTime;
/** 预约最后更新时间。 */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
@TableField(value = "update_time", fill = FieldFill.INSERT_UPDATE)
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;
/** 预约状态操作记录,用于管理员预约详情时间线。 */
@Data
@TableName("training_room_booking_log")
public class TrainingRoomBookingLogEntity {
/** 操作记录字符串雪花ID。 */
@TableId(value = "id", type = IdType.ASSIGN_ID)
private String id;
/** 关联的预约记录ID。 */
@TableField("booking_id")
private String bookingId;
/** 操作类型,例如创建、自动开始、取消或签退。 */
private String action;
/** 操作前的预约状态,创建预约时为空。 */
@TableField("from_status")
private String fromStatus;
/** 操作完成后的预约状态。 */
@TableField("to_status")
private String toStatus;
/** 操作人ID;自动任务使用system。 */
@TableField("operator_id")
private String operatorId;
/** 操作人姓名快照。 */
@TableField("operator_name")
private String operatorName;
/** 状态变更原因或操作说明。 */
private String remark;
/** 操作发生时间。 */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
@TableField("operate_time")
private Date operateTime;
}
package com.platform.business.model.entity;
import com.baomidou.mybatisplus.annotation.FieldFill;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableLogic;
import com.baomidou.mybatisplus.annotation.TableName;
import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;
import java.math.BigDecimal;
import java.util.Date;
/** 实训室基础信息。 */
@Data
@TableName("training_room")
public class TrainingRoomEntity {
/** 新增模块主键统一使用字符串雪花ID。 */
@TableId(value = "id", type = IdType.ASSIGN_ID)
private String id;
/** 实训室名称,同一有效实训室名称不可重复。 */
private String name;
/** 实训室所在位置。 */
private String location;
/** 实训室面积,单位由前端统一展示。 */
private BigDecimal area;
/** 是否全天开放。全天开放时开始、结束时间可以为空。 */
@TableField("all_day")
private Boolean allDay;
/** 非全天开放时的开始时间,格式 HH:mm:ss。 */
@TableField("open_start")
private String openStart;
/** 非全天开放时的结束时间,格式 HH:mm:ss。 */
@TableField("open_end")
private String openEnd;
/** 当前启用的机位总数,机位编号固定为1至seatCount。 */
@TableField("seat_count")
private Integer seatCount;
/** 机位布局的文字描述。 */
@TableField("layout_description")
private String layoutDescription;
/** 负责人用户ID,关联 user.id。 */
@TableField("manager_id")
private String managerId;
/** running:运行中,disabled:已停用。 */
private String status;
/** 实训室管理备注。 */
private String remark;
/** 逻辑删除标记:0正常,1删除;当前模块不提供删除接口。 */
@TableLogic(value = "0", delval = "1")
@TableField("del_flag")
private Integer delFlag;
/** 创建时间。 */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
@TableField(value = "create_time", fill = FieldFill.INSERT)
private Date createTime;
/** 最后更新时间。 */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
@TableField(value = "update_time", fill = FieldFill.INSERT_UPDATE)
private Date updateTime;
}
package com.platform.business.model.entity;
import com.baomidou.mybatisplus.annotation.FieldFill;
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;
/**
* 实训室机位定义。机位本身不保存预约状态,预约/使用状态按日期和时段动态计算。
*/
@Data
@TableName("training_room_seat")
public class TrainingRoomSeatEntity {
/** 机位字符串雪花ID。 */
@TableId(value = "id", type = IdType.ASSIGN_ID)
private String id;
/** 机位所属实训室ID。 */
@TableField("room_id")
private String roomId;
/** 实训室内连续递增的机位编号。 */
@TableField("seat_no")
private Integer seatNo;
/** 缩减机位时置为 false,再次扩容时可以恢复原机位。 */
private Boolean enabled;
/** 机位记录创建时间。 */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
@TableField(value = "create_time", fill = FieldFill.INSERT)
private Date createTime;
}
package com.platform.business.model.vo;
import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;
import java.math.BigDecimal;
import java.util.Date;
@Data
public class AttendanceCourseStatisticsVO {
private Integer subjectId;
private String subjectName;
private Integer classId;
private String className;
private String teacherId;
private String teacherName;
private String teacherPhone;
@JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
private Date subjectDate;
private String timeFrame;
private long requiredCount;
private long normalCount;
private long lateCount;
private long absentCount;
private long leaveCount;
private BigDecimal attendanceRate;
}
package com.platform.business.model.vo;
import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;
import java.util.Date;
@Data
public class AttendanceRecordVO {
private String id;
private Integer subjectId;
private String subjectName;
private Integer classId;
private String className;
private String studentId;
private String studentName;
private String studentPhone;
private String teacherId;
private String teacherName;
private String teacherPhone;
private String status;
private String checkInMethod;
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;
}
package com.platform.business.model.vo;
import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;
import java.util.Date;
@Data
public class AttendanceSessionVO {
private String sessionId;
private Integer subjectId;
private String subjectName;
private String className;
private String teacherId;
private String teacherName;
private String teacherPhone;
private String verificationCode;
private String status;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date scheduledStartTime;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date scheduledEndTime;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date startedAt;
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date codeExpiresAt;
}
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