==========================================
PSA - Python Scripting & Automation
==========================================

Willkommen zur Dokumentation des Moduls PSA. Diese Unterlagen fassen die 
Lerninhalte von der Infrastruktur-Automatisierung bis zur sicheren 
Netzwerk-Kommunikation zusammen.

GitHub Organisation & Ressourcen
================================

Sämtliche praktischen Arbeiten, Skripte und Konfigurationen sind in der offiziellen
GitHub-Organisation hinterlegt. Das Haupt-Repository dient dabei als Root-Eintrag
für die Koordination aller Aufgaben:

* **Zentrale Repository-Übersicht:** `HF-Python-Scripting-Automation <https://github.com/orgs/HF-Python-Scripting-Automation/repositories>`_

Hier finden sich unter anderem:

* ``.github``: Zentrale Profil- und Organisationskonfiguration.
* ``socket_com``: Implementierungen für die Netzwerk-Kommunikation (Woche 2).
* ``psa-utils``: Hilfswerkzeuge und Skripte für das Modul.

Alle wöchentlichen Aufträge und Projekte werden direkt aus diesen Repositories
heraus ausgeführt und verwaltet.

.. toctree::
   :maxdepth: 2
   :numbered:
   :caption: Lernmodule & Arbeitsblätter

   arbeits_blatt_01
   arbeits_blatt_02

Überblick der Schwerpunkte
--------------------------

* **Woche 1 (Ansible):** Fokus auf **Infrastructure as Code (IaC)**. Einrichtung von Servern,
  SSH-Key-Management und automatisierte Software-Verteilung via Playbooks.
  
* **Woche 2 (Sockets & Protokolle):** Fokus auf die **Netzwerk-Ebene**. Programmierung von Client-Server-Systemen 
  und Analyse des Datenverkehrs mit Wireshark (TCP-Handshake & Payload).

* **Ausblick Woche 3 (Security):** Erweiterung der Kommunikation um kryptographische Verfahren (Fernet), 
  um die CIA-Triade (Vertraulichkeit) zu vervollständigen.

Indizes und Tabellen
====================

* :ref:`genindex`
* :ref:`search`