using System;

namespace GB5Shared.EntityHandler
{
    /// <summary>
    /// Marks the property on an entity DTO that <see cref="BaseEntityAppService{TDto}"/> should
    /// set to the active/approved status value (1) when no workflow is configured, or when a
    /// WIP-approval callback finalises the record.
    /// <para>
    /// Opt-in and takes priority over both the "{Entity}Status" naming convention and the
    /// generic "*Status" suffix scan — use it whenever a DTO's canonical status property does
    /// not follow the "{EntityName}Status" convention (e.g. it's just "Status", or the DTO has
    /// several "*Status" properties and the convention name doesn't match the real one).
    /// </para>
    /// <example>
    /// <code>
    /// public record CallDTO
    /// {
    ///     [WorkflowStatusField]
    ///     public byte CallStatus { get; set; }
    /// }
    /// </code>
    /// </example>
    /// </summary>
    [AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = false)]
    public sealed class WorkflowStatusFieldAttribute : Attribute
    {
    }
}