tiku-backend.net/Tiku.Api/Contracts/ProfileDtos.cs

using System.ComponentModel.DataAnnotations;
using System.Text.Json;
using Tiku.Application.Profile;

namespace Tiku.Api.Contracts;

/// <summary>
///     资料查询参数。
/// </summary>
public sealed class ProfileQueryDto
{
    /// <summary>
    ///     最近记录数量上限。
    /// </summary>
    [Range(1, 50)]
    public int? RecentLimit { get; set; }

    /// <summary>
    ///     返回数量上限。
    /// </summary>
    [Range(1, 20)]
    public int? Limit { get; set; }

    /// <summary>
    ///     状态。
    /// </summary>
    [StringLength(32)]
    public string? Status { get; set; }

    /// <summary>
    ///     类型。
    /// </summary>
    [StringLength(50)]
    public string? Type { get; set; }

    /// <summary>
    ///     分类。
    /// </summary>
    [StringLength(50)]
    public string? Category { get; set; }

    /// <summary>
    ///     是否包含锁定资源。
    /// </summary>
    public bool IncludeLocked { get; set; }

    /// <summary>
    ///     来源类型。
    /// </summary>
    [StringLength(100)]
    public string? SourceType { get; set; }

    /// <summary>
    ///     开始时间。
    /// </summary>
    public DateTimeOffset? From { get; set; }

    /// <summary>
    ///     结束时间。
    /// </summary>
    public DateTimeOffset? To { get; set; }
}

/// <summary>
///     更新资料请求 DTO。
/// </summary>
public sealed class UpdateProfileDto
{
    /// <summary>
    ///     名称。
    /// </summary>
    [StringLength(100)]
    public string? Name { get; set; }

    /// <summary>
    ///     头像预设。
    /// </summary>
    [StringLength(32)]
    public string? AvatarPreset { get; set; }

    /// <summary>
    ///     地区 ID。
    /// </summary>
    public Guid? RegionId { get; set; }

    /// <summary>
    ///     已选择院校 ID。
    /// </summary>
    public Guid? SelectedSchoolId { get; set; }

    /// <summary>
    ///     已选择专业 ID。
    /// </summary>
    public Guid? SelectedMajorId { get; set; }

    /// <summary>
    ///     统计数据。
    /// </summary>
    public JsonElement? Stats { get; set; }

    /// <summary>
    ///     进度数据。
    /// </summary>
    public JsonElement? Progress { get; set; }

    /// <summary>
    ///     模块选择数据。
    /// </summary>
    public JsonElement? ModuleSelections { get; set; }

    /// <summary>
    ///     最近活动数据。
    /// </summary>
    public JsonElement? RecentActivities { get; set; }

    public UpdateProfileCommand ToCommand()
    {
        return new UpdateProfileCommand(
            Name,
            AvatarPreset,
            RegionId,
            SelectedSchoolId,
            SelectedMajorId,
            Stats,
            Progress,
            ModuleSelections,
            RecentActivities);
    }
}

/// <summary>
///     通知状态请求 DTO。
/// </summary>
public sealed class NotificationStatusDto
{
    /// <summary>
    ///     通知 ID 列表。
    /// </summary>
    [Required]
    [MinLength(1)]
    [MaxLength(100)]
    public IReadOnlyCollection<Guid> NotificationIds { get; set; } = [];

    /// <summary>
    ///     状态。
    /// </summary>
    [StringLength(32)]
    public string? Status { get; set; }

    public UpdateNotificationStatusCommand ToCommand()
    {
        return new UpdateNotificationStatusCommand(NotificationIds, Status);
    }
}

/// <summary>
///     提交反馈请求 DTO。
/// </summary>
public sealed class SubmitFeedbackDto
{
    /// <summary>
    ///     题目 ID。
    /// </summary>
    public Guid? QuestionId { get; set; }

    /// <summary>
    ///     类型。
    /// </summary>
    [StringLength(50)]
    public string? Type { get; set; }

    /// <summary>
    ///     分类。
    /// </summary>
    [StringLength(100)]
    public string? Category { get; set; }

    /// <summary>
    ///     标题。
    /// </summary>
    [StringLength(200)]
    public string? Title { get; set; }

    /// <summary>
    ///     说明。
    /// </summary>
    [Required]
    [StringLength(5000)]
    public string Description { get; set; } = string.Empty;

    /// <summary>
    ///     优先级。
    /// </summary>
    [StringLength(32)]
    public string? Priority { get; set; }

    /// <summary>
    ///     联系方式。
    /// </summary>
    [StringLength(200)]
    public string? Contact { get; set; }

    /// <summary>
    ///     附件列表。
    /// </summary>
    public JsonElement Attachments { get; set; } = JsonSerializer.SerializeToElement(Array.Empty<object>());

    /// <summary>
    ///     扩展元数据。
    /// </summary>
    public JsonElement Metadata { get; set; } = JsonSerializer.SerializeToElement(new { });

    public SubmitFeedbackCommand ToCommand()
    {
        return new SubmitFeedbackCommand(
            QuestionId,
            Type,
            Category,
            Title,
            Description,
            Priority,
            Contact,
            Attachments,
            Metadata);
    }
}