Hua.Todo/src/Hua.Todo.Application/Services/Meeting/Models/MeetingDtos.cs

using System.ComponentModel.DataAnnotations;
using Hua.Todo.Application.Models;
using Hua.Todo.Core.Entities;

namespace Hua.Todo.Application.Services.Meeting.Models;

/// <summary>
/// 保存会议纪要请求。
/// </summary>
public class SaveNotesRequest
{
    /// <summary>
    /// 待办项 ID。
    /// </summary>
    [Required]
    public Guid TaskId { get; set; }

    /// <summary>
    /// 会议纪要/转写文字内容。
    /// </summary>
    [Required]
    [MaxLength(20000)]
    public string Notes { get; set; } = string.Empty;
}

/// <summary>
/// 保存会议纪要响应。
/// </summary>
public class SaveNotesResponse
{
    /// <summary>
    /// 待办项 ID。
    /// </summary>
    public Guid TaskId { get; set; }

    /// <summary>
    /// 保存后的会议纪要内容。
    /// </summary>
    public string MeetingNotes { get; set; } = string.Empty;
}

/// <summary>
/// 会议详情响应（不含子任务递归）。
/// </summary>
public class MeetingDetailResponse
{
    /// <summary>
    /// 待办项 ID。
    /// </summary>
    public Guid TaskId { get; set; }

    /// <summary>
    /// 会议标题。
    /// </summary>
    public string Title { get; set; } = string.Empty;

    /// <summary>
    /// 会议纪要/转写文字。
    /// </summary>
    public string? MeetingNotes { get; set; }

    /// <summary>
    /// 录音时长（秒）。
    /// </summary>
    public double? AudioDuration { get; set; }

    /// <summary>
    /// 是否已完成。
    /// </summary>
    public bool IsCompleted { get; set; }
}

/// <summary>
/// 会议任务拆分建议（LLM 输出）。
/// </summary>
public class MeetingTaskSuggestion
{
    /// <summary>建议的待办项标题</summary>
    public string Title { get; set; } = string.Empty;

    /// <summary>建议优先级</summary>
    public TaskPriority Priority { get; set; } = TaskPriority.Medium;

    /// <summary>拆分原因（LLM 输出，用于 UI 展示）</summary>
    public string Reason { get; set; } = string.Empty;
}

/// <summary>
/// AI 拆分请求。
/// </summary>
public class BreakdownRequest
{
    /// <summary>待办项 ID</summary>
    [Required]
    public Guid TaskId { get; set; }

    /// <summary>会议纪要文字（可选，不传则使用已保存的 meetingNotes）</summary>
    public string? Notes { get; set; }
}

/// <summary>
/// AI 拆分响应。
/// </summary>
public class BreakdownResponse
{
    /// <summary>待办项 ID</summary>
    public Guid TaskId { get; set; }

    /// <summary>拆分建议列表</summary>
    public List<MeetingTaskSuggestion> Suggestions { get; set; } = new();
}

/// <summary>
/// 批量创建请求中的单个子任务项。
/// </summary>
public class SubTaskCreateItem
{
    /// <summary>子任务标题</summary>
    [Required]
    public string Title { get; set; } = string.Empty;

    /// <summary>子任务优先级</summary>
    public TaskPriority Priority { get; set; } = TaskPriority.Medium;
}

/// <summary>
/// 批量确认拆分请求。
/// </summary>
public class ConfirmBreakdownRequest
{
    /// <summary>待办项 ID</summary>
    [Required]
    public Guid TaskId { get; set; }

    /// <summary>要创建的子任务列表</summary>
    [Required]
    public List<SubTaskCreateItem> SubTasks { get; set; } = new();
}

/// <summary>
/// 批量创建结果。
/// </summary>
public class BatchCreateResult
{
    /// <summary>成功创建数量</summary>
    public int CreatedCount { get; set; }

    /// <summary>创建后的子任务 DTO 列表</summary>
    public List<TaskDto> SubTasks { get; set; } = new();
}

/// <summary>
/// 语音转写请求。
/// 音频数据以 Base64 编码在 JSON 中传输，避免 DynamicApi 中间件处理 multipart/form-data 的兼容问题。
/// </summary>
public class TranscribeRequest
{
    /// <summary>
    /// 待办项 ID。
    /// </summary>
    [Required]
    public Guid TaskId { get; set; }

    /// <summary>
    /// Base64 编码的音频数据。
    /// </summary>
    [Required]
    public string AudioBase64 { get; set; } = string.Empty;

    /// <summary>
    /// 音频格式，例如 "webm"、"mp4"、"wav"。
    /// </summary>
    [Required]
    public string Format { get; set; } = string.Empty;

    /// <summary>
    /// 音频时长（秒），由前端录制时计算。
    /// </summary>
    public double AudioDuration { get; set; }
}

/// <summary>
/// 语音转写响应。
/// </summary>
public class TranscribeResponse
{
    /// <summary>
    /// 待办项 ID。
    /// </summary>
    public Guid TaskId { get; set; }

    /// <summary>
    /// 转写后的文字内容。
    /// </summary>
    public string Transcript { get; set; } = string.Empty;

    /// <summary>
    /// 音频时长（秒）。
    /// </summary>
    public double AudioDuration { get; set; }
}