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

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

parent 903ab81c
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);
}
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);
}
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);
}
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);
}
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);
}
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);
}
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);
}
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);
}
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);
}
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> {
}
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);
}
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();
}
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);
}
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);
}
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 {
}
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);
}
}
}
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);
}
}
}
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