Uni-Lab-OS/unilabos/devices/workstation/workstation_base.py

"""
工作站基类
Workstation Base Class - 简化版

基于PLR Deck的简化工作站架构
专注于核心物料系统和工作流管理
"""

import collections
import time
from typing import Dict, Any, List, Optional, Union
from abc import ABC, abstractmethod
from dataclasses import dataclass
from enum import Enum
from pylabrobot.resources import Deck, Plate, Resource as PLRResource

from pylabrobot.resources.coordinate import Coordinate
from unilabos.ros.nodes.presets.workstation import ROS2WorkstationNode

from unilabos.utils.log import logger


class WorkflowStatus(Enum):
    """工作流状态"""

    IDLE = "idle"
    INITIALIZING = "initializing"
    RUNNING = "running"
    PAUSED = "paused"
    STOPPING = "stopping"
    STOPPED = "stopped"
    ERROR = "error"
    COMPLETED = "completed"


@dataclass
class WorkflowInfo:
    """工作流信息"""

    name: str
    description: str
    estimated_duration: float  # 预估持续时间（秒）
    required_materials: List[str]  # 所需物料类型
    output_product: str  # 输出产品类型
    parameters_schema: Dict[str, Any]  # 参数架构


class WorkStationContainer(Plate):
    """
    WorkStation 专用 Container 类，继承自 Plate和TipRack
    注意这个物料必须通过plr_additional_res_reg.py注册到edge，才能正常序列化
    """

    def __init__(
        self,
        name: str,
        size_x: float,
        size_y: float,
        size_z: float,
        category: str,
        ordering: collections.OrderedDict,
        model: Optional[str] = None,
    ):
        """
        这里的初始化入参要和plr的保持一致
        """
        super().__init__(name, size_x, size_y, size_z, category=category, ordering=ordering, model=model)
        self._unilabos_state = {}  # 必须有此行，自己的类描述的是物料的

    def load_state(self, state: Dict[str, Any]) -> None:
        """从给定的状态加载工作台信息。"""
        super().load_state(state)
        self._unilabos_state = state

    def serialize_state(self) -> Dict[str, Dict[str, Any]]:
        data = super().serialize_state()
        data.update(
            self._unilabos_state
        )  # Container自身的信息，云端物料将保存这一data，本地也通过这里的data进行读写，当前类用来表示这个物料的长宽高大小的属性，而data（state用来表示物料的内容，细节等）
        return data


def get_workstation_plate_resource(name: str) -> PLRResource:  # 要给定一个返回plr的方法
    """
    用于获取一些模板，例如返回一个带有特定信息/子物料的 Plate，这里需要到注册表注册，例如unilabos/registry/resources/organic/workstation.yaml
    可以直接运行该函数或者利用注册表补全机制，来检查是否资源出错
    :param name: 资源名称
    :return: Resource对象
    """
    plate = WorkStationContainer(
        name, size_x=50, size_y=50, size_z=10, category="plate", ordering=collections.OrderedDict()
    )
    tip_rack = WorkStationContainer(
        "tip_rack_inside_plate",
        size_x=50,
        size_y=50,
        size_z=10,
        category="tip_rack",
        ordering=collections.OrderedDict(),
    )
    plate.assign_child_resource(tip_rack, Coordinate.zero())
    return plate


class ResourceSynchronizer(ABC):
    """资源同步器基类

    负责与外部物料系统的同步，并对 self.deck 做修改
    """

    def __init__(self, workstation: "WorkstationBase"):
        self.workstation = workstation

    @abstractmethod
    def sync_from_external(self) -> bool:
        """从外部系统同步物料到本地deck"""
        pass

    @abstractmethod
    def sync_to_external(self, plr_resource: PLRResource) -> bool:
        """将本地物料同步到外部系统"""
        pass

    @abstractmethod
    def handle_external_change(self, change_info: Dict[str, Any]) -> bool:
        """处理外部系统的变更通知"""
        pass


class WorkstationBase(ABC):
    """工作站基类 - 简化版

    核心功能：
    1. 基于 PLR Deck 的物料系统，支持格式转换
    2. 可选的资源同步器支持外部物料系统
    3. 简化的工作流管理
    """

    _ros_node: ROS2WorkstationNode

    @property
    def _children(self) -> Dict[str, Any]:  # 不要删除这个下划线，不然会自动导入注册表，后面改成装饰器识别
        return self._ros_node.children

    async def update_resource_example(self):
        return await self._ros_node.update_resource([get_workstation_plate_resource("test")])

    def __init__(
        self,
        deck: Deck,
        *args,
        **kwargs,  # 必须有kwargs
    ):
        # PLR 物料系统
        self.deck: Optional[Deck] = deck
        self.plr_resources: Dict[str, PLRResource] = {}

        self.resource_synchronizer = None  # type: Optional[ResourceSynchronizer]
        # 硬件接口
        self.hardware_interface: Union[Any, str] = None

        # 工作流状态
        self.current_workflow_status = WorkflowStatus.IDLE
        self.current_workflow_info = None
        self.workflow_start_time = None
        self.workflow_parameters = {}

        # 支持的工作流（静态预定义）
        self.supported_workflows: Dict[str, WorkflowInfo] = {}

    def post_init(self, ros_node: ROS2WorkstationNode) -> None:
        # 初始化物料系统
        self._ros_node = ros_node

    def _build_resource_mappings(self, deck: Deck):
        """递归构建资源映射"""

        def add_resource_recursive(resource: PLRResource):
            if hasattr(resource, "name"):
                self.plr_resources[resource.name] = resource

            if hasattr(resource, "children"):
                for child in resource.children:
                    add_resource_recursive(child)

        add_resource_recursive(deck)

    # ============ 硬件接口管理 ============

    def set_hardware_interface(self, hardware_interface: Union[Any, str]):
        """设置硬件接口"""
        self.hardware_interface = hardware_interface
        logger.info(f"工作站 {self._ros_node.device_id} 硬件接口设置: {type(hardware_interface).__name__}")

    def set_workstation_node(self, workstation_node: "ROS2WorkstationNode"):
        """设置协议节点引用（用于代理模式）"""
        self._ros_node = workstation_node
        logger.info(f"工作站 {self._ros_node.device_id} 关联协议节点")

    # ============ 设备操作接口 ============

    def call_device_method(self, method: str, *args, **kwargs) -> Any:
        """调用设备方法的统一接口"""
        # 1. 代理模式：通过协议节点转发
        if isinstance(self.hardware_interface, str) and self.hardware_interface.startswith("proxy:"):
            if not self._ros_node:
                raise RuntimeError("代理模式需要设置workstation_node")

            device_id = self.hardware_interface[6:]  # 移除 "proxy:" 前缀
            return self._ros_node.call_device_method(device_id, method, *args, **kwargs)

        # 2. 直接模式：直接调用硬件接口方法
        elif self.hardware_interface and hasattr(self.hardware_interface, method):
            return getattr(self.hardware_interface, method)(*args, **kwargs)

        else:
            raise AttributeError(f"硬件接口不支持方法: {method}")

    def get_device_status(self) -> Dict[str, Any]:
        """获取设备状态"""
        try:
            return self.call_device_method("get_status")
        except AttributeError:
            # 如果设备不支持get_status方法，返回基础状态
            return {
                "status": "unknown",
                "interface_type": type(self.hardware_interface).__name__,
                "timestamp": time.time(),
            }

    def is_device_available(self) -> bool:
        """检查设备是否可用"""
        try:
            self.get_device_status()
            return True
        except:
            return False

    # ============ 物料系统接口 ============

    def get_deck(self) -> Deck:
        """获取主 Deck"""
        return self.deck

    def get_all_resources(self) -> Dict[str, PLRResource]:
        """获取所有 PLR 资源"""
        return self.plr_resources.copy()

    def find_resource_by_name(self, name: str) -> Optional[PLRResource]:
        """按名称查找资源"""
        return self.plr_resources.get(name)

    def find_resources_by_type(self, resource_type: type) -> List[PLRResource]:
        """按类型查找资源"""
        return [res for res in self.plr_resources.values() if isinstance(res, resource_type)]

    def sync_with_external_system(self) -> bool:
        """与外部物料系统同步"""
        if not self.resource_synchronizer:
            logger.info(f"工作站 {self._ros_node.device_id} 没有配置资源同步器")
            return True

        try:
            success = self.resource_synchronizer.sync_from_external()
            if success:
                logger.info(f"工作站 {self._ros_node.device_id} 外部同步成功")
            else:
                logger.warning(f"工作站 {self._ros_node.device_id} 外部同步失败")
            return success
        except Exception as e:
            logger.error(f"工作站 {self._ros_node.device_id} 外部同步异常: {e}")
            return False

    # ============ 简化的工作流控制 ============

    def execute_workflow(self, workflow_name: str, parameters: Dict[str, Any]) -> bool:
        """执行工作流"""
        try:
            # 设置工作流状态
            self.current_workflow_status = WorkflowStatus.INITIALIZING
            self.workflow_parameters = parameters
            self.workflow_start_time = time.time()

            # 委托给子类实现
            success = self._execute_workflow_impl(workflow_name, parameters)

            if success:
                self.current_workflow_status = WorkflowStatus.RUNNING
                logger.info(f"工作站 {self._ros_node.device_id} 工作流 {workflow_name} 启动成功")
            else:
                self.current_workflow_status = WorkflowStatus.ERROR
                logger.error(f"工作站 {self._ros_node.device_id} 工作流 {workflow_name} 启动失败")

            return success

        except Exception as e:
            self.current_workflow_status = WorkflowStatus.ERROR
            logger.error(f"工作站 {self._ros_node.device_id} 执行工作流失败: {e}")
            return False

    def stop_workflow(self, emergency: bool = False) -> bool:
        """停止工作流"""
        try:
            if self.current_workflow_status in [WorkflowStatus.IDLE, WorkflowStatus.STOPPED]:
                logger.warning(f"工作站 {self._ros_node.device_id} 没有正在运行的工作流")
                return True

            self.current_workflow_status = WorkflowStatus.STOPPING

            # 委托给子类实现
            success = self._stop_workflow_impl(emergency)

            if success:
                self.current_workflow_status = WorkflowStatus.STOPPED
                logger.info(f"工作站 {self._ros_node.device_id} 工作流停止成功 (紧急: {emergency})")
            else:
                self.current_workflow_status = WorkflowStatus.ERROR
                logger.error(f"工作站 {self._ros_node.device_id} 工作流停止失败")

            return success

        except Exception as e:
            self.current_workflow_status = WorkflowStatus.ERROR
            logger.error(f"工作站 {self._ros_node.device_id} 停止工作流失败: {e}")
            return False

    # ============ 状态属性 ============

    @property
    def workflow_status(self) -> WorkflowStatus:
        """获取当前工作流状态"""
        return self.current_workflow_status

    @property
    def is_busy(self) -> bool:
        """检查工作站是否忙碌"""
        return self.current_workflow_status in [
            WorkflowStatus.INITIALIZING,
            WorkflowStatus.RUNNING,
            WorkflowStatus.STOPPING,
        ]

    @property
    def workflow_runtime(self) -> float:
        """获取工作流运行时间（秒）"""
        if self.workflow_start_time is None:
            return 0.0
        return time.time() - self.workflow_start_time


class ProtocolNode(WorkstationBase):
    def __init__(self, deck: Optional[PLRResource], *args, **kwargs):
        super().__init__(deck, *args, **kwargs)