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
Commit
65288165
authored
Aug 07, 2026
by
王蔡翾
Browse files
出勤管理,请假管理,实验室管理
parent
903ab81c
Changes
73
Expand all
Show whitespace changes
Inline
Side-by-side
practical-business/src/main/java/com/platform/business/mapper/ClassSubjectAttendanceSessionMapper.java
0 → 100644
View file @
65288165
package
com.platform.business.mapper
;
import
com.baomidou.mybatisplus.core.mapper.BaseMapper
;
import
com.platform.business.model.entity.ClassSubjectAttendanceSessionEntity
;
import
org.apache.ibatis.annotations.Mapper
;
@Mapper
public
interface
ClassSubjectAttendanceSessionMapper
extends
BaseMapper
<
ClassSubjectAttendanceSessionEntity
>
{
int
insertIgnore
(
ClassSubjectAttendanceSessionEntity
session
);
}
practical-business/src/main/java/com/platform/business/mapper/StudentLeaveApplicationMapper.java
0 → 100644
View file @
65288165
package
com.platform.business.mapper
;
import
com.baomidou.mybatisplus.core.mapper.BaseMapper
;
import
com.platform.business.model.dto.LeaveQueryDTO
;
import
com.platform.business.model.entity.StudentLeaveApplicationEntity
;
import
com.platform.business.model.vo.LeaveApplicationVO
;
import
org.apache.ibatis.annotations.Mapper
;
import
org.apache.ibatis.annotations.Param
;
import
java.util.Date
;
import
java.util.List
;
@Mapper
public
interface
StudentLeaveApplicationMapper
extends
BaseMapper
<
StudentLeaveApplicationEntity
>
{
List
<
LeaveApplicationVO
>
queryApplications
(
LeaveQueryDTO
query
);
StudentLeaveApplicationEntity
selectByIdForUpdate
(
@Param
(
"id"
)
String
id
);
int
reviewPending
(
@Param
(
"id"
)
String
id
,
@Param
(
"status"
)
String
status
,
@Param
(
"approverId"
)
String
approverId
,
@Param
(
"approverRole"
)
String
approverRole
,
@Param
(
"approvalOpinion"
)
String
approvalOpinion
,
@Param
(
"reviewedAt"
)
Date
reviewedAt
);
int
countTeacherRelatedSubjects
(
@Param
(
"leaveId"
)
String
leaveId
,
@Param
(
"teacherId"
)
String
teacherId
);
}
practical-business/src/main/java/com/platform/business/mapper/StudentLeaveAttachmentMapper.java
0 → 100644
View file @
65288165
package
com.platform.business.mapper
;
import
com.baomidou.mybatisplus.core.mapper.BaseMapper
;
import
com.platform.business.model.entity.StudentLeaveAttachmentEntity
;
import
com.platform.business.model.vo.LeaveAttachmentVO
;
import
org.apache.ibatis.annotations.Mapper
;
import
org.apache.ibatis.annotations.Param
;
import
java.util.List
;
@Mapper
public
interface
StudentLeaveAttachmentMapper
extends
BaseMapper
<
StudentLeaveAttachmentEntity
>
{
List
<
LeaveAttachmentVO
>
queryAttachmentsByLeaveId
(
@Param
(
"leaveId"
)
String
leaveId
);
}
practical-business/src/main/java/com/platform/business/mapper/StudentLeaveSubjectMapper.java
0 → 100644
View file @
65288165
package
com.platform.business.mapper
;
import
com.baomidou.mybatisplus.core.mapper.BaseMapper
;
import
com.platform.business.model.entity.StudentLeaveSubjectEntity
;
import
com.platform.business.model.vo.LeaveSubjectVO
;
import
org.apache.ibatis.annotations.Mapper
;
import
org.apache.ibatis.annotations.Param
;
import
java.util.List
;
@Mapper
public
interface
StudentLeaveSubjectMapper
extends
BaseMapper
<
StudentLeaveSubjectEntity
>
{
List
<
LeaveSubjectVO
>
querySubjectsByLeaveId
(
@Param
(
"leaveId"
)
String
leaveId
);
}
practical-business/src/main/java/com/platform/business/mapper/TrainingRoomBookingLogMapper.java
0 → 100644
View file @
65288165
package
com.platform.business.mapper
;
import
com.baomidou.mybatisplus.core.mapper.BaseMapper
;
import
com.platform.business.model.entity.TrainingRoomBookingLogEntity
;
import
org.apache.ibatis.annotations.Mapper
;
import
org.apache.ibatis.annotations.Param
;
import
java.util.List
;
/** 预约操作时间线数据访问接口。 */
@Mapper
public
interface
TrainingRoomBookingLogMapper
extends
BaseMapper
<
TrainingRoomBookingLogEntity
>
{
/** 查询指定预约的完整操作时间线,并按操作时间升序返回。 */
List
<
TrainingRoomBookingLogEntity
>
selectByBookingId
(
@Param
(
"bookingId"
)
String
bookingId
);
}
practical-business/src/main/java/com/platform/business/mapper/TrainingRoomBookingMapper.java
0 → 100644
View file @
65288165
package
com.platform.business.mapper
;
import
com.baomidou.mybatisplus.core.mapper.BaseMapper
;
import
com.platform.business.model.dto.TrainingRoomBookingDTO
;
import
com.platform.business.model.entity.TrainingRoomBookingEntity
;
import
com.platform.business.model.vo.TrainingRoomBookingStatisticsVO
;
import
com.platform.business.model.vo.TrainingRoomBookingVO
;
import
org.apache.ibatis.annotations.Mapper
;
import
org.apache.ibatis.annotations.Param
;
import
java.util.Date
;
import
java.util.List
;
/** 预约查询、冲突校验和状态流转数据访问接口。 */
@Mapper
public
interface
TrainingRoomBookingMapper
extends
BaseMapper
<
TrainingRoomBookingEntity
>
{
/** 管理员按实训室、日期、状态和关键字查询预约列表。 */
List
<
TrainingRoomBookingVO
>
selectAdminList
(
@Param
(
"query"
)
TrainingRoomBookingDTO
query
);
/** 查询指定学员自己的预约列表。 */
List
<
TrainingRoomBookingVO
>
selectStudentList
(
@Param
(
"studentId"
)
String
studentId
,
@Param
(
"query"
)
TrainingRoomBookingDTO
query
);
/** 查询预约详情及关联的实训室信息。 */
TrainingRoomBookingVO
selectDetail
(
@Param
(
"id"
)
String
id
);
/** 按状态统计指定实训室的预约数量。 */
TrainingRoomBookingStatisticsVO
selectStatistics
(
@Param
(
"roomId"
)
String
roomId
);
/** 统计同一实训室、日期、时段和机位上的有效预约,用于冲突校验。 */
int
countSeatConflict
(
@Param
(
"roomId"
)
String
roomId
,
@Param
(
"bookingDate"
)
String
bookingDate
,
@Param
(
"slotCode"
)
Integer
slotCode
,
@Param
(
"seatNo"
)
Integer
seatNo
);
/** 统计同一学员、日期和时段上的有效预约,用于冲突校验。 */
int
countStudentConflict
(
@Param
(
"studentId"
)
String
studentId
,
@Param
(
"bookingDate"
)
String
bookingDate
,
@Param
(
"slotCode"
)
Integer
slotCode
);
/** 查询已经到达开始时间、但状态仍为booked的预约。 */
List
<
TrainingRoomBookingEntity
>
selectDueBooked
(
@Param
(
"now"
)
Date
now
);
/** 查询已经到达结束时间、但状态仍为using的预约。 */
List
<
TrainingRoomBookingEntity
>
selectDueUsing
(
@Param
(
"now"
)
Date
now
);
/** 以条件更新方式将预约从booked变更为using。 */
int
startBooking
(
@Param
(
"id"
)
String
id
,
@Param
(
"actualStartTime"
)
Date
actualStartTime
);
/** 以条件更新方式将预约从using变更为done并释放唯一约束。 */
int
finishUsingBooking
(
@Param
(
"id"
)
String
id
,
@Param
(
"actualEndTime"
)
Date
actualEndTime
);
/** 服务停机跨过完整预约时段时,将booked预约直接补偿为done。 */
int
finishExpiredBooked
(
@Param
(
"id"
)
String
id
);
/** 仅在预约尚未开始时将其取消,并释放唯一约束。 */
int
cancelBooked
(
@Param
(
"id"
)
String
id
,
@Param
(
"cancelTime"
)
Date
cancelTime
,
@Param
(
"cancelBy"
)
String
cancelBy
);
}
practical-business/src/main/java/com/platform/business/mapper/TrainingRoomMapper.java
0 → 100644
View file @
65288165
package
com.platform.business.mapper
;
import
com.baomidou.mybatisplus.core.mapper.BaseMapper
;
import
com.platform.business.model.dto.TrainingRoomDTO
;
import
com.platform.business.model.entity.TrainingRoomEntity
;
import
com.platform.business.model.vo.TrainingRoomStatisticsVO
;
import
com.platform.business.model.vo.TrainingRoomVO
;
import
org.apache.ibatis.annotations.Mapper
;
import
org.apache.ibatis.annotations.Param
;
import
java.util.Date
;
import
java.util.List
;
/** 实训室列表、详情与KPI数据访问接口。 */
@Mapper
public
interface
TrainingRoomMapper
extends
BaseMapper
<
TrainingRoomEntity
>
{
/** 管理员查询全部有效实训室及当前使用情况。 */
List
<
TrainingRoomVO
>
selectAdminList
(
@Param
(
"query"
)
TrainingRoomDTO
query
,
@Param
(
"now"
)
Date
now
);
/** 学员查询运行中的实训室及当前使用情况。 */
List
<
TrainingRoomVO
>
selectStudentList
(
@Param
(
"query"
)
TrainingRoomDTO
query
,
@Param
(
"now"
)
Date
now
);
/** 查询单个实训室详情及动态统计数据。 */
TrainingRoomVO
selectDetail
(
@Param
(
"id"
)
String
id
,
@Param
(
"now"
)
Date
now
);
/** 查询管理员端实训室KPI。 */
TrainingRoomStatisticsVO
selectAdminStatistics
(
@Param
(
"now"
)
Date
now
);
/** 查询学员端运行中实训室KPI。 */
TrainingRoomStatisticsVO
selectStudentStatistics
(
@Param
(
"now"
)
Date
now
);
/** 检查有效实训室名称是否重复,编辑时排除当前ID。 */
int
countSameName
(
@Param
(
"name"
)
String
name
,
@Param
(
"excludeId"
)
String
excludeId
);
/** 统计指定实训室当前尚未结束的有效预约。 */
int
countActiveBookingsAfter
(
@Param
(
"roomId"
)
String
roomId
,
@Param
(
"now"
)
Date
now
);
}
practical-business/src/main/java/com/platform/business/mapper/TrainingRoomSeatMapper.java
0 → 100644
View file @
65288165
package
com.platform.business.mapper
;
import
com.baomidou.mybatisplus.core.mapper.BaseMapper
;
import
com.platform.business.model.entity.TrainingRoomSeatEntity
;
import
com.platform.business.model.vo.TrainingRoomSeatVO
;
import
org.apache.ibatis.annotations.Mapper
;
import
org.apache.ibatis.annotations.Param
;
import
java.util.List
;
/** 机位定义与指定时段可用状态查询。 */
@Mapper
public
interface
TrainingRoomSeatMapper
extends
BaseMapper
<
TrainingRoomSeatEntity
>
{
/** 查询实训室的全部机位定义,包括缩容后停用的机位。 */
List
<
TrainingRoomSeatEntity
>
selectAllByRoom
(
@Param
(
"roomId"
)
String
roomId
);
/** 校验指定编号是否为当前启用机位。 */
TrainingRoomSeatEntity
selectEnabledSeat
(
@Param
(
"roomId"
)
String
roomId
,
@Param
(
"seatNo"
)
Integer
seatNo
);
/** 一次返回指定实训室、日期和时段下的全部启用机位及动态状态。 */
List
<
TrainingRoomSeatVO
>
selectAvailability
(
@Param
(
"roomId"
)
String
roomId
,
@Param
(
"bookingDate"
)
String
bookingDate
,
@Param
(
"slotCode"
)
Integer
slotCode
);
/** 扩容时重新启用编号不大于新机位总数的历史机位。 */
int
enableSeatsUpTo
(
@Param
(
"roomId"
)
String
roomId
,
@Param
(
"seatCount"
)
Integer
seatCount
);
/** 缩容时停用编号大于新机位总数的机位。 */
int
disableSeatsAbove
(
@Param
(
"roomId"
)
String
roomId
,
@Param
(
"seatCount"
)
Integer
seatCount
);
}
practical-business/src/main/java/com/platform/business/service/AttendanceService.java
0 → 100644
View file @
65288165
package
com.platform.business.service
;
import
com.platform.business.model.dto.AttendanceCheckInDTO
;
import
com.platform.business.model.dto.AttendanceQueryDTO
;
import
com.platform.business.model.dto.AttendanceStatusUpdateDTO
;
import
com.platform.business.model.vo.AttendanceRecordVO
;
import
com.platform.business.model.vo.AttendanceSessionVO
;
import
com.platform.business.model.vo.AttendanceSummaryVO
;
import
java.util.Date
;
import
java.util.List
;
public
interface
AttendanceService
{
AttendanceSessionVO
startClass
(
Integer
subjectId
,
String
teacherId
);
AttendanceRecordVO
checkIn
(
AttendanceCheckInDTO
request
,
String
studentId
,
String
clientIp
);
AttendanceRecordVO
updateStatus
(
AttendanceStatusUpdateDTO
request
,
String
teacherId
);
List
<
AttendanceRecordVO
>
teacherRoster
(
Integer
subjectId
,
String
teacherId
);
List
<
AttendanceRecordVO
>
queryRecords
(
AttendanceQueryDTO
query
);
AttendanceSummaryVO
querySummary
(
AttendanceQueryDTO
query
);
void
finalizeEndedSubjects
(
Date
startDate
,
Date
endDate
);
}
practical-business/src/main/java/com/platform/business/service/ClassSubjectAttendanceSessionService.java
0 → 100644
View file @
65288165
package
com.platform.business.service
;
import
com.baomidou.mybatisplus.extension.service.IService
;
import
com.platform.business.model.entity.ClassSubjectAttendanceSessionEntity
;
public
interface
ClassSubjectAttendanceSessionService
extends
IService
<
ClassSubjectAttendanceSessionEntity
>
{
}
practical-business/src/main/java/com/platform/business/service/LeaveManagementService.java
0 → 100644
View file @
65288165
package
com.platform.business.service
;
import
com.platform.business.model.dto.LeaveApplyDTO
;
import
com.platform.business.model.dto.LeaveQueryDTO
;
import
com.platform.business.model.dto.LeaveReviewDTO
;
import
com.platform.business.model.vo.LeaveApplicationVO
;
import
java.util.List
;
public
interface
LeaveManagementService
{
LeaveApplicationVO
apply
(
LeaveApplyDTO
request
,
String
studentId
);
LeaveApplicationVO
update
(
LeaveApplyDTO
request
,
String
studentId
);
boolean
withdraw
(
String
leaveId
,
String
studentId
);
LeaveApplicationVO
review
(
String
leaveId
,
LeaveReviewDTO
request
,
String
approverId
,
String
approverRole
);
List
<
LeaveApplicationVO
>
queryApplications
(
LeaveQueryDTO
query
);
LeaveApplicationVO
studentDetail
(
String
leaveId
,
String
studentId
);
LeaveApplicationVO
teacherDetail
(
String
leaveId
,
String
teacherId
);
LeaveApplicationVO
adminDetail
(
String
leaveId
);
}
practical-business/src/main/java/com/platform/business/service/TrainingRoomBookingService.java
0 → 100644
View file @
65288165
package
com.platform.business.service
;
import
com.baomidou.mybatisplus.extension.service.IService
;
import
com.platform.business.model.dto.TrainingRoomBookingCreateDTO
;
import
com.platform.business.model.dto.TrainingRoomBookingDTO
;
import
com.platform.business.model.entity.TrainingRoomBookingEntity
;
import
com.platform.business.model.entity.UserEntity
;
import
com.platform.business.model.vo.TrainingRoomBookingDetailVO
;
import
com.platform.business.model.vo.TrainingRoomBookingStatisticsVO
;
import
com.platform.business.model.vo.TrainingRoomBookingVO
;
import
com.platform.business.model.vo.TrainingRoomSeatVO
;
import
com.platform.business.model.vo.TrainingRoomTimeSlotVO
;
import
java.util.List
;
/** 学员与管理员共用的预约业务服务。 */
public
interface
TrainingRoomBookingService
extends
IService
<
TrainingRoomBookingEntity
>
{
/** 管理员分页查询全部预约记录。 */
List
<
TrainingRoomBookingVO
>
adminList
(
TrainingRoomBookingDTO
query
);
/** 学员分页查询自己的预约记录。 */
List
<
TrainingRoomBookingVO
>
studentList
(
String
studentId
,
TrainingRoomBookingDTO
query
);
/** 管理员查看预约详情和完整操作记录。 */
TrainingRoomBookingDetailVO
adminDetail
(
String
id
);
/** 学员查看自己的预约详情和操作记录。 */
TrainingRoomBookingDetailVO
studentDetail
(
String
id
,
String
studentId
);
/** 获取指定实训室各预约状态的统计数量。 */
TrainingRoomBookingStatisticsVO
adminStatistics
(
String
roomId
);
/** 管理员查看指定日期和时段的机位状态,已停用实训室也可查看。 */
List
<
TrainingRoomSeatVO
>
adminAvailability
(
String
roomId
,
String
bookingDate
,
Integer
slotCode
);
/** 学员查看运行中实训室在可预约日期、时段下的全部机位状态。 */
List
<
TrainingRoomSeatVO
>
availability
(
String
roomId
,
String
bookingDate
,
Integer
slotCode
);
/** 获取系统支持的五个固定预约时段。 */
List
<
TrainingRoomTimeSlotVO
>
timeSlots
();
/** 创建预约,并执行机位冲突、学员冲突和数据库并发约束校验。 */
TrainingRoomBookingVO
createBooking
(
TrainingRoomBookingCreateDTO
request
,
UserEntity
student
);
/** 学员取消本人尚未开始的预约。 */
boolean
studentCancel
(
String
id
,
UserEntity
student
);
/** 学员提前结束本人使用中的预约。 */
boolean
studentSignOut
(
String
id
,
UserEntity
student
);
/** 管理员取消尚未开始的预约。 */
boolean
adminCancel
(
String
id
,
UserEntity
administrator
);
/** 管理员结束使用中的预约。 */
boolean
adminEnd
(
String
id
,
UserEntity
administrator
);
/** 定时任务和查询入口共同调用,用于补偿更新预约状态。 */
void
synchronizeBookingStatuses
();
}
practical-business/src/main/java/com/platform/business/service/TrainingRoomSeatService.java
0 → 100644
View file @
65288165
package
com.platform.business.service
;
import
com.baomidou.mybatisplus.extension.service.IService
;
import
com.platform.business.model.entity.TrainingRoomSeatEntity
;
/** 机位基础数据服务。 */
public
interface
TrainingRoomSeatService
extends
IService
<
TrainingRoomSeatEntity
>
{
/** 按新的机位总数启用、停用或补充编号连续的机位。 */
void
synchronizeSeats
(
String
roomId
,
Integer
seatCount
);
}
practical-business/src/main/java/com/platform/business/service/TrainingRoomService.java
0 → 100644
View file @
65288165
package
com.platform.business.service
;
import
com.baomidou.mybatisplus.extension.service.IService
;
import
com.platform.business.model.dto.TrainingRoomDTO
;
import
com.platform.business.model.entity.TrainingRoomEntity
;
import
com.platform.business.model.vo.TrainingRoomStatisticsVO
;
import
com.platform.business.model.vo.TrainingRoomVO
;
import
java.util.Date
;
import
java.util.List
;
/** 实训室管理服务。 */
public
interface
TrainingRoomService
extends
IService
<
TrainingRoomEntity
>
{
/** 管理员分页查询实训室,包含运行中和已停用状态。 */
List
<
TrainingRoomVO
>
adminList
(
TrainingRoomDTO
query
,
Date
now
);
/** 学员分页查询运行中的实训室。 */
List
<
TrainingRoomVO
>
studentList
(
TrainingRoomDTO
query
,
Date
now
);
/** 查询实训室详情及当前动态机位统计。 */
TrainingRoomVO
detail
(
String
id
,
Date
now
);
/** 获取管理员端实训室KPI。 */
TrainingRoomStatisticsVO
adminStatistics
(
Date
now
);
/** 获取学员端运行中实训室KPI。 */
TrainingRoomStatisticsVO
studentStatistics
(
Date
now
);
/** 创建实训室并同步生成连续机位编号。 */
TrainingRoomVO
createRoom
(
TrainingRoomDTO
room
);
/** 编辑实训室基本信息并同步机位数量。 */
boolean
updateRoom
(
TrainingRoomDTO
room
);
/** 单独启用或停用实训室;停用前检查未结束预约。 */
boolean
updateStatus
(
String
id
,
String
status
);
}
practical-business/src/main/java/com/platform/business/service/impl/AttendanceServiceImpl.java
0 → 100644
View file @
65288165
This diff is collapsed.
Click to expand it.
practical-business/src/main/java/com/platform/business/service/impl/ClassSubjectAttendanceSessionServiceImpl.java
0 → 100644
View file @
65288165
package
com.platform.business.service.impl
;
import
com.baomidou.mybatisplus.extension.service.impl.ServiceImpl
;
import
com.platform.business.mapper.ClassSubjectAttendanceSessionMapper
;
import
com.platform.business.model.entity.ClassSubjectAttendanceSessionEntity
;
import
com.platform.business.service.ClassSubjectAttendanceSessionService
;
import
org.springframework.stereotype.Service
;
@Service
public
class
ClassSubjectAttendanceSessionServiceImpl
extends
ServiceImpl
<
ClassSubjectAttendanceSessionMapper
,
ClassSubjectAttendanceSessionEntity
>
implements
ClassSubjectAttendanceSessionService
{
}
practical-business/src/main/java/com/platform/business/service/impl/LeaveManagementServiceImpl.java
0 → 100644
View file @
65288165
This diff is collapsed.
Click to expand it.
practical-business/src/main/java/com/platform/business/service/impl/TrainingRoomBookingServiceImpl.java
0 → 100644
View file @
65288165
This diff is collapsed.
Click to expand it.
practical-business/src/main/java/com/platform/business/service/impl/TrainingRoomSeatServiceImpl.java
0 → 100644
View file @
65288165
package
com.platform.business.service.impl
;
import
com.baomidou.mybatisplus.extension.service.impl.ServiceImpl
;
import
com.platform.business.mapper.TrainingRoomSeatMapper
;
import
com.platform.business.model.entity.TrainingRoomSeatEntity
;
import
com.platform.business.service.TrainingRoomSeatService
;
import
org.springframework.stereotype.Service
;
import
org.springframework.transaction.annotation.Transactional
;
import
java.util.ArrayList
;
import
java.util.HashSet
;
import
java.util.List
;
import
java.util.Set
;
/** 机位编号同步实现。 */
@Service
public
class
TrainingRoomSeatServiceImpl
extends
ServiceImpl
<
TrainingRoomSeatMapper
,
TrainingRoomSeatEntity
>
implements
TrainingRoomSeatService
{
@Override
@Transactional
(
rollbackFor
=
Exception
.
class
)
public
void
synchronizeSeats
(
String
roomId
,
Integer
seatCount
)
{
// 先读取包含停用机位在内的全部历史编号,避免扩容时重复插入相同编号。
List
<
TrainingRoomSeatEntity
>
existingSeats
=
baseMapper
.
selectAllByRoom
(
roomId
);
Set
<
Integer
>
existingNumbers
=
new
HashSet
<>();
for
(
TrainingRoomSeatEntity
seat
:
existingSeats
)
{
existingNumbers
.
add
(
seat
.
getSeatNo
());
}
// 扩容时先恢复曾被停用的编号,缩容时停用超出范围的编号。
baseMapper
.
enableSeatsUpTo
(
roomId
,
seatCount
);
baseMapper
.
disableSeatsAbove
(
roomId
,
seatCount
);
List
<
TrainingRoomSeatEntity
>
newSeats
=
new
ArrayList
<>();
// 仅补充数据库中从未创建过的编号,所有新增ID由MyBatis-Plus生成字符串雪花ID。
for
(
int
seatNo
=
1
;
seatNo
<=
seatCount
;
seatNo
++)
{
if
(!
existingNumbers
.
contains
(
seatNo
))
{
TrainingRoomSeatEntity
seat
=
new
TrainingRoomSeatEntity
();
seat
.
setRoomId
(
roomId
);
seat
.
setSeatNo
(
seatNo
);
seat
.
setEnabled
(
true
);
newSeats
.
add
(
seat
);
}
}
if
(!
newSeats
.
isEmpty
())
{
saveBatch
(
newSeats
);
}
}
}
practical-business/src/main/java/com/platform/business/service/impl/TrainingRoomServiceImpl.java
0 → 100644
View file @
65288165
package
com.platform.business.service.impl
;
import
com.baomidou.mybatisplus.extension.service.impl.ServiceImpl
;
import
com.platform.business.constant.TrainingRoomConstants
;
import
com.platform.business.mapper.TrainingRoomMapper
;
import
com.platform.business.model.dto.TrainingRoomDTO
;
import
com.platform.business.model.entity.TrainingRoomEntity
;
import
com.platform.business.model.entity.UserEntity
;
import
com.platform.business.model.vo.TrainingRoomStatisticsVO
;
import
com.platform.business.model.vo.TrainingRoomVO
;
import
com.platform.business.service.TrainingRoomSeatService
;
import
com.platform.business.service.TrainingRoomService
;
import
com.platform.business.service.UserService
;
import
com.platform.exception.BusinessException
;
import
org.springframework.stereotype.Service
;
import
org.springframework.transaction.annotation.Transactional
;
import
org.springframework.util.StringUtils
;
import
javax.annotation.Resource
;
import
java.math.BigDecimal
;
import
java.time.LocalTime
;
import
java.time.format.DateTimeFormatter
;
import
java.time.format.DateTimeParseException
;
import
java.util.Date
;
import
java.util.List
;
import
java.util.Locale
;
import
java.util.Objects
;
/** 实训室管理业务实现。 */
@Service
public
class
TrainingRoomServiceImpl
extends
ServiceImpl
<
TrainingRoomMapper
,
TrainingRoomEntity
>
implements
TrainingRoomService
{
private
static
final
DateTimeFormatter
TIME_FORMATTER
=
DateTimeFormatter
.
ofPattern
(
"HH:mm:ss"
);
@Resource
private
TrainingRoomSeatService
trainingRoomSeatService
;
@Resource
private
UserService
userService
;
@Override
public
List
<
TrainingRoomVO
>
adminList
(
TrainingRoomDTO
query
,
Date
now
)
{
normalizeQuery
(
query
,
false
);
return
baseMapper
.
selectAdminList
(
query
,
now
);
}
@Override
public
List
<
TrainingRoomVO
>
studentList
(
TrainingRoomDTO
query
,
Date
now
)
{
normalizeQuery
(
query
,
true
);
return
baseMapper
.
selectStudentList
(
query
,
now
);
}
@Override
public
TrainingRoomVO
detail
(
String
id
,
Date
now
)
{
requireRoom
(
id
);
return
baseMapper
.
selectDetail
(
id
,
now
);
}
@Override
public
TrainingRoomStatisticsVO
adminStatistics
(
Date
now
)
{
return
baseMapper
.
selectAdminStatistics
(
now
);
}
@Override
public
TrainingRoomStatisticsVO
studentStatistics
(
Date
now
)
{
return
baseMapper
.
selectStudentStatistics
(
now
);
}
@Override
@Transactional
(
rollbackFor
=
Exception
.
class
)
public
TrainingRoomVO
createRoom
(
TrainingRoomDTO
request
)
{
validateAndNormalizeRoom
(
request
);
if
(
baseMapper
.
countSameName
(
request
.
getName
(),
null
)
>
0
)
{
throw
new
BusinessException
(
"实训室名称已存在"
);
}
TrainingRoomEntity
room
=
copyEditableFields
(
request
);
room
.
setStatus
(
StringUtils
.
hasText
(
request
.
getStatus
())
?
request
.
getStatus
()
:
TrainingRoomConstants
.
ROOM_RUNNING
);
validateRoomStatus
(
room
.
getStatus
());
room
.
setDelFlag
(
0
);
if
(!
save
(
room
))
{
throw
new
BusinessException
(
"实训室创建失败"
);
}
// 创建实训室后生成1至seatCount的连续机位编号。
trainingRoomSeatService
.
synchronizeSeats
(
room
.
getId
(),
room
.
getSeatCount
());
return
baseMapper
.
selectDetail
(
room
.
getId
(),
new
Date
());
}
@Override
@Transactional
(
rollbackFor
=
Exception
.
class
)
public
boolean
updateRoom
(
TrainingRoomDTO
request
)
{
if
(
request
==
null
||
!
StringUtils
.
hasText
(
request
.
getId
()))
{
throw
new
BusinessException
(
"实训室ID不能为空"
);
}
TrainingRoomEntity
current
=
requireRoom
(
request
.
getId
());
validateAndNormalizeRoom
(
request
);
if
(
baseMapper
.
countSameName
(
request
.
getName
(),
request
.
getId
())
>
0
)
{
throw
new
BusinessException
(
"实训室名称已存在"
);
}
boolean
reducingSeats
=
request
.
getSeatCount
()
<
current
.
getSeatCount
();
boolean
changingOpenTime
=
!
Objects
.
equals
(
request
.
getAllDay
(),
current
.
getAllDay
())
||
!
Objects
.
equals
(
request
.
getOpenStart
(),
current
.
getOpenStart
())
||
!
Objects
.
equals
(
request
.
getOpenEnd
(),
current
.
getOpenEnd
());
if
((
reducingSeats
||
changingOpenTime
)
&&
baseMapper
.
countActiveBookingsAfter
(
current
.
getId
(),
new
Date
())
>
0
)
{
throw
new
BusinessException
(
"存在未结束预约,请先取消相关预约后再缩减机位或修改开放时间"
);
}
TrainingRoomEntity
update
=
copyEditableFields
(
request
);
update
.
setId
(
current
.
getId
());
// 状态只能通过单独的启用/停用接口修改,避免编辑表单绕过预约检查。
update
.
setStatus
(
current
.
getStatus
());
update
.
setUpdateTime
(
new
Date
());
if
(!
updateById
(
update
))
{
throw
new
BusinessException
(
"实训室更新失败"
);
}
trainingRoomSeatService
.
synchronizeSeats
(
current
.
getId
(),
request
.
getSeatCount
());
return
true
;
}
@Override
@Transactional
(
rollbackFor
=
Exception
.
class
)
public
boolean
updateStatus
(
String
id
,
String
status
)
{
TrainingRoomEntity
room
=
requireRoom
(
id
);
String
normalizedStatus
=
status
==
null
?
""
:
status
.
trim
().
toLowerCase
(
Locale
.
ROOT
);
validateRoomStatus
(
normalizedStatus
);
if
(
Objects
.
equals
(
room
.
getStatus
(),
normalizedStatus
))
{
return
true
;
}
if
(
TrainingRoomConstants
.
ROOM_DISABLED
.
equals
(
normalizedStatus
)
&&
baseMapper
.
countActiveBookingsAfter
(
id
,
new
Date
())
>
0
)
{
throw
new
BusinessException
(
"存在未结束预约,请先取消相关预约后再停用实训室"
);
}
TrainingRoomEntity
update
=
new
TrainingRoomEntity
();
update
.
setId
(
id
);
update
.
setStatus
(
normalizedStatus
);
update
.
setUpdateTime
(
new
Date
());
if
(!
updateById
(
update
))
{
throw
new
BusinessException
(
"实训室状态更新失败"
);
}
return
true
;
}
/** 根据ID查询未逻辑删除的实训室,不存在时统一抛出业务异常。 */
private
TrainingRoomEntity
requireRoom
(
String
id
)
{
if
(!
StringUtils
.
hasText
(
id
))
{
throw
new
BusinessException
(
"实训室ID不能为空"
);
}
TrainingRoomEntity
room
=
getById
(
id
);
if
(
room
==
null
)
{
throw
new
BusinessException
(
"实训室不存在"
);
}
return
room
;
}
/** 校验必填字段,并将开放时间统一规范为 HH:mm:ss。 */
private
void
validateAndNormalizeRoom
(
TrainingRoomDTO
room
)
{
if
(
room
==
null
)
{
throw
new
BusinessException
(
"实训室参数不能为空"
);
}
if
(!
StringUtils
.
hasText
(
room
.
getName
()))
{
throw
new
BusinessException
(
"实训室名称不能为空"
);
}
if
(!
StringUtils
.
hasText
(
room
.
getLocation
()))
{
throw
new
BusinessException
(
"实训室位置不能为空"
);
}
room
.
setName
(
room
.
getName
().
trim
());
room
.
setLocation
(
room
.
getLocation
().
trim
());
if
(
room
.
getName
().
length
()
>
100
||
room
.
getLocation
().
length
()
>
200
)
{
throw
new
BusinessException
(
"实训室名称或位置长度超出限制"
);
}
if
(
room
.
getSeatCount
()
==
null
||
room
.
getSeatCount
()
<
1
)
{
throw
new
BusinessException
(
"机位总数必须大于0"
);
}
if
(
room
.
getArea
()
!=
null
&&
room
.
getArea
().
compareTo
(
BigDecimal
.
ZERO
)
<
0
)
{
throw
new
BusinessException
(
"实训室面积不能小于0"
);
}
validateManager
(
room
.
getManagerId
());
boolean
allDay
=
Boolean
.
TRUE
.
equals
(
room
.
getAllDay
());
room
.
setAllDay
(
allDay
);
if
(
allDay
)
{
room
.
setOpenStart
(
null
);
room
.
setOpenEnd
(
null
);
}
else
{
LocalTime
start
=
parseTime
(
room
.
getOpenStart
(),
"开放开始时间"
);
LocalTime
end
=
parseTime
(
room
.
getOpenEnd
(),
"开放结束时间"
);
if
(!
start
.
isBefore
(
end
))
{
throw
new
BusinessException
(
"开放开始时间必须早于结束时间"
);
}
room
.
setOpenStart
(
start
.
format
(
TIME_FORMATTER
));
room
.
setOpenEnd
(
end
.
format
(
TIME_FORMATTER
));
}
}
/** 管理员字段可以为空;有值时必须关联到有效的user.id。 */
private
void
validateManager
(
String
managerId
)
{
if
(!
StringUtils
.
hasText
(
managerId
))
{
return
;
}
UserEntity
manager
=
userService
.
getById
(
managerId
);
if
(
manager
==
null
||
Boolean
.
TRUE
.
equals
(
manager
.
getDelFlag
()))
{
throw
new
BusinessException
(
"实训室管理员不存在"
);
}
}
/** 实训室状态仅允许running和disabled。 */
private
void
validateRoomStatus
(
String
status
)
{
if
(!
TrainingRoomConstants
.
ROOM_RUNNING
.
equals
(
status
)
&&
!
TrainingRoomConstants
.
ROOM_DISABLED
.
equals
(
status
))
{
throw
new
BusinessException
(
"实训室状态只支持运行中或已停用"
);
}
}
/** 兼容HH:mm和HH:mm:ss输入,并统一转换为HH:mm:ss。 */
private
LocalTime
parseTime
(
String
value
,
String
fieldName
)
{
if
(!
StringUtils
.
hasText
(
value
))
{
throw
new
BusinessException
(
fieldName
+
"不能为空"
);
}
try
{
String
normalized
=
value
.
trim
().
length
()
==
5
?
value
.
trim
()
+
":00"
:
value
.
trim
();
return
LocalTime
.
parse
(
normalized
,
TIME_FORMATTER
);
}
catch
(
DateTimeParseException
e
)
{
throw
new
BusinessException
(
fieldName
+
"格式必须为HH:mm"
);
}
}
/** 只复制管理员允许编辑的字段,防止覆盖逻辑删除和审计字段。 */
private
TrainingRoomEntity
copyEditableFields
(
TrainingRoomDTO
source
)
{
TrainingRoomEntity
target
=
new
TrainingRoomEntity
();
target
.
setName
(
source
.
getName
());
target
.
setLocation
(
source
.
getLocation
());
target
.
setArea
(
source
.
getArea
());
target
.
setAllDay
(
source
.
getAllDay
());
target
.
setOpenStart
(
source
.
getOpenStart
());
target
.
setOpenEnd
(
source
.
getOpenEnd
());
target
.
setSeatCount
(
source
.
getSeatCount
());
target
.
setLayoutDescription
(
StringUtils
.
hasText
(
source
.
getLayoutDescription
())
?
source
.
getLayoutDescription
().
trim
()
:
source
.
getSeatCount
()
+
"个机位"
);
target
.
setManagerId
(
StringUtils
.
hasText
(
source
.
getManagerId
())
?
source
.
getManagerId
().
trim
()
:
null
);
target
.
setRemark
(
StringUtils
.
hasText
(
source
.
getRemark
())
?
source
.
getRemark
().
trim
()
:
null
);
return
target
;
}
/** 清理列表查询参数,并分别校验管理员端状态和学员端动态状态。 */
private
void
normalizeQuery
(
TrainingRoomDTO
query
,
boolean
student
)
{
if
(
query
==
null
)
{
throw
new
BusinessException
(
"查询参数不能为空"
);
}
if
(
StringUtils
.
hasText
(
query
.
getKeyword
()))
{
query
.
setKeyword
(
query
.
getKeyword
().
trim
());
}
if
(
student
&&
StringUtils
.
hasText
(
query
.
getAvailabilityStatus
()))
{
String
status
=
query
.
getAvailabilityStatus
().
trim
().
toLowerCase
(
Locale
.
ROOT
);
if
(!
"all"
.
equals
(
status
)
&&
!
"free"
.
equals
(
status
)
&&
!
"busy"
.
equals
(
status
)
&&
!
"full"
.
equals
(
status
))
{
throw
new
BusinessException
(
"不支持的实训室可用状态"
);
}
query
.
setAvailabilityStatus
(
status
);
}
if
(!
student
&&
StringUtils
.
hasText
(
query
.
getStatus
()))
{
String
status
=
query
.
getStatus
().
trim
().
toLowerCase
(
Locale
.
ROOT
);
if
(!
"all"
.
equals
(
status
))
{
validateRoomStatus
(
status
);
}
query
.
setStatus
(
status
);
}
}
}
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