package cn.iocoder.yudao.module.mes.service.trace.integrity;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.mes.controller.admin.trace.integrity.vo.MesTraceIntegrityRecordPageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.trace.integrity.vo.MesTraceIntegrityVerifyRespVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.trace.consumer.MesTraceConsumerScanEventDO;
import cn.iocoder.yudao.module.mes.dal.dataobject.trace.integrity.MesTraceIntegrityRecordDO;

/**
 * 数据完整性 Service 接口
 * <p>
 * 在批次创建、销售出库、消费者扫码等关键事件发生时，对不可变核心字段生成 SHA-256 摘要并存储；
 * 提供重算比对能力，供管理端发现事后篡改。摘要生成失败不得阻断业务主流程。
 *
 * @author 超级管理员
 */
public interface MesTraceIntegrityService {

    /**
     * 生成并保存批次完整性摘要（code|itemId|lineCode|produceDate|planQuantity）
     *
     * @param batchId 批次编号
     */
    void recordBatchIntegrity(Long batchId);

    /**
     * 生成并保存销售出库完整性摘要（code|clientId|salesDate|明细袋码/托盘码id列表）
     *
     * @param salesId 销售出库单编号
     */
    void recordSalesIntegrity(Long salesId);

    /**
     * 生成并保存消费者扫码事件完整性摘要（normalizedCode|sourceType|province|city|success|eventTime）
     *
     * @param event 消费者扫码事件
     */
    void recordScanIntegrity(MesTraceConsumerScanEventDO event);

    /**
     * 校验数据完整性：重算当前数据摘要，与存储摘要比对
     *
     * @param bizType 业务类型：BATCH / SALES / SCAN
     * @param bizId   业务记录编号
     * @return 校验结果
     */
    MesTraceIntegrityVerifyRespVO verify(String bizType, Long bizId);

    /**
     * 获得数据完整性记录分页
     *
     * @param reqVO 查询条件
     * @return 记录分页
     */
    PageResult<MesTraceIntegrityRecordDO> getIntegrityPage(MesTraceIntegrityRecordPageReqVO reqVO);

}