🎉 Improved backend structure & added utility modules 🎨📚

backend/utils/maintenance_system.py

@@ -685,4 +685,106 @@ def get_maintenance_javascript() -> str:
     document.addEventListener('DOMContentLoaded', function() {
         window.maintenanceManager = new MaintenanceManager();
     });
-    """ 
+    """ 
+
+def create_maintenance_task(printer_id: int, title: str, description: str = "", 
+                          maintenance_type: MaintenanceType = MaintenanceType.PREVENTIVE,
+                          priority: MaintenancePriority = MaintenancePriority.NORMAL) -> int:
+    """
+    Erstellt eine neue Wartungsaufgabe.
+    
+    Args:
+        printer_id: ID des Druckers
+        title: Titel der Wartungsaufgabe
+        description: Beschreibung der Aufgabe
+        maintenance_type: Art der Wartung
+        priority: Priorität der Aufgabe
+    
+    Returns:
+        int: ID der erstellten Aufgabe
+    """
+    task = MaintenanceTask(
+        printer_id=printer_id,
+        title=title,
+        description=description,
+        maintenance_type=maintenance_type,
+        priority=priority,
+        checklist=maintenance_manager.create_maintenance_checklist(maintenance_type)
+    )
+    
+    return maintenance_manager.create_task(task)
+
+def schedule_maintenance(printer_id: int, maintenance_type: MaintenanceType, 
+                        interval_days: int, description: str = "") -> MaintenanceSchedule:
+    """
+    Plant regelmäßige Wartungen (Alias für maintenance_manager.schedule_maintenance).
+    
+    Args:
+        printer_id: ID des Druckers
+        maintenance_type: Art der Wartung
+        interval_days: Intervall in Tagen
+        description: Beschreibung
+    
+    Returns:
+        MaintenanceSchedule: Erstellter Wartungsplan
+    """
+    return maintenance_manager.schedule_maintenance(
+        printer_id=printer_id,
+        maintenance_type=maintenance_type,
+        interval_days=interval_days,
+        description=description
+    )
+
+def get_maintenance_overview() -> Dict[str, Any]:
+    """
+    Holt eine Übersicht aller Wartungsaktivitäten.
+    
+    Returns:
+        Dict: Wartungsübersicht mit Statistiken und anstehenden Aufgaben
+    """
+    upcoming = maintenance_manager.get_upcoming_maintenance()
+    overdue = maintenance_manager.get_overdue_tasks()
+    metrics = maintenance_manager.get_maintenance_metrics()
+    
+    # Aktive Tasks
+    active_tasks = [task for task in maintenance_manager.tasks.values() 
+                   if task.status == MaintenanceStatus.IN_PROGRESS]
+    
+    # Completed tasks in last 30 days
+    thirty_days_ago = datetime.now() - timedelta(days=30)
+    recent_completed = [task for task in maintenance_manager.maintenance_history
+                       if task.completed_at and task.completed_at >= thirty_days_ago]
+    
+    return {
+        'summary': {
+            'total_tasks': len(maintenance_manager.tasks),
+            'active_tasks': len(active_tasks),
+            'upcoming_tasks': len(upcoming),
+            'overdue_tasks': len(overdue),
+            'completed_this_month': len(recent_completed)
+        },
+        'upcoming_tasks': [asdict(task) for task in upcoming[:10]],
+        'overdue_tasks': [asdict(task) for task in overdue],
+        'active_tasks': [asdict(task) for task in active_tasks],
+        'recent_completed': [asdict(task) for task in recent_completed[:5]],
+        'metrics': asdict(metrics),
+        'schedules': {
+            printer_id: [asdict(schedule) for schedule in schedules]
+            for printer_id, schedules in maintenance_manager.schedules.items()
+        }
+    }
+
+def update_maintenance_status(task_id: int, new_status: MaintenanceStatus, 
+                            notes: str = "") -> bool:
+    """
+    Aktualisiert den Status einer Wartungsaufgabe (Alias für maintenance_manager.update_task_status).
+    
+    Args:
+        task_id: ID der Wartungsaufgabe
+        new_status: Neuer Status
+        notes: Optionale Notizen
+    
+    Returns:
+        bool: True wenn erfolgreich aktualisiert
+    """
+    return maintenance_manager.update_task_status(task_id, new_status, notes)