namespace GeoVLog.Core.Models;

/// <summary>
/// Base contract for every sensor reading captured by GeoVLog.
/// </summary>
public interface ISensorReading
{
    /// <summary>UTC time the message was received (system clock).</summary>
    DateTime TimestampUtc { get; }

    /// <summary>
    /// Short string identifier (“gps”, “mag”, “imu”, “ralt”, “vlf”…)
    /// used for routing and dataset naming.
    /// </summary>
    string SensorName { get; }

    /// <summary>
    /// Secondary channel index (0 = default).  
    /// Example: magnetometer #1 → 0, magnetometer #2 → 1.
    /// </summary>
    int Channel { get; }

    /// <summary>
    /// Raw message bytes or text exactly as received—preserved for
    /// forensic analysis and re-parsing.
    /// </summary>
    ReadOnlyMemory<byte> RawPayload { get; }
}