package com.kaidi.oa.web;
import com.kaidi.oa.common.ApiException;
import com.kaidi.oa.common.ApiResp;
import com.kaidi.oa.common.NotFoundException;
import com.kaidi.oa.domain.Archive;
import com.kaidi.oa.domain.ArchiveReservation;
import com.kaidi.oa.repository.ArchiveRepository;
import com.kaidi.oa.repository.ArchiveReservationRepository;
import org.springframework.transaction.annotation.Transactional;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import java.time.Instant;
import java.time.LocalDate;
import java.util.List;
/**
* 资料室·预约与续借管理(Module 5「预约与续借」缺口补深)。
* 档案被借出时,其他用户可排队预约;归还后按预约队列通知可借(状态「排队中→可借」)。
* 预约人再发起正式借阅后状态置「已转借阅」。补审计「预约与续借完全缺」缺口。
*
*
状态机:
*
* 排队中 ──(档案归还通知)notify──▶ 可借 ──(预约人发起借阅)convert──▶ 已转借阅(终态)
* 排队中 / 可借 ──cancel──▶ 已取消(终态)
*
*
* 排队序号(queueNo):同一档案下先到先得,新预约自动取当前最大序号+1。
* 写口受 default-deny(ADMIN/APPROVER) 保护。
*/
@RestController
@RequestMapping("/api/oa/archive-reservations")
public class ArchiveReservationController {
private final ArchiveReservationRepository reserveRepo;
private final ArchiveRepository archiveRepo;
public ArchiveReservationController(ArchiveReservationRepository reserveRepo,
ArchiveRepository archiveRepo) {
this.reserveRepo = reserveRepo;
this.archiveRepo = archiveRepo;
}
@GetMapping
public ApiResp> list(@RequestParam(required = false) String status) {
if (status != null && !status.isBlank()) {
return ApiResp.ok(reserveRepo.findByStatus(status));
}
return ApiResp.ok(reserveRepo.findAll());
}
/** 某档案的预约队列(按排队序号升序)。 */
@GetMapping("/by-archive/{archiveId}")
public ApiResp> byArchive(@PathVariable Long archiveId) {
return ApiResp.ok(reserveRepo.findByArchiveIdOrderByQueueNoAsc(archiveId));
}
@GetMapping("/{id}")
public ApiResp get(@PathVariable Long id) {
return ApiResp.ok(require(id));
}
public record CreateRequest(
Long archiveId, String requester, String requesterDept, String purpose) {
}
/**
* 发起预约(排队中)。自动计算排队序号(同档案现有非终止预约数+1)。
* 同一用户对同一档案只可有一条「排队中/可借」预约(防重复排队)。
*/
@PostMapping
@Transactional
public ApiResp create(@RequestBody CreateRequest req) {
if (req.archiveId() == null) {
throw new ApiException(400, "档案 id(archiveId) 不能为空");
}
if (req.requester() == null || req.requester().isBlank()) {
throw new ApiException(400, "预约人(requester) 不能为空");
}
Archive arch = archiveRepo.findById(req.archiveId())
.orElseThrow(() -> new NotFoundException("archive not found: " + req.archiveId()));
// 防重复:同用户对同档案只能有一条活跃预约
List existing = reserveRepo.findByArchiveIdOrderByQueueNoAsc(req.archiveId())
.stream()
.filter(r -> req.requester().equals(r.getRequester())
&& ("排队中".equals(r.getStatus()) || "可借".equals(r.getStatus())))
.toList();
if (!existing.isEmpty()) {
throw new ApiException(409, "您已对该档案有一条预约(序号 " + existing.get(0).getQueueNo() + "),请勿重复预约");
}
// 队尾排号
long activeCount = reserveRepo.findByArchiveIdOrderByQueueNoAsc(req.archiveId())
.stream()
.filter(r -> "排队中".equals(r.getStatus()) || "可借".equals(r.getStatus()))
.count();
ArchiveReservation rsv = new ArchiveReservation();
rsv.setCode("YY-" + (reserveRepo.count() + 1));
rsv.setArchiveId(arch.getId());
rsv.setArchiveTitle(arch.getTitle());
rsv.setRequester(req.requester().trim());
rsv.setRequesterDept(req.requesterDept());
rsv.setPurpose(req.purpose());
rsv.setQueueNo((int) activeCount + 1);
rsv.setStatus("排队中");
rsv.setReserveDate(LocalDate.now().toString());
rsv.setCreatedAt(Instant.now());
return ApiResp.ok(reserveRepo.save(rsv));
}
/**
* 通知可借(排队中 → 可借)。档案归还后,资料室管理员调此端点通知队首预约人可借阅。
* 自动取该档案队首(最小 queueNo 且状态=排队中)通知;也可指定 id 直接通知。
*/
@PostMapping("/{id}/notify")
public ApiResp notify(@PathVariable Long id) {
ArchiveReservation rsv = require(id);
if (!"排队中".equals(rsv.getStatus())) {
throw new ApiException(409, "仅「排队中」可通知,当前:" + rsv.getStatus());
}
rsv.setStatus("可借");
rsv.setNotifyDate(LocalDate.now().toString());
return ApiResp.ok(reserveRepo.save(rsv));
}
/** 转为已借阅(可借 → 已转借阅)。预约人发起正式借阅后由系统调用,闭合预约。 */
@PostMapping("/{id}/convert")
public ApiResp convert(@PathVariable Long id) {
ArchiveReservation rsv = require(id);
if (!"可借".equals(rsv.getStatus())) {
throw new ApiException(409, "仅「可借」状态可转借阅,当前:" + rsv.getStatus());
}
rsv.setStatus("已转借阅");
return ApiResp.ok(reserveRepo.save(rsv));
}
/** 取消预约(排队中/可借 → 已取消)。 */
@PostMapping("/{id}/cancel")
public ApiResp cancel(@PathVariable Long id) {
ArchiveReservation rsv = require(id);
if ("已转借阅".equals(rsv.getStatus()) || "已取消".equals(rsv.getStatus())) {
throw new ApiException(409, "「" + rsv.getStatus() + "」状态不可取消");
}
rsv.setStatus("已取消");
return ApiResp.ok(reserveRepo.save(rsv));
}
private ArchiveReservation require(Long id) {
return reserveRepo.findById(id)
.orElseThrow(() -> new NotFoundException("archive reservation not found: " + id));
}
}