package com.superbiz.agent.dto;

import lombok.Builder;
import lombok.Data;

import java.util.List;
import java.util.Map;

/**
 * L1 向量命中后、后处理前的统一候选结构。
 *
 * <p>后处理：{@code RetrievalScoreNormalizer} → qualityScore；按 {@link #originalRank} 保序；
 * evidenceKey 去重 / 截断；不再用关键词 boost 改序。</p>
 */
@Data
@Builder
public class RetrievedEvidenceCandidate {

    private String id;

    private String docId;

    private Integer chunkIndex;

    private String evidenceKey;

    private String source;

    private String title;

    private String breadcrumb;

    private String content;

    private String retrievalLayer;

    private String retrievalAttempt;

    /**
     * 引擎主分：dense=L2；hybrid=融合分。量纲由 {@link #scoreLabel} 解释。
     */
    private Double score;

    private Double rawScore;

    /**
     * {@code dense} | {@code hybrid}（及可被 canonicalize 的历史别名）。
     */
    private String scoreLabel;

    /**
     * 检索返回名次（从 1 起）——后处理排序权威。
     */
    private Integer originalRank;

    /**
     * hybrid 命中可选的 dense L2，仅供质量闸门；不参与排序。
     */
    private Double denseDistance;

    private Map<String, String> metadata;

    /**
     * 初步命中原因；后处理可追加 L0 重叠解释（无分值）。
     */
    private List<String> hitReasons;
}