package com.battery.device.api.model;

import java.time.Instant;

/**
 * 发现结果中的一个通道。
 * {@code lastDataAt} 是来源里最近一次采样行的设备时间；它是"最近是否有新采样行写入"这一条依据的取值，
 * 与设备结束时间或通道水位线列无关。来源不提供该事实时保持为空。
 *
 * <p>{@code sourceDisplayNo} 是**来源自己的叫法**（通常是它自己软件里显示的通道号，也可能是文本）：
 * 各厂商给通道编号的方式不同（新威按「单元-通道」，22 所按它界面上的 01–30），
 * 由来源在发现结果里报出来，界面与登记就用它显示，操作员才能拿它跟厂商软件对上。
 * 来源不提供时保持为空，界面回退到身份里的「单元-通道」。
 * 它只是展示名，**不参与通道身份**（身份始终是设备的存储事实），所以改它不需要迁移任何数据。
 */
public record DetectedChannel(ChannelIdentity identity, String serverIp, boolean available,
        DetectedDeviceMetadata deviceMetadata, Instant lastDataAt, String sourceDisplayNo)
{
    public DetectedChannel(ChannelIdentity identity, String serverIp, boolean available)
    {
        this(identity, serverIp, available, DetectedDeviceMetadata.empty(), null, null);
    }

    public DetectedChannel(ChannelIdentity identity, String serverIp, boolean available,
            DetectedDeviceMetadata deviceMetadata)
    {
        this(identity, serverIp, available, deviceMetadata, null, null);
    }

    /** 兼容不带来源叫法的既有适配器。 */
    public DetectedChannel(ChannelIdentity identity, String serverIp, boolean available,
            DetectedDeviceMetadata deviceMetadata, Instant lastDataAt)
    {
        this(identity, serverIp, available, deviceMetadata, lastDataAt, null);
    }
}