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

SRV/services/firewalld_service.py

@@ -1,3 +1,16 @@
+"""
+Сервис для управления firewalld через D‑Bus.
+
+Назначение:
+- Обёртка над интерфейсами `org.fedoraproject.FirewallD1` для выполнения
+  типовых операций по зонам: просмотр/изменение дефолтной зоны, добавление и
+  удаление сервисов, портов, источников, перезагрузка конфигурации.
+
+Примечания:
+- Используется `pydbus.SystemBus` для доступа к системной шине.
+- Методы генерируют дружелюбные исключения при ошибках, содержащие контекст
+  операции.
+"""
 from re import DEBUG
 from typing import Dict, List, Optional