云
2026-09-29 f87ce86307056f63f79312178037cc8714eb2b13
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
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
package cn.iocoder.yudao.module.archive.controller.admin.borrow;
 
import cn.hutool.core.collection.CollUtil;
import cn.iocoder.yudao.framework.common.pojo.CommonResult;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
import cn.iocoder.yudao.module.archive.controller.admin.borrow.vo.ArchiveBorrowPageReqVO;
import cn.iocoder.yudao.module.archive.controller.admin.borrow.vo.ArchiveBorrowRespVO;
import cn.iocoder.yudao.module.archive.controller.admin.borrow.vo.ArchiveBorrowReturnReqVO;
import cn.iocoder.yudao.module.archive.controller.admin.borrow.vo.ArchiveBorrowSaveReqVO;
import cn.iocoder.yudao.module.archive.dal.dataobject.borrow.ArchiveBorrowDO;
import cn.iocoder.yudao.module.archive.enums.ArchiveBorrowStatusEnum;
import cn.iocoder.yudao.module.archive.service.borrow.ArchiveBorrowService;
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.validation.Valid;
import org.springframework.security.access.prepost.PreAuthorize;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;
 
import java.time.LocalDate;
import java.time.temporal.ChronoUnit;
import java.util.Collections;
import java.util.List;
import java.util.Map;
 
import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
import static cn.iocoder.yudao.framework.common.util.collection.MapUtils.findAndThen;
 
@Tag(name = "管理后台 - 档案借阅")
@RestController
@RequestMapping("/archive/borrow")
@Validated
public class ArchiveBorrowController {
 
    @Resource
    private ArchiveBorrowService borrowService;
 
    @Resource
    private AdminUserApi adminUserApi;
 
    @PostMapping("/create")
    @Operation(summary = "创建档案借阅单(草稿)")
    @PreAuthorize("@ss.hasPermission('archive:borrow:create')")
    public CommonResult<Long> createBorrow(@Valid @RequestBody ArchiveBorrowSaveReqVO createReqVO) {
        return success(borrowService.createBorrow(createReqVO));
    }
 
    @PutMapping("/update")
    @Operation(summary = "更新档案借阅单(仅草稿或已驳回可修改)")
    @PreAuthorize("@ss.hasPermission('archive:borrow:update')")
    public CommonResult<Boolean> updateBorrow(@Valid @RequestBody ArchiveBorrowSaveReqVO updateReqVO) {
        borrowService.updateBorrow(updateReqVO);
        return success(true);
    }
 
    @DeleteMapping("/delete")
    @Operation(summary = "删除档案借阅单(仅草稿可删除)")
    @Parameter(name = "id", description = "编号", required = true)
    @PreAuthorize("@ss.hasPermission('archive:borrow:delete')")
    public CommonResult<Boolean> deleteBorrow(@RequestParam("id") Long id) {
        borrowService.deleteBorrow(id);
        return success(true);
    }
 
    @GetMapping("/get")
    @Operation(summary = "获得档案借阅单")
    @Parameter(name = "id", description = "编号", required = true, example = "1024")
    @PreAuthorize("@ss.hasPermission('archive:borrow:query')")
    public CommonResult<ArchiveBorrowRespVO> getBorrow(@RequestParam("id") Long id) {
        return success(buildBorrowDetail(borrowService.getBorrow(id)));
    }
 
    @GetMapping("/page")
    @Operation(summary = "获得档案借阅单分页")
    @PreAuthorize("@ss.hasPermission('archive:borrow:query')")
    public CommonResult<PageResult<ArchiveBorrowRespVO>> getBorrowPage(@Valid ArchiveBorrowPageReqVO pageReqVO) {
        PageResult<ArchiveBorrowDO> pageResult = borrowService.getBorrowPage(pageReqVO);
        return success(new PageResult<>(buildBorrowDetailList(pageResult.getList()), pageResult.getTotal()));
    }
 
    @GetMapping("/overdue-page")
    @Operation(summary = "获得逾期未还借阅单分页(借出中 且 归还期限已过)")
    @PreAuthorize("@ss.hasPermission('archive:borrow:query')")
    public CommonResult<PageResult<ArchiveBorrowRespVO>> getOverdueBorrowPage(
            @Valid ArchiveBorrowPageReqVO pageReqVO) {
        PageResult<ArchiveBorrowDO> pageResult = borrowService.getOverdueBorrowPage(pageReqVO);
        return success(new PageResult<>(buildBorrowDetailList(pageResult.getList()), pageResult.getTotal()));
    }
 
    @PostMapping("/submit")
    @Operation(summary = "提交档案借阅审批")
    @PreAuthorize("@ss.hasPermission('archive:borrow:submit')")
    public CommonResult<Boolean> submitBorrow(@RequestParam("id") Long id,
                                              @RequestParam(value = "processDefinitionKey", required = false)
                                              String processDefinitionKey) {
        borrowService.submitBorrow(id, processDefinitionKey);
        return success(true);
    }
 
    @GetMapping("/approve-process-list")
    @Operation(summary = "获得档案借阅审批的流程定义列表")
    @PreAuthorize("@ss.hasPermission('archive:borrow:query')")
    public CommonResult<List<Map<String, Object>>> getApproveProcessDefinitionList() {
        return success(borrowService.getApproveProcessDefinitionList());
    }
 
    @PostMapping("/return")
    @Operation(summary = "归还登记(仅借出中可登记,归还后档案回到在库)")
    @PreAuthorize("@ss.hasPermission('archive:borrow:return')")
    public CommonResult<Boolean> returnBorrow(@Valid @RequestBody ArchiveBorrowReturnReqVO returnReqVO) {
        borrowService.returnBorrow(returnReqVO);
        return success(true);
    }
 
    // ==================== 内部方法 ====================
 
    private ArchiveBorrowRespVO buildBorrowDetail(ArchiveBorrowDO borrow) {
        if (borrow == null) {
            return null;
        }
        return buildBorrowDetailList(Collections.singletonList(borrow)).get(0);
    }
 
    private List<ArchiveBorrowRespVO> buildBorrowDetailList(List<ArchiveBorrowDO> list) {
        if (CollUtil.isEmpty(list)) {
            return Collections.emptyList();
        }
 
        // 1. 归还确认人姓名
        Map<Long, AdminUserRespDTO> confirmUserMap = adminUserApi.getUserMap(
                convertSet(list, ArchiveBorrowDO::getReturnConfirmUserId));
 
        // 2. 拼接结果(逾期状态实时计算,不落库)
        LocalDate today = LocalDate.now();
        return BeanUtils.toBean(list, ArchiveBorrowRespVO.class, vo -> {
            findAndThen(confirmUserMap, vo.getReturnConfirmUserId(),
                    user -> vo.setReturnConfirmUserName(user.getNickname()));
            boolean overdue = ArchiveBorrowStatusEnum.BORROWED.getStatus().equals(vo.getStatus())
                    && vo.getReturnDeadline() != null && vo.getReturnDeadline().isBefore(today);
            vo.setOverdue(overdue);
            vo.setOverdueDays(overdue ? ChronoUnit.DAYS.between(vo.getReturnDeadline(), today) : 0L);
        });
    }
 
}