Initial MobilityOps build pack (docs, contracts, scaffold)

2026-08-01 20:34:43 +02:00
commit 24188d9b10
71 changed files with 3412 additions and 0 deletions
@@ -0,0 +1,32 @@
+# User stories
+
+## Dashboard
+
+- As an Operations Manager, I can see available, rented, maintenance and blocked vehicles so I know the current operational state.
+- As an Operations Manager, I can open an attention item and reach the relevant record directly.
+
+## Return workflow
+
+- As a Rental Employee, I can register a return with mileage, fuel, cleanliness, damage and technical notes.
+- The system validates mileage and required fields before deriving the new vehicle state.
+- A problematic return is committed, audited and blocked even when n8n is unavailable.
+
+## Data quality
+
+- As an Operations Manager, I can review possible duplicate customers with explainable match signals.
+- I can merge, reject or defer the duplicate and see an audit event.
+- I can review falling mileage, overlapping bookings, missing required data and status conflicts.
+
+## Knowledge
+
+- As an employee, I can ask a question about one of the supplied procedures.
+- The answer contains sources and document versions, or explicitly states that evidence is insufficient.
+
+## Automation
+
+- As an Operations Manager, I can see pending, successful and failed workflow deliveries.
+- Failed deliveries can be retried safely without duplicating domain actions.
+
+## MCP
+
+- As an authorised external AI client, I can request the operations summary, attention vehicles, vehicle details and procedure search without database or write access.