Покрытие кода docstrings

SRV/services/arp_service.py

@@ -1,3 +1,22 @@
+"""
+Сервис низкоуровневого ARP-сканирования локальной сети.
+
+Назначение:
+- Обнаружение активных узлов в пределах сетей хоста путём широковещательных
+  ARP‑запросов от имени выбранного интерфейса.
+- Помощь сервисам более высокого уровня (например, IPService) при проверке
+  занятости адресов перед применением конфигураций.
+
+Особенности реализации:
+- Определяет подключённые сети интерфейса через `netifaces` и строит CIDR для
+  сканирования.
+- Формирует ARP‑пакеты с помощью `scapy` (Ether/ARP) и отправляет их с таймаутом.
+- Добавляет локальный адрес интерфейса в результирующий список клиентов.
+
+Требования/ограничения:
+- Для отправки ARP‑кадров могут потребоваться повышенные привилегии или
+  capability на сырой сокет.
+"""
 from fastapi import Depends
 from scapy.layers.l2 import ARP, Ether
 from scapy.sendrecv import srp