namespace WIDESEAWCS_Tasks.StackerCraneJob
{
    /// <summary>
    /// 堆垛机 PLC 寄存器名称枚举
    /// </summary>
    /// <remarks>
    /// 定义堆垛机与 WCS 通信时使用的 PLC 寄存器地址名称。
    /// 包含任务号、作业类型、起止位置等信息。
    /// </remarks>
    public enum StackerCraneDBName
    {
        /// <summary>
        /// 任务号
        /// </summary>
        /// <remarks>
        /// WCS 分配的任务唯一标识号。
        /// 用于 WCS 和堆垛机之间建立任务对应的关联。
        /// </remarks>
        TaskNum,

        /// <summary>
        /// 作业类型
        /// </summary>
        /// <remarks>
        /// 标识任务的类型。
        /// </remarks>
        WorkType,

        /// <summary>
        /// 托盘类型
        /// </summary>
        /// <remarks>
        /// 标识托盘的规格类型。
        /// </remarks>
        TrayType,

        /// <summary>
        /// 起始行
        /// </summary>
        /// <remarks>
        /// 任务的起始位置-行坐标。
        /// 用于确定库位在货架中的行位置。
        /// </remarks>
        StartRow,

        /// <summary>
        /// 起始列
        /// </summary>
        /// <remarks>
        /// 任务的起始位置-列坐标。
        /// 用于确定库位在货架中的列位置。
        /// </remarks>
        StartColumn,

        /// <summary>
        /// 起始层
        /// </summary>
        /// <remarks>
        /// 任务的起始位置-层坐标。
        /// 用于确定库位在货架中的层位置。
        /// </remarks>
        StartLayer,

        /// <summary>
        /// 目标行
        /// </summary>
        /// <remarks>
        /// 任务的目标位置-行坐标。
        /// 入库时表示货物存放的行位置，出库时表示货物来源的行位置。
        /// </remarks>
        EndRow,

        /// <summary>
        /// 目标列
        /// </summary>
        /// <remarks>
        /// 任务的目标位置-列坐标。
        /// 入库时表示货物存放的列位置，出库时表示货物来源的列位置。
        /// </remarks>
        EndColumn,

        /// <summary>
        /// 目标层
        /// </summary>
        /// <remarks>
        /// 任务的目标位置-层坐标。
        /// 入库时表示货物存放的层位置，出库时表示货物来源的层位置。
        /// </remarks>
        EndLayer,

        /// <summary>
        /// 作业指令
        /// </summary>
        /// <remarks>
        /// 控制堆垛机的动作：
        /// - 1: 开始执行任务
        /// - 2: 任务完成/停止
        /// - 3: 消防任务开始
        /// </remarks>
        WorkAction,

        /// <summary>
        /// 当前任务号
        /// </summary>
        /// <remarks>
        /// 堆垛机当前正在执行的任务号。
        /// </remarks>
        CurrentTaskNum
    }
}