按代码规范检查整改实体注释、Service Javadoc 与分层边界

yeg

2026-09-29 b78295e8da96c3e5e76befeef9582ce5273dbb74

 battery-device-api/src/main/java/com/battery/device/api/model/DeviceObservation.java

@@ -78,6 +78,7 @@
                reason == null ? ObservationFailureReason.OFFLINE : reason);
    }

    /** 按失败分类创建不携带过期设备事实的离线观测；通道工作状态一律为 UNOBSERVABLE。 */
    public static DeviceObservation offline(ChannelIdentity channel, ObservationFailureReason failureReason)
    {
        Objects.requireNonNull(channel, "channel");