Files
Projektarbeit-MYP/DOCS/Workflow_Diagramm_Visual.md
Till Tomczak 83d3ca5e28 🔧 Update: Database and Log Enhancements
**Ä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)
2025-06-16 01:08:51 +02:00

22 KiB

MYP Workflow-Diagramm (Visuell)

Für Schulungspräsentationen


🎯 Workflow-Übersicht (Flowchart)

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.