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
65288165
"...src/git@gitlab.ruzhoukj.com:wujipeng/practical_train.git" did not exist on "145151781496706bec37c281f16907946a5831a5"
Commit
65288165
authored
Aug 07, 2026
by
王蔡翾
Browse files
出勤管理,请假管理,实验室管理
parent
903ab81c
Changes
73
Hide whitespace changes
Inline
Side-by-side
practical-business/src/main/java/com/platform/business/task/AttendanceAutoCloseTask.java
0 → 100644
View file @
65288165
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
);
}
}
practical-business/src/main/java/com/platform/business/util/ClassSubjectTimeUtils.java
0 → 100644
View file @
65288165
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
;
}
}
}
practical-business/src/main/java/com/platform/business/util/IpNetworkMatcher.java
0 → 100644
View file @
65288165
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
:
(
0xFFFFFFFF
L
<<
(
32
-
prefix
))
&
0xFFFFFFFF
L
;
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
;
}
}
practical-business/src/main/resources/attendance-api.md
0 → 100644
View file @
65288165
# 出勤管理接口
所有人员均由登录令牌解析出的用户
`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`
。统计时,请假计入应到和请假次数,但不计入出勤人数,因此会降低出勤率。
practical-business/src/main/resources/com/platform/business/mapper/ClassSubjectAttendanceSessionMapper.xml
0 → 100644
View file @
65288165
<?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>
practical-business/src/main/resources/com/platform/business/mapper/StudentLeaveApplicationMapper.xml
0 → 100644
View file @
65288165
<?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
>
= #{startDate}
</if>
<if
test=
"endDate != null"
>
and l.start_time
<
= #{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>
practical-business/src/main/resources/com/platform/business/mapper/StudentLeaveAttachmentMapper.xml
0 → 100644
View file @
65288165
<?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>
practical-business/src/main/resources/com/platform/business/mapper/StudentLeaveSubjectMapper.xml
0 → 100644
View file @
65288165
<?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>
practical-business/src/main/resources/com/platform/business/mapper/TrainingRoomBookingLogMapper.xml
0 → 100644
View file @
65288165
<?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>
practical-business/src/main/resources/com/platform/business/mapper/TrainingRoomBookingMapper.xml
0 → 100644
View file @
65288165
<?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
<
= #{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
<
= #{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
>
#{cancelTime} AND del_flag = 0
</update>
</mapper>
practical-business/src/main/resources/com/platform/business/mapper/TrainingRoomMapper.xml
0 → 100644
View file @
65288165
<?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
>
#{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)
>
= 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
>
0
AND full_room.seat_count
<
= (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
>
#{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
>
0
AND full_room.seat_count
<
= (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
>
#{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
>
#{now} AND del_flag = 0
</select>
</mapper>
practical-business/src/main/resources/com/platform/business/mapper/TrainingRoomSeatMapper.xml
0 → 100644
View file @
65288165
<?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
<
= #{seatCount}
</update>
<!-- 缩容时保留机位记录,只将超出范围的机位置为停用。 -->
<update
id=
"disableSeatsAbove"
>
UPDATE training_room_seat SET enabled = 0
WHERE room_id = #{roomId} AND seat_no
>
#{seatCount}
</update>
</mapper>
practical-business/src/main/resources/sql/attendance_management.sql
0 → 100644
View file @
65288165
-- 出勤管理数据库变更(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
=
'课程签到会话'
;
Prev
1
2
3
4
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