using System;

namespace ZB.MOM.WW.OtOpcUa.Host.Domain
{
    /// <summary>
    ///     Point-in-time runtime state of a single Galaxy runtime host ($WinPlatform or $AppEngine)
    ///     as tracked by the <c>GalaxyRuntimeProbeManager</c>. Surfaced on the status dashboard and
    ///     consumed by <c>HealthCheckService</c> so operators can detect a stopped host before
    ///     downstream clients notice the stale data.
    /// </summary>
    public sealed class GalaxyRuntimeStatus
    {
        /// <summary>
        ///     Gets or sets the Galaxy tag_name of the host (e.g., <c>DevPlatform</c> or
        ///     <c>DevAppEngine</c>).
        /// </summary>
        public string ObjectName { get; set; } = "";

        /// <summary>
        ///     Gets or sets the Galaxy gobject_id of the host.
        /// </summary>
        public int GobjectId { get; set; }

        /// <summary>
        ///     Gets or sets the Galaxy template category name — <c>$WinPlatform</c> or
        ///     <c>$AppEngine</c>. Used by the dashboard to group hosts by kind.
        /// </summary>
        public string Kind { get; set; } = "";

        /// <summary>
        ///     Gets or sets the current runtime state.
        /// </summary>
        public GalaxyRuntimeState State { get; set; }

        /// <summary>
        ///     Gets or sets the UTC timestamp of the most recent probe callback, whether it
        ///     reported success or failure. <see langword="null"/> before the first callback.
        /// </summary>
        public DateTime? LastStateCallbackTime { get; set; }

        /// <summary>
        ///     Gets or sets the UTC timestamp of the most recent <see cref="State"/> transition.
        ///     Backs the dashboard "Since" column. <see langword="null"/> in the initial Unknown
        ///     state before any transition.
        /// </summary>
        public DateTime? LastStateChangeTime { get; set; }

        /// <summary>
        ///     Gets or sets the last <c>ScanState</c> value received from the probe, or
        ///     <see langword="null"/> before the first update or when the last callback carried
        ///     a non-success item status (no value delivered).
        /// </summary>
        public bool? LastScanState { get; set; }

        /// <summary>
        ///     Gets or sets the detail message from the most recent failure callback, cleared on
        ///     the next successful <c>ScanState = true</c> delivery.
        /// </summary>
        public string? LastError { get; set; }

        /// <summary>
        ///     Gets or sets the cumulative number of callbacks where <c>ScanState = true</c>.
        /// </summary>
        public long GoodUpdateCount { get; set; }

        /// <summary>
        ///     Gets or sets the cumulative number of callbacks where <c>ScanState != true</c>
        ///     or the item status reported failure.
        /// </summary>
        public long FailureCount { get; set; }
    }
}