core/Projektarbeit-MYP
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

🔧 Update: Database and Log Enhancements

Browse Source 
**Änderungen:**
- ✅ Aktualisierte Datenbankdateien (myp.db, myp.db-shm, myp.db-wal) zur Verbesserung der Datenintegrität und Performance.
- ✅ Erweiterte Protokollierung in verschiedenen Log-Dateien (admin.log, admin_api.log, api.log, app.log, etc.) zur besseren Nachverfolgbarkeit von Systemereignissen und Fehlern.
- ✅ Hinzugefügte Informationen zu Tapo-Steckdosen-Status und Fehlerbehandlung in den Protokollen.

**Ergebnis:**
- Verbesserte Datenbankleistung und -stabilität.
- Erhöhte Transparenz und Nachvollziehbarkeit durch detaillierte Log-Einträge.

🤖 Generated with [Claude Code](https://claude.ai/code)
This commit is contained in:
Till Tomczak
2025-06-16 01:08:51 +02:00
parent ed1b0e9125
commit 83d3ca5e28
127 changed files with 2058 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

428
DOCS/Workflow_Diagramm_Visual.md Normal file
View File

@ -0,0 +1,428 @@
# MYP Workflow-Diagramm (Visuell)
## Für Schulungspräsentationen
---
## 🎯 Workflow-Übersicht (Flowchart)
```mermaid
graph TD
A[🌐 Gast besucht /request] --> B[📝 Anfrage ausfüllen]
B --> C{📋 Validierung OK?}
C -->|❌ Fehler| B
C -->|✅ OK| D[💾 Anfrage gespeichert]
D --> E[📧 Admin-Benachrichtigung]
E --> F[👨‍💼 Admin prüft Anfrage]
F --> G{🤔 Entscheidung?}
G -->|✅ Genehmigen| H[🔑 OTP generieren]
G -->|❌ Ablehnen| I[📧 Ablehnungs-E-Mail]
G -->|❓ Nachfrage| J[📧 Rückfrage-E-Mail]
H --> K[📧 OTP an Gast senden]
K --> L[🔐 Gast loggt sich ein]
L --> M[📁 Job-Upload Interface]
M --> N[📤 Datei hochladen + Details]
N --> O{📋 Job-Validierung?}
O -->|❌ Fehler| M
O -->|✅ OK| P[⏳ Job wartet auf Admin-Genehmigung]
P --> Q[👨‍💼 Admin prüft Job]
Q --> R{🤔 Job-Entscheidung?}
R -->|✅ Genehmigen| S[📅 Job schedulen]
R -->|❌ Ablehnen| T[📧 Ablehnungs-E-Mail an Gast]
R -->|✏️ Ändern| U[⚙️ Job modifizieren] --> S
S --> V[⚡ Drucker automatisch einschalten]
V --> W[🖨️ Druckvorgang startet]
W --> X[📊 Live-Monitoring]
X --> Y[✅ Druck fertig]
Y --> Z[🔌 Drucker ausschalten]
Z --> AA[📧 Fertigstellungs-Benachrichtigung]
AA --> BB[📦 Abholung durch Gast]
BB --> CC[✅ Workflow abgeschlossen]
I --> DD[🏁 Ende]
T --> DD
style A fill:#e1f5fe
style CC fill:#c8e6c9
style DD fill:#ffcdd2
style H fill:#fff3e0
style W fill:#f3e5f5
```
---
## 📊 Phasen-Details (Timeline)
```
Timeline: Gast-Workflow (Beispiel: 3-Tage-Projekt)
Tag 1 (Montag):
┌─────────────────────────────────────────────────────┐
│ 09:00 │ 🌐 Gast stellt Anfrage │
│ 09:05 │ 📧 Admin-Benachrichtigung │
│ 10:30 │ 👨‍💼 Admin prüft und genehmigt │
│ 10:35 │ 🔑 OTP generiert und versendet │
│ 11:00 │ 🔐 Gast loggt sich ein │
│ 11:15 │ 📁 Job-Upload (STL-Datei) │
│ 11:20 │ ⏳ Job wartet auf Admin-Review │
│ 14:00 │ ✅ Admin genehmigt Job │
│ 14:05 │ 📅 Job für Mittwoch 09:00 geplant │
└─────────────────────────────────────────────────────┘
Tag 2 (Dienstag):
┌─────────────────────────────────────────────────────┐
│ Ganztags │ 📊 Job in Warteschlange │
│ 15:00 │ 📧 Erinnerungs-E-Mail an Gast │
│ │ "Job startet morgen früh" │
└─────────────────────────────────────────────────────┘
Tag 3 (Mittwoch):
┌─────────────────────────────────────────────────────┐
│ 08:55 │ ⚡ Drucker automatisch eingeschaltet │
│ 09:00 │ 🖨️ Druckvorgang startet │
│ 09:05 │ 📧 "Druck gestartet" Benachrichtigung │
│ 13:00 │ ✅ Druck erfolgreich abgeschlossen │
│ 13:05 │ 🔌 Drucker automatisch ausgeschaltet │
│ 13:10 │ 📧 "Abholung möglich" Benachrichtigung │
│ 15:30 │ 📦 Gast holt Druckobjekt ab │
│ 15:35 │ ✅ Workflow komplett abgeschlossen │
└─────────────────────────────────────────────────────┘
```
---
## 🎭 Rollen und Verantwortlichkeiten
```
┌─────────────────────────────────────────────────────┐
│ 👤 GAST │
├─────────────────────────────────────────────────────┤
│ ✅ Anfrage stellen │
│ ✅ Job-Dateien hochladen │
│ ✅ Fortschritt verfolgen │
│ ✅ Objekt abholen │
│ ❌ Drucker steuern │
│ ❌ Andere Jobs sehen │
│ ❌ Admin-Funktionen │
└─────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────┐
│ 👨‍💼 ADMINISTRATOR │
├─────────────────────────────────────────────────────┤
│ ✅ Gastzugang genehmigen/ablehnen │
│ ✅ Jobs prüfen und freigeben │
│ ✅ Drucker-Zuweisung optimieren │
│ ✅ Warteschlangen verwalten │
│ ✅ Probleme lösen │
│ ✅ System überwachen │
│ ✅ Berichte erstellen │
└─────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────┐
│ 🤖 SYSTEM │
├─────────────────────────────────────────────────────┤
│ ✅ OTP-Codes generieren │
│ ✅ E-Mails versenden │
│ ✅ Drucker automatisch steuern │
│ ✅ Jobs schedulen │
│ ✅ Status überwachen │
│ ✅ Benachrichtigungen senden │
│ ✅ Sicherheit gewährleisten │
└─────────────────────────────────────────────────────┘
```
---
## 🔄 Status-Übersicht
### Gastzugang-Status
```
🔴 PENDING │ Anfrage eingegangen, wartet auf Admin
🟡 REVIEWING │ Admin prüft Anfrage
🟢 APPROVED │ Genehmigt, OTP versendet
🔵 ACTIVE │ Gast angemeldet, kann Jobs erstellen
🟠 EXPIRING │ Zugang läuft in 24h ab
❌ REJECTED │ Anfrage abgelehnt
⚫ EXPIRED │ Zugang abgelaufen
```
### Job-Status
```
📝 DRAFT │ Job wird erstellt
⏳ PENDING │ Wartet auf Admin-Genehmigung
📅 SCHEDULED │ Genehmigt, wartet auf Druckslot
🔄 QUEUED │ In Warteschlange
⚡ STARTING │ Drucker wird vorbereitet
🖨️ PRINTING │ Wird gedruckt
⏸️ PAUSED │ Pausiert (manuell oder Fehler)
✅ COMPLETED │ Erfolgreich gedruckt
📦 READY │ Bereit zur Abholung
🏁 PICKED_UP │ Abgeholt
❌ FAILED │ Druckfehler
🚫 CANCELLED │ Abgebrochen
```
---
## 📱 UI-Flow (Mockups)
### Schritt 1: Gastzugang beantragen
```
┌─────────────────────────────────────────────────────┐
│ 🌐 MYP - Gastzugang beantragen │
├─────────────────────────────────────────────────────┤
│ │
│ 👋 Willkommen bei MYP │
│ Mercedes-Benz TBA Marienfelde │
│ │
│ Vollständiger Name: * │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Max Mustermann │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ E-Mail-Adresse: * │
│ ┌─────────────────────────────────────────────────┐ │
│ │ max.mustermann@example.com │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ Telefonnummer: │
│ ┌─────────────────────────────────────────────────┐ │
│ │ +49 123 456789 │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ Grund der Anfrage: * │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Prototyp für Kundenpräsentation drucken │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ Gewünschte Zugangsdauer: │
│ ○ 1 Tag ● 3 Tage ○ 7 Tage │
│ │
│ [ ] Ich akzeptiere die Nutzungsbedingungen │
│ │
│ [📤 Anfrage senden] │
│ │
└─────────────────────────────────────────────────────┘
```
### Schritt 2: OTP-Login
```
┌─────────────────────────────────────────────────────┐
│ 🔐 MYP - Gast-Anmeldung │
├─────────────────────────────────────────────────────┤
│ │
│ 🎉 Ihr Zugang wurde genehmigt! │
│ │
│ E-Mail-Adresse: │
│ ┌─────────────────────────────────────────────────┐ │
│ │ max.mustermann@example.com │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ OTP-Code (aus E-Mail): │
│ ┌─────────────────────────────────────────────────┐ │
│ │ 123456 │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ ⏰ Ihr Zugang ist gültig bis: │
│ 18. Juni 2025, 14:30 Uhr │
│ │
│ [🔑 Anmelden] │
│ │
│ 💡 Tipp: Speichern Sie diese Seite als Lesezeichen│
│ │
└─────────────────────────────────────────────────────┘
```
### Schritt 3: Job erstellen
```
┌─────────────────────────────────────────────────────┐
│ 📁 Neuen Druckauftrag erstellen │
├─────────────────────────────────────────────────────┤
│ │
│ Job-Name: * │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Kundenpräsentation Prototyp │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ Beschreibung: │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Gehäuse für Elektronikmodul │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 📁 Datei hochladen: * │
│ ┌─────────────────────────────────────────────────┐ │
│ │ 📁 Datei auswählen oder hierher ziehen │ │
│ │ │ │
│ │ Unterstützt: .stl, .obj, .3mf, .gcode │ │
│ │ Max. Größe: 50 MB │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ ⏱️ Geschätzte Druckdauer: 240 Minuten │
│ 🧱 Material: [PLA ▼] │
│ 🔥 Priorität: Normal (Gäste) │
│ │
│ 📅 Gewünschter Starttermin: │
│ [16.06.2025] [09:00] (Optional) │
│ │
│ [✅ Job erstellen] [❌ Abbrechen] │
│ │
└─────────────────────────────────────────────────────┘
```
### Schritt 4: Job-Monitoring
```
┌─────────────────────────────────────────────────────┐
│ 📊 Meine Druckaufträge │
├─────────────────────────────────────────────────────┤
│ │
│ 🖨️ Kundenpräsentation Prototyp │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Status: ⚡ WIRD GEDRUCKT │ │
│ │ │ │
│ │ ████████████░░░░ 75% │ │
│ │ 3:00 / 4:00 Stunden │ │
│ │ │ │
│ │ 🖨️ Drucker: Prusa i3 MK3S #1 │ │
│ │ 📅 Gestartet: 16.06.2025 09:15 │ │
│ │ ⏰ Fertig um: ~13:15 Uhr │ │
│ │ │ │
│ │ ┌─────────────────────────────────────────────┐ │ │
│ │ │ 📹 Live Webcam Feed │ │ │
│ │ │ │ │ │
│ │ │ [Aktuelles Bild vom Drucker] │ │ │
│ │ └─────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ ⚡ Verbrauch: 45W 🌡️ Extruder: 210°C │ │
│ │ 🛏️ Bett: 60°C 📏 Layer: 180/240 │ │
│ │ │ │
│ │ [⏸️ Pausieren] [🚨 Problem melden] │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ ✅ Weiterer Job: Ersatzteil Halterung │
│ Status: 📅 Geplant für morgen 10:00 │
│ │
└─────────────────────────────────────────────────────┘
```
---
## 📧 E-Mail-Templates (Beispiele)
### Genehmigung mit OTP
```
Von: MYP System <noreply@tba-marienfelde.de>
An: max.mustermann@example.com
Betreff: ✅ Gastzugang genehmigt - Willkommen bei MYP!
Hallo Max Mustermann,
großartige Neuigkeiten! Ihr Gastzugang wurde genehmigt.
🔑 Ihre Zugangsdaten:
E-Mail: max.mustermann@example.com
OTP-Code: 123456
⏰ Gültig bis: 18. Juni 2025, 14:30 Uhr
🚀 So geht's weiter:
1. Besuchen Sie: https://myp.tba-marienfelde.de/auth/guest
2. Geben Sie Ihre E-Mail und den OTP-Code ein
3. Laden Sie Ihre Druckdateien hoch
4. Warten Sie auf die Admin-Freigabe
📋 Wichtige Informationen:
• Max. Druckzeit pro Job: 4 Stunden
• Unterstützte Formate: STL, OBJ, 3MF, GCODE
• Materialien: PLA, PETG
• Abholung: Mo-Fr 8:00-16:00, Raum B2.1
❓ Fragen? Antworten Sie einfach auf diese E-Mail.
Viel Erfolg mit Ihrem Projekt!
Das MYP-Team
```
### Job fertig - Abholung
```
Von: MYP System <noreply@tba-marienfelde.de>
An: max.mustermann@example.com
Betreff: 🎉 Druckauftrag fertig - Abholung möglich!
Hallo Max Mustermann,
Ihr Druckauftrag ist erfolgreich abgeschlossen! 🎉
📦 Job-Details:
Name: Kundenpräsentation Prototyp
Fertiggestellt: 16.06.2025 um 13:15 Uhr
Druckdauer: 4:15 Stunden
Material: PLA, Grau
📍 Abholung:
Ort: TBA Marienfelde, Raum B2.1
Öffnungszeiten: Mo-Fr 8:00-16:00 Uhr
Lagerplatz: Regal B2.1-A3
⚠️ Wichtig:
- Bringen Sie einen Ausweis mit
- Abholung bis zum 23.06.2025
- Danach wird das Objekt entsorgt
📸 Hier ist ein Foto Ihres fertigen Drucks:
[Bild des gedruckten Objekts]
✨ Zufrieden? Wir freuen uns über Ihr Feedback:
https://myp.tba-marienfelde.de/feedback/xyz123
Vielen Dank für die Nutzung von MYP!
Das Team der TBA Marienfelde
```
---
## 🎓 Schulungsplan (Empfehlung)
### Modul 1: System-Überblick (15 Min)
- Was ist MYP?
- Zielgruppe und Anwendungsfälle
- Sicherheitskonzept
- **Praktisch:** Live-Demo der Benutzeroberfläche
### Modul 2: Gastzugang-Management (30 Min)
- Anfrageprozess verstehen
- Bewertungskriterien für Genehmigungen
- OTP-System verwalten
- **Praktisch:** Anfrage bearbeiten und genehmigen
### Modul 3: Job-Management (45 Min)
- Datei-Upload und Validierung
- Druckparameter beurteilen
- Drucker-Zuweisung optimieren
- **Praktisch:** Gast-Job von Anfang bis Ende begleiten
### Modul 4: Monitoring und Problembehebung (20 Min)
- Live-Status überwachen
- Häufige Probleme erkennen
- Eskalationswege
- **Praktisch:** Simulierte Problemfälle lösen
### Modul 5: Abholung und Nachbereitung (10 Min)
- Lagerorganisation
- Erinnerungen und Follow-up
- Dokumentation
- **Praktisch:** Abholungsprozess durchspielen
**Gesamtdauer:** 2 Stunden
**Format:** 60% Theorie, 40% praktische Übungen
**Nachschulung:** Alle 6 Monate oder bei größeren Updates
---
*Diese visuelle Workflow-Dokumentation ergänzt die detaillierte technische Dokumentation und eignet sich besonders für Präsentationen und Schulungen.*