package com.cmvr.inspection.service;

import com.cmvr.inspection.domain.dto.alert.AlertEnvelope;

/**
 * 边缘 AI 检测报警接收服务。
 */
public interface IInspectionDetectionAlertService
{
    /**
     * 接收并持久化一条 PPE 违规报警。
     *
     * @param envelope 报警信封
     * @param requestIdempotencyKey HTTP 请求头中的幂等键，仅记录，不用于重复过滤
     * @return true 表示本次新增，false 表示重复事件
     */
    boolean receive(AlertEnvelope envelope, String requestIdempotencyKey);
}