"...src/git@gitlab.ruzhoukj.com:wujipeng/practical_train.git" did not exist on "145151781496706bec37c281f16907946a5831a5"
Commit 65288165 authored by 王蔡翾's avatar 王蔡翾
Browse files

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

parent 903ab81c
package com.platform.business.task;
import com.platform.business.service.AttendanceService;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
import javax.annotation.Resource;
@Component
public class AttendanceAutoCloseTask {
@Resource
private AttendanceService attendanceService;
/** 每分钟将已结束课程中仍无签到记录的学员自动记为缺勤。 */
@Scheduled(cron = "0 * * * * ?")
public void closeEndedSubjects() {
attendanceService.finalizeEndedSubjects(null, null);
}
}
package com.platform.business.util;
import com.platform.business.model.entity.ClassSubjectEntity;
import com.platform.exception.BusinessException;
import java.time.Instant;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.ZoneId;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.util.Date;
public final class ClassSubjectTimeUtils {
private static final DateTimeFormatter TIME_FORMATTER = DateTimeFormatter.ofPattern("H:mm");
private ClassSubjectTimeUtils() {
}
public static TimeWindow resolve(ClassSubjectEntity subject) {
if (subject == null || subject.getDate() == null || subject.getTimeFrame() == null
|| subject.getTimeFrame().trim().isEmpty()) {
throw new BusinessException("课程日期或上课时段未配置");
}
LocalDate date = Instant.ofEpochMilli(subject.getDate().getTime())
.atZone(ZoneId.systemDefault()).toLocalDate();
LocalTime earliest = null;
LocalTime latest = null;
String normalized = subject.getTimeFrame().replace('—', '-').replace('–', '-');
for (String frame : normalized.split(",")) {
String[] times = frame.trim().split("-", -1);
if (times.length != 2) {
continue;
}
try {
LocalTime start = LocalTime.parse(times[0].trim(), TIME_FORMATTER);
LocalTime end = LocalTime.parse(times[1].trim(), TIME_FORMATTER);
if (!end.isAfter(start)) {
throw new BusinessException("课程结束时间必须晚于开始时间");
}
if (earliest == null || start.isBefore(earliest)) {
earliest = start;
}
if (latest == null || end.isAfter(latest)) {
latest = end;
}
} catch (DateTimeParseException e) {
throw new BusinessException("课程时段格式不正确,应为 HH:mm-HH:mm");
}
}
if (earliest == null || latest == null) {
throw new BusinessException("课程时段格式不正确,应为 HH:mm-HH:mm");
}
ZoneId zone = ZoneId.systemDefault();
return new TimeWindow(
Date.from(LocalDateTime.of(date, earliest).atZone(zone).toInstant()),
Date.from(LocalDateTime.of(date, latest).atZone(zone).toInstant()));
}
public static final class TimeWindow {
private final Date start;
private final Date end;
private TimeWindow(Date start, Date end) {
this.start = start;
this.end = end;
}
public Date getStart() {
return start;
}
public Date getEnd() {
return end;
}
}
}
package com.platform.business.util;
import com.platform.exception.BusinessException;
import java.util.List;
/** 只接受数字形式的IPv4地址,避免通过InetAddress触发DNS解析。 */
public final class IpNetworkMatcher {
private IpNetworkMatcher() {
}
public static boolean matchesAny(String ip, List<String> cidrs) {
if (cidrs == null || cidrs.isEmpty()) {
throw new BusinessException("签到允许网段尚未配置");
}
long ipValue = parseIpv4(ip);
for (String cidr : cidrs) {
if (cidr == null || cidr.trim().isEmpty()) {
continue;
}
if (matches(ipValue, cidr.trim())) {
return true;
}
}
return false;
}
private static boolean matches(long ipValue, String cidr) {
String[] parts = cidr.split("/", -1);
long network = parseIpv4(parts[0]);
int prefix = parts.length == 1 ? 32 : parsePrefix(parts[1]);
long mask = prefix == 0 ? 0L : (0xFFFFFFFFL << (32 - prefix)) & 0xFFFFFFFFL;
return (ipValue & mask) == (network & mask);
}
private static int parsePrefix(String value) {
try {
int prefix = Integer.parseInt(value);
if (prefix < 0 || prefix > 32) {
throw new BusinessException("签到网段配置不合法: /" + value);
}
return prefix;
} catch (NumberFormatException e) {
throw new BusinessException("签到网段配置不合法: /" + value);
}
}
private static long parseIpv4(String ip) {
if (ip == null) {
throw new BusinessException("无法获取签到IP地址");
}
String[] octets = ip.trim().split("\\.", -1);
if (octets.length != 4) {
throw new BusinessException("暂不支持该签到IP地址格式: " + ip);
}
long value = 0L;
for (String octet : octets) {
try {
if (octet.isEmpty() || (octet.length() > 1 && octet.charAt(0) == '0')) {
throw new NumberFormatException();
}
int part = Integer.parseInt(octet);
if (part < 0 || part > 255) {
throw new NumberFormatException();
}
value = (value << 8) | part;
} catch (NumberFormatException e) {
throw new BusinessException("签到IP地址不合法: " + ip);
}
}
return value;
}
}
# 出勤管理接口
所有人员均由登录令牌解析出的用户 `id` 标识;响应中的学员、教师展示字段使用完整手机号,不使用学号或教师号。
## 教师端
- `POST /attendance/teacher/course/{subjectId}/start`:到达计划开始时间后开始上课。首次调用生成6位验证码;后续调用返回同一课次原验证码。
- `GET /attendance/teacher/course/{subjectId}/roster`:查询学员姓名、完整手机号、签到时间、方式、IP和状态。
- `PUT /attendance/teacher/status`:教师手动设置 `NORMAL`、`LATE` 或 `ABSENT`。
状态调整请求示例:
```json
{
"subjectId": 1001,
"studentId": "190000000000000001",
"status": "LATE"
}
```
## 学员端
- `POST /attendance/student/check-in`:课程开始15分钟内同时校验IP和验证码;超过15分钟且未到课程结束时间时只校验IP并自动记为 `LATE`。
- `POST /attendance/student/records`:查询当前登录学员的出勤记录。
签到请求示例:
```json
{
"subjectId": 1001,
"verificationCode": "123456"
}
```
## 管理端
- `POST /attendance/admin/records/page`:按班级、课程、状态、日期范围分页查询。
- `POST /attendance/admin/statistics`:统计应到、正常、迟到、缺勤、请假及出勤率。管理员接口不修改出勤状态。
## IP网段配置
在配置中心为业务服务补充:
```yaml
attendance:
verification-code-valid-minutes: 15
allowed-ip-cidrs:
- 192.168.10.0/24
trust-forwarded-headers: false
```
`allowed-ip-cidrs` 为空时系统会拒绝签到。只有入口网关会清洗并重写转发头时,才能把 `trust-forwarded-headers` 设为 `true`。
审批通过的请假会把所关联课程的出勤状态同步为 `LEAVE`。统计时,请假计入应到和请假次数,但不计入出勤人数,因此会降低出勤率。
<?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.ClassSubjectAttendanceSessionMapper">
<insert id="insertIgnore">
insert ignore into class_subject_attendance_session
(id, subject_id, teacher_id, verification_code, scheduled_start_time, scheduled_end_time,
started_at, code_expires_at, status, created_time, update_time)
values
(#{id}, #{subjectId}, #{teacherId}, #{verificationCode}, #{scheduledStartTime}, #{scheduledEndTime},
#{startedAt}, #{codeExpiresAt}, #{status}, #{createdTime}, #{updateTime})
</insert>
</mapper>
<?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.StudentLeaveApplicationMapper">
<select id="queryApplications" resultType="com.platform.business.model.vo.LeaveApplicationVO">
select
l.id,
l.student_id as studentId,
student.nick_name as studentName,
student.phone_number as studentPhone,
l.leave_type as leaveType,
l.start_time as startTime,
l.end_time as endTime,
timestampdiff(minute, l.start_time, l.end_time) as durationMinutes,
l.reason,
l.emergency_contact_name as emergencyContactName,
l.emergency_contact_phone as emergencyContactPhone,
l.status,
l.approver_id as approverId,
approver.nick_name as approverName,
approver.phone_number as approverPhone,
l.approver_role as approverRole,
l.approval_opinion as approvalOpinion,
l.applied_at as appliedAt,
l.reviewed_at as reviewedAt
from student_leave_application l
inner join user student on student.id = l.student_id
left join user approver on approver.id = l.approver_id
<where>
<if test="id != null and id != ''">and l.id = #{id}</if>
<if test="studentId != null and studentId != ''">and l.student_id = #{studentId}</if>
<if test="teacherId != null and teacherId != ''">
and exists (
select 1
from student_leave_subject ls
inner join class_subject s on s.id = ls.subject_id
where ls.leave_id = l.id and s.teacher_id = #{teacherId}
)
</if>
<if test="status != null and status != ''">and l.status = #{status}</if>
<if test="leaveType != null and leaveType != ''">and l.leave_type = #{leaveType}</if>
<if test="keyword != null and keyword != ''">
and (student.nick_name like concat('%', #{keyword}, '%')
or student.phone_number like concat('%', #{keyword}, '%'))
</if>
<if test="startDate != null">and l.end_time &gt;= #{startDate}</if>
<if test="endDate != null">and l.start_time &lt;= #{endDate}</if>
</where>
order by case when l.status = 'PENDING' then 0 else 1 end, l.applied_at desc
</select>
<select id="selectByIdForUpdate" resultType="com.platform.business.model.entity.StudentLeaveApplicationEntity">
select * from student_leave_application where id = #{id} for update
</select>
<update id="reviewPending">
update student_leave_application
set status = #{status},
approver_id = #{approverId},
approver_role = #{approverRole},
approval_opinion = #{approvalOpinion},
reviewed_at = #{reviewedAt},
updated_at = #{reviewedAt}
where id = #{id} and status = 'PENDING'
</update>
<select id="countTeacherRelatedSubjects" resultType="java.lang.Integer">
select count(1)
from student_leave_subject ls
inner join class_subject s on s.id = ls.subject_id
where ls.leave_id = #{leaveId} and s.teacher_id = #{teacherId}
</select>
</mapper>
<?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.StudentLeaveAttachmentMapper">
<select id="queryAttachmentsByLeaveId" resultType="com.platform.business.model.vo.LeaveAttachmentVO">
select
la.file_id as fileId,
f.file_name as fileName
from student_leave_attachment la
inner join bs_file f on f.id = la.file_id and f.del_flag = 0
where la.leave_id = #{leaveId}
order by la.created_time asc
</select>
</mapper>
<?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.StudentLeaveSubjectMapper">
<select id="querySubjectsByLeaveId" resultType="com.platform.business.model.vo.LeaveSubjectVO">
select
s.id as subjectId,
s.subject_name as subjectName,
s.class_id as classId,
c.name as className,
s.teacher_id as teacherId,
teacher.nick_name as teacherName,
teacher.phone_number as teacherPhone,
s.date as subjectDate,
s.time_frame as timeFrame
from student_leave_subject ls
inner join class_subject s on s.id = ls.subject_id
left join class c on c.id = s.class_id
left join user teacher on teacher.id = s.teacher_id
where ls.leave_id = #{leaveId}
order by s.date asc, s.time_frame asc
</select>
</mapper>
<?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.TrainingRoomBookingLogMapper">
<!-- 预约详情时间线按操作发生顺序返回,创建记录排在最前。 -->
<select id="selectByBookingId" resultType="com.platform.business.model.entity.TrainingRoomBookingLogEntity">
SELECT id, booking_id, action, from_status, to_status,
operator_id, operator_name, remark, operate_time
FROM training_room_booking_log
WHERE booking_id = #{bookingId}
ORDER BY operate_time, id
</select>
</mapper>
<?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.TrainingRoomBookingMapper">
<!-- 预约列表和详情共用字段,同时拼接实训室信息与固定时段文本。 -->
<sql id="bookingColumns">
b.id, b.booking_no AS bookingNo, b.room_id AS roomId,
b.student_id AS studentId, b.student_name AS studentName,
b.student_no AS studentNo, b.class_name AS className,
b.booking_date AS bookingDate, b.slot_code AS slotCode,
b.start_time AS startTime, b.end_time AS endTime, b.seat_no AS seatNo,
b.note, b.status, b.actual_start_time AS actualStartTime,
b.actual_end_time AS actualEndTime, b.cancel_time AS cancelTime,
b.cancel_by AS cancelBy, b.create_time AS createTime, b.update_time AS updateTime,
r.name AS roomName, r.location AS roomLocation,
CASE b.slot_code
WHEN 1 THEN '08:00 - 10:00' WHEN 2 THEN '10:00 - 12:00'
WHEN 3 THEN '14:00 - 16:00' WHEN 4 THEN '16:00 - 18:00'
WHEN 5 THEN '19:00 - 21:00' ELSE '' END AS slotLabel
</sql>
<!-- 管理员和学员预约列表共用的可选筛选条件。 -->
<sql id="bookingFilters">
<if test="query.roomId != null and query.roomId != ''">AND b.room_id = #{query.roomId}</if>
<if test="query.status != null and query.status != '' and query.status != 'all'">AND b.status = #{query.status}</if>
<if test="query.bookingDate != null and query.bookingDate != ''">AND b.booking_date = #{query.bookingDate}</if>
<if test="query.keyword != null and query.keyword != ''">
AND (b.booking_no LIKE CONCAT('%', #{query.keyword}, '%')
OR b.student_name LIKE CONCAT('%', #{query.keyword}, '%')
OR b.student_no LIKE CONCAT('%', #{query.keyword}, '%')
OR CAST(b.seat_no AS CHAR) LIKE CONCAT('%', #{query.keyword}, '%'))
</if>
</sql>
<!-- 管理员预约列表:可查看全部学员记录。 -->
<select id="selectAdminList" resultType="com.platform.business.model.vo.TrainingRoomBookingVO">
SELECT <include refid="bookingColumns"/>
FROM training_room_booking b INNER JOIN training_room r ON r.id = b.room_id
WHERE b.del_flag = 0 <include refid="bookingFilters"/>
ORDER BY b.booking_date DESC, b.slot_code DESC, b.create_time DESC
</select>
<!-- 学员预约列表:强制附加student_id条件,避免越权查询。 -->
<select id="selectStudentList" resultType="com.platform.business.model.vo.TrainingRoomBookingVO">
SELECT <include refid="bookingColumns"/>
FROM training_room_booking b INNER JOIN training_room r ON r.id = b.room_id
WHERE b.del_flag = 0 AND b.student_id = #{studentId}
<include refid="bookingFilters"/>
ORDER BY b.booking_date DESC, b.slot_code DESC, b.create_time DESC
</select>
<!-- 查询预约详情,同时返回实训室名称、位置和时段文本。 -->
<select id="selectDetail" resultType="com.platform.business.model.vo.TrainingRoomBookingVO">
SELECT <include refid="bookingColumns"/>
FROM training_room_booking b INNER JOIN training_room r ON r.id = b.room_id
WHERE b.id = #{id} AND b.del_flag = 0
</select>
<!-- 单个实训室的预约状态KPI,已取消记录保留在总数中。 -->
<select id="selectStatistics" resultType="com.platform.business.model.vo.TrainingRoomBookingStatisticsVO">
SELECT COUNT(1) AS totalCount,
COALESCE(SUM(CASE WHEN status = 'booked' THEN 1 ELSE 0 END), 0) AS bookedCount,
COALESCE(SUM(CASE WHEN status = 'using' THEN 1 ELSE 0 END), 0) AS usingCount,
COALESCE(SUM(CASE WHEN status = 'done' THEN 1 ELSE 0 END), 0) AS doneCount,
COALESCE(SUM(CASE WHEN status = 'canceled' THEN 1 ELSE 0 END), 0) AS canceledCount
FROM training_room_booking
WHERE room_id = #{roomId} AND del_flag = 0
</select>
<!-- active_flag 配合唯一索引,在数据库层防止并发重复预约。 -->
<select id="countSeatConflict" resultType="java.lang.Integer">
SELECT COUNT(1) FROM training_room_booking
WHERE room_id = #{roomId} AND booking_date = #{bookingDate}
AND slot_code = #{slotCode} AND seat_no = #{seatNo}
AND active_flag = 1 AND del_flag = 0
</select>
<select id="countStudentConflict" resultType="java.lang.Integer">
SELECT COUNT(1) FROM training_room_booking
WHERE student_id = #{studentId} AND booking_date = #{bookingDate}
AND slot_code = #{slotCode} AND active_flag = 1 AND del_flag = 0
</select>
<!-- 查询需要自动开始或跨时段补偿完成的预约。 -->
<select id="selectDueBooked" resultType="com.platform.business.model.entity.TrainingRoomBookingEntity">
SELECT * FROM training_room_booking
WHERE status = 'booked' AND start_time &lt;= #{now} AND del_flag = 0
ORDER BY start_time
</select>
<!-- 查询到达计划结束时间、需要自动完成的使用中预约。 -->
<select id="selectDueUsing" resultType="com.platform.business.model.entity.TrainingRoomBookingEntity">
SELECT * FROM training_room_booking
WHERE status = 'using' AND end_time &lt;= #{now} AND del_flag = 0
ORDER BY end_time
</select>
<!-- 条件更新保证定时任务、查询补偿并发执行时只有一个线程成功流转状态。 -->
<update id="startBooking">
UPDATE training_room_booking
SET status = 'using', actual_start_time = #{actualStartTime}, update_time = CURRENT_TIMESTAMP
WHERE id = #{id} AND status = 'booked' AND active_flag = 1 AND del_flag = 0
</update>
<!-- 完成预约时将active_flag置空,释放机位和学员的有效预约唯一约束。 -->
<update id="finishUsingBooking">
UPDATE training_room_booking
SET status = 'done', active_flag = NULL, actual_end_time = #{actualEndTime},
update_time = CURRENT_TIMESTAMP
WHERE id = #{id} AND status = 'using' AND active_flag = 1 AND del_flag = 0
</update>
<!-- 服务停机跨过完整时段时,查询补偿会将预约直接补齐为已完成。 -->
<update id="finishExpiredBooked">
UPDATE training_room_booking
SET status = 'done', active_flag = NULL,
actual_start_time = start_time, actual_end_time = end_time,
update_time = CURRENT_TIMESTAMP
WHERE id = #{id} AND status = 'booked' AND active_flag = 1 AND del_flag = 0
</update>
<!-- 只允许取消开始时间之后且状态仍为booked的预约。 -->
<update id="cancelBooked">
UPDATE training_room_booking
SET status = 'canceled', active_flag = NULL, cancel_time = #{cancelTime},
cancel_by = #{cancelBy}, update_time = CURRENT_TIMESTAMP
WHERE id = #{id} AND status = 'booked' AND active_flag = 1
AND start_time &gt; #{cancelTime} AND del_flag = 0
</update>
</mapper>
<?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.TrainingRoomMapper">
<!-- 当前使用数仅统计 using,未来 booked 不占用当前机位。 -->
<sql id="roomColumns">
r.id, r.name, r.location, r.area,
r.all_day AS allDay, r.open_start AS openStart, r.open_end AS openEnd,
r.seat_count AS seatCount, r.layout_description AS layoutDescription,
r.manager_id AS managerId, r.status, r.remark,
r.create_time AS createTime, r.update_time AS updateTime,
manager.nick_name AS managerName, manager.phone_number AS managerPhone,
(SELECT COUNT(1) FROM training_room_booking current_booking
WHERE current_booking.room_id = r.id AND current_booking.status = 'using'
AND current_booking.del_flag = 0) AS currentUsingCount,
(SELECT COUNT(1) FROM training_room_booking booked_booking
WHERE booked_booking.room_id = r.id AND booked_booking.status = 'booked'
AND booked_booking.del_flag = 0) AS bookedCount,
(SELECT COUNT(1) FROM training_room_booking done_booking
WHERE done_booking.room_id = r.id AND done_booking.status = 'done'
AND done_booking.del_flag = 0) AS doneCount,
r.seat_count - (SELECT COUNT(1) FROM training_room_booking current_booking
WHERE current_booking.room_id = r.id AND current_booking.status = 'using'
AND current_booking.del_flag = 0) AS freeSeatCount,
(SELECT COUNT(1) FROM training_room_booking future_booking
WHERE future_booking.room_id = r.id AND future_booking.active_flag = 1
AND future_booking.start_time &gt; #{now} AND future_booking.del_flag = 0) AS futureBookingCount,
CASE
WHEN (SELECT COUNT(1) FROM training_room_booking current_booking
WHERE current_booking.room_id = r.id AND current_booking.status = 'using'
AND current_booking.del_flag = 0) = 0 THEN 'free'
WHEN (SELECT COUNT(1) FROM training_room_booking current_booking
WHERE current_booking.room_id = r.id AND current_booking.status = 'using'
AND current_booking.del_flag = 0) &gt;= r.seat_count THEN 'full'
ELSE 'busy'
END AS availabilityStatus
</sql>
<!-- 实训室名称、位置及运行状态筛选。 -->
<sql id="roomFilters">
<if test="query.keyword != null and query.keyword != ''">
AND (r.name LIKE CONCAT('%', #{query.keyword}, '%')
OR r.location LIKE CONCAT('%', #{query.keyword}, '%'))
</if>
<if test="query.status != null and query.status != '' and query.status != 'all'">
AND r.status = #{query.status}
</if>
</sql>
<!-- 管理员端包含运行中和已停用的全部有效实训室。 -->
<select id="selectAdminList" resultType="com.platform.business.model.vo.TrainingRoomVO">
SELECT <include refid="roomColumns"/>
FROM training_room r
LEFT JOIN user manager ON manager.id = r.manager_id AND manager.del_flag = 0
WHERE r.del_flag = 0
<include refid="roomFilters"/>
ORDER BY r.create_time DESC, r.id DESC
</select>
<!-- 学员端仅返回运行中实训室,并支持按当前动态状态筛选。 -->
<select id="selectStudentList" resultType="com.platform.business.model.vo.TrainingRoomVO">
SELECT <include refid="roomColumns"/>
FROM training_room r
LEFT JOIN user manager ON manager.id = r.manager_id AND manager.del_flag = 0
WHERE r.del_flag = 0 AND r.status = 'running'
<if test="query.keyword != null and query.keyword != ''">
AND (r.name LIKE CONCAT('%', #{query.keyword}, '%')
OR r.location LIKE CONCAT('%', #{query.keyword}, '%'))
</if>
<if test="query.availabilityStatus != null and query.availabilityStatus != '' and query.availabilityStatus != 'all'">
HAVING availabilityStatus = #{query.availabilityStatus}
</if>
ORDER BY r.create_time DESC, r.id DESC
</select>
<!-- 实训室详情与列表复用相同的当前使用、空闲和未来预约统计口径。 -->
<select id="selectDetail" resultType="com.platform.business.model.vo.TrainingRoomVO">
SELECT <include refid="roomColumns"/>
FROM training_room r
LEFT JOIN user manager ON manager.id = r.manager_id AND manager.del_flag = 0
WHERE r.id = #{id} AND r.del_flag = 0
</select>
<!-- 管理员KPI统计全部有效实训室。未来预约不会计入当前使用机位。 -->
<select id="selectAdminStatistics" resultType="com.platform.business.model.vo.TrainingRoomStatisticsVO">
SELECT
COUNT(1) AS totalRooms,
COALESCE(SUM(CASE WHEN r.status = 'running' THEN 1 ELSE 0 END), 0) AS runningRooms,
COALESCE(SUM(CASE WHEN r.status = 'disabled' THEN 1 ELSE 0 END), 0) AS disabledRooms,
COALESCE(SUM(r.seat_count), 0) AS totalSeats,
COALESCE(SUM(r.seat_count), 0) -
(SELECT COUNT(1) FROM training_room_booking b
WHERE b.status = 'using' AND b.del_flag = 0) AS freeSeats,
(SELECT COUNT(DISTINCT b.room_id) FROM training_room_booking b
WHERE b.status = 'using' AND b.del_flag = 0) AS usingRooms,
(SELECT COUNT(1) FROM training_room full_room
WHERE full_room.del_flag = 0 AND full_room.seat_count &gt; 0
AND full_room.seat_count &lt;= (SELECT COUNT(1) FROM training_room_booking b
WHERE b.room_id = full_room.id AND b.status = 'using' AND b.del_flag = 0)) AS fullRooms,
(SELECT COUNT(1) FROM training_room_booking b
WHERE b.active_flag = 1 AND b.start_time &gt; #{now} AND b.del_flag = 0) AS futureBookings
FROM training_room r
WHERE r.del_flag = 0
</select>
<!-- 学员KPI仅统计运行中的实训室。 -->
<select id="selectStudentStatistics" resultType="com.platform.business.model.vo.TrainingRoomStatisticsVO">
SELECT
COUNT(1) AS totalRooms,
COUNT(1) AS runningRooms,
0 AS disabledRooms,
COALESCE(SUM(r.seat_count), 0) AS totalSeats,
COALESCE(SUM(r.seat_count), 0) -
(SELECT COUNT(1) FROM training_room_booking b
INNER JOIN training_room rr ON rr.id = b.room_id
WHERE b.status = 'using' AND b.del_flag = 0
AND rr.status = 'running' AND rr.del_flag = 0) AS freeSeats,
(SELECT COUNT(DISTINCT b.room_id) FROM training_room_booking b
INNER JOIN training_room rr ON rr.id = b.room_id
WHERE b.status = 'using' AND b.del_flag = 0
AND rr.status = 'running' AND rr.del_flag = 0) AS usingRooms,
(SELECT COUNT(1) FROM training_room full_room
WHERE full_room.del_flag = 0 AND full_room.status = 'running' AND full_room.seat_count &gt; 0
AND full_room.seat_count &lt;= (SELECT COUNT(1) FROM training_room_booking b
WHERE b.room_id = full_room.id AND b.status = 'using' AND b.del_flag = 0)) AS fullRooms,
(SELECT COUNT(1) FROM training_room_booking b
INNER JOIN training_room rr ON rr.id = b.room_id
WHERE b.active_flag = 1 AND b.start_time &gt; #{now} AND b.del_flag = 0
AND rr.status = 'running' AND rr.del_flag = 0) AS futureBookings
FROM training_room r
WHERE r.del_flag = 0 AND r.status = 'running'
</select>
<!-- 新建、编辑时校验有效实训室名称唯一。 -->
<select id="countSameName" resultType="java.lang.Integer">
SELECT COUNT(1) FROM training_room
WHERE name = #{name} AND del_flag = 0
<if test="excludeId != null and excludeId != ''">AND id != #{excludeId}</if>
</select>
<!-- 停用实训室或缩减机位前检查尚未结束的有效预约。 -->
<select id="countActiveBookingsAfter" resultType="java.lang.Integer">
SELECT COUNT(1) FROM training_room_booking
WHERE room_id = #{roomId} AND active_flag = 1
AND end_time &gt; #{now} AND del_flag = 0
</select>
</mapper>
<?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.TrainingRoomSeatMapper">
<!-- 查询全部历史机位,供机位扩缩容时复用原编号。 -->
<select id="selectAllByRoom" resultType="com.platform.business.model.entity.TrainingRoomSeatEntity">
SELECT id, room_id, seat_no, enabled, create_time
FROM training_room_seat WHERE room_id = #{roomId} ORDER BY seat_no
</select>
<!-- 创建预约前校验机位编号存在且当前启用。 -->
<select id="selectEnabledSeat" resultType="com.platform.business.model.entity.TrainingRoomSeatEntity">
SELECT id, room_id, seat_no, enabled, create_time
FROM training_room_seat
WHERE room_id = #{roomId} AND seat_no = #{seatNo} AND enabled = 1
</select>
<!-- 预约状态只针对所选日期和时段计算,不写回机位基础表。 -->
<select id="selectAvailability" resultType="com.platform.business.model.vo.TrainingRoomSeatVO">
SELECT s.id, s.seat_no AS seatNo,
CASE WHEN b.status = 'using' THEN 'using'
WHEN b.status = 'booked' THEN 'booked'
ELSE 'free' END AS status,
b.id AS bookingId
FROM training_room_seat s
LEFT JOIN training_room_booking b
ON b.room_id = s.room_id AND b.seat_no = s.seat_no
AND b.booking_date = #{bookingDate} AND b.slot_code = #{slotCode}
AND b.active_flag = 1 AND b.del_flag = 0
WHERE s.room_id = #{roomId} AND s.enabled = 1
ORDER BY s.seat_no
</select>
<!-- 扩容时重新启用处于新机位总数范围内的历史机位。 -->
<update id="enableSeatsUpTo">
UPDATE training_room_seat SET enabled = 1
WHERE room_id = #{roomId} AND seat_no &lt;= #{seatCount}
</update>
<!-- 缩容时保留机位记录,只将超出范围的机位置为停用。 -->
<update id="disableSeatsAbove">
UPDATE training_room_seat SET enabled = 0
WHERE room_id = #{roomId} AND seat_no &gt; #{seatCount}
</update>
</mapper>
-- 出勤管理数据库变更(MySQL)
-- 执行前请备份数据库;本脚本按“尚未添加这些列/索引”的数据库执行一次。
alter table class_subject_attendance
modify column check_in_time datetime null comment '实际签到时间,缺勤时为空',
add column status varchar(16) not null default 'NORMAL' comment 'NORMAL/LATE/ABSENT/LEAVE' after check_in_time,
add column check_in_method varchar(16) null comment 'IP_CODE/IP_ONLY/TEACHER/SYSTEM/LEAVE/LEGACY' after status,
add column check_in_ip varchar(45) null comment '服务端识别的签到IP' after check_in_method,
add column teacher_confirmed tinyint(1) not null default 0 after check_in_ip,
add column confirmed_by varchar(64) null after teacher_confirmed,
add column confirmed_at datetime null after confirmed_by,
add column created_time datetime null after confirmed_at,
add column update_time datetime null after created_time;
update class_subject_attendance
set status = 'NORMAL',
check_in_method = 'LEGACY',
teacher_confirmed = 0,
created_time = coalesce(created_time, check_in_time),
update_time = coalesce(update_time, check_in_time)
where check_in_method is null;
-- 添加唯一索引前可先执行以下语句检查历史重复数据:
-- select subject_id, user_id, count(*) from class_subject_attendance group by subject_id, user_id having count(*) > 1;
alter table class_subject_attendance
add unique key uk_attendance_subject_user (subject_id, user_id),
add key idx_attendance_user_status (user_id, status),
add key idx_attendance_subject_status (subject_id, status);
create table class_subject_attendance_session (
id varchar(64) not null,
subject_id int not null,
teacher_id varchar(64) not null,
verification_code char(6) null,
scheduled_start_time datetime not null,
scheduled_end_time datetime not null,
started_at datetime null,
code_expires_at datetime null,
status varchar(16) not null comment 'ACTIVE/ENDED',
created_time datetime not null,
update_time datetime not null,
primary key (id),
unique key uk_attendance_session_subject (subject_id),
key idx_attendance_session_end_status (scheduled_end_time, status)
) engine=InnoDB default charset=utf8mb4 comment='课程签到会话';
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