package cn.iocoder.yudao.module.mes.service.dc.device; import cn.iocoder.yudao.framework.common.pojo.PageResult; import cn.iocoder.yudao.module.mes.controller.admin.dc.device.vo.MesDcDevicePageReqVO; import cn.iocoder.yudao.module.mes.controller.admin.dc.device.vo.MesDcDeviceSaveReqVO; import cn.iocoder.yudao.module.mes.controller.admin.dc.open.vo.MesDcHeartbeatReqVO; import cn.iocoder.yudao.module.mes.controller.admin.dc.open.vo.MesDcHeartbeatRespVO; import cn.iocoder.yudao.module.mes.dal.dataobject.dc.device.MesDcDeviceDO; import jakarta.validation.Valid; import java.util.List; /** * MES 数据采集设备 Service 接口 * * @author 超级管理员 */ public interface MesDcDeviceService { /** * 创建设备 * * @param createReqVO 创建信息 * @return 创建设备(含自动生成的采集令牌) */ MesDcDeviceDO createDevice(@Valid MesDcDeviceSaveReqVO createReqVO); /** * 更新设备 * * @param updateReqVO 更新信息 */ void updateDevice(@Valid MesDcDeviceSaveReqVO updateReqVO); /** * 删除设备 * * @param id 编号 */ void deleteDevice(Long id); /** * 获得设备 * * @param id 编号 * @return 设备 */ MesDcDeviceDO getDevice(Long id); /** * 校验设备存在 * * @param id 编号 * @return 设备 */ MesDcDeviceDO validateDeviceExists(Long id); /** * 获得设备分页 * * @param pageReqVO 分页查询 * @return 设备分页 */ PageResult getDevicePage(MesDcDevicePageReqVO pageReqVO); /** * 获得全部设备列表(按设备编号升序) * * @return 设备列表 */ List getDeviceList(); /** * 重置采集令牌 * * @param id 编号 * @return 新令牌(仅本次返回) */ String resetToken(Long id); /** * 绑定生产工单 * * @param id 设备编号 * @param workOrderId 生产工单编号 */ void bindWorkOrder(Long id, Long workOrderId); /** * 解绑生产工单 * * @param id 设备编号 */ void unbindWorkOrder(Long id); /** * 校验设备编号与采集令牌(仅校验存在性与令牌,不校验禁用状态) * * @param deviceCode 设备编号 * @param token 采集令牌 * @return 设备 */ MesDcDeviceDO validateDeviceToken(String deviceCode, String token); /** * 设备心跳 * * @param heartbeatReqVO 心跳信息 * @param token 采集令牌 * @return 心跳响应 */ MesDcHeartbeatRespVO heartbeat(MesDcHeartbeatReqVO heartbeatReqVO, String token); }