🛠️ IT-Support & Systemadmin Diagnose-Tool

Ein leistungsstarkes konsolenbasiertes Python-Programm für IT-Support und Systemadministration

🚀 Features • 📋 Installation • 🎯 Verwendung • 📁 Struktur • ⚙️ Anforderungen

---

📝 Überblick

Dieses Projekt ist ein umfassendes IT-Support Diagnose-Tool für alltägliche Systemadministrations-Aufgaben. Es wurde als Abschlussprojekt für Python Tag 4 entwickelt und kombiniert moderne Python-Konzepte in einer benutzerfreundlichen Konsolenanwendung.

Hauptfunktionen:

• ✅ Menüführung & Benutzereingaben
• ✅ Datenverarbeitung (CSV, Textdateien)
• ✅ Fehlerbehandlung & Validierung
• ✅ Systemintegration & Reports
• ✅ Logdatei-Analyse

---

🎯 Features

#	📌 Menüfunktion	📂 Datenquelle / Ergebnis
1	🆕 Neues Ticket erstellen	→ tickets/neue_tickets.txt & data/tickets.csv
2	📖 Bestehende Tickets anzeigen	← data/tickets.csv
3	👥 Benutzerliste anzeigen	← data/benutzer.csv (mit Status-Warnung)
4	💾 Inventarliste anzeigen	← data/inventar.csv (mit Status-Meldung)
5	🔍 Logdatei durchsuchen	← logs/server.log (case-insensitive)
6	📊 Ordner analysieren	📈 Datei- & Ordnerzählung
7	📋 Systemreport erstellen	→ reports/system_report.txt
8	🚪 Programm beenden	✓ Sichere Beendigung

Nach jeder Aktion wird das Menü automatisch erneut angezeigt.

---

📋 Voraussetzungen

Anforderung	Details
🐍 Python-Version	3.14.6 oder höher
🖥️ Betriebssystem	Windows (getestet), Linux & macOS (mit Einschränkungen)
📦 Dependencies	Keine! Nur Python Standard Library
⚙️ Besonderheit	OS-spezifische Systembefehle (Windows/Unix)

---

🚀 Installation

1️⃣ Repository klonen

git clone https://github.com/harry0203vn/python-it-support-diagnose-tool.git
cd python-it-support-diagnose-tool

2️⃣ Programm starten

Auf Linux/macOS:

python main.py

Auf Windows (beide Varianten funktionieren):

python main.py

oder

py main.py

3️⃣ Menü bedienen

Geben Sie eine Zahl zwischen 1 und 8 ein und folgen Sie den Anweisungen im Terminal.

---

📁 Projektstruktur

python-it-support-diagnose-tool/
│
├── 📄 README.md                    # Dieses Dokument
├── 📄 main.py                      # Hauptprogramm
├── 📄 .gitignore                   # Git-Konfiguration
│
├── 📂 data/                        # Datenverwaltung
│   ├── benutzer.csv               # Benutzerdatenbank
│   ├── inventar.csv               # Geräte-Inventar
│   └── tickets.csv                # Ticket-Historie
│
├── 📂 logs/                        # System-Logs
│   └── server.log                 # Server-Logdatei
│
├── 📂 reports/                     # Generierte Reports
│   └── system_report.txt          # Automatischer Report
│
└── 📂 tickets/                     # Neue Tickets (dynamisch)
    ├── .gitkeep                   # Ordner-Platzhalter
    └── neue_tickets.txt           # (Wird bei Bedarf erstellt)

---

🔒 Fehlerbehandlung

Das Programm ist robust und behandelt folgende Fehlerszenarien:

Fehlerfall	Behandlung
❌ Leere Pflichtfelder	Erneute Abfrage mit Benutzer-Feedback
❌ Ungültige Menüwahl	Verständliche Fehlermeldung
❌ Fehlende CSV/Log-Dateien	Abfang & aussagekräftige Warnung
❌ Ungültiger Ordnerpfad	Sichere Beendigung ohne Crash
❌ Schreibfehler	Fehlerbehandlung & Meldung
❌ Systembefehl-Fehler	Timeout-Abfang & Fehlerbehandlung

---

📊 Systemreport

Der automatisch generierte Report (reports/system_report.txt) enthält:

✓ Datum und Uhrzeit der Erstellung
✓ Aktuelles Arbeitsverzeichnis
✓ Anzahl der Dateien im Projektordner
✓ Betriebssystem-spezifische Systemdiagnose
✓ Anzahl der WARN-Einträge in der Logdatei
✓ Anzahl der ERROR/FAILED-Einträge in der Logdatei

---

⚡ Umgesetzte Zusatzfunktionen

Über die Grundanforderungen hinaus wurden folgende Features implementiert:

• 🔧 Automatische Log-Analyse – Intelligente Zählung von Warnungen und Fehlern
• 💾 Duale Speicherung – Neue Tickets in TXT und CSV
• 🎨 Modularer Code – Eigene Funktionen für Menü und Optionen
• 🔄 Validierung – Erneute Abfrage bei leeren Eingaben
• 📐 Formatierung – Übersichtliche & lesbare Konsolenausgaben

---

✅ Tests & Qualitätssicherung

Test-Aspekt	Status
🖥️ Windows-Kompatibilität	✅ Vollständig getestet
🎮 Alle 8 Menüoptionen	✅ Funktioniert
✏️ Ticket-Speicherung (CSV)	✅ Funktioniert
📖 CSV-Ausgabe & Anzeige	✅ Funktioniert
🔍 Logsuche (mit/ohne Treffer)	✅ Funktioniert
📁 Ordner-Analyse	✅ Funktioniert
📋 Reportgenerierung	✅ Funktioniert
⚠️ Fehlende Dateien	✅ Ordnungsgemäß behandelt
🐧 Linux/macOS	⚠️ Nicht praktisch getestet

📌 Hinweis: Kein automatisiertes Test-Framework im Repository. Manuell validiert unter Windows.

---

🔗 Repository-Informationen

Info	Details
📍 Repository	harry0203vn/python-it-support-diagnose-tool
🔓 Sichtbarkeit	Öffentlich
🌿 Standard Branch	main
📝 Commits	Thematisch strukturiert
📦 Abgabeformat	GitHub Repository Link

---

📄 Lizenz

Dieses Projekt ist offen für Bildungszwecke und professionelle Nutzung.

---

💡 Fragen oder Verbesserungen?

Erstelle ein Issue oder Fork das Projekt

Happy Coding! 🚀