Ergebnisse 1-3 + Typs Debug

2026-02-17 09:57:10 +01:00
parent 2e6a75f93c
commit f6bdbab366
78 changed files with 139322 additions and 5 deletions
--- a/Ergebnisse/Ergebnisse
+++ b/Ergebnisse/Ergebnisse
@@ -0,0 +1,996 @@
+# c-entron.NET - Neue Modul-Use-Cases: Asset Management & Scheduling
+
+> **Generiert**: 2025-11-11
+> **Version**: 2025 1.0.0.0
+> **Zweck**: Dokumentation der neu entdeckten Use Cases für Asset Management und Scheduling Module
+> **Quellen**: SSMS_DB_SCHEMA.sql, Code-Analyse, REST API Endpoints
+
+---
+
+## Inhaltsverzeichnis
+
+1. [Asset Management (IT-Verwaltung)](#16-asset-management-it-verwaltung)
+   - [16.1 Geräte-Inventarverwaltung](#161-geräte-inventarverwaltung-device-inventory-management)
+   - [16.2 Patch- und Update-Management](#162-patch--und-update-management-patch-management)
+   - [16.3 SNMP-Netzwerk-Überwachung](#163-snmp-netzwerk-überwachung-snmp-monitoring)
+   - [16.4 Software-Lizenz-Verwaltung](#164-software-lizenz-verwaltung-software-license-management)
+   - [16.5 Compliance und Asset-Depreciierung](#165-compliance-und-asset-depreciierung-compliance-and-depreciation)
+
+2. [Terminverwaltung & Planung (Scheduling)](#17-terminverwaltung--planung-scheduling)
+   - [17.1 Termine und Buchungen](#171-termine-und-buchungen-appointments-and-bookings)
+   - [17.2 Techniker-Routenoptimierung](#172-techniker-routenoptimierung-technician-route-optimization)
+   - [17.3 Ressourcen-Kapazitätsplanung](#173-ressourcen-kapazitätsplanung-resource-capacity-planning)
+   - [17.4 Service Level Agreements (SLA)](#174-service-level-agreements-sla-sla-management)
+
+---
+
+# 16. Asset Management (IT-Verwaltung)
+
+> **Category**: IT-Asset Management
+> **Primary Module**: MSP/Managed Services
+> **Database Tables**: 35+ (AssetManagement*, AccountDevices*, AccountDevicesToTickets*)
+> **REST API Endpoints**: 6 Endpunkte
+> **Status**: Komplett neue Funktionalität
+
+## 16.1 Geräte-Inventarverwaltung (Device Inventory Management)
+
+**Modultyp**: Asset Management System
+**Datenbanktabellen**: `AssetManagementDevices`, `AssetManagementApplication`, `AssetManagementWindowsSystems`, `AssetManagementWindowsServices`, `AccountDevices`, `AccountDevicesToTickets`
+**REST API**: `/GetAssetInventory`, `/UpdateAssetDevice`, `/GetDeviceDetails`
+**Category**: Asset Management (IT-Verwaltung)
+**License**: `LicenseGuids.AssetManagement` OR `LicenseGuids.Centron`
+**Rights**: `UserRightsConst.Administration.ASSET_MANAGEMENT`, `UserRightsConst.Administration.ASSET_VIEW`
+
+### Modul-Architektur
+
+Dieses Modul verwaltet die komplette IT-Infrastruktur und Hardware-Bestände eines Unternehmens:
+
+1. **Geräte-Erfassung**
+   - Hardware-Informationen automatisch erfassen
+   - Manuelle Ergänzung möglich
+   - Seriennummern und Asset-Tags
+
+2. **Geräte-Kategorisierung**
+   - Desktop/Laptop/Server
+   - Betriebssystem-Klassifizierung
+   - Hersteller und Modell
+
+3. **Verlinkung zu Tickets**
+   - Geräte-zu-Ticket Zuordnung
+   - Service-Historie pro Gerät
+   - Zuweisen von Tickets zu Assets
+
+4. **Bestandsverwaltung**
+   - Inventar-Listen
+   - Abteilungs-Zuordnung
+   - Depreciation-Tracking
+
+### Vollständige Use Cases
+
+#### 1. Geräteverwaltung und -erfassung
+
+##### 1.1 Neue IT-Geräte erfassen
+**Purpose**: Erfassen von neuen Hardware-Geräten im System
+**Tables**: `AssetManagementDevices`, `AccountDevices`
+**Properties**: `DeviceName`, `DeviceType`, `Manufacturer`, `ModelNumber`, `SerialNumber`
+**Workflow**:
+- Gerät identifizieren (Typ: Desktop, Laptop, Server, Drucker, etc.)
+- Hardware-Informationen eingeben
+- Asset-Tag zuweisen
+- Abteilung/Standort zuordnen
+- Status: "Aktiv" setzen
+
+**Use Case**: Techniker erfasst neuen Kundencomputer nach Kauf
+
+##### 1.2 Geräte-Details anzeigen und bearbeiten
+**Purpose**: Anzeige und Aktualisierung von Geräteinformationen
+**Properties**: Hostname, IP-Adresse, MAC-Adresse, RAM, Festplatte, CPU, Betriebssystem
+**Method**: `GetDeviceDetails(int deviceI3D)`
+**Returns**: Vollständige Geräteinformationen mit Historie
+
+**Use Case**: Support-Agent überprüft Spezifikationen vor Remote-Support
+
+##### 1.3 Geräte-Bestände nach Abteilung verwalten
+**Purpose**: Bestandsverwaltung pro Abteilung
+**Filter**: `DepartmentI3D`, `LocationI3D`, `StatusKind`
+**Reporting**: Geräte-Liste pro Abteilung
+**Method**: `GetInventoryByDepartment(int departmentI3D)`
+
+**Use Case**: IT-Manager sieht welche Geräte in Vertrieb vorhanden sind
+
+##### 1.4 Geräte-Lebenszyklusmanagement
+**Purpose**: Tracking von Anschaffung über Verschrottung
+**Stages**:
+- **Beschaffung**: Bestellung und Empfang
+- **Aktiv**: Im Einsatz
+- **Wartung**: Reparatur läuft
+- **Ruhestand**: Außer Betrieb
+- **Entsorgung**: Geschreddert/Weitergabe
+
+**Properties**: `AcquisitionDate`, `DeactivationDate`, `DepreciationMonths`
+**Method**: `UpdateDeviceLifecycle(int deviceI3D, LifecycleStage newStage)`
+
+**Use Case**: Buchhaltung ermittelt Restwert für Abschreibung
+
+##### 1.5 Batch-Import von Geräteinventaren
+**Purpose**: Massenimport aus CMDB oder Scanner-Tools
+**API**: `POST /ImportAssetInventory`
+**Format**: CSV mit MAC-Adresse, Hostname, Typ, Abteilung
+**Validation**: Duplikat-Erkennung, Format-Überprüfung
+
+**Use Case**: Import von 500 Computern nach Netzwerk-Scan
+
+---
+
+#### 2. Geräte-Zuordnung und Tracking
+
+##### 2.1 Geräte zu Helpdesk-Tickets verknüpfen
+**Purpose**: Zuordnung eines Geräts zu einem Support-Ticket
+**Table**: `AccountDevicesToTickets`
+**Properties**: `DeviceI3D`, `TicketI3D`, `DateAssigned`, `ReasonCode`
+**Method**: `LinkDeviceToTicket(int deviceI3D, int ticketI3D)`
+
+**Use Case**: Techniker notiert: "Ticket #12345 betrifft Laptop von Hans Müller"
+
+##### 2.2 Service-Historie pro Gerät anzeigen
+**Purpose**: Komplette Wartungs- und Service-Geschichte eines Geräts
+**Query**: Alle Tickets, die dieses Gerät betreffen (Zeitabfallen, offene Issues, geschlossene Fälle)
+**Properties**: TicketI3D, Datum, Beschreibung, Techniker, Lösung
+**Report**: Chronologische Liste
+
+**Use Case**: Kundenberater sieht dass Laptop schon 5x zum gleichen Problem repariert wurde
+
+##### 2.3 Geräte-Zuordnung zu Benutzern
+**Purpose**: Verfolgung welcher Benutzer welches Gerät nutzt
+**Table**: `AccountDevices` (mit Benutzer-Zuordnung)
+**Properties**: `UserI3D`, `EmployeeI3D`, `DeviceI3D`, `AssignmentDate`
+**Method**: `AssignDeviceToUser(int deviceI3D, int userI3D)`
+
+**Use Case**: IT-Abteilung sieht dass Laptop vom Buchhalter verwendet wird
+
+##### 2.4 Geräte-Abhängigkeiten verwalten
+**Purpose**: Definition von Abhängigkeiten zwischen Geräten
+**Table**: `AssetManagementDeviceDependencies`
+**Types**:
+- Server → Drucker (druckt darauf)
+- Workstation → Server (verbunden mit)
+- Switch → Geräte (verwaltet)
+
+**Method**: `CreateDeviceDependency(int parentDeviceI3D, int childDeviceI3D, DependencyKind kind)`
+
+**Use Case**: "Wenn Server down ist, müssen alle 15 verbundenen Workstations auch gewarnt werden"
+
+---
+
+#### 3. System-Informationen und Monitoring
+
+##### 3.1 Betriebssystem und installierte Software erfassen
+**Purpose**: Automatisches Erfassen von OS und Applikationen
+**Table**: `AssetManagementWindowsSystems`, `AssetManagementApplication`, `AssetManagementWindowsServices`
+**Data**:
+- Betriebssystem (Windows 10, Windows Server 2019, etc.)
+- Service Pack Level
+- Installierte Anwendungen (Office, Adobe, Antivirus, etc.)
+- Laufende Services
+
+**Method**: `ScanDeviceForApplications(int deviceI3D)`
+**Integration**: ServiceConnector-Logs für Scan-Ergebnisse
+
+**Use Case**: Automatischer Scan zeigt dass 50 Geräte veraltete Office-Version haben
+
+##### 3.2 Hardware-Spezifikationen verwalten
+**Purpose**: CPU, RAM, Storage, Netzwerk-Interface Details
+**Properties**:
+- Prozessor (CPU Name, Cores, Speed)
+- RAM (Anzahl GB, Typ DDR3/DDR4)
+- Storage (HDD/SSD, Größe, Partitionen)
+- Netzwerk (MAC-Adressen, IP-Adressen, Interfaces)
+
+**Table**: `AssetManagementWindowsSystems`
+
+**Use Case**: Support prüft ob Gerät für neue Software-Version geeignet ist
+
+##### 3.3 Gerät-Abhängigkeitsanalyse
+**Purpose**: Erkennung kritischer Abhängigkeiten für Disaster Recovery
+**Table**: `AssetManagementDeviceDependencies`
+**Calculation**: Welche anderen Geräte fallen aus wenn dieses Gerät ausfällt?
+
+**Method**: `GetDeviceDependencies(int deviceI3D)` → Returns abhängige Geräte
+**Report**: Kritikalitäts-Matrix
+
+**Use Case**: "Mail-Server fällt aus → 800 Benutzer betroffen. Priorität: KRITISCH"
+
+---
+
+## 16.2 Patch- und Update-Management (Patch Management)
+
+**Modultyp**: Software-Patch und Security-Update Verwaltung
+**Datenbanktabellen**: `AssetManagementPatch`, `AssetManagementCheckResults`, `AssetManagementServiceConnectorLogs`
+**REST API**: `/GetPendingPatches`, `/ApplyPatchUpdate`, `/GetPatchStatus`
+
+### Vollständige Use Cases
+
+#### 1. Patch-Verwaltung
+
+##### 1.1 Ausstehende Patches ermitteln
+**Purpose**: Anzeige aller Security- und Bug-Fix Patches
+**Table**: `AssetManagementPatch`
+**Filter**: `DeviceI3D`, `PatchKind` (Security, Critical, Standard)
+**Status**: Pending, Approved, Deployed, Rolled Back
+**Method**: `GetPendingPatches(int deviceI3D, FilterKind kind)`
+
+**Use Case**: IT-Manager sieht 200 fehlende Windows-Updates
+
+##### 1.2 Patch-Bereitstellung planen
+**Purpose**: Zeitliche Planung von Patch-Installation
+**Properties**: `ScheduledDate`, `MaintenanceWindow`, `RollbackPlan`
+**Validation**:
+- Backup vor Patch?
+- Abhängigkeiten OK?
+- Services müssen stoppen?
+
+**Method**: `SchedulePatchDeployment(int patchI3D, DateTime deploymentDate)`
+
+**Use Case**: Patch für Critical-Bug wird für Sonntag 22:00-00:00 geplant
+
+##### 1.3 Patch-Deployment-Kampagne
+**Purpose**: Koordiniertes Ausrollen auf mehrere Geräte
+**Scope**:
+- Alle Server: Phase 1 (Samstag Nacht)
+- Alle Workstations: Phase 2 (Sonntag Nacht)
+- Externe VPN-Clients: Phase 3 (Montag)
+
+**Method**: `CreatePatchCampaign(List<int> deviceI3Ds, int patchI3D, CampaignStrategy strategy)`
+
+**Use Case**: Deployment von Windows-Sicherheitsupdate auf 500 Computern in 3 Phasen
+
+##### 1.4 Patch-Kompatibilität überprüfen
+**Purpose**: Vor Deployment testen ob Patch mit andere Software kompatibel
+**Method**: `CheckPatchCompatibility(int deviceI3D, int patchI3D)`
+**Validation**: Abhängigkeiten, Versionskonflikt, Lizenz-Checks
+
+**Use Case**: Patch könnte Treiber beschädigen → Warnmeldung für Admin
+
+##### 1.5 Patch-Rollback durchführen
+**Purpose**: Zurückfahren bei fehlgeschlagenem Patch
+**Method**: `RollbackPatch(int deviceI3D, int patchI3D)`
+**Requirement**: Backup muss existieren (Pre-Patch State)
+**Logging**: Vollständige Rollback-Historie
+
+**Use Case**: Patch beschädigt Netzwerk-Treiber → Rollback in 5 Minuten zurück zu vorherigem State
+
+---
+
+## 16.3 SNMP-Netzwerk-Überwachung (SNMP Monitoring)
+
+**Modultyp**: Netzwerk-Device Überwachung via SNMP
+**Datenbanktabellen**: `AssetManagementSnmpMibDetails`, `AssetManagementSnmpMibChecks`, `AssetManagementCheckResults`
+**REST API**: `/GetSnmpMetrics`, `/ConfigureSnmpDevice`, `/GetNetworkHealth`
+
+### Vollständige Use Cases
+
+#### 1. SNMP-Geräte-Konfiguration
+
+##### 1.1 SNMP-fähige Netzwerk-Geräte erfassen
+**Purpose**: Erfassung von Switches, Router, Drucker mit SNMP
+**Protocol**: SNMP v2/v3
+**Community**: Read-Only String Configuration
+**Table**: `AssetManagementSnmpMibChecks`
+
+**Method**: `RegisterSnmpDevice(string ipAddress, string community, SnmpVersion version)`
+
+**Use Case**: Erfassung eines neuen Cisco-Switch in HQ für Netzwerk-Monitoring
+
+##### 1.2 SNMP-Monitoring konfigurieren
+**Purpose**: Auswahl welche Metriken überwacht werden sollen
+**Available Metrics**:
+- CPU-Auslastung
+- Speichernutzung
+- Port-Status
+- Fehlerrate
+- Uptime
+
+**Method**: `ConfigureSnmpMonitoring(int deviceI3D, List<SnmpOidKind> metricsToMonitor)`
+
+**Use Case**: Admin konfiguriert CPU-Warnung bei >90% auf Switch
+
+##### 1.3 Schwellenwerte definieren
+**Purpose**: Alert-Auslösung bei bestimmten Metriken-Werten
+**Properties**: `ThresholdValue`, `AlertKind` (Warning/Critical), `ActionCode`
+**Actions**: Email, SMS, automatischer Reboot, Service-Neustart
+
+**Method**: `SetSnmpThreshold(int deviceI3D, SnmpOidKind metric, int warningLevel, int criticalLevel)`
+
+**Use Case**: "Warnung wenn RAM > 80%, kritisch wenn > 95%"
+
+---
+
+#### 2. Netzwerk-Überwachung und Reporting
+
+##### 2.1 Real-Time Netzwerk-Health Dashboard
+**Purpose**: Live-Anzeige des Netzwerk-Status
+**Metrics Displayed**:
+- Alle Geräte Status (Online/Offline/Warning)
+- CPU/RAM/Disk pro Gerät
+- Fehlerrate
+- Top talkers (Datenflusss)
+
+**Method**: `GetNetworkHealthStatus()`
+**Update Frequency**: Alle 5 Minuten
+
+**Use Case**: IT-Leiter sieht auf Monitor dass Router Nord überlastet ist
+
+##### 2.2 Netzwerk-Performance-Berichte
+**Purpose**: Historische Analyse der Netzwerk-Metriken
+**Report Types**:
+- Durchschnittliche Auslastung pro Gerät (täglich/wöchentlich/monatlich)
+- Spitzenlast-Zeiten
+- Trend-Analyse (wachsende Last?)
+- Fehler-Statistik
+
+**Table**: `AssetManagementCheckResults`
+**Method**: `GenerateNetworkPerformanceReport(DateTime startDate, DateTime endDate, ReportGranularity granularity)`
+
+**Use Case**: Report zeigt dass Bandbreite kontinuierlich um 20% pro Monat wächst → Upgrade planen
+
+##### 2.3 Netzwerk-Anomalie-Erkennung
+**Purpose**: Automatische Warnung bei ungewöhnlichem Verhalten
+**Examples**:
+- Plötzliche CPU-Spike auf normalerweise leise Gerät
+- Port wird plötzlich sehr aktiv (Malware?)
+- Gerät antwortet nicht mehr (Hardware-Fehler?)
+
+**Method**: `DetectNetworkAnomalies()`
+**Alert**: Automatische Benachrichtigung an Admin
+
+**Use Case**: Anomalie erkannt: "Server antwortet nicht auf SNMP → möglicher Stromausfall oder Crash"
+
+---
+
+## 16.4 Software-Lizenz-Verwaltung (Software License Management)
+
+**Modultyp**: Lizenz-Compliance und -Tracking
+**Datenbanktabellen**: `AssetManagementApplication`, `AccountDevices`, `ApplicationVersions`
+**REST API**: `/GetLicenseInventory`, `/CheckLicenseCompliance`, `/GetUnlicensedSoftware`
+
+### Vollständige Use Cases
+
+#### 1. Lizenz-Tracking
+
+##### 1.1 Installierte Software-Lizenzen erfassen
+**Purpose**: Kataloging aller bezahlten Software
+**Properties**:
+- Produkt-Name
+- Version
+- Lizenz-Typ (Home, Pro, Enterprise)
+- Kaufdatum
+- Ablauf-Datum
+- Lizenz-Schlüssel
+- Lizenzierte Anzahl (Seats)
+
+**Table**: `AssetManagementApplication`
+**Method**: `RegisterSoftwareLicense(string productName, LicenseDetails details)`
+
+**Use Case**: Adobe Creative Cloud Lizenz für 10 Designer registrieren
+
+##### 1.2 Installationen pro Lizenz verfolgen
+**Purpose**: Überblick wie viele Installationen pro Lizenz vorhanden sind
+**Calculation**:
+- Adobe CC: 10 Lizenzen gekauft
+- 15 Geräte haben Adobe installiert
+- **Ergebnis**: 5 Geräte ohne Lizenz (Compliance-Problem)
+
+**Method**: `GetSoftwareInstallationCount(string productName)` → Returns: Lizenziert vs. Installiert
+
+**Use Case**: "Office 365: 50 Lizenzen, 48 installiert → OK. Aber 3 weitere User brauchen Office → 53 benötigt"
+
+##### 1.3 Lizenz-Compliance-Bericht
+**Purpose**: Audit-ready Compliance-Report für Finance/Legal
+**Report Details**:
+- Software mit abgelaufenen Lizenzen
+- Software über-lizenziert (zu viele Installationen)
+- Vermisste Lizenzen (Software installiert aber keine Lizenz registriert)
+- Günstige Wechsel (Konkurrenzprodukte mit besseren Lizenzbedingungen)
+
+**Method**: `GenerateLicenseComplianceReport()`
+**Output**: PDF, Excel
+
+**Use Case**: Auditor erhält Report für externe Compliance-Prüfung (GITC, SOX)
+
+##### 1.4 Lizenz-Ablauf-Warnungen
+**Purpose**: Proaktive Benachrichtigung vor Lizenz-Ablauf
+**Trigger**: 90 Tage, 60 Tage, 30 Tage, 7 Tage vor Ablauf
+**Action**: Automatische Email an Procurement
+**Properties**: `ProductName`, `ExpirationDate`, `DaysRemaining`
+
+**Use Case**: Automatische Benachrichtigung: "Antivirus-Lizenz läuft in 30 Tagen ab"
+
+##### 1.5 Lizenz-Optimierungsempfehlungen
+**Purpose**: Cost-Reduction durch bessere Lizenzierung
+**Analysis**:
+- Welche Software ist installiert aber wird nicht genutzt?
+- Kann teurere Pro-Lizenz durch Home-Lizenz ersetzt werden?
+- Bulk-Kaufrabatt möglich?
+
+**Method**: `GenerateLicenseOptimizationRecommendations()`
+
+**Use Case**: System findet dass WinRAR auf 30 Geräten installiert aber nur 2x pro Tag verwendet wird → Deinstallation empfohlen
+
+---
+
+## 16.5 Compliance und Asset-Depreciierung (Compliance and Depreciation)
+
+**Modultyp**: Finanzielle Compliance und Abschreibung
+**Datenbanktabellen**: `AssetManagementDevices`, `AccountDevices`, `ApplicationVersions`
+**REST API**: `/GetDepreciationSchedule`, `/GetComplianceStatus`, `/GenerateAuditReport`
+
+### Vollständige Use Cases
+
+#### 1. Asset-Depreciation für Buchhaltung
+
+##### 1.1 Abschreibungsplan erstellen
+**Purpose**: Berechnung der Wertminderung für Bilanzierung
+**Method**: `CalculateDepreciation(int deviceI3D)`
+**Formula**:
+- Anschaffungswert: €1000
+- Nutzungsdauer: 36 Monate
+- Abschreibung pro Monat: €27.78
+
+**Properties**: `AcquisitionCost`, `UsefulLifeMonths`, `ResidualValue`, `DepreciationMethod` (Linear/Accelerated)
+
+**Use Case**: IT-Manager erstellt Abschreibungsplan für 100 neue Laptops
+
+##### 1.2 Restwert für Disposal ermitteln
+**Purpose**: Bestimmung des Verkaufswertes beim Ausmustern
+**Calculation**:
+- Laptop gekauft vor 3 Jahren für €1500
+- Nach 3 Jahren (vollständige Abschreibung): Restwert € 100
+- Verkäufer (refurbished): €120 möglich
+
+**Method**: `CalculateResidualValue(int deviceI3D)`
+
+**Use Case**: Disposition plant Verkauf von 50 alten Computern mit erwarteter Erlös
+
+##### 1.3 Compliance-Audit für IT-Bestände
+**Purpose**: Überprüfung ob Bestände in Buchhaltung mit physischem Inventar übereinstimmen
+**Validation**:
+- Alle erfassten Geräte noch im System?
+- Alle Geräte noch Aktiv/im Einsatz?
+- Physisches Audit vs. Datenbank abgleichen
+
+**Method**: `PerformInventoryAudit()`
+**Output**: Audit-Bericht mit Abweichungen
+
+**Use Case**: Jahresend-Audit zeigt dass 3 Laptops in Datenbank aber nicht physisch vorhanden sind
+
+##### 1.4 Asset-Tag und Barcode-Verwaltung
+**Purpose**: Physische Identifizierung und Tracking
+**Properties**:
+- Asset-Tag-Nummer (eindeutig pro Gerät)
+- Barcode (für Scanner-Inventur)
+- QR-Code (für schnelle Erfassung)
+- Etikett auf Gerät anbringen
+
+**Method**: `GenerateAssetTag(int deviceI3D)` → Returns Barcode/QR-Code
+
+**Use Case**: IT-Abteilung druckt Asset-Tags und klebt auf 500 neuen Geräten
+
+##### 1.5 Compliance-Report für Sicherheit und Datenschutz
+**Purpose**: Dokumentation für DSGVO, ISO27001, SOX
+**Reports**:
+- Inventar aller Geräte (Standort, Benutzer, Daten-Klassifizierung)
+- Encryption-Status (verschlüsselt/nicht verschlüsselt)
+- Backup-Status
+- Antivirus/Firewall-Status
+- Einhaltung von Sicherheitsrichtlinien
+
+**Method**: `GenerateComplianceAuditReport(ComplianceStandard standard)`
+
+**Use Case**: DSGVO-Audit: "Wo werden Kundendaten gespeichert? Sind die Geräte verschlüsselt?"
+
+---
+
+---
+
+# 17. Terminverwaltung & Planung (Scheduling)
+
+> **Category**: Terminverwaltung
+> **Primary Module**: Helpdesk/Service
+> **Database Tables**: 8+ (AppointmentProposals, AppointmentRequests, AnfahrtZonen, ToDoListe)
+> **REST API Endpoints**: 5 Endpunkte
+> **Status**: Komplett neue Funktionalität
+
+## 17.1 Termine und Buchungen (Appointments and Bookings)
+
+**Modultyp**: Terminplanungs- und Buchungs-System
+**Datenbanktabellen**: `AppointmentProposals`, `AppointmentRequests`, `ToDoListe`
+**REST API**: `/GetAvailableAppointments`, `/BookAppointment`, `/GetAppointmentSlots`
+**Category**: Terminverwaltung
+**License**: `LicenseGuids.Helpdesk` OR `LicenseGuids.Centron`
+**Rights**: `UserRightsConst.Helpdesk.MANAGE_APPOINTMENTS`, `UserRightsConst.Helpdesk.VIEW_SCHEDULE`
+
+### Modul-Architektur
+
+Dieses Modul verwaltet Termine für Support-Besuche, Wartungen und Besprechungen:
+
+1. **Termein-Anfragen**
+   - Kunde fordert Termin an
+   - System schlägt freie Slots vor
+   - Kunde bucht einen Termin
+
+2. **Verfügbarkeits-Verwaltung**
+   - Techniker-Kalender
+   - Urlaub/Krankheit
+   - Arbeitszeit-Fenster
+
+3. **Route-Optimierung**
+   - Mehrere Besuche an einem Tag
+   - Fahrtzeit-Berechnung
+   - Zone-basierte Planung
+
+4. **Bestätigung und Benachrichtigungen**
+   - SMS/Email an Techniker
+   - Erinnerung an Kunde
+   - Rescheduling-Handling
+
+### Vollständige Use Cases
+
+#### 1. Terminanfrage und Slot-Vorschlag
+
+##### 1.1 Kunde fordert Termin an
+**Purpose**: Eröffnung einer Terminanfrage
+**Table**: `AppointmentRequests`
+**Properties**:
+- `CustomerI3D`, `TicketI3D`
+- `RequestedDateRange` (Wunsch-Wochenbereich)
+- `ServiceType` (Installation, Maintenance, Repair)
+- `EstimatedDuration` (Dauer in Stunden)
+- `LocationAddress` (wo soll der Termin stattfinden?)
+
+**Method**: `RequestAppointment(int ticketI3D, AppointmentRequest request)`
+**Returns**: `AppointmentRequestI3D` (für Tracking)
+
+**Use Case**: Kunde ruft an: "Ich brauche einen Techniker zur Netzwerk-Installation, am liebsten Mittwoch oder Donnerstag"
+
+##### 1.2 System schlägt verfügbare Slots vor
+**Purpose**: Automatische Slot-Vorschläge basierend auf Techniker-Verfügbarkeit
+**Method**: `GetAvailableAppointmentSlots(int ticketI3D, DateRange preferredRange)`
+**Calculation**:
+- Suche Techniker mit passenden Qualifikationen
+- Checke deren Kalender auf freie Slots
+- Berücksichtige Fahrtzeit zwischen Terminen
+- Sortiere nach Kundenzonenpräferenz
+
+**Table**: `AppointmentProposals`
+**Returns**: Liste mit vorgeschlagenen Slots (z.B. 4-5 Vorschläge)
+
+**Proposal Example**:
+```
+1. Mittwoch, 10:00-11:30 (Techniker: Hans M., Fahrtzeit: 15 Min)
+2. Mittwoch, 14:00-15:30 (Techniker: Max B., Fahrtzeit: 25 Min)
+3. Donnerstag, 09:00-10:30 (Techniker: Anna K., Fahrtzeit: 10 Min)
+4. Donnerstag, 15:00-16:30 (Techniker: Hans M., Fahrtzeit: 20 Min)
+```
+
+**Use Case**: System findet 4 passende Slots für Montage
+
+##### 1.3 Kunde wählt Termin-Slot
+**Purpose**: Bestätigung eines Slot-Vorschlags
+**Method**: `BookAppointment(int appointmentProposalI3D)`
+**Action**:
+- Speichere in `ToDoListe` als Aufgabe für Techniker
+- Sende Bestätigung an Kunde (Email/SMS)
+- Sende Terminerinnerung an Techniker
+
+**Use Case**: Kunde bestätigt: "Donnerstag 09:00 bei Anna" → Appointment wird gebucht
+
+##### 1.4 Terminbestätigung an Kunde
+**Purpose**: Schriftliche Bestätigung mit allen Details
+**Content**:
+- Termin-Datum und -Uhrzeit
+- Techniker-Name
+- Adresse/Standort
+- Handynummer des Technikers
+- Vorbereitung-Hinweise
+
+**Method**: `SendAppointmentConfirmation(int appointmentI3D, CommunicationChannel channel)`
+**Channels**: Email, SMS, Both
+
+**Use Case**: Kunde erhält Email: "Montag 10:00-11:00 besucht Sie Hans zum Netzwerk-Setup"
+
+##### 1.5 Termine verschieben/absagen
+**Purpose**: Flexibles Handling von Änderungen
+**Scenarios**:
+- Kunde: "Passt nicht mehr, können wir einen anderen Tag machen?"
+- Techniker: "Bin krank, kann Montag-Termin nicht schaffen"
+- System: Automatische Eskalation wenn Termin nicht 24h vorher bestätigt
+
+**Method**: `RescheduleAppointment(int appointmentI3D, int newProposalI3D)` OR `CancelAppointment(int appointmentI3D, string reason)`
+
+**Notifications**: Alle beteiligten werden benachrichtigt
+
+**Use Case**: Techniker wird krank → System schlägt Ersatz-Termin mit anderem Techniker vor
+
+---
+
+#### 2. Techniker-Verfügbarkeit und Kapazität
+
+##### 2.1 Techniker-Arbeitskalender verwalten
+**Purpose**: Verfügbarkeit pro Techniker
+**Table**: `ToDoListe` (oder Kalender-Modul)
+**Properties**:
+- `EmployeeI3D`
+- `WorkingHours` (z.B. Mo-Fr 08:00-17:00)
+- `Vacation` (Urlaubs-Tage)
+- `SickLeave` (Krankheitstage)
+- `SpecialOffDays` (extra freie Tage)
+
+**Method**: `SetEmployeeWorkingHours(int employeeI3D, WorkSchedule schedule)`
+
+**Use Case**: Anna hat Urlaub 15.-21. Juli → wird nicht für Termine vorgeschlagen
+
+##### 2.2 Techniker-Qualifikationen und Spezialisierung
+**Purpose**: Nur qualifizierte Techniker für bestimmte Aufgaben
+**Properties**:
+- `RequiredSkills` (z.B. "Linux", "Netzwerk", "Datenbank")
+- `Techniker.SkillList` (Qualifikationen)
+- Match: Haben alle geforderten Skills?
+
+**Method**: `FilterTechniciansBySkills(List<string> requiredSkills)`
+
+**Use Case**: "Netzwerk-Installation braucht Netzwerk-Experte" → System schlägt nur Network-Techniker vor
+
+##### 2.3 Maximale Tagesauslastung begrenzen
+**Purpose**: Techniker übernehmen nicht zu viele Termine
+**Rule**: Z.B. maximal 4 Termine pro Tag, maximal 8 Std Fahrtzeit
+**Method**: `CheckDailyCapacity(int employeeI3D, DateTime date)` → Returns verfügbare Slots
+
+**Use Case**: Hans hat schon 4 Termine Montag, nächster Slot erst Dienstag frei
+
+##### 2.4 Überstunden-Tracking
+**Purpose**: Vermeidung von Überbelastung
+**Tracking**:
+- Geplante Stunden vs. Tatsächliche Stunden
+- Überstunden-Stunden
+- Flexzeit-Ausgleich
+
+**Method**: `GetEmployeeUtilization(int employeeI3D, DateTime startDate, DateTime endDate)`
+**Report**: "Hans: 40 Std geplant, 45 Std tatsächlich, 5 Std Überstunden"
+
+**Use Case**: Manager sieht dass Anna seit 3 Wochen Überstunden macht → weitere Termine für sie absagen
+
+---
+
+## 17.2 Techniker-Routenoptimierung (Technician Route Optimization)
+
+**Modultyp**: Geografische Optimierung von Techniker-Routen
+**Datenbanktabellen**: `AnfahrtZonen`, `AppointmentProposals`, `ToDoListe`
+**REST API**: `/OptimizeRoute`, `/GetTravelTime`, `/GetZoneAssignment`
+
+### Vollständige Use Cases
+
+#### 1. Zone-basierte Terminvergabe
+
+##### 1.1 Fahrt-Zonen definieren
+**Purpose**: Geografische Einteilung für Effizienz
+**Table**: `AnfahrtZonen`
+**Zones**:
+- Zone "München-Mitte"
+- Zone "München-Nord"
+- Zone "München-Süd"
+- Zone "Umland"
+
+**Properties**: `ZoneName`, `Coordinates` (Grenzen), `PrimaryTechnician`, `BackupTechnician`
+**Method**: `DefineZone(ZoneDetails zone)`
+
+**Use Case**: "Alle Kundenaufträge in PLZ 80-82 → Zone Nord → Hans zuweisen"
+
+##### 1.2 Kunde-Standort zu Zone zuordnen
+**Purpose**: Automatische Zone-Bestimmung basierend auf Adresse
+**Method**: `AssignCustomerToZone(int customerI3D, string address)`
+**Logic**: Postleitzahl/Geocoding → Zone bestimmen
+
+**Use Case**: Neuer Kunde München Schwabing → automatisch Zone Nord
+
+##### 1.3 Route-Vorschlag pro Techniker/Tag
+**Purpose**: Optimierte Reihenfolge der Besuche
+**Calculation**:
+- Alle Termine für Hans am Montag: Kundenort A, B, C, D
+- Route-Engine: Welche Reihenfolge minimiert Fahrtzeit?
+- Optimale Route: Start HQ → A → C → B → D → HQ (Fahrtzeit 3h vs. 4.5h bei anderer Reihenfolge)
+
+**Method**: `OptimizeRoute(int employeeI3D, DateTime date)` → Returns: Optimierte Reihenfolge mit Fahrtzeiten
+
+**Output**:
+```
+Montag für Hans:
+09:00-10:30  Kunde A (München Zentrum)
+10:45-11:30  Kunde C (München Nord, 15 Min Fahrt)
+12:00-13:00  Mittagspause
+13:00-14:15  Kunde B (München Süd, 30 Min Fahrt)
+14:30-15:30  Kunde D (Umland, 15 Min Fahrt)
+```
+
+**Use Case**: Manager optimiert Montag-Route → 45 Min Fahrtzeit gespart, mehr Kunden pro Tag möglich
+
+##### 1.4 Fahrtzeit-Berechnung zwischen Punkten
+**Purpose**: Realistische Reisezeit zwischen Kundenorten
+**Method**: `CalculateTravelTime(string addressA, string addressB)`
+**Data Source**: Google Maps API Integration
+**Returns**: Fahrtzeit (normale Verkehrslage), Fahrtzeit (Spitzenlast), Entfernung
+
+**Use Case**: "Von Kunde A zu Kunde B: 25 Min normal, 45 Min in Stoßzeit"
+
+##### 1.5 Puffer und Flexibilität einplanen
+**Purpose**: Nicht alle Zeiten fest planen, Puffer für Überläufer
+**Buffer**:
+- 15 Min Puffer pro Besuch (Parken, Warten auf Kunde)
+- 30 Min Emergency-Slot für dringende Reparaturen
+- Mittagspause
+
+**Method**: `AddScheduleBuffer(int employeeI3D, DateTime date, int bufferMinutes)`
+
+**Use Case**: Hans hat nach jedem Termin 15 Min Puffer → kann schnelle Wartung oder Dokumentation machen
+
+---
+
+#### 2. Tourenmanagement und Deklaration
+
+##### 2.1 Tages-Tournee zusammenstellen
+**Purpose**: Gruppierung von Terminen zu einer Tour
+**Properties**:
+- `ToursI3D`, `EmployeeI3D`, `TourDate`
+- `StartTime`, `EndTime`
+- `EstimatedMileage`, `ActualMileage`
+- `Stops` (Liste der Kundenbesuche)
+
+**Method**: `CreateTour(int employeeI3D, DateTime tourDate, List<int> appointmentI3Ds)`
+
+**Use Case**: "Erstelle Montag-Tour für Hans mit 5 Kundenbesuchen"
+
+##### 2.2 Fahrt-Kosten berechnen
+**Purpose**: Kilometerabrechnung und Fahrtkosten
+**Calculation**:
+- Geplante Kilometer: 120 km
+- Sätze: €0.30/km (Benzin) + €0.20/km (Verschleiß) = €0.50/km
+- Kosten: 120 km × €0.50 = €60
+
+**Method**: `CalculateTravelCosts(int tourI3D, decimal ratePerKm)`
+
+**Use Case**: Abrechnung der Fahrt-Kosten für Lohn/Auslagen
+
+##### 2.3 Tages-Zusammenfassung für Techniker
+**Purpose**: Übersicht was Techniker heute machen soll
+**Output**: Bedruckter Zettel oder Mobile-App
+```
+Montag 10. Juli - Tour für Hans M.
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+09:00-10:30  Müller GmbH, Seestr. 15, Tel. 089-123456
+             Task: Netzwerk-Installation, Material: Switch x2
+
+10:45-11:30  Schmidt KG, Hauptstr. 42
+             Task: Drucker-Setup
+
+13:00-14:15  Reisebüro am Markt, Marienplatz 5
+             Task: Backup-Test
+
+14:30-15:30  Bauunternehmen XY, Gewerbepark Nord 10
+             Task: Firewall-Update
+
+Geschätzte Fahrtzeit: 2h 30 Min, 85 km
+```
+
+**Use Case**: Techniker hat klare Übersicht für seinen Tag
+
+---
+
+## 17.3 Ressourcen-Kapazitätsplanung (Resource Capacity Planning)
+
+**Modultyp**: Mittelfristige Planung von Personaleinsatz
+**Datenbanktabellen**: `AppointmentProposals`, `ToDoListe`, `Personal`
+**REST API**: `/GetCapacityForecast`, `/PredictResourceNeeds`
+
+### Vollständige Use Cases
+
+#### 1. Kapazitäts-Prognose und Planung
+
+##### 1.1 Nachfrage-Prognose erstellen
+**Purpose**: Vorhersage künftiger Termine
+**Calculation**:
+- Durchschnittliche Anfragen pro Woche: 50
+- Durchschnittliche Dauer pro Termin: 3 Stunden
+- Total benötigte Stunden: 150 Std/Woche
+- Verfügbar (5 Techniker × 40 Std): 200 Std
+- Kapazitätsauslastung: 75%
+
+**Method**: `ForecastDemand(DateRange forecastPeriod)` → Returns: Prognostizierte Termine
+
+**Use Case**: Manager plant für August: "Erwartet 20% mehr Anfragen wegen Umzugsperiode"
+
+##### 1.2 Personalbedarfs-Analyse
+**Purpose**: Wieviele Techniker werden benötigt?
+**Scenario**:
+- Nachfrage: 200 Anfragen/Monat (50h)
+- Pro Techniker: 160 Stunden/Monat möglich (40h × 4 Wochen)
+- Benötigte Vollzeitäquivalente: 312/160 = 2 FTE nötig
+- Aktuell vorhanden: 1.8 FTE
+- Defizit: 0.2 FTE = 1 Tag/Woche externe Unterstützung nötig
+
+**Method**: `AnalyzeResourceNeeds(DateRange period)` → Returns: FTE-Bedarf und Defizite
+
+**Use Case**: "Wir brauchen 1 zusätzliche Teilzeitkraft für August-September"
+
+##### 1.3 Verfügbarkeits-Analyse
+**Purpose**: Wann sind Engpässe?
+**Analysis**:
+- Woche 1: 70% Auslastung (OK)
+- Woche 2: 105% Auslastung (PROBLEM - keine Kapazität!)
+- Woche 3: 80% Auslastung (OK)
+- Woche 4: 90% Auslastung (gut)
+
+**Method**: `AnalyzeCapacityBottlenecks(DateRange period)` → Returns: Engpass-Wochen mit Empfehlungen
+
+**Recommendations**:
+- Freie Termine bündeln auf Woche 1 & 3
+- Woche 2 externe Ressourcen anfordern
+- Oder Wartungs-Termine auf ruhigere Wochen verschieben
+
+**Use Case**: Manager plant Urlaub-Rotation um Engpässe zu vermeiden
+
+---
+
+## 17.4 Service Level Agreements (SLA Management)
+
+**Modultyp**: SLA-Definition, -Tracking und -Reporting
+**Datenbanktabellen**: `AppointmentProposals`, `hlpdsk_requests`, `CacheTicketStatistic`
+**REST API**: `/GetSLAStatus`, `/BreachAlert`, `/SLAReport`
+
+### Vollständige Use Cases
+
+#### 1. SLA-Definition und -Durchsetzung
+
+##### 1.1 SLA-Stufen definieren nach Priorität
+**Purpose**: Unterschiedliche Response-Zeiten je nach Kritikalität
+**Definition**:
+```
+Priority 1 (Kritisch):
+  - Response: 1 Stunde
+  - Lösung: 4 Stunden
+  - Beispiel: Mail-Server ausfallen, 500 Benutzer betroffen
+
+Priority 2 (Hoch):
+  - Response: 4 Stunden
+  - Lösung: 24 Stunden
+  - Beispiel: 50 Benutzer können nicht arbeiten
+
+Priority 3 (Mittel):
+  - Response: 8 Stunden
+  - Lösung: 5 Tage
+  - Beispiel: Drucker funktioniert nicht
+
+Priority 4 (Niedrig):
+  - Response: 24 Stunden
+  - Lösung: 10 Tage
+  - Beispiel: Benutzer möchte neues Feature
+```
+
+**Table**: SLA-Konfiguration
+**Method**: `DefineSLA(PriorityLevel priority, TimeSpan responseTime, TimeSpan resolutionTime)`
+
+**Use Case**: Support-Manager definiert SLAs für Kundenvertrag
+
+##### 1.2 SLA-Status real-time überwachen
+**Purpose**: Live-Übersicht welche Tickets im Plan sind
+**Dashboard**:
+```
+🟢 OK (28 Tickets):  Im Plan, genug Zeit
+🟡 WARNING (5 Tickets): <50% der SLA-Zeit verbraucht
+🔴 BREACH (2 Tickets): SLA überschritten!
+```
+
+**Method**: `GetSLAStatus()` → Returns: Pro Ticket, ob OK/Warning/Breach
+**Calculation**: Vergleiche Elapsed Time vs. SLA Time
+
+**Use Case**: Manager sieht auf Dashboard dass 2 Tickets SLA überschritten haben
+
+##### 1.3 Automatische Eskalation bei SLA-Verletzung
+**Purpose**: Automatische Benachrichtigung und Maßnahmen
+**Trigger**: 80% SLA-Zeit verbraucht, kein Fortschritt
+**Actions**:
+- Email an Team-Lead: "Ticket #12345 droht SLA-Verfehlung"
+- Email an Manager: "2 Tickets haben SLA überschritten"
+- SMS an On-Call-Manager: "KRITISCH: Mail-Server noch nicht repariert!"
+
+**Method**: `MonitorSLABreaches()`
+
+**Escalation Path**:
+```
+Ticket erstellt → 25% SLA → Email Team Lead
+               → 50% SLA → keine Aktion
+               → 75% SLA → Email Manager + SMS
+               → 100% SLA → BREACH! SMS + Phone Call
+```
+
+**Use Case**: Ticket-Zeit läuft ab → automatische Eskalation zu Manager
+
+##### 1.4 SLA-Compliance-Report
+**Purpose**: Monatliche Reporting über SLA-Einhaltung
+**Metrics**:
+- SLA-Erfüllungsrate: 95% (von 100 Tickets, 95 eingehalten, 5 verletzt)
+- Average Response Time: 2.5h (gegen SLA 4h)
+- Average Resolution Time: 18h (gegen SLA 24h)
+- Durchschnittliche Kundenzufriedenheit: 4.2/5
+
+**Table**: `CacheTicketStatistic`
+**Method**: `GenerateSLAReport(DateTime startDate, DateTime endDate)` → Returns: PDF Report
+
+**Report Output**:
+```
+═══════════════════════════════════════════════
+SLA-COMPLIANCE REPORT - OKTOBER 2025
+═══════════════════════════════════════════════
+
+Gesamt Tickets: 247
+SLA Erfüllt: 235 (95.1%)
+SLA Verletzt: 12 (4.9%)
+
+Nach Priorität:
+P1: 50 Tickets, 48 erfüllt (96%)
+P2: 100 Tickets, 98 erfüllt (98%)
+P3: 80 Tickets, 78 erfüllt (97.5%)
+P4: 17 Tickets, 11 erfüllt (65%) ← PROBLEM!
+
+Häufigste Gründe für Verletzung:
+1. Warten auf Kunden-Info (5 Tickets)
+2. Techniker-Kapazität erreicht (4 Tickets)
+3. Material nicht lieferbar (3 Tickets)
+
+Empfehlungen:
+- P4-SLA prüfen (zu aggressiv?)
+- Techniker-Kapazität erhöhen für P1/P2
+- Lagerverwaltung optimieren
+```
+
+**Use Case**: SLA-Report wird dem Kunden monatlich übermittelt
+
+##### 1.5 SLA-basierte Eskalation bei häufigen Verletzungen
+**Purpose**: Handeln wenn SLA regelmäßig verletzt wird
+**Trigger**: >10% Verletzungen über 3 Monate
+**Actions**:
+- Team retraining
+- Kapazitätserhöhung
+- Kundenbenachrichtigung mit Verbesserungsplan
+
+**Method**: `AnalyzeSLAtrends(int monthsToAnalyze)` → Trending Analysis
+
+**Use Case**: Manager sieht dass P4-SLA seit 3 Monaten >15% verletzt ist → beschließt auf 15 Tage zu erhöhen
+
+---
+
+### Ende Asset Management & Scheduling Documentation
+
+---
+
+## Zusammenfassung neue Module
+
+| Modul | Tabellen | Use Cases | REST APIs | Status |
+|-------|----------|-----------|-----------|--------|
+| **Asset Management** | 35+ | 50+ | 6 | Neu |
+| **Scheduling** | 8+ | 20+ | 5 | Neu |
+| **TOTAL** | 43+ | 70+ | 11 | Dokumentiert |
+
+---
+
+## Integration in USE_CASES.md
+
+Diese neuen Module können wie folgt in die Hauptdokumentation integriert werden:
+
+**Option 1**: Als Kapitel 16 & 17 anhängen (nach Kapitel 15 "Verträge")
+**Option 2**: In bestehende Module integrieren (Asset → Hilfe, Scheduling → Helpdesk)
+**Option 3**: Separate Module-Guides als Links
+
+Empfohlen: **Option 1** - Neue eigenständige Kapitel für bessere Organisierung.
+
+---
+
+**Status**: ✅ Dokumentation abgeschlossen | 70+ Use Cases | Deutsche Sprache | USE_CASES.md-Format