package cn.iocoder.yudao.module.hrm.controller.admin.attendance;
|
|
import cn.hutool.core.collection.CollUtil;
|
import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
|
import cn.iocoder.yudao.framework.common.pojo.CommonResult;
|
import cn.iocoder.yudao.framework.common.pojo.PageParam;
|
import cn.iocoder.yudao.framework.common.pojo.PageResult;
|
import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
|
import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
|
import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.HrmAttendanceRecordPageReqVO;
|
import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.HrmAttendanceRecordRespVO;
|
import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.HrmAttendanceRecordDO;
|
import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.HrmEmployeeDO;
|
import cn.iocoder.yudao.module.hrm.service.attendance.HrmAttendanceRecordService;
|
import cn.iocoder.yudao.module.hrm.service.employee.HrmEmployeeService;
|
import cn.iocoder.yudao.module.system.api.dept.DeptApi;
|
import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
|
import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
|
import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
|
import io.swagger.v3.oas.annotations.Operation;
|
import io.swagger.v3.oas.annotations.Parameter;
|
import io.swagger.v3.oas.annotations.tags.Tag;
|
import jakarta.annotation.Resource;
|
import jakarta.servlet.http.HttpServletResponse;
|
import jakarta.validation.Valid;
|
import org.springframework.security.access.prepost.PreAuthorize;
|
import org.springframework.validation.annotation.Validated;
|
import org.springframework.web.bind.annotation.*;
|
|
import java.io.IOException;
|
import java.time.LocalDateTime;
|
import java.util.*;
|
import java.util.stream.Collectors;
|
|
import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
|
import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
|
import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
|
import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_NOT_EXISTS;
|
|
@Tag(name = "管理后台 - HRM 考勤记录")
|
@RestController
|
@RequestMapping("/hrm/attendance/record")
|
@Validated
|
public class HrmAttendanceRecordController {
|
|
@Resource
|
private HrmAttendanceRecordService attendanceRecordService;
|
@Resource
|
private HrmEmployeeService employeeService;
|
@Resource
|
private DeptApi deptApi;
|
@Resource
|
private AdminUserApi adminUserApi;
|
|
@PostMapping("/clock-in")
|
@Operation(summary = "上班打卡")
|
@PreAuthorize("@ss.hasPermission('hrm:attendance:clock')")
|
public CommonResult<HrmAttendanceRecordRespVO> clockIn(@RequestParam("location") String location) {
|
Long loginUserId = getLoginUserId();
|
HrmEmployeeDO employee = employeeService.getEmployeeByUserId(loginUserId);
|
if (employee == null) {
|
throw exception(EMPLOYEE_NOT_EXISTS, "当前用户未关联员工信息，无法打卡");
|
}
|
HrmAttendanceRecordDO record = attendanceRecordService.clockIn(employee.getId(), LocalDateTime.now(), location);
|
HrmAttendanceRecordRespVO respVO = BeanUtils.toBean(record, HrmAttendanceRecordRespVO.class);
|
respVO.setUserName(employee.getName());
|
if (record.getDeptId() != null) {
|
DeptRespDTO dept = deptApi.getDept(record.getDeptId());
|
if (dept != null) {
|
respVO.setDeptName(dept.getName());
|
}
|
}
|
return success(respVO);
|
}
|
|
@PostMapping("/clock-out")
|
@Operation(summary = "下班打卡")
|
@PreAuthorize("@ss.hasPermission('hrm:attendance:clock')")
|
public CommonResult<HrmAttendanceRecordRespVO> clockOut(@RequestParam("location") String location) {
|
Long loginUserId = getLoginUserId();
|
HrmEmployeeDO employee = employeeService.getEmployeeByUserId(loginUserId);
|
if (employee == null) {
|
throw exception(EMPLOYEE_NOT_EXISTS, "当前用户未关联员工信息，无法打卡");
|
}
|
HrmAttendanceRecordDO record = attendanceRecordService.clockOut(employee.getId(), LocalDateTime.now(), location);
|
HrmAttendanceRecordRespVO respVO = BeanUtils.toBean(record, HrmAttendanceRecordRespVO.class);
|
respVO.setUserName(employee.getName());
|
if (record.getDeptId() != null) {
|
DeptRespDTO dept = deptApi.getDept(record.getDeptId());
|
if (dept != null) {
|
respVO.setDeptName(dept.getName());
|
}
|
}
|
return success(respVO);
|
}
|
|
private Long getLoginUserId() {
|
return cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId();
|
}
|
|
@GetMapping("/page")
|
@Operation(summary = "获得考勤记录分页")
|
@PreAuthorize("@ss.hasPermission('hrm:attendance:query')")
|
public CommonResult<PageResult<HrmAttendanceRecordRespVO>> getAttendanceRecordPage(@Valid HrmAttendanceRecordPageReqVO pageReqVO) {
|
PageResult<HrmAttendanceRecordDO> pageResult = attendanceRecordService.getAttendanceRecordPage(pageReqVO);
|
// 转换为 VO
|
List<HrmAttendanceRecordRespVO> list = BeanUtils.toBean(pageResult.getList(), HrmAttendanceRecordRespVO.class);
|
// 填充员工和部门信息
|
if (CollUtil.isNotEmpty(list)) {
|
fillUserInfo(list, pageResult.getList());
|
}
|
return success(new PageResult<>(list, pageResult.getTotal()));
|
}
|
|
/**
|
* 填充员工和部门信息
|
* 注意：考勤记录的 userId 是员工ID，不是系统用户ID
|
*/
|
private void fillUserInfo(List<HrmAttendanceRecordRespVO> respList, List<HrmAttendanceRecordDO> recordList) {
|
// 批量获取员工信息（userId 是员工ID）
|
Set<Long> employeeIds = recordList.stream()
|
.map(HrmAttendanceRecordDO::getUserId)
|
.filter(Objects::nonNull)
|
.collect(Collectors.toSet());
|
Map<Long, HrmEmployeeDO> employeeMap = new HashMap<>();
|
for (Long employeeId : employeeIds) {
|
HrmEmployeeDO employee = employeeService.getEmployee(employeeId);
|
if (employee != null) {
|
employeeMap.put(employeeId, employee);
|
}
|
}
|
// 批量获取部门信息
|
Set<Long> deptIds = recordList.stream()
|
.map(HrmAttendanceRecordDO::getDeptId)
|
.filter(Objects::nonNull)
|
.collect(Collectors.toSet());
|
Map<Long, DeptRespDTO> deptMap = CollUtil.isEmpty(deptIds) ? Collections.emptyMap() : deptApi.getDeptMap(deptIds);
|
|
// 填充信息
|
for (HrmAttendanceRecordRespVO respVO : respList) {
|
// 通过员工ID获取员工信息，再获取员工姓名
|
HrmEmployeeDO employee = employeeMap.get(respVO.getUserId());
|
if (employee != null) {
|
respVO.setUserName(employee.getName());
|
}
|
// 部门名称
|
DeptRespDTO dept = deptMap.get(respVO.getDeptId());
|
if (dept != null) {
|
respVO.setDeptName(dept.getName());
|
}
|
}
|
}
|
|
@GetMapping("/get")
|
@Operation(summary = "获得考勤记录")
|
@Parameter(name = "id", description = "记录ID", required = true)
|
@PreAuthorize("@ss.hasPermission('hrm:attendance:query')")
|
public CommonResult<HrmAttendanceRecordRespVO> getAttendanceRecord(@RequestParam("id") Long id) {
|
HrmAttendanceRecordDO attendanceRecord = attendanceRecordService.getAttendanceRecord(id);
|
if (attendanceRecord == null) {
|
return success(null);
|
}
|
HrmAttendanceRecordRespVO respVO = BeanUtils.toBean(attendanceRecord, HrmAttendanceRecordRespVO.class);
|
// 填充员工和部门信息（userId 是员工ID）
|
if (attendanceRecord.getUserId() != null) {
|
HrmEmployeeDO employee = employeeService.getEmployee(attendanceRecord.getUserId());
|
if (employee != null) {
|
respVO.setUserName(employee.getName());
|
}
|
}
|
if (attendanceRecord.getDeptId() != null) {
|
DeptRespDTO dept = deptApi.getDept(attendanceRecord.getDeptId());
|
if (dept != null) {
|
respVO.setDeptName(dept.getName());
|
}
|
}
|
return success(respVO);
|
}
|
|
@GetMapping("/export-excel")
|
@Operation(summary = "导出考勤记录 Excel")
|
@PreAuthorize("@ss.hasPermission('hrm:attendance:export')")
|
@ApiAccessLog(operateType = EXPORT)
|
public void exportAttendanceRecordExcel(@Valid HrmAttendanceRecordPageReqVO pageReqVO,
|
HttpServletResponse response) throws IOException {
|
pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
|
PageResult<HrmAttendanceRecordDO> pageResult = attendanceRecordService.getAttendanceRecordPage(pageReqVO);
|
List<HrmAttendanceRecordDO> recordList = pageResult.getList();
|
// 转换为 VO
|
List<HrmAttendanceRecordRespVO> list = BeanUtils.toBean(recordList, HrmAttendanceRecordRespVO.class);
|
// 填充员工和部门信息
|
if (CollUtil.isNotEmpty(list)) {
|
fillUserInfo(list, recordList);
|
}
|
ExcelUtils.write(response, "考勤记录.xls", "数据", HrmAttendanceRecordRespVO.class, list);
|
}
|
|
}
|
