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

SRV/services/connect_service.py

@@ -1,3 +1,19 @@
+"""
+Сервис управления подключениями Wi‑Fi через `nmcli`.
+
+Назначение:
+- Предоставляет операции подключения/отключения к точкам доступа и проверки
+  текущего статуса, ориентируясь на системный NetworkManager.
+
+Поведение:
+- Автоматически определяет активный Wi‑Fi‑интерфейс.
+- Валидирует наличие SSID в листинге перед подключением и интерпретирует
+  частые ошибки `nmcli` (неверный пароль, отсутствующая сеть и т.п.).
+
+Ограничения:
+- Требуются права для управления сетевыми соединениями в системе.
+- В окружениях без NetworkManager команды `nmcli` будут недоступны.
+"""
 import subprocess
 import logging
 from typing import Tuple, Optional