Tasks manuell erstellen
In einer reifen Flotte werden die meisten Auftraege von der Rule Engine erzeugt, aber manuelles Anlegen bleibt die richtige Antwort fuer Ad-hoc-Arbeit: ein Kundenanruf zu einem geparkten, undichten Moped, eine geplante Modifikation, eine einmalige Inspektion. Dieser Artikel deckt die drei manuellen Pfade ab.
Vom Kanban Board aus
Das ist der schnellste Pfad und derjenige, den Ihr Ops-Team in 90% der Faelle benutzen wird.
New Task anklicken
Oben rechts auf /dashboard/tasks.
Fahrzeug auswaehlen
Tippen Sie eine Vehicle Number in das Autocomplete ein. Das Formular fuellt Subaccount, letzten bekannten GPS-Standort und aktuellen Akkustand als Kontext vor.
Type auswaehlen
Die 14 Task-Typen sind: scheduled_maintenance, repair, deploy, retrieve, charge_swap, battery_swap, rebalance, lost_and_found, inspection, cleaning, parts_replacement, software_update, inspection_failed_followup, vendor_dispatch. Waehlen Sie den naheliegendsten.
Priority auswaehlen
low, medium, high oder critical. Die SLA-Due-Time berechnet sich aus der SLA-Konfiguration Ihres Subaccounts - siehe SLA and Performance.
Title und Description schreiben
Der Title sollte auf eine Karte passen (unter 60 Zeichen). Die Description richtet sich an den Techniker - bitte Teile-Nummern, Beobachtungen und alle relevanten Fotos referenzieren.
Zuweisen (optional)
Ueberspringen, damit ein nahegelegener Tech den Task aus der operator-app heraus annimmt. Namen waehlen, wenn Sie ihn direkt pushen wollen.
Erstellen
Der Task landet auf dem Board. Bei Prioritaet high oder critical flippt das Fahrzeug automatisch auf maintenance und verschwindet innerhalb von Sekunden aus der Rider App.
Aus der Fahrzeug-Detailseite
Wenn Sie ohnehin den Verlauf eines Fahrzeugs anschauen, ist es schneller, den Task im Kontext anzulegen:
- Oeffnen Sie das Fahrzeug unter
/dashboard/vehicles/[id] - Scrollen Sie rechts zur Karte Open Tasks
- Klicken Sie + New Task
- Der Dialog oeffnet sich mit vorausgewaehltem Fahrzeug - fuellen Sie Type, Priority, Title, Description aus und erstellen Sie
Die Fahrzeug-Detailseite zeigt im Abschnitt Maintenance History auch jeden geschlossenen Task gegen die Maschine, sodass Sie pruefen koennen, ob ein bestimmter Defekt wiederkehrt, bevor Sie einen weiteren Auftrag eroeffnen.
Per API
Fuer Integrationen und Skripte: POST an /api/tasks:
POST /api/tasks
Content-Type: application/json
{
"vehicle_uuid": "uuid-here",
"task_type": "repair",
"priority": "high",
"title": "Front brake cable replacement",
"description": "Reported by rider - cable slipping. Replace cable + housing.",
"assignee_id": "team-member-uuid-or-null"
}
Die Route setzt die Regel ein offener Task desselben Type pro Fahrzeug durch. Existiert bereits ein repair-Task gegen das Fahrzeug, ist die Antwort 200 mit skipped_duplicate: true statt 201. Das verhindert Rule-Loop- und Integrations-Bug-Duplikate.
Was nach dem Erstellen passiert
Drei Dinge feuern sofort:
- SLA-Uhr startet.
sla_due_atwird basierend auf Ihrer Priority-Konfiguration geschrieben. - Vehicle Status Check. Bei Priority
highodercriticalflippt ein DB-Triggervehicles.statusaufmaintenance- es sei denn, das Fahrzeug istin_use(eine Fahrt laeuft), dann wartet der Flip auf das Fahrtende. - Notification Fan-Out. Ist der Task zugewiesen, erhaelt der Assignee einen Expo Push. Bei Priority
criticalbekommt zusaetzlich derops_managerdes Subaccounts einen Push und eine Slack-Nachricht.
Was manuell nicht geht
Ein paar Regeln, um die Daten sauber zu halten:
- Kein Task ohne
vehicle_uuid. Nicht-Fahrzeug-Assets (Ladeschraenke, Akkus im Regal) sind ausserhalb des Scopes, bis die CMMS-Erweiterung ausgeliefert wird. - Kein duplizierter Task desselben
task_typegegen dasselbe Fahrzeug. Schliessen Sie den ersten oder waehlen Sie einen anderen Type. - Kein Task fuer ein Fahrzeug in einem anderen Subaccount. RLS blockt das serverseitig.
Keine Wartungs-Tasks gegen geloeschte Fahrzeuge
Ist ein Fahrzeug soft-geloescht, gibt die API 404 zurueck. Wenn Sie die letzte Reparatur eines stillgelegten Fahrzeugs erfassen muessen, tun Sie es vor der Loeschung.