puzhibing
2026-05-06 f38e9ae62489022734c6d8a7b98f010133c6cf24
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
package com.xiaopeng.maintenance.controller;
 
 
import com.xiaopeng.common.core.domain.R;
import com.xiaopeng.common.core.web.page.PageInfo;
import com.xiaopeng.common.security.service.TokenService;
import com.xiaopeng.maintenance.dto.ClockDTO;
import com.xiaopeng.maintenance.dto.ClockInStatisticsDto;
import com.xiaopeng.maintenance.dto.GetClockInStatisticsDetailsDto;
import com.xiaopeng.maintenance.dto.VerifyRangeDTO;
import com.xiaopeng.maintenance.service.IXpClockInService;
import com.xiaopeng.maintenance.vo.ClockInStatisticsDetailsVo;
import com.xiaopeng.maintenance.vo.ClockInStatisticsVo;
import io.swagger.annotations.ApiOperation;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
 
import javax.servlet.http.HttpServletResponse;
 
/**
 * <p>
 * 打卡明细 前端控制器
 * </p>
 * 打卡管理 Controller
 *
 * @author xiaochen
 * @author mitao
 * @date 2026-02-14
 * @since 2026-02-06
 */
@Slf4j
@RestController
@RequestMapping("")
public class XpClockInController {
 
    @Autowired
    private IXpClockInService xpClockInService;
    @Autowired
    private TokenService tokenService;
 
    @ApiOperation(value = "校验是否在打卡范围内", tags = "运维APP-排班与考勤")
    @PostMapping("/maintenance-app/api/v1/clock/verifyRange")
    public R<Boolean> verifyRange(@RequestBody VerifyRangeDTO dto) {
        return R.ok(xpClockInService.verifyRange(dto));
    }
 
    @ApiOperation(value = "上班打卡", tags = "运维APP-排班与考勤")
    @PostMapping("/maintenance-app/api/v1/clock/clockIn")
    public R<Integer> clockIn(@RequestBody ClockDTO dto) {
        Long id = tokenService.getLoginOperationUser().getId();
        dto.setOperationsUserId(id);
        return xpClockInService.clockIn(dto);
    }
 
    /**
     * 检查用户是否上班中(内部接口)
     */
    @GetMapping("/logan/inner/clock-in/checkWorkStatus")
    @ApiOperation(value = "检查用户是否上班中", tags = {"内部接口"})
    public R<Integer> checkWorkStatus(@RequestParam("appUserId") Long appUserId) {
        log.info("检查用户上班状态, appUserId={}", appUserId);
        Integer workFlag = xpClockInService.checkWorkStatus(appUserId);
        return R.ok(workFlag);
    }
 
    @ApiOperation(value = "下班打卡", tags = "运维APP-排班与考勤")
    @PostMapping("/maintenance-app/api/v1/clock/clockOut")
    public R<Integer> clockOut(@RequestBody ClockDTO dto) {
        Long id = tokenService.getLoginOperationUser().getId();
        dto.setOperationsUserId(id);
        return xpClockInService.clockOut(dto);
    }
 
 
    @ApiOperation(value = "排班考勤打卡统计列表", tags = {"管理后台-运维执行"})
    @PostMapping("/api/v1/clock/getClockInStatistics")
    public R<PageInfo<ClockInStatisticsDto>> getClockInStatistics(@RequestBody ClockInStatisticsVo vo) {
        PageInfo<ClockInStatisticsDto> clockInStatistics = xpClockInService.getClockInStatistics(vo);
        return R.ok(clockInStatistics);
    }
 
 
    @ApiOperation(value = "排班考勤打卡统计导出", tags = {"管理后台-运维执行"})
    @PostMapping("/api/v1/clock/exportClockInStatistics")
    public void exportClockInStatistics(@RequestBody ClockInStatisticsVo vo, HttpServletResponse response) {
        xpClockInService.exportClockInStatistics(vo, response);
    }
 
 
    @ApiOperation(value = "排班考勤打卡统计详情列表", tags = {"管理后台-运维执行"})
    @PostMapping("/api/v1/clock/getClockInStatisticsDetails")
    public R<GetClockInStatisticsDetailsDto> getClockInStatisticsDetails(@RequestBody ClockInStatisticsDetailsVo query) {
        GetClockInStatisticsDetailsDto clockInStatisticsDetails = xpClockInService.getClockInStatisticsDetails(query);
        return R.ok(clockInStatisticsDetails);
    }
 
 
    @ApiOperation(value = "排班考勤打卡统计详情导出", tags = {"管理后台-运维执行"})
    @PostMapping("/api/v1/clock/exportClockInStatisticsDetails")
    public void exportClockInStatisticsDetails(@RequestBody ClockInStatisticsDetailsVo query, HttpServletResponse response) {
        xpClockInService.exportClockInStatisticsDetails(query, response);
    }
 
}