pdock-dockstrings ergänzt

functions/verfahrensgebiet_alkis.py

@@ -1,4 +1,7 @@
-#sn_verfahrensgebiet/functions/verfahrensgebiet_alkis
+"""sn_verfahrensgebiet/functions/verfahrensgebiet_alkis.py – ALKIS-Integration.
+Lädt Verfahrensgebiete aus dem ALKIS-WFS-Dienst.
+"""
+
 from enum import Enum
 from sn_basis.functions import (
     QgsVectorLayer, QgsProject, QgsFeature, QgsField, QgsGeometry
@@ -11,6 +14,14 @@ alkis_NAS_url = "https://geodienste.sachsen.de/aaa/public_alkis/nas/wfs"
 typename = "adv:AX_BauRaumOderBodenordnungsrecht"
 
 class LoadStatus(Enum):
+    """Status eines Layer-Ladevorgangs.
+    
+    Attributes:
+        NONE: Nichts geladen
+        FIRST: Erstmalig geladen
+        RELOAD: Neu geladen
+        KEEP: Vorhandener Layer behalten
+    """
     NONE = "none"       # nichts geladen
     FIRST = "first"     # erstmalig geladen
     RELOAD = "reload"   # neu geladen
@@ -18,6 +29,14 @@ class LoadStatus(Enum):
 
 
 def _check_existing_layer(tab_widget):
+    """Prüft, ob ein Verfahrensgebiet-Layer bereits existiert.
+    
+    Args:
+        tab_widget: Parent-Widget für Dialoge
+        
+    Returns:
+        Tuple[Optional[QgsVectorLayer], LoadStatus]: Layer und Status
+    """
     project = QgsProject.instance()
     existing_layers = project.mapLayersByName("Verfahrensgebiet")
     if not existing_layers:
@@ -40,6 +59,14 @@ def _check_existing_layer(tab_widget):
 
 
 def verfahrensgebiet_alkis(tab_widget):
+    """Lädt Verfahrensgebiet aus ALKIS-WFS basierend auf Verfahrensnummer.
+    
+    Args:
+        tab_widget: Parent-Widget für Dialoge und Meldungen
+        
+    Returns:
+        Tuple[Optional[QgsVectorLayer], LoadStatus]: Geladener Layer und Status
+    """
     verfahrensnummer = get_variable("verfahrensnummer")
     if not verfahrensnummer:
         QMessageBox.critical(tab_widget, "Fehler",