package jnpf.bizcommon.audit.entity.model;

import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;
import jnpf.base.Pagination;
import lombok.Data;
import lombok.EqualsAndHashCode;

import java.util.Date;

/**
 * 审计事件分页查询入参（spec §7.1）。沿平台 Pagination 惯例继承分页基类
 * （currentPage/pageSize 取自 {@link Pagination}，默认 currentPage=1、pageSize=20）。
 */
@Data
@EqualsAndHashCode(callSuper = true)
public class AuditPageQuery extends Pagination {

    /**
     * 起止时间（Task D1 拍板，收 M2 遗留清单 §五-③）。
     *
     * <p>本类走 {@code @RequestBody} 由 Jackson 反序列化。**不加这个注解时，
     * 传空格分隔的 {@code "yyyy-MM-dd HH:mm:ss"} 会报 `System abnormality`**——Jackson 默认只认
     * ISO8601 与 epoch 数字，不认空格分隔（注意：平台的 `JsonUtil` 走 fastjson、认这个格式，
     * 但那是**消息通道**的反序列化器，与 Web 入参不是同一条路，早前的排查在这里绕过弯）。
     *
     * <p>选择「加注解」而不是「让前端对齐 epoch 毫秒」的理由：`yyyy-MM-dd HH:mm:ss` 是本平台
     * 前端日期控件的默认出参格式，`jnpf-flowable` / `jnpf-visualdata` 等模块的入参模型都是这么标的
     * （如 `FlowableInstanceModel`），跟着平台惯例走比让每个接入方记住一个例外便宜。
     *
     * <p>⚠️ **两种格式都要能收**：既有脚本（`tasks/audit-test.sh` 等）传的是 epoch 毫秒**数字**。
     * Jackson 的 `DateDeserializer` 对 `VALUE_NUMBER_INT` 先行短路、不过 pattern，故加 pattern
     * 不影响数字形态——这一点**已用探针实测**而非推断，见 `tasks/audit-query-datefmt-probe.sh`。
     * 但 epoch 毫秒若以**字符串**形态传（`"1785120484000"`）则会被 pattern 拒收，脚本勿改成那样。
     */
    @Schema(description = "起始时间（含）。接受 \"yyyy-MM-dd HH:mm:ss\" 或 epoch 毫秒数字")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    private Date startTime;

    @Schema(description = "结束时间（含）。接受 \"yyyy-MM-dd HH:mm:ss\" 或 epoch 毫秒数字")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    private Date endTime;

    @Schema(description = "操作人姓名，模糊匹配")
    private String operatorName;

    @Schema(description = "应用名，如 jnpf-lims")
    private String appName;

    /**
     * Codex 批次三a Important#1：spec §7.1 层 0 事件的 app_name 固定为 jnpf-visualdev（发起服务），
     * 用户视角"按业务应用筛选"应落在 biz_module（业务模块标识，如 lims/eln）。app_name 保留供技术侧筛选。
     */
    @Schema(description = "业务模块，如 lims/eln（用户视角应用筛选，区别于技术侧 app_name）")
    private String bizModule;

    @Schema(description = "事件类型：DATA_CHANGE / BIZ_ACTION / E_SIGNATURE")
    private String eventType;

    @Schema(description = "动作码：CREATE/UPDATE/DELETE/...")
    private String actionCode;

    @Schema(description = "目标表名")
    private String targetTable;

    @Schema(description = "业务单号")
    private String bizCode;

    @Schema(description = "业务对象类型")
    private String bizType;

    @Schema(description = "关键字，匹配 field_diffs 内容（pg_bigm 加速）")
    private String keyword;
}