docs(device): document adapter service contracts

yeg

2026-08-26 a9e3435464f86a50ffa81a16ef92e47734adef6e

 ruoyi-system/src/main/java/com/ruoyi/system/service/impl/DeviceDiscoveryPersistenceService.java

@@ -27,7 +27,7 @@
        this.mapper = mapper;
    }

    /** 在一个事务内 upsert 本轮观测事实；未返回通道保持原记录不变。 */
    /** 在事务内 upsert 本轮发现和实时观测；未返回通道保持原记录不变。 */
    @Transactional(rollbackFor = Exception.class)
    public AdapterDiscoveryResult persist(TDeviceAdapter adapter, List<DetectedChannel> detected,
            Map<ChannelIdentity, RealtimeSnapshot> snapshots, Instant observedAt)