ERP/oa-backend/src/main/java/com/kaidi/oa/web/FinCostTriggerController.java

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<Map<String, Object>> triggerMonthEnd() {
        String period = LocalDate.now().toString().substring(0, 7);
        try {
            costAutoCalcJob.monthEndCostCalc();
        } catch (Exception e) {
            // Job 内部已对单条失败做捕获，此处仅兜底
        }
        Map<String, Object> 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<Map<String, Object>> triggerPost() {
        String lastMonth = LocalDate.now().minusMonths(1).toString().substring(0, 7);
        try {
            costAutoCalcJob.monthlyAutoPost();
        } catch (Exception e) {
            // Job 内部已对单条失败做捕获
        }
        Map<String, Object> 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<Map<String, Object>> jobStatus(@RequestParam(required = false) String period) {
        String p = period != null ? period : LocalDate.now().toString().substring(0, 7);
        Map<String, Object> 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);
    }
}