namespace Dpz.Core.Service.RepositoryService;

public interface ICodeNoteService
{
    /// <summary>
    /// 保存代码描述
    /// </summary>
    /// <param name="path"></param>
    /// <param name="name"></param>
    /// <param name="note"></param>
    /// <returns></returns>
    Task<string> SaveNoteAsync(string[]? path, string name, string? note);

    /// <summary>
    /// 查询代码描述
    /// </summary>
    /// <param name="path"></param>
    /// <param name="name"></param>
    /// <returns></returns>
    Task<VmCodeNote?> FindAsync(string[]? path, string? name);

    /// <summary>
    /// 保存AI分析结果
    /// </summary>
    /// <param name="path"></param>
    /// <param name="name"></param>
    /// <param name="analyzeResult"></param>
    /// <returns></returns>
    Task SaveAiAnalyzeResultAsync(string[]? path, string name, string analyzeResult);

    /// <summary>
    /// 判断是否需要触发AI分析
    /// </summary>
    /// <param name="path"></param>
    /// <param name="name"></param>
    /// <param name="codeContainer"></param>
    /// <returns></returns>
    Task<bool> ShouldAnalyzeAsync(string[]? path, string? name, CodeContainer? codeContainer);

    /// <summary>
    /// 根据路径查询当前文件夹下所有描述
    /// </summary>
    /// <param name="path"></param>
    /// <returns></returns>
    Task<List<VmCodeNote>> GetNoteAsync(string[]? path);

    /// <summary>
    /// 获取所有代码描述
    /// </summary>
    /// <returns></returns>
    Task<List<VmCodeNote>> GetAllNoteAsync();

    /// <summary>
    /// 删除代码描述
    /// </summary>
    /// <param name="path"></param>
    /// <param name="name"></param>
    /// <returns></returns>
    Task DeleteAsync(string[]? path, string name);
}