194 lines
8.4 KiB
Python
194 lines
8.4 KiB
Python
|
# 联软LV7000数据模型
|
||
|
|
"""
|
||
|
|
定义联软API返回数据的Pydantic模型。
|
||
|
|
|
||
|
|
核心模型：
|
||
|
|
- TerminalBasicInfo：终端基本信息（queryDevByParams返回）
|
||
|
|
- TerminalAllInfo：终端详细信息（getDevAllInfo返回，极详细）
|
||
|
|
- UserInfo：用户信息（getUserInfoByAccount返回）
|
||
|
|
- OrgInfo：组织架构信息（getAllOrgInfo返回）
|
||
|
|
- OnlineStatus：终端在线状态（existOnlineUser返回）
|
||
|
|
"""
|
||
|
|
|
||
|
|
from typing import Optional
|
||
|
|
from pydantic import BaseModel, Field
|
||
|
|
|
||
|
|
|
||
|
|
# ==========================================================================
|
||
|
|
# 终端基本信息（queryDevByParams返回）
|
||
|
|
# ==========================================================================
|
||
|
|
|
||
|
|
class TerminalBasicInfo(BaseModel):
|
||
|
|
"""终端基本信息 — 最核心的映射数据源。
|
||
|
|
|
||
|
|
⭐ strusername + struserdes 字段直接提供员工账号→终端映射！
|
||
|
|
这是联软相比火绒最大的优势。
|
||
|
|
"""
|
||
|
|
# 终端标识
|
||
|
|
strdevname: str = Field(default="", description="计算机名")
|
||
|
|
strdevip: str = Field(default="", description="IP地址")
|
||
|
|
strmac: str = Field(default="", description="MAC地址")
|
||
|
|
|
||
|
|
# ⭐ 员工映射字段（核心价值）
|
||
|
|
strusername: str = Field(default="", description="使用该终端的用户账号（映射金钥匙）")
|
||
|
|
struserdes: str = Field(default="", description="用户姓名/描述")
|
||
|
|
|
||
|
|
# 组织信息
|
||
|
|
strdeptname: str = Field(default="", description="所属部门名")
|
||
|
|
|
||
|
|
# 状态
|
||
|
|
istatus: str = Field(default="", description="终端状态（1=在线/0=离线）")
|
||
|
|
|
||
|
|
# 网络
|
||
|
|
strswitchname: str = Field(default="", description="接入交换机名")
|
||
|
|
strifname: str = Field(default="", description="交换机接口名")
|
||
|
|
|
||
|
|
# 联系方式
|
||
|
|
strmail: str = Field(default="", description="用户邮箱")
|
||
|
|
strphone: str = Field(default="", description="用户电话")
|
||
|
|
|
||
|
|
# 其他
|
||
|
|
strdomain: str = Field(default="", description="Windows域")
|
||
|
|
strdevtype: str = Field(default="", description="设备类型")
|
||
|
|
|
||
|
|
|
||
|
|
# ==========================================================================
|
||
|
|
# 终端详细信息（getDevAllInfo返回）
|
||
|
|
# ==========================================================================
|
||
|
|
|
||
|
|
class HardwareInfo(BaseModel):
|
||
|
|
"""硬件组件信息"""
|
||
|
|
name: str = Field(default="", description="名称")
|
||
|
|
model: str = Field(default="", description="型号")
|
||
|
|
vendor: str = Field(default="", description="厂商")
|
||
|
|
capacity: str = Field(default="", description="容量")
|
||
|
|
serial: str = Field(default="", description="序列号")
|
||
|
|
|
||
|
|
|
||
|
|
class LogicalDiskInfo(BaseModel):
|
||
|
|
"""逻辑磁盘信息（含使用率，判断磁盘满）"""
|
||
|
|
name: str = Field(default="", description="卷标")
|
||
|
|
file_system: str = Field(default="", description="文件系统")
|
||
|
|
total_size: str = Field(default="", description="总量")
|
||
|
|
free_space: str = Field(default="", description="可用空间")
|
||
|
|
usage_percent: str = Field(default="", description="使用率")
|
||
|
|
|
||
|
|
|
||
|
|
class NetworkCardInfo(BaseModel):
|
||
|
|
"""网卡信息"""
|
||
|
|
name: str = Field(default="", description="名称")
|
||
|
|
is_wireless: str = Field(default="", description="是否无线")
|
||
|
|
vendor: str = Field(default="", description="厂商")
|
||
|
|
mac: str = Field(default="", description="MAC地址")
|
||
|
|
|
||
|
|
|
||
|
|
class DisplayInfo(BaseModel):
|
||
|
|
"""显示器信息（多屏配置排查）"""
|
||
|
|
vendor: str = Field(default="", description="厂商")
|
||
|
|
model: str = Field(default="", description="型号")
|
||
|
|
serial: str = Field(default="", description="序列号")
|
||
|
|
size: str = Field(default="", description="尺寸")
|
||
|
|
|
||
|
|
|
||
|
|
class TerminalAllInfo(BaseModel):
|
||
|
|
"""终端详细信息 — 极其详细，比火绒_info2更丰富。
|
||
|
|
|
||
|
|
包含：设备基础+硬件+软件+资产+网络配置。
|
||
|
|
特别是逻辑磁盘使用率和显示器信息，是火绒没有的。
|
||
|
|
"""
|
||
|
|
# 设备基础
|
||
|
|
strdevname: str = Field(default="", description="计算机名")
|
||
|
|
strip1: str = Field(default="", description="IP地址")
|
||
|
|
strmac: str = Field(default="", description="MAC地址")
|
||
|
|
strnatip: str = Field(default="", description="NAT IP")
|
||
|
|
macverdor: str = Field(default="", description="MAC厂商")
|
||
|
|
strdevtype: str = Field(default="", description="设备类型")
|
||
|
|
|
||
|
|
# 组织+用户
|
||
|
|
strdeptname: str = Field(default="", description="所属部门")
|
||
|
|
strusername: str = Field(default="", description="用户账号⭐")
|
||
|
|
struserdes: str = Field(default="", description="用户姓名⭐")
|
||
|
|
|
||
|
|
# 时间
|
||
|
|
dtdevuptime: str = Field(default="", description="最近上线时间")
|
||
|
|
dtdevdowntime: str = Field(default="", description="最近下线时间")
|
||
|
|
dtdevfirstfoundtime: str = Field(default="", description="首次发现时间")
|
||
|
|
|
||
|
|
# 系统
|
||
|
|
stros: str = Field(default="", description="操作系统")
|
||
|
|
strdomain: str = Field(default="", description="Windows域")
|
||
|
|
strserialnumber: str = Field(default="", description="序列号")
|
||
|
|
strmainboardtype: str = Field(default="", description="主板型号")
|
||
|
|
|
||
|
|
# 客户端详情
|
||
|
|
strverofuaagent: str = Field(default="", description="安全助手版本")
|
||
|
|
istatus: str = Field(default="", description="在线状态")
|
||
|
|
devassetno: str = Field(default="", description="设备资产号")
|
||
|
|
devgroup: str = Field(default="", description="设备所属设备组")
|
||
|
|
|
||
|
|
# 硬件详情（列表）
|
||
|
|
mainboard: list[HardwareInfo] = Field(default_factory=list, description="主板信息")
|
||
|
|
cpu: list[HardwareInfo] = Field(default_factory=list, description="CPU信息")
|
||
|
|
memory: list[HardwareInfo] = Field(default_factory=list, description="内存信息")
|
||
|
|
hard_disk: list[HardwareInfo] = Field(default_factory=list, description="硬盘信息")
|
||
|
|
logical_disk: list[LogicalDiskInfo] = Field(default_factory=list, description="逻辑磁盘")
|
||
|
|
graphics_card: list[HardwareInfo] = Field(default_factory=list, description="显卡信息")
|
||
|
|
network_card: list[NetworkCardInfo] = Field(default_factory=list, description="网卡信息")
|
||
|
|
display: list[DisplayInfo] = Field(default_factory=list, description="显示器信息")
|
||
|
|
|
||
|
|
|
||
|
|
# ==========================================================================
|
||
|
|
# 用户信息（getUserInfoByAccount返回）
|
||
|
|
# ==========================================================================
|
||
|
|
|
||
|
|
class UserInfo(BaseModel):
|
||
|
|
"""用户信息"""
|
||
|
|
deptid: str = Field(default="", description="部门ID")
|
||
|
|
userid: str = Field(default="", description="用户ID")
|
||
|
|
useraccount: str = Field(default="", description="用户账号")
|
||
|
|
username: str = Field(default="", description="用户姓名")
|
||
|
|
|
||
|
|
|
||
|
|
# ==========================================================================
|
||
|
|
# 组织架构信息（getAllOrgInfo返回）
|
||
|
|
# ==========================================================================
|
||
|
|
|
||
|
|
class OrgDeptInfo(BaseModel):
|
||
|
|
"""部门信息"""
|
||
|
|
deptid: str = Field(default="", description="部门ID")
|
||
|
|
deptname: str = Field(default="", description="部门名称")
|
||
|
|
parentid: str = Field(default="", description="父部门ID")
|
||
|
|
users: list[UserInfo] = Field(default_factory=list, description="部门下用户列表")
|
||
|
|
|
||
|
|
|
||
|
|
# ==========================================================================
|
||
|
|
# 终端在线状态（existOnlineUser返回）
|
||
|
|
# ==========================================================================
|
||
|
|
|
||
|
|
class OnlineStatus(BaseModel):
|
||
|
|
"""终端在线状态"""
|
||
|
|
username: str = Field(default="", description="用户名")
|
||
|
|
ip: str = Field(default="", description="IP地址")
|
||
|
|
is_online: bool = Field(default=False, description="是否在线")
|
||
|
|
|
||
|
|
|
||
|
|
# ==========================================================================
|
||
|
|
# 软件信息（querysoftwarebydev返回）
|
||
|
|
# ==========================================================================
|
||
|
|
|
||
|
|
class SoftwareInfo(BaseModel):
|
||
|
|
"""软件安装信息"""
|
||
|
|
name: str = Field(default="", description="软件名称")
|
||
|
|
version: str = Field(default="", description="版本")
|
||
|
|
vendor: str = Field(default="", description="厂商")
|
||
|
|
install_date: str = Field(default="", description="安装日期")
|
||
|
|
|
||
|
|
|
||
|
|
class TerminalSoftwareInfo(BaseModel):
|
||
|
|
"""终端安装软件信息"""
|
||
|
|
strdevname: str = Field(default="", description="计算机名")
|
||
|
|
strdevip: str = Field(default="", description="IP地址")
|
||
|
|
strmac: str = Field(default="", description="MAC地址")
|
||
|
|
strusername: str = Field(default="", description="用户账号")
|
||
|
|
softwares: list[SoftwareInfo] = Field(default_factory=list, description="软件列表")
|