namespace SHH.Contracts
{
    /// <summary>
    /// 协议代码定义常量类
    /// <para>职责：统一管理 gRpc 通讯中所涉及的协议大类 (Protocol) 与具体业务指令码 (CmdCode)</para>
    /// </summary>
    public static class ProtocolCodes
    {
        #region --- 1. 协议类型定义 (对应 Protocol 字段) ---

        /// <summary>
        /// 基础指令协议头
        /// <para>用于标记该消息是一个业务控制指令</para>
        /// </summary>
        public const string Command = "Command";

        /// <summary>
        /// 指令执行结果反馈协议头
        /// <para>用于分析节点执行完指令后，向主控端回执操作结果</para>
        /// </summary>
        public const string Command_Result = "Command_Result";

        #endregion

        #region --- 2. 业务指令码定义 (对应 CmdCode 字段) ---

        /// <summary>
        /// 服务器注册指令
        /// <para>触发场景：节点启动时向主控端注册自身信息</para>
        /// </summary>
        public const string ServerRegister = "SERVER_REGISTER";

        /// <summary>
        /// 同步摄像头配置指令
        /// <para>触发场景：节点上线全量同步、数据库摄像头信息变更增量同步</para>
        /// </summary>
        public static string Sync_Camera { get; } = "Sync_Camera";

        /// <summary>
        /// 移除摄像头指令
        /// <para>触发场景：本地数据库删除摄像头后，通知远程节点停止相关流采集与分析</para>
        /// </summary>
        public static string Remove_Camera { get; } = "Remove_Camera";

        /// <summary>云台控制指令</summary>
        public static string Ptz_Control { get; } = "Ptz_Control";

        /// <summary>设备重启指令</summary>
        public static string Device_Reboot { get; } = "Device_Reboot";

        /// <summary>时间同步指令</summary>
        public static string Device_TimeSync { get; } = "Device_TimeSync";

        /// <summary>预置点控制指令</summary>
        public static string Device_Preset { get; } = "Device_Preset";

        #endregion
    }
}