📝 "Erweiterte Dokumentation für Druckerkonflikt-Management und Steckdosenschaltzeiten hinzugefügt, einschließlich API-Endpunkte, Konfliktbehandlungsszenarien und Systemarchitektur." 📚
This commit is contained in:
@@ -1 +1,331 @@
|
||||
|
||||
# Druckerkonflikt-Management System - MYP Platform
|
||||
|
||||
## 📋 Übersicht
|
||||
|
||||
Das MYP-System verfügt über ein mehrstufiges Druckerkonflikt-Management-System, das proaktiv Konflikte verhindert, automatisch Lösungen findet und Benutzern transparente Handlungsoptionen bietet.
|
||||
|
||||
## 🏗️ Systemarchitektur
|
||||
|
||||
### Komponenten
|
||||
- **Intelligent Assignment Engine** - Automatische Druckerzuweisung
|
||||
- **Conflict Detection System** - Echtzeit-Konflikterkennung
|
||||
- **User Guidance Interface** - Benutzerführung bei Konflikten
|
||||
- **Analytics & Optimization** - Datenbasierte Optimierung
|
||||
|
||||
## 🎯 Konfliktarten und Behandlung
|
||||
|
||||
### 1. Zeitüberschneidungen (Primärkonflikte)
|
||||
|
||||
**Problem:** Benutzer wählt Drucker zu einem Zeitpunkt, zu dem bereits ein Job läuft.
|
||||
|
||||
**Erkennung:**
|
||||
```sql
|
||||
SELECT COUNT(*) FROM jobs
|
||||
WHERE printer_id = ?
|
||||
AND status IN ('scheduled', 'running')
|
||||
AND (
|
||||
(start_at >= ? AND start_at < ?) OR
|
||||
(end_at > ? AND end_at <= ?) OR
|
||||
(start_at <= ? AND end_at >= ?)
|
||||
)
|
||||
```
|
||||
|
||||
**Behandlungsstrategien:**
|
||||
1. **Automatische Umzuweisung** - System findet alternativen Drucker
|
||||
2. **Zeitverschiebung** - Vorschlag alternativer Zeitfenster
|
||||
3. **Prioritätsbasierte Verdrängung** - Bei Urgent-Jobs Umplanung bestehender Jobs
|
||||
|
||||
### 2. Druckerausfälle (Sekundärkonflikte)
|
||||
|
||||
**Problem:** Zugewiesener Drucker wird offline oder defekt.
|
||||
|
||||
**Behandlung:**
|
||||
1. Automatische Neuzuweisung an verfügbaren Drucker
|
||||
2. Benachrichtigung des Benutzers
|
||||
3. Status-Update auf "waiting_for_printer"
|
||||
|
||||
### 3. Ressourcenkonflikte (Tertiärkonflikte)
|
||||
|
||||
**Problem:** Material, Wartung oder andere Ressourcen nicht verfügbar.
|
||||
|
||||
**Behandlung:**
|
||||
1. Warteschlange mit automatischer Reaktivierung
|
||||
2. Benachrichtigung bei Ressourcenverfügbarkeit
|
||||
3. Alternative Materialvorschläge
|
||||
|
||||
## 🧠 Intelligente Druckerzuweisung
|
||||
|
||||
### Scoring-Algorithmus
|
||||
|
||||
Das System bewertet jeden Drucker anhand folgender Kriterien:
|
||||
|
||||
#### Verfügbarkeit (Gewichtung: 100 Punkte)
|
||||
- **Verfügbar:** +100 Punkte
|
||||
- **Belegt:** Ausschluss aus Bewertung
|
||||
|
||||
#### Auslastung (Gewichtung: 50 Punkte)
|
||||
- **Niedrige Auslastung (0-2 Jobs/24h):** +50 Punkte
|
||||
- **Mittlere Auslastung (3-5 Jobs/24h):** +30 Punkte
|
||||
- **Hohe Auslastung (6+ Jobs/24h):** +10 Punkte
|
||||
|
||||
#### Prioritätsoptimierung (Gewichtung: 30 Punkte)
|
||||
- **Urgent + Express-Drucker:** +30 Punkte
|
||||
- **High + Niedrige Auslastung:** +20 Punkte
|
||||
- **Normal:** +10 Punkte
|
||||
|
||||
#### Zeitfenster-Eignung (Gewichtung: 25 Punkte)
|
||||
- **Nachtschicht (18-06 Uhr) + Nacht-Drucker:** +25 Punkte
|
||||
- **Tagschicht (08-17 Uhr) + Tag-Drucker:** +15 Punkte
|
||||
|
||||
#### Job-Dauer-Eignung (Gewichtung: 20 Punkte)
|
||||
- **Lange Jobs (>8h) + Langzeit-Drucker:** +20 Punkte
|
||||
- **Kurze Jobs (≤2h) + Express-Drucker:** +15 Punkte
|
||||
|
||||
### Beispiel-Bewertung
|
||||
|
||||
```python
|
||||
Drucker A: Express-Drucker, 1 Job heute, verfügbar
|
||||
- Verfügbarkeit: +100
|
||||
- Auslastung: +50 (niedrig)
|
||||
- Priorität: +30 (urgent job)
|
||||
- Zeitfenster: +15 (tag)
|
||||
- Job-Dauer: +15 (kurz)
|
||||
GESAMT: 210 Punkte
|
||||
|
||||
Drucker B: Standard-Drucker, 3 Jobs heute, verfügbar
|
||||
- Verfügbarkeit: +100
|
||||
- Auslastung: +30 (mittel)
|
||||
- Priorität: +10 (normal)
|
||||
- Zeitfenster: +15 (tag)
|
||||
- Job-Dauer: +10 (standard)
|
||||
GESAMT: 165 Punkte
|
||||
|
||||
→ Drucker A wird gewählt
|
||||
```
|
||||
|
||||
## 🚨 Konfliktbehandlungsszenarien
|
||||
|
||||
### Szenario 1: Zeitüberschneidung bei manueller Druckerauswahl
|
||||
|
||||
**Ablauf:**
|
||||
1. Benutzer wählt Drucker X für 14:00-16:00
|
||||
2. System erkennt: Drucker X bereits belegt 13:30-15:30
|
||||
3. **Mögliche Reaktionen:**
|
||||
- Fehlermeldung mit Alternativvorschlägen
|
||||
- Automatische Umzuweisung mit Bestätigung
|
||||
- Zeitverschiebung vorschlagen (16:00-18:00)
|
||||
|
||||
### Szenario 2: Automatische Zuweisung ohne Verfügbarkeit
|
||||
|
||||
**Ablauf:**
|
||||
1. Benutzer gibt nur Zeitraum an (ohne Drucker)
|
||||
2. System sucht verfügbare Drucker
|
||||
3. **Bei Erfolg:** Automatische Zuweisung mit Begründung
|
||||
4. **Bei Fehlschlag:** Alternativen vorschlagen oder Warteschlange
|
||||
|
||||
### Szenario 3: Prioritätskonflikt
|
||||
|
||||
**Ablauf:**
|
||||
1. Urgent-Job benötigt Drucker X
|
||||
2. Drucker X hat Normal-Job geplant
|
||||
3. **System-Reaktion:**
|
||||
- Normal-Job auf anderen Drucker umplanen
|
||||
- Benutzer beider Jobs benachrichtigen
|
||||
- Begründung der Umplanung
|
||||
|
||||
## 📊 Benutzeroberfläche und Feedback
|
||||
|
||||
### Visueller Status der Drucker
|
||||
|
||||
```html
|
||||
🟢 Verfügbar (0-1 Jobs heute)
|
||||
🟡 Mäßig belegt (2-4 Jobs heute)
|
||||
🟠 Stark belegt (5-7 Jobs heute)
|
||||
🔴 Vollbelegt (8+ Jobs heute)
|
||||
⚫ Offline/Wartung
|
||||
```
|
||||
|
||||
### Konfliktmeldungen
|
||||
|
||||
#### Typ 1: Informativ
|
||||
```
|
||||
ℹ️ Der gewählte Drucker ist zu diesem Zeitpunkt belegt.
|
||||
Alternative: Drucker Y ist verfügbar und optimal geeignet.
|
||||
[Drucker Y wählen] [Anderen Zeitpunkt wählen]
|
||||
```
|
||||
|
||||
#### Typ 2: Warnung
|
||||
```
|
||||
⚠️ Hohe Auslastung in diesem Zeitraum.
|
||||
Empfehlung: Verschiebung um 2 Stunden für bessere Performance.
|
||||
[Trotzdem buchen] [Empfehlung annehmen]
|
||||
```
|
||||
|
||||
#### Typ 3: Fehler
|
||||
```
|
||||
❌ Keine Drucker verfügbar im gewählten Zeitraum.
|
||||
Nächste Verfügbarkeit: Morgen 08:00 Uhr
|
||||
[Warteschlange beitreten] [Anderen Zeitraum wählen]
|
||||
```
|
||||
|
||||
### Smart Recommendations
|
||||
|
||||
Das System zeigt proaktiv Empfehlungen:
|
||||
|
||||
```
|
||||
🎯 SMART-EMPFEHLUNG
|
||||
Drucker: Mercedes Express-01
|
||||
Verfügbarkeit: 95%
|
||||
Auslastung: Niedrig (18%)
|
||||
Begründung: Optimal für Express-Jobs, keine Warteschlange
|
||||
Geschätzte Startzeit: Sofort
|
||||
[Empfehlung annehmen] [Mehr Details]
|
||||
```
|
||||
|
||||
## 🔄 Automatische Optimierung
|
||||
|
||||
### Load Balancing
|
||||
- Gleichmäßige Verteilung auf verfügbare Drucker
|
||||
- Berücksichtigung historischer Auslastungsmuster
|
||||
- Dynamische Anpassung bei Druckerausfällen
|
||||
|
||||
### Predictive Scheduling
|
||||
- Analyse vergangener Buchungsmuster
|
||||
- Vorhersage von Spitzenzeiten
|
||||
- Proaktive Ressourcenzuteilung
|
||||
|
||||
### Queue Management
|
||||
- Intelligente Warteschlangen mit Prioritätssystem
|
||||
- Automatische Nachrückung bei Stornierungen
|
||||
- Benachrichtigungen bei verfügbar werdenden Plätzen
|
||||
|
||||
## 🛠️ Konfiguration
|
||||
|
||||
### Prioritätsstufen
|
||||
```python
|
||||
PRIORITY_LEVELS = {
|
||||
'urgent': {'weight': 4, 'preemption': True},
|
||||
'high': {'weight': 3, 'preemption': False},
|
||||
'normal': {'weight': 2, 'preemption': False},
|
||||
'low': {'weight': 1, 'preemption': False}
|
||||
}
|
||||
```
|
||||
|
||||
### Zeitfenster-Kategorien
|
||||
```python
|
||||
TIME_CATEGORIES = {
|
||||
'night_shift': {'start': 18, 'end': 6, 'bonus': 25},
|
||||
'day_shift': {'start': 8, 'end': 17, 'bonus': 15},
|
||||
'transition': {'start': 6, 'end': 8, 'bonus': 5}
|
||||
}
|
||||
```
|
||||
|
||||
### Drucker-Kategorien
|
||||
```python
|
||||
PRINTER_CATEGORIES = {
|
||||
'express': {'short_job_bonus': 15, 'urgent_bonus': 30},
|
||||
'longterm': {'long_job_bonus': 20, 'reliability_bonus': 10},
|
||||
'standard': {'balanced_bonus': 10}
|
||||
}
|
||||
```
|
||||
|
||||
## 📈 Monitoring und Analytics
|
||||
|
||||
### Wichtige Metriken
|
||||
- **Konfliktrate:** Anzahl Konflikte / Gesamtbuchungen
|
||||
- **Lösungsrate:** Automatisch gelöste / Gesamtkonflikte
|
||||
- **Benutzerzufriedenheit:** Akzeptierte Empfehlungen / Gesamtempfehlungen
|
||||
- **Systemeffizienz:** Durchschnittliche Druckerauslastung
|
||||
|
||||
### Dashboard-Elemente
|
||||
- Echtzeit-Druckerstatus
|
||||
- Konflikthistorie
|
||||
- Optimierungsvorschläge
|
||||
- Auslastungsprognosen
|
||||
|
||||
## 🔧 Wartung und Fehlerbehebung
|
||||
|
||||
### Häufige Probleme
|
||||
|
||||
#### Problem: Falsche Druckerzuweisung
|
||||
**Lösung:** Scoring-Algorithmus-Parameter anpassen
|
||||
|
||||
#### Problem: Zu viele Konflikte
|
||||
**Lösung:** Mehr Drucker aktivieren oder Zeitfenster erweitern
|
||||
|
||||
#### Problem: Benutzer umgehen Empfehlungen
|
||||
**Lösung:** Incentive-System oder bessere Begründungen
|
||||
|
||||
### Log-Analyse
|
||||
```bash
|
||||
grep "CONFLICT" logs/calendar/*.log | tail -50
|
||||
grep "RECOMMENDATION" logs/calendar/*.log | grep "accepted"
|
||||
```
|
||||
|
||||
## 📚 API-Dokumentation
|
||||
|
||||
### Konfliktprüfung
|
||||
```http
|
||||
POST /api/calendar/check-conflicts
|
||||
{
|
||||
"printer_id": 1,
|
||||
"start_time": "2025-01-10T14:00:00",
|
||||
"end_time": "2025-01-10T16:00:00"
|
||||
}
|
||||
|
||||
Response:
|
||||
{
|
||||
"conflicts": true,
|
||||
"conflicting_jobs": [{"id": 123, "name": "Prototyp A"}],
|
||||
"alternatives": [{"printer_id": 2, "name": "Mercedes-02"}]
|
||||
}
|
||||
```
|
||||
|
||||
### Smart Recommendation
|
||||
```http
|
||||
POST /api/calendar/smart-recommendation
|
||||
{
|
||||
"start_time": "2025-01-10T14:00:00",
|
||||
"duration_minutes": 120,
|
||||
"priority": "high"
|
||||
}
|
||||
|
||||
Response:
|
||||
{
|
||||
"recommended_printer": {
|
||||
"id": 3,
|
||||
"name": "Mercedes Express-01",
|
||||
"score": 195,
|
||||
"availability": "96%",
|
||||
"reason": "Optimal für Express-Jobs"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 🚀 Zukünftige Erweiterungen
|
||||
|
||||
### Geplante Features
|
||||
- **KI-basierte Optimierung** - Machine Learning für bessere Vorhersagen
|
||||
- **Multi-Standort-Management** - Konfliktbehandlung über mehrere Standorte
|
||||
- **Ressourcenoptimierung** - Integration von Material- und Personalplanung
|
||||
- **Mobile Benachrichtigungen** - Push-Notifications bei Konflikten
|
||||
- **Automatische Umplanung** - Vollautomatische Konfliktlösung
|
||||
|
||||
### Integration mit externen Systemen
|
||||
- **ERP-System** - Materialverfügbarkeit berücksichtigen
|
||||
- **Wartungskalender** - Planned Maintenance integrieren
|
||||
- **Benutzerkalender** - Outlook/Teams-Integration für bessere Planung
|
||||
|
||||
---
|
||||
|
||||
## 📞 Support und Dokumentation
|
||||
|
||||
**Bei Fragen zur Konfliktbehandlung:**
|
||||
- Dokumentation: `docs/DRUCKERKONFLIKT_MANAGEMENT.md`
|
||||
- Log-Dateien: `logs/calendar/conflict_*.log`
|
||||
- Admin-Interface: `/admin/conflicts`
|
||||
- Support-Ticket: Internes Ticketsystem
|
||||
|
||||
**Letzte Aktualisierung:** 06.01.2025
|
||||
**Version:** 2.1.0
|
||||
**Autor:** MYP Development Team
|
||||
Reference in New Issue
Block a user