@burdenoff/microfe-movethewheels 2026.822.1 → 2026.827.1

package/src/movethewheels/pages/VehicleDetailsPage.tsx

@@ -4,7 +4,7 @@
 
 import { useEffect, useState } from 'react';
 import { useParams, useLocation } from 'react-router';
-import { Truck, ArrowLeft, MapPin, Fuel, Wrench, Edit, Save } from 'lucide-react';
+import { Truck, ArrowLeft, MapPin, Fuel, UserRound, Edit, Save, Mail, Phone } from 'lucide-react';
 import { PageLayout, LoadingState, ErrorState } from '../components/PageLayout';
 import { StatusBadge, VehicleTypeBadge } from '../components/StatusBadge';
 import {
@@ -21,11 +21,13 @@ import {
   SelectItem,
   SelectTrigger,
   SelectValue,
+  Avatar,
+  AvatarFallback,
 } from '../components/ui';
 import { EmphasisPanel, NextSteps, PagePurpose } from '@burdenoff/fe-libs/ui';
-import { useVehicle, useFleet } from '../hooks/useFleet';
+import { useVehicle, useVehicleDrivers, useFleet } from '../hooks/useFleet';
 import { useMoveTheWheels } from '../providers/MoveTheWheelsProvider';
-import { formatDate } from '../utils/formatters';
+import { formatDate, getInitials } from '../utils/formatters';
 import { joinPath } from '../utils/navigation';
 import { FormError } from '../components/FormError';
 import { DocumentsCard } from '../components/DocumentsCard';
@@ -213,6 +215,13 @@ export default function VehicleDetailsPage() {
   const { basePath, navigate } = useMoveTheWheels();
   const { vehicle, isLoading, error, refetch } = useVehicle(vehicleId);
   const isEditRoute = useLocation().pathname.endsWith('/edit');
+  // Who is behind the wheel — resolved through DriverFilterInput.vehicleId, the
+  // same link `assignDriverVehicle` writes.
+  const {
+    drivers: assignedDrivers,
+    isLoading: driversLoading,
+    error: driversError,
+  } = useVehicleDrivers(isEditRoute ? undefined : vehicleId);
 
   const goBack = () => navigate?.(joinPath(basePath, 'fleet/vehicles'));
   const goTo = (path: string) => navigate?.(joinPath(basePath, path));
@@ -247,8 +256,8 @@ export default function VehicleDetailsPage() {
       }
     >
       <PagePurpose icon={<Truck size={18} />}>
-        The full record for this vehicle — specs, capacity, fuel and mileage, maintenance schedule
-        and current location. Use it to confirm a vehicle is fuelled, serviced and the right size
+        The full record for this vehicle — specs, capacity, fuel and mileage, who is driving it and
+        where it is right now. Use it to confirm a vehicle is fuelled, crewed and the right size
         before dispatching it on a delivery.
       </PagePurpose>
 
@@ -263,11 +272,15 @@ export default function VehicleDetailsPage() {
             onClick: () => goTo('orders'),
           },
           {
-            id: 'maintenance',
-            label: 'Schedule maintenance',
-            description: 'Keep it road-ready and compliant.',
-            icon: <Wrench size={16} />,
-            onClick: () => {},
+            id: 'driver',
+            label: assignedDrivers.length > 0 ? 'Review the assigned driver' : 'Assign a driver',
+            description: 'A vehicle needs a driver before it can be dispatched.',
+            icon: <UserRound size={16} />,
+            done: assignedDrivers.length > 0,
+            onClick: () =>
+              assignedDrivers[0]
+                ? goTo(`fleet/drivers/${assignedDrivers[0].id}`)
+                : goTo('fleet/drivers'),
           },
         ]}
       />
@@ -277,23 +290,31 @@ export default function VehicleDetailsPage() {
           {/* Vehicle Information — the page's single emphasis zone */}
           <EmphasisPanel>
             <h2 className="text-base font-semibold text-text-primary mb-4">Vehicle Information</h2>
-            <div className="grid grid-cols-2 md:grid-cols-4 gap-6">
+            <div className="grid grid-cols-2 md:grid-cols-3 gap-6">
               <div>
                 <p className="text-sm text-text-secondary">Type</p>
                 <p className="font-medium capitalize">{vehicle.type}</p>
               </div>
               <div>
                 <p className="text-sm text-text-secondary">Make</p>
-                <p className="font-medium">{vehicle.make}</p>
+                <p className="font-medium">{vehicle.make || '—'}</p>
               </div>
               <div>
                 <p className="text-sm text-text-secondary">Model</p>
-                <p className="font-medium">{vehicle.model}</p>
+                <p className="font-medium">{vehicle.model || '—'}</p>
               </div>
               <div>
                 <p className="text-sm text-text-secondary">Year</p>
                 <p className="font-medium">{vehicle.year}</p>
               </div>
+              <div>
+                <p className="text-sm text-text-secondary">License Plate</p>
+                <p className="font-medium">{vehicle.licensePlate || '—'}</p>
+              </div>
+              <div>
+                <p className="text-sm text-text-secondary">Ownership</p>
+                <p className="font-medium capitalize">{vehicle.ownershipType || '—'}</p>
+              </div>
             </div>
           </EmphasisPanel>
 
@@ -359,25 +380,63 @@ export default function VehicleDetailsPage() {
             </CardContent>
           </Card>
 
+          {/* Assigned driver — resolved from drivers(filter: { vehicleId }). */}
           <Card>
             <CardHeader>
               <CardTitle className="flex items-center gap-2">
-                <Wrench size={18} /> Maintenance
+                <UserRound size={18} /> Assigned Driver
               </CardTitle>
             </CardHeader>
-            <CardContent className="space-y-3">
-              <div>
-                <p className="text-sm text-text-secondary">Last Maintenance</p>
-                <p className="font-medium">
-                  {vehicle.lastMaintenance ? formatDate(vehicle.lastMaintenance) : 'N/A'}
-                </p>
-              </div>
-              <div>
-                <p className="text-sm text-text-secondary">Next Scheduled</p>
-                <p className="font-medium">
-                  {vehicle.nextMaintenance ? formatDate(vehicle.nextMaintenance) : 'N/A'}
-                </p>
-              </div>
+            <CardContent className="space-y-4">
+              {driversLoading ? (
+                <p className="text-sm text-text-secondary">Loading assignment…</p>
+              ) : driversError ? (
+                <p className="text-sm text-status-error-text">{driversError.message}</p>
+              ) : assignedDrivers.length === 0 ? (
+                <div className="space-y-3">
+                  <p className="text-sm text-text-secondary">
+                    No driver is assigned to this vehicle yet.
+                  </p>
+                  <Button variant="outline" size="sm" onClick={() => goTo('fleet/drivers')}>
+                    Assign from the roster
+                  </Button>
+                </div>
+              ) : (
+                assignedDrivers.map((driver) => (
+                  <div
+                    key={driver.id}
+                    role="button"
+                    tabIndex={0}
+                    className="flex w-full items-start gap-3 rounded-lg p-2 text-left hover:bg-bg-sunken/50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-action-primary-bg"
+                    onClick={() => goTo(`fleet/drivers/${driver.id}`)}
+                    onKeyDown={(e) => {
+                      if (e.key === 'Enter' || e.key === ' ') {
+                        e.preventDefault();
+                        goTo(`fleet/drivers/${driver.id}`);
+                      }
+                    }}
+                  >
+                    <Avatar>
+                      <AvatarFallback>{getInitials(driver.fullName)}</AvatarFallback>
+                    </Avatar>
+                    <div className="min-w-0 space-y-1">
+                      <p className="font-medium">{driver.fullName}</p>
+                      <p className="text-xs text-text-secondary">{driver.employeeId}</p>
+                      <StatusBadge status={driver.status} type="driver" size="sm" />
+                      {driver.email && (
+                        <p className="flex items-center gap-1.5 truncate text-sm text-text-secondary">
+                          <Mail size={13} /> {driver.email}
+                        </p>
+                      )}
+                      {driver.phone && (
+                        <p className="flex items-center gap-1.5 text-sm text-text-secondary">
+                          <Phone size={13} /> {driver.phone}
+                        </p>
+                      )}
+                    </div>
+                  </div>
+                ))
+              )}
             </CardContent>
           </Card>
 

package/src/movethewheels/types/index.ts

@@ -328,6 +328,8 @@ export interface Vehicle {
   make: string;
   model: string;
   licensePlate: string;
+  /** MtwVehicle.ownershipType — free-text, e.g. "owned", "leased". */
+  ownershipType?: string;
   year: number;
   capacity: {
     weight: number;

package/src/operations/wspace/movethewheels/fragments/core.graphql

@@ -1,14 +1,20 @@
-fragment MovethewheelsOrderCore on MovethewheelsOrder {
+# Core selection sets for the wspace-movethewheels-svc surface.
+#
+# Fragment names keep the MFE's own domain vocabulary (Order, Product, ...)
+# because that is what src/movethewheels/ calls these concepts; the `on <Type>`
+# condition is what has to track the service, which renamed its GraphQL types
+# to the Mtw* prefix (BOFF-6758).
+
+fragment MovethewheelsOrderCore on MtwDeliveryJob {
   id
-  orderNumber
-  orderType
+  deliveryJobNumber
   status
   priority
   customerId
   trackingNumber
   pickupAddress
   deliveryAddress
-  items
+  cargoItems
   pricing
   scheduledDelivery
   vehicleId
@@ -17,7 +23,7 @@ fragment MovethewheelsOrderCore on MovethewheelsOrder {
   updatedAt
 }
 
-fragment CustomerCore on Customer {
+fragment CustomerCore on MtwCustomer {
   id
   name
   email
@@ -30,7 +36,7 @@ fragment CustomerCore on Customer {
   updatedAt
 }
 
-fragment ProductCore on Product {
+fragment ProductCore on MtwCargoItem {
   id
   sku
   name
@@ -47,7 +53,7 @@ fragment ProductCore on Product {
   updatedAt
 }
 
-fragment VehicleCore on Vehicle {
+fragment VehicleCore on MtwVehicle {
   id
   vehicleNumber
   make
@@ -65,7 +71,7 @@ fragment VehicleCore on Vehicle {
   updatedAt
 }
 
-fragment DriverCore on Driver {
+fragment DriverCore on MtwDriver {
   id
   employeeId
   firstName
@@ -84,7 +90,7 @@ fragment DriverCore on Driver {
   updatedAt
 }
 
-fragment WarehouseCore on Warehouse {
+fragment WarehouseCore on MtwWarehouse {
   id
   name
   code
@@ -100,9 +106,9 @@ fragment WarehouseCore on Warehouse {
   updatedAt
 }
 
-fragment InventoryItemCore on InventoryItem {
+fragment InventoryItemCore on MtwInventoryItem {
   id
-  productId
+  cargoItemId
   warehouseId
   locationId
   onHand
@@ -116,7 +122,7 @@ fragment InventoryItemCore on InventoryItem {
   updatedAt
 }
 
-fragment RouteCore on Route {
+fragment RouteCore on MtwRoute {
   id
   name
   status
@@ -133,10 +139,10 @@ fragment RouteCore on Route {
   updatedAt
 }
 
-fragment ShipmentCore on Shipment {
+fragment ShipmentCore on MtwShipment {
   id
   shipmentNumber
-  orderId
+  deliveryJobId
   customerId
   carrierId
   status
@@ -150,42 +156,6 @@ fragment ShipmentCore on Shipment {
   updatedAt
 }
 
-fragment ServiceProviderCore on ServiceProvider {
-  id
-  name
-  type
-  description
-  rating
-  contactInfo
-  services
-  isVerified
-  isActive
-  createdAt
-  updatedAt
-}
-
-fragment ServiceOfferingCore on ServiceOffering {
-  id
-  providerId
-  name
-  description
-  category
-  price
-  currency
-  availability
-  createdAt
-  updatedAt
-}
-
-fragment MovethewheelsReportCore on MovethewheelsReport {
-  id
-  name
-  type
-  description
-  schedule
-  lastGenerated
-  configuration
-  status
-  createdAt
-  updatedAt
-}
+# The ServiceProvider / ServiceOffering / MovethewheelsReport fragments that
+# used to live here are preserved in `core.withdrawn.graphql` — the service no
+# longer exposes those types.

package/src/operations/wspace/movethewheels/fragments/core.withdrawn.graphql

@@ -0,0 +1,59 @@
+# ─── Withdrawn service surface — preserved, not deleted ──────────────────────
+#
+# `ServiceProvider`, `ServiceOffering` and `MovethewheelsReport` were dropped
+# from wspace-movethewheels-svc by migration
+# `20260707000001_movethewheels_reuse_cleanup`. The live supergraph carries no
+# replacement for any of them:
+#
+#   * no Mtw* provider or offering type exists — `MtwIntegration` is a
+#     TMS/visibility connector (Project44 / FourKites / Descartes), a different
+#     domain, not a marketplace listing;
+#   * the platform-wide `Report` type belongs to the analytics-report module and
+#     has a different shape (sections / parameters / runs, and no
+#     type / schedule / lastGenerated / configuration), so it is not a drop-in.
+#
+# These fragments are kept verbatim so they can be restored unchanged the day the
+# service re-publishes the surface. Files matching `*.withdrawn.graphql` are
+# excluded from the codegen `documents` globs in `.graphqlrc.yml`, because
+# codegen validates every document it loads and an unresolvable type condition
+# fails the whole run.
+
+fragment ServiceProviderCore on ServiceProvider {
+  id
+  name
+  type
+  description
+  rating
+  contactInfo
+  services
+  isVerified
+  isActive
+  createdAt
+  updatedAt
+}
+
+fragment ServiceOfferingCore on ServiceOffering {
+  id
+  providerId
+  name
+  description
+  category
+  price
+  currency
+  availability
+  createdAt
+  updatedAt
+}
+
+fragment MovethewheelsReportCore on MovethewheelsReport {
+  id
+  name
+  type
+  description
+  schedule
+  lastGenerated
+  configuration
+  status
+  createdAt
+  updatedAt
+}

package/src/operations/wspace/movethewheels/mutations/entities.graphql

@@ -14,20 +14,20 @@ mutation DeleteCustomer($id: ID!) {
   deleteCustomer(id: $id)
 }
 
-mutation CreateProduct($input: CreateProductInput!) {
-  createProduct(input: $input) {
+mutation CreateProduct($input: CreateCargoItemInput!) {
+  createCargoItem(input: $input) {
     ...ProductCore
   }
 }
 
-mutation UpdateProduct($id: ID!, $input: UpdateProductInput!) {
-  updateProduct(id: $id, input: $input) {
+mutation UpdateProduct($id: ID!, $input: UpdateCargoItemInput!) {
+  updateCargoItem(id: $id, input: $input) {
     ...ProductCore
   }
 }
 
 mutation DeleteProduct($id: ID!) {
-  deleteProduct(id: $id)
+  deleteCargoItem(id: $id)
 }
 
 mutation CreateVehicle($input: CreateVehicleInput!) {

package/src/operations/wspace/movethewheels/mutations/marketplace-reports.graphql

@@ -1,81 +1,21 @@
-mutation CreateServiceProvider($input: CreateServiceProviderInput!) {
-  createServiceProvider(input: $input) {
-    ...ServiceProviderCore
-  }
-}
-
-mutation UpdateServiceProvider($id: ID!, $input: UpdateServiceProviderInput!) {
-  updateServiceProvider(id: $id, input: $input) {
-    ...ServiceProviderCore
-  }
-}
-
-mutation DeleteServiceProvider($id: ID!) {
-  deleteServiceProvider(id: $id)
-}
-
-mutation CreateServiceOffering($input: CreateServiceOfferingInput!) {
-  createServiceOffering(input: $input) {
-    ...ServiceOfferingCore
-  }
-}
-
-mutation UpdateServiceOffering($id: ID!, $input: UpdateServiceOfferingInput!) {
-  updateServiceOffering(id: $id, input: $input) {
-    ...ServiceOfferingCore
-  }
-}
-
-mutation DeleteServiceOffering($id: ID!) {
-  deleteServiceOffering(id: $id)
-}
-
-mutation CreateMovethewheelsReport($input: CreateMovethewheelsReportInput!) {
-  createMovethewheelsReport(input: $input) {
-    ...MovethewheelsReportCore
-  }
-}
-
-mutation UpdateMovethewheelsReport($id: ID!, $input: UpdateMovethewheelsReportInput!) {
-  updateMovethewheelsReport(id: $id, input: $input) {
-    ...MovethewheelsReportCore
-  }
-}
-
-mutation DeleteMovethewheelsReport($id: ID!) {
-  deleteMovethewheelsReport(id: $id)
-}
-
-mutation GenerateMovethewheelsReport($input: GenerateMovethewheelsReportInput!) {
-  generateMovethewheelsReport(input: $input) {
-    generatedAt
-    result
-    report {
-      ...MovethewheelsReportCore
-    }
-  }
-}
-
-mutation ImportMovethewheelsData($input: MovethewheelsImportDataInput!) {
-  importData(input: $input) {
-    success
-    message
-    payload
-  }
-}
-
-mutation ExportMovethewheelsData($input: MovethewheelsExportDataInput!) {
-  exportData(input: $input) {
-    success
-    message
-    payload
-  }
-}
-
-mutation UpdateMovethewheelsModuleSettings($input: UpdateMovethewheelsModuleSettingsInput!) {
-  updateModuleSettings(input: $input) {
+# Data export against the live wspace-movethewheels-svc surface.
+#
+# `exportData` / `MovethewheelsExportDataInput` were replaced by
+# `exportMtwEntities` / `ExportMtwEntitiesInput`, which STARTS an export job
+# instead of returning an inline success/message/payload envelope — hence the
+# new selection set (MtwExportJob: poll `status`, then read `downloadUrl`).
+#
+# The marketplace, report and module-settings writes that used to live in this
+# file are preserved in `marketplace-reports.withdrawn.graphql`; the service no
+# longer exposes them.
+mutation ExportMovethewheelsData($input: ExportMtwEntitiesInput!) {
+  exportMtwEntities(input: $input) {
+    id
     workspaceId
-    preferences
-    updatedAt
+    entityTypes
+    format
+    status
+    downloadUrl
+    createdAt
   }
 }

package/src/operations/wspace/movethewheels/mutations/marketplace-reports.withdrawn.graphql

@@ -0,0 +1,93 @@
+# ─── Withdrawn service surface — preserved, not deleted ──────────────────────
+#
+# Every write below targets a surface that migration
+# `20260707000001_movethewheels_reuse_cleanup` removed from
+# wspace-movethewheels-svc, with no replacement in the live supergraph:
+#
+#   * service-provider / service-offering marketplace CRUD — no Mtw* provider or
+#     offering type exists (`MtwIntegration` is a TMS/visibility connector for
+#     Project44 / FourKites / Descartes, a different domain).
+#   * MovethewheelsReport CRUD + generation — the platform-wide `Report` type is
+#     the analytics-report module's, a different shape, not a drop-in.
+#   * `importData` — the service exposes an export job (`exportMtwEntities`, see
+#     mutations/marketplace-reports.graphql) but no import counterpart.
+#   * `updateModuleSettings` — no per-module settings surface remains.
+#
+# Kept verbatim so they can be restored unchanged if the surface returns. Files
+# matching `*.withdrawn.graphql` are excluded from the codegen `documents` globs
+# in `.graphqlrc.yml`; codegen validates every document it loads, and an
+# unresolvable field fails the whole run.
+
+mutation CreateServiceProvider($input: CreateServiceProviderInput!) {
+  createServiceProvider(input: $input) {
+    ...ServiceProviderCore
+  }
+}
+
+mutation UpdateServiceProvider($id: ID!, $input: UpdateServiceProviderInput!) {
+  updateServiceProvider(id: $id, input: $input) {
+    ...ServiceProviderCore
+  }
+}
+
+mutation DeleteServiceProvider($id: ID!) {
+  deleteServiceProvider(id: $id)
+}
+
+mutation CreateServiceOffering($input: CreateServiceOfferingInput!) {
+  createServiceOffering(input: $input) {
+    ...ServiceOfferingCore
+  }
+}
+
+mutation UpdateServiceOffering($id: ID!, $input: UpdateServiceOfferingInput!) {
+  updateServiceOffering(id: $id, input: $input) {
+    ...ServiceOfferingCore
+  }
+}
+
+mutation DeleteServiceOffering($id: ID!) {
+  deleteServiceOffering(id: $id)
+}
+
+mutation CreateMovethewheelsReport($input: CreateMovethewheelsReportInput!) {
+  createMovethewheelsReport(input: $input) {
+    ...MovethewheelsReportCore
+  }
+}
+
+mutation UpdateMovethewheelsReport($id: ID!, $input: UpdateMovethewheelsReportInput!) {
+  updateMovethewheelsReport(id: $id, input: $input) {
+    ...MovethewheelsReportCore
+  }
+}
+
+mutation DeleteMovethewheelsReport($id: ID!) {
+  deleteMovethewheelsReport(id: $id)
+}
+
+mutation GenerateMovethewheelsReport($input: GenerateMovethewheelsReportInput!) {
+  generateMovethewheelsReport(input: $input) {
+    generatedAt
+    result
+    report {
+      ...MovethewheelsReportCore
+    }
+  }
+}
+
+mutation ImportMovethewheelsData($input: MovethewheelsImportDataInput!) {
+  importData(input: $input) {
+    success
+    message
+    payload
+  }
+}
+
+mutation UpdateMovethewheelsModuleSettings($input: UpdateMovethewheelsModuleSettingsInput!) {
+  updateModuleSettings(input: $input) {
+    workspaceId
+    preferences
+    updatedAt
+  }
+}

package/src/operations/wspace/movethewheels/mutations/orders.graphql

@@ -1,21 +1,21 @@
-mutation CreateMovethewheelsOrder($input: CreateOrderInput!) {
-  createMovethewheelsOrder(input: $input) {
+mutation CreateMovethewheelsOrder($input: CreateDeliveryJobInput!) {
+  createDeliveryJob(input: $input) {
     ...MovethewheelsOrderCore
   }
 }
 
-mutation UpdateMovethewheelsOrder($id: ID!, $input: UpdateOrderInput!) {
-  updateMovethewheelsOrder(id: $id, input: $input) {
+mutation UpdateMovethewheelsOrder($id: ID!, $input: UpdateDeliveryJobInput!) {
+  updateDeliveryJob(id: $id, input: $input) {
     ...MovethewheelsOrderCore
   }
 }
 
-mutation UpdateMovethewheelsOrderStatus($id: ID!, $input: UpdateOrderStatusInput!) {
-  updateMovethewheelsOrderStatus(id: $id, input: $input) {
+mutation UpdateMovethewheelsOrderStatus($id: ID!, $input: UpdateDeliveryJobStatusInput!) {
+  updateDeliveryJobStatus(id: $id, input: $input) {
     ...MovethewheelsOrderCore
   }
 }
 
 mutation DeleteMovethewheelsOrder($id: ID!) {
-  deleteMovethewheelsOrder(id: $id)
+  deleteDeliveryJob(id: $id)
 }

package/src/operations/wspace/movethewheels/queries/dashboard.graphql

@@ -1,16 +1,16 @@
 query GetMovethewheelsDashboard {
   dashboardMetrics {
-    totalOrders
+    totalDeliveryJobs
     activeDeliveries
     availableDrivers
     activeVehicles
     lowStockItems
     totalRevenue
-    recentOrders {
+    recentDeliveryJobs {
       ...MovethewheelsOrderCore
     }
   }
-  orderStats {
+  deliveryJobStats {
     total
     pending
     inTransit