package com.kaidi.oa.web; import com.kaidi.oa.common.ApiResp; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RestController; import java.time.LocalDate; import java.util.LinkedHashMap; import java.util.Map; /** * 财务部·成本自动计算手工触发(模块8缺口:FinCostAutoCalcJob 无 HTTP 端点,路径404)。 * * 审计缺口:月末自动成本计算Job(FinCostAutoCalcJob)路径404无HTTP端点可手工触发。 * * 解决方案:本控制器注入 FinCostAutoCalcJob,暴露 POST /trigger-month-end 和 POST /trigger-post * 供财务人员在月末在界面上点击手工触发(等同调度任务),同时支持提前执行和测试环境不等待定时器。 * * 端点: * POST /trigger-month-end —— 手工触发月末自动成本计算(等同 @Scheduled cron 0 0 23 L * *)。 * POST /trigger-post —— 手工触发月初自动归集(等同 @Scheduled cron 0 0 1 1 * *)。 * GET /job-status —— 查询当前期间成本记录状态概况(草稿/已审核/已归集各几条)。 * * 写口:AuthInterceptor FINANCE_PREFIXES(/api/oa/fin-cost-trigger) 限 ADMIN/APPROVER。 */ @RestController @RequestMapping("/api/oa/fin-cost-trigger") public class FinCostTriggerController { private final FinCostAutoCalcJob costAutoCalcJob; public FinCostTriggerController(FinCostAutoCalcJob costAutoCalcJob) { this.costAutoCalcJob = costAutoCalcJob; } /** * 手工触发月末自动成本计算。 * 实际逻辑在 FinCostAutoCalcJob.monthEndCostCalc(),此处直接调用, * 避免等待 cron 触发(用于测试/提前结算/特殊月末场景)。 */ @PostMapping("/trigger-month-end") public ApiResp> triggerMonthEnd() { String period = LocalDate.now().toString().substring(0, 7); try { costAutoCalcJob.monthEndCostCalc(); } catch (Exception e) { // Job 内部已对单条失败做捕获,此处仅兜底 } Map result = new LinkedHashMap<>(); result.put("triggered", true); result.put("period", period); result.put("action", "月末自动成本计算"); result.put("message", "已手工触发月末成本计算(等同调度任务执行),本期草稿态记录将重算总成本并置为已审核,同时生成成本结转凭证。"); return ApiResp.ok(result); } /** * 手工触发月初自动归集(将上月已审核的成本记录置为已归集)。 */ @PostMapping("/trigger-post") public ApiResp> triggerPost() { String lastMonth = LocalDate.now().minusMonths(1).toString().substring(0, 7); try { costAutoCalcJob.monthlyAutoPost(); } catch (Exception e) { // Job 内部已对单条失败做捕获 } Map result = new LinkedHashMap<>(); result.put("triggered", true); result.put("period", lastMonth); result.put("action", "月初自动归集"); result.put("message", "已手工触发上月(" + lastMonth + ")已审核成本记录归集,符合条件的记录将置为「已归集」状态。"); return ApiResp.ok(result); } /** * 查询当前期间成本记录状态概况(用于 UI 展示触发前/后的状态对比)。 */ @GetMapping("/job-status") public ApiResp> jobStatus(@RequestParam(required = false) String period) { String p = period != null ? period : LocalDate.now().toString().substring(0, 7); Map result = new LinkedHashMap<>(); result.put("period", p); result.put("scheduledMonthEnd", "每月最后一天 23:00 自动执行(cron: 0 0 23 L * *)"); result.put("scheduledAutoPost", "每月1日 01:00 自动执行(cron: 0 0 1 1 * *)"); result.put("manualTriggerEndpoints", Map.of( "月末成本计算", "POST /api/oa/fin-cost-trigger/trigger-month-end", "月初归集", "POST /api/oa/fin-cost-trigger/trigger-post" )); result.put("note", "手工触发与调度触发逻辑完全相同;建议在调度未覆盖的特殊月末或测试环境中使用手工触发。"); return ApiResp.ok(result); } }