using System.Text.Json;
using System.Text.Json.Serialization;
using Workflow.Domain.Enums;

namespace Workflow.Domain.Engine;

/// <summary>
/// 钉钉式审批流的强类型树模型。前端树编辑器与后端存储/编译共用此结构。
/// <para>
/// 结构约定：
/// <list type="bullet">
///   <item>Root 固定为 <see cref="TreeNodeTypeEnum.Initiator"/>（发起人节点）。</item>
///   <item>顺序链：每个节点的 <see cref="TreeNode.Child"/> 指向下一个节点，形成链式（发起人→审批→抄送…）。</item>
///   <item>条件分支 / 并行分支容器：节点的 <see cref="TreeNode.Branches"/> 存放分支集合；每条分支内部又是独立的顺序链（<see cref="TreeBranch.Child"/>）。</item>
///   <item>分支在末端会自动收口回主链（编译器负责生成汇合边）。</item>
/// </list>
/// 与 <see cref="WorkflowGraph"/>（运行态图）解耦：<see cref="Workflow.Application.Engine.TreeToGraphCompiler"/>
/// 负责把本树编译成引擎可运行的图。
/// </para>
/// </summary>
public sealed class WorkflowTree
{
    /// <summary>树的根节点（发起人）。前端编辑态始终非空；空树用 <see cref="Empty"/> 表达。</summary>
    [JsonPropertyName("root")]
    public TreeNode? Root { get; set; }

    /// <summary>空树工厂：用于缺省/容错。</summary>
    public static WorkflowTree Empty() => new();
}