100 lines
2.5 KiB
Python
100 lines
2.5 KiB
Python
|
"""ODF 光纤配线单元管理系统 - 数据模型定义。
|
|||
|
|
|
|||
|
|
本模块定义了系统中使用的内部数据模型（内存存储结构）。
|
|||
|
|
"""
|
|||
|
|
|
|||
|
|
from dataclasses import dataclass, field
|
|||
|
|
from enum import Enum
|
|||
|
|
from typing import Optional
|
|||
|
|
|
|||
|
|
|
|||
|
|
class PortType(str, Enum):
|
|||
|
|
"""光纤端口类型枚举。"""
|
|||
|
|
LC = "LC" # LC 接口
|
|||
|
|
SC = "SC" # SC 接口
|
|||
|
|
FC = "FC" # FC 接口
|
|||
|
|
ST = "ST" # ST 接口
|
|||
|
|
|
|||
|
|
|
|||
|
|
class PortStatus(str, Enum):
|
|||
|
|
"""光纤端口状态枚举。"""
|
|||
|
|
FREE = "FREE" # 空闲
|
|||
|
|
IN_USE = "IN_USE" # 使用中
|
|||
|
|
FAULT = "FAULT" # 故障
|
|||
|
|
|
|||
|
|
|
|||
|
|
@dataclass
|
|||
|
|
class Port:
|
|||
|
|
"""光纤端口数据模型。
|
|||
|
|
|
|||
|
|
Attributes:
|
|||
|
|
port_id: 端口唯一标识。
|
|||
|
|
unit_id: 所属配线单元 ID。
|
|||
|
|
port_number: 端口编号（同一单元内唯一）。
|
|||
|
|
port_type: 端口类型。
|
|||
|
|
status: 端口状态。
|
|||
|
|
label: 端口标签/标识说明。
|
|||
|
|
"""
|
|||
|
|
port_id: str
|
|||
|
|
unit_id: str
|
|||
|
|
port_number: int
|
|||
|
|
port_type: PortType = PortType.LC
|
|||
|
|
status: PortStatus = PortStatus.FREE
|
|||
|
|
label: str = ""
|
|||
|
|
|
|||
|
|
|
|||
|
|
@dataclass
|
|||
|
|
class Unit:
|
|||
|
|
"""配线单元数据模型。
|
|||
|
|
|
|||
|
|
Attributes:
|
|||
|
|
unit_id: 配线单元唯一标识。
|
|||
|
|
rack_id: 所属机架 ID。
|
|||
|
|
unit_number: 单元编号（同一机架内唯一）。
|
|||
|
|
unit_name: 单元名称。
|
|||
|
|
position: 在机架中的位置描述（如 "上排"、"下排"）。
|
|||
|
|
ports: 单元包含的光纤端口列表。
|
|||
|
|
"""
|
|||
|
|
unit_id: str
|
|||
|
|
rack_id: str
|
|||
|
|
unit_number: int
|
|||
|
|
unit_name: str = ""
|
|||
|
|
position: str = ""
|
|||
|
|
ports: list[Port] = field(default_factory=list)
|
|||
|
|
|
|||
|
|
|
|||
|
|
@dataclass
|
|||
|
|
class Rack:
|
|||
|
|
"""ODF 机架数据模型。
|
|||
|
|
|
|||
|
|
Attributes:
|
|||
|
|
rack_id: 机架唯一标识。
|
|||
|
|
rack_name: 机架名称/编号。
|
|||
|
|
location: 物理位置描述（如机房、列、排）。
|
|||
|
|
units: 机架中包含的配线单元列表。
|
|||
|
|
"""
|
|||
|
|
rack_id: str
|
|||
|
|
rack_name: str
|
|||
|
|
location: str = ""
|
|||
|
|
units: list[Unit] = field(default_factory=list)
|
|||
|
|
|
|||
|
|
|
|||
|
|
@dataclass
|
|||
|
|
class Connection:
|
|||
|
|
"""跳接连接数据模型，记录光纤端口之间的跳纤关系。
|
|||
|
|
|
|||
|
|
Attributes:
|
|||
|
|
connection_id: 连接唯一标识。
|
|||
|
|
port_a_id: 起始端口 ID（A端）。
|
|||
|
|
port_b_id: 终止端口 ID（B端）。
|
|||
|
|
fiber_length: 光纤长度（米）。
|
|||
|
|
create_time: 创建时间。
|
|||
|
|
remark: 备注说明。
|
|||
|
|
"""
|
|||
|
|
connection_id: str
|
|||
|
|
port_a_id: str
|
|||
|
|
port_b_id: str
|
|||
|
|
fiber_length: float = 0.0
|
|||
|
|
create_time: str = ""
|
|||
|
|
remark: str = ""
|