Backend-Api/ProgramManager/src/Application/GozareshgirProgramManager.Application/Modules/Projects/Queries/GetProjectHierarchySearch/ProjectHierarchySearchResultDto.cs

using GozareshgirProgramManager.Domain.ProjectAgg.Enums;

namespace GozareshgirProgramManager.Application.Modules.Projects.Queries.GetProjectHierarchySearch;

/// <summary>
/// DTO برای نتایج جستجوی سراسری در سلسله‌مراتب پروژه.
/// حاوی اطلاعات کافی برای بازسازی مسیر سلسله‌مراتب و بسط درخت در رابط کاربری است.
/// </summary>
public record ProjectHierarchySearchResultDto
{
    /// <summary>
    /// شناسه آیتم (پروژه، فاز یا تسک)
    /// </summary>
    public Guid Id { get; init; }

    /// <summary>
    /// نام/عنوان آیتم
    /// </summary>
    public string Title { get; init; } = string.Empty;

    /// <summary>
    /// سطح سلسله‌مراتب این آیتم
    /// </summary>
    public ProjectHierarchyLevel Level { get; init; }

    /// <summary>
    /// شناسه پروژه - همیشه برای فاز و تسک پر شده است، برای پروژه با شناسه خود پر می‌شود
    /// </summary>
    public Guid? ProjectId { get; init; }

    /// <summary>
    /// شناسه فاز - فقط برای تسک پر شده است، برای پروژه و فاز خالی است
    /// </summary>
    public Guid? PhaseId { get; init; }
}