package com.superbiz.agent.dto;

import lombok.Builder;
import lombok.Data;

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

/**
 * 知识库索引条目
 * L0 内存索引使用的数据结构
 */
@Data
@Builder
public class KnowledgeEntry {

    /**
     * 文件路径（如：knowledge_base/api/payment-errors.md）
     */
    private String filePath;

    /**
     * 文档标题
     */
    private String title;

    /**
     * 关键词列表（用于精确匹配）
     */
    private List<String> keywords;

    /**
     * 文档摘要
     */
    private String summary;

    /**
     * 文档类别（如：api、domain、troubleshooting）
     */
    private String category;

    /**
     * 章节锚点（预留字段，MVP 不使用）
     */
    private Map<String, String> sections;

    /**
     * 业务场景标签，供 Planner 决策用
     */
    private List<String> covers;

    /**
     * 文档级检索时机
     */
    private String whenToRetrieve;
}