feat: initialize HostBooking and ConveyorDispo code structure and document project processes and database schema

04_Dokumentation/DOKUMENTATIONS GERUEST.md

@@ -0,0 +1,86 @@
+# Projektdokumentation: Optimierung der Auftragsverarbeitung eines WCS
+
+**Prüfling:** Kai Kröger  
+**Beruf:** Fachinformatiker für Anwendungsentwicklung  
+**Betrieb:** Gebhardt Fördertechnik GmbH  
+**Zeitraum:** 04.05.2026 - 25.05.2026 (80 Stunden)
+
+---
+
+## 1. Einleitung
+### 1.1 Das Unternehmen
+Die Gebhardt Fördertechnik GmbH ist ein international agierendes Familienunternehmen mit Sitz in Sinsheim, das sich auf die Entwicklung und Herstellung modularer Intralogistiksysteme spezialisiert hat. Mit über 70 Jahren Erfahrung bietet Gebhardt ein breites Spektrum an Lösungen – von der Förder- und Lagertechnik bis hin zu komplexen Warehouse Control Systemen (WCS). Ein zentraler Baustein des Portfolios ist die Softwareplattform GEBHARDT StoreWare, die Materialfluss- (MFS), Lagerverwaltungs- (LVS) und Visualisierungssysteme integriert, um eine effiziente Steuerung und Kontrolle der Warenströme in automatisierten Lagern zu ermöglichen.
+
+### 1.2 Projektziel
+Das Ziel des Projekts ist die Optimierung und Stabilisierung der Auftragsverarbeitung innerhalb des WCS. Aktuell führt die dezentrale Logik beim Starten von Transportaufträgen (OrdersHost) zu Race Conditions, da mehrere parallel laufende Prozesse simultan versuchen, denselben Auftrag zu initiieren. Dies resultiert in inkonsistenten Datenbeständen und nicht abschließbaren Auftragsleichen. Im Rahmen dieser Arbeit wird die Start-Logik im Prozess ConveyorDispo zentralisiert. Durch gezieltes Refactoring und die Implementierung thread-sicherer Mechanismen wird sichergestellt, dass Aufträge exklusiv und prozesssicher verarbeitet werden, was die Fehleranfälligkeit der Anlage signifikant reduziert.
+
+### 1.3 Projektumfeld & Schnittstellen
+*Einordnung des WCS in die Systemlandschaft (SAP, Host-Systeme). Spezifikation der Schnittstellen (TCP/IP, IDocs).*
+
+---
+
+## 2. Projektplanung (Bewertung: Ressourcen & Ablauf)
+### 2.1 Projektphasen & Zeitplanung
+*Vergleich von Soll-Planung (Antrag) und grober Zeitübersicht.*
+
+### 2.2 Ressourcenplanung
+*Hardware, Software-Stack (C# .NET), Personal.*
+
+### 2.3 Kostenplanung
+*Kalkulation der Personalkosten für 80 Stunden und potenzielle Sachkosten.*
+
+---
+
+## 3. Analyse & Konzept (Bewertung: Ausgangssituation)
+### 3.1 Ist-Analyse
+*Detaillierte technische Beschreibung des aktuellen Problems (Race Condition zwischen OrdersHost und ConveyorDispo).*
+
+### 3.2 Soll-Konzept
+*Definition der funktionalen und nicht-funktionalen Anforderungen.*
+
+### 3.3 Wirtschaftlichkeitsbetrachtung
+*ROI-Analyse: Wie viel kostet der Fehler aktuell? Wie schnell amortisiert sich die Entwicklung?*
+
+---
+
+## 4. Design & Architektur (Bewertung: Durchführung/Entscheidungen)
+### 4.1 Technische Entscheidungen
+*Begründung der Wahl von C# und spezifischen Entwurfsmustern (z.B. Singleton, Lock-Mechanismen).*
+
+### 4.2 Systemarchitektur
+*Darstellung der neuen Prozesssteuerung. Wie wird die Zentralisierung technisch umgesetzt?*
+
+### 4.3 Schnittstellen-Design
+*Detaillierte Beschreibung der Kommunikationsprotokolle (Auflagen-Erfüllung).*
+
+---
+
+## 5. Realisierung (Bewertung: Durchführung/Auftragsbearbeitung)
+### 5.1 Implementierung
+*Wichtige Code-Ausschnitte (Fokus auf Thread-Safety und Logik-Zentralisierung).*
+
+### 5.2 Qualitätssicherung & Testen
+*Testplan, Unit-Tests, Integrationstests im WCS-Emulator.*
+
+### 5.3 Abweichungen vom Projektplan
+*Dokumentation und Begründung von Änderungen während der Durchführung.*
+
+---
+
+## 6. Projektabschluss (Bewertung: Auftragsergebnisse)
+### 6.1 Soll-Ist-Vergleich
+*Überprüfung, ob alle Ziele des Soll-Konzepts erreicht wurden.*
+
+### 6.2 Abnahme & Übergabe
+*Protokoll der Übergabe an die Fachabteilung/QS.*
+
+### 6.3 Fazit & Ausblick
+*Persönliches Resümee und mögliche Erweiterungen.*
+
+---
+
+## Anhang (Zählt nicht zu den 15 Seiten)
+- Kundendokumentation (Bedienungsanleitung/API-Doku)
+- Quellcode (Relevante Ausschnitte)
+- Abnahmeprotokoll
+- Glossar & Quellenverzeichnis