Docstring документация моделей сервера

SRV/models/subnet.py

@@ -2,6 +2,19 @@ from pydantic import BaseModel
 from typing import Optional, List
 
 class Device(BaseModel):
+    """
+    Сканируемое устройство в подсети
+
+    Атрибуты:
+        ip (str): IP-адрес устройства
+        mac (Optional[str]): MAC-адрес устройства
+        hostname (Optional[str]): Имя хоста
+        vendor (Optional[str]): Название производителя устройства (По MAC-адресу)
+        open_ports (List[str]): Открытые порты устройства
+        status (str): Статус устройства (онлайн/оффлайн)
+        last_seen (Optional[str]): Последняя активность устройства
+        note (Optional[str]): Заметка устройства
+    """
     ip: str
     mac: Optional[str] = None
     hostname: Optional[str] = None
@@ -12,4 +25,10 @@ class Device(BaseModel):
     note: Optional[str] = None
 
 class SubnetScanResult(BaseModel):
+    """
+    Результат сканирования устройств в подсети
+
+    Атрибуты:
+        devices (List[Device]): Список просканированных устройств
+    """
     devices: List[Device] = []