package jnpf.bizcommon.audit.service;

import jnpf.bizcommon.audit.entity.model.AuditEventDetailVO;
import jnpf.bizcommon.audit.entity.model.AuditEventListVO;
import jnpf.bizcommon.audit.entity.model.AuditPageQuery;
import jnpf.base.vo.PageListVO;

import java.util.List;

/**
 * 审计事件查询侧服务（spec §7.1）：按 operationId 的业务主行分页、单事件详情、操作时间线。
 */
public interface AuditQueryService {

    /**
     * 分页查询：写入侧已完成物理合并，直接返回审计表行。
     * pageSize 强制 <= 100。
     */
    PageListVO<AuditEventListVO> page(AuditPageQuery query);

    /** 详情：单条事件全字段（含 field_diffs/extra/data_snapshot 正文）。id 不存在时抛 DataException。 */
    AuditEventDetailVO detail(Long id);

    /** 时间线：按 targetId 和自增 id 正序查操作，按 operationId 返回 BUSINESS 主行及关联签名。 */
    List<AuditEventListVO> timeline(String targetId);
}