@burdenoff/microfe-movethewheels 2026.1031.3 → 2026.1031.5

package/dist/providers/ModuleSettingsProvider.js

@@ -0,0 +1,74 @@
+import { useMoveTheWheels as e } from "./MoveTheWheelsProvider.js";
+import { executeGraphQL as t } from "../utils/graphqlClient.js";
+import { setFormatPreferences as n } from "../utils/formatters.js";
+import { MTW_MODULE_SETTINGS_QUERY as r, UPDATE_MTW_MODULE_SETTINGS_MUTATION as i, platformDefaults as a, toFormatPreferences as o } from "../utils/moduleSettings.js";
+import { createContext as s, useCallback as c, useContext as l, useEffect as u, useMemo as d, useState as f } from "react";
+import { jsx as p } from "react/jsx-runtime";
+//#region src/movethewheels/providers/ModuleSettingsProvider.tsx
+var m = s(null), h = ({ children: s }) => {
+	let { apiGatewayUrl: l, authToken: h, workspaceToken: g, workspaceId: _, tenantId: v, currentUser: y } = e(), b = d(() => ({
+		apiGatewayUrl: l,
+		authToken: h,
+		workspaceToken: g,
+		workspaceId: _,
+		tenantId: v,
+		actorId: y?.id
+	}), [
+		l,
+		h,
+		g,
+		_,
+		v,
+		y?.id
+	]), [x, S] = f(() => a(_ ?? "")), [C, w] = f(!1), [T, E] = f(null), [D, O] = f(0), k = c((e) => {
+		n(o(e)), S(e);
+	}, []);
+	u(() => {
+		if (!b.workspaceId) return;
+		let e = !1;
+		return t(b, r).then((t) => {
+			e || (k(t.mtwModuleSettings), E(null));
+		}).catch((t) => {
+			e || (k(a(b.workspaceId ?? "")), E(t instanceof Error ? t : /* @__PURE__ */ Error("Could not load settings")));
+		}).finally(() => {
+			e || w(!0);
+		}), () => {
+			e = !0;
+		};
+	}, [
+		b,
+		D,
+		k
+	]);
+	let A = c(async (e) => {
+		let n = await t(b, i, { input: e });
+		return k(n.updateMtwModuleSettings), E(null), n.updateMtwModuleSettings;
+	}, [b, k]), j = c(() => O((e) => e + 1), []), M = d(() => ({
+		settings: x,
+		isLoaded: C,
+		error: T,
+		save: A,
+		reload: j
+	}), [
+		x,
+		C,
+		T,
+		A,
+		j
+	]);
+	return /* @__PURE__ */ p(m.Provider, {
+		value: M,
+		children: s
+	});
+};
+function g() {
+	return l(m) || {
+		settings: a(),
+		isLoaded: !0,
+		error: null,
+		save: () => Promise.reject(/* @__PURE__ */ Error("Module settings are not available here")),
+		reload: () => void 0
+	};
+}
+//#endregion
+export { h as ModuleSettingsProvider, g as useModuleSettings };

package/dist/utils/formatters.js

@@ -1,5 +1,17 @@
-//#region src/movethewheels/utils/formatters.ts
-function e(e) {
+var e = {
+	currency: "USD",
+	distanceUnit: "KM",
+	weightUnit: "KG",
+	timeZone: null
+};
+function t(t) {
+	e = { ...t };
+}
+function n() {
+	return e.timeZone ? { timeZone: e.timeZone } : {};
+}
+var r = 1.609344, i = .45359237;
+function a(e) {
 	return [
 		e.street,
 		e.city,
@@ -8,35 +20,38 @@ function e(e) {
 		e.country
 	].filter(Boolean).join(", ");
 }
-function t(e, t = "USD") {
+function o(t, n) {
 	return new Intl.NumberFormat("en-US", {
 		style: "currency",
-		currency: t,
+		currency: n || e.currency,
 		minimumFractionDigits: 2,
 		maximumFractionDigits: 2
-	}).format(e);
+	}).format(t);
 }
-function n(e, t = "short") {
-	let n = typeof e == "string" ? new Date(e) : e;
-	return t === "relative" ? i(n) : t === "time" ? new Intl.DateTimeFormat("en-US", {
+function s(e, t = "short") {
+	let r = typeof e == "string" ? new Date(e) : e;
+	return t === "relative" ? l(r) : t === "time" ? new Intl.DateTimeFormat("en-US", {
 		hour: "numeric",
 		minute: "2-digit",
-		hour12: !0
-	}).format(n) : t === "full" ? new Intl.DateTimeFormat("en-US", {
+		hour12: !0,
+		...n()
+	}).format(r) : t === "full" ? new Intl.DateTimeFormat("en-US", {
 		weekday: "long",
 		year: "numeric",
 		month: "long",
 		day: "numeric",
 		hour: "numeric",
 		minute: "2-digit",
-		hour12: !0
-	}).format(n) : new Intl.DateTimeFormat("en-US", {
+		hour12: !0,
+		...n()
+	}).format(r) : new Intl.DateTimeFormat("en-US", {
 		year: "numeric",
 		month: "short",
-		day: "numeric"
-	}).format(n);
+		day: "numeric",
+		...n()
+	}).format(r);
 }
-function r(e) {
+function c(e) {
 	let t = typeof e == "string" ? new Date(e) : e;
 	return new Intl.DateTimeFormat("en-US", {
 		year: "numeric",
@@ -44,21 +59,33 @@ function r(e) {
 		day: "numeric",
 		hour: "numeric",
 		minute: "2-digit",
-		hour12: !0
+		hour12: !0,
+		...n()
 	}).format(t);
 }
-function i(e) {
-	let t = typeof e == "string" ? new Date(e) : e, r = Math.floor(((/* @__PURE__ */ new Date()).getTime() - t.getTime()) / 1e3);
-	if (r < 60) return "Just now";
+function l(e) {
+	let t = typeof e == "string" ? new Date(e) : e, n = Math.floor(((/* @__PURE__ */ new Date()).getTime() - t.getTime()) / 1e3);
+	if (n < 60) return "Just now";
+	let r = Math.floor(n / 60);
+	if (r < 60) return `${r} ${r === 1 ? "minute" : "minutes"} ago`;
 	let i = Math.floor(r / 60);
-	if (i < 60) return `${i} ${i === 1 ? "minute" : "minutes"} ago`;
-	let a = Math.floor(i / 60);
-	if (a < 24) return `${a} ${a === 1 ? "hour" : "hours"} ago`;
-	let o = Math.floor(a / 24);
-	return o < 7 ? `${o} ${o === 1 ? "day" : "days"} ago` : n(t);
+	if (i < 24) return `${i} ${i === 1 ? "hour" : "hours"} ago`;
+	let a = Math.floor(i / 24);
+	return a < 7 ? `${a} ${a === 1 ? "day" : "days"} ago` : s(t);
 }
-function a(e) {
+var u = new Intl.NumberFormat("en-US", { maximumFractionDigits: 2 }), d = new Intl.NumberFormat("en-US", { maximumFractionDigits: 1 });
+function f(t) {
+	return e.weightUnit === "LB" ? `${u.format(t / i)} lb` : Math.abs(t) >= 1e3 ? `${u.format(t / 1e3)} tonnes` : `${u.format(t)} kg`;
+}
+function p(t) {
+	if (e.distanceUnit === "MI") {
+		let e = t / r;
+		return Math.abs(e) < .1 ? `${Math.round(e * 5280)} ft` : `${d.format(e)} mi`;
+	}
+	return Math.abs(t) < 1 ? `${Math.round(t * 1e3)} m` : `${d.format(t)} km`;
+}
+function m(e) {
 	return e.split(" ").map((e) => e[0]).join("").toUpperCase().slice(0, 2);
 }
 //#endregion
-export { e as formatAddress, t as formatCurrency, n as formatDate, r as formatDateTime, a as getInitials };
+export { a as formatAddress, o as formatCurrency, s as formatDate, c as formatDateTime, p as formatDistance, f as formatWeight, m as getInitials, t as setFormatPreferences };

package/dist/utils/moduleSettings.js

@@ -0,0 +1,132 @@
+function e(e = "") {
+	return {
+		workspaceId: e,
+		defaultCurrency: "USD",
+		distanceUnit: "KM",
+		weightUnit: "KG",
+		timezone: null,
+		defaultOrderPriority: "MEDIUM",
+		defaultDeliveryWindowHours: 24,
+		isCustomized: !1,
+		updatedAt: null,
+		updatedBy: null
+	};
+}
+var t = "\n  workspaceId\n  defaultCurrency\n  distanceUnit\n  weightUnit\n  timezone\n  defaultOrderPriority\n  defaultDeliveryWindowHours\n  isCustomized\n  updatedAt\n  updatedBy\n", n = `
+  query MtwModuleSettings {
+    mtwModuleSettings {
+      ${t}
+    }
+  }
+`, r = `
+  mutation UpdateMtwModuleSettings($input: UpdateMtwModuleSettingsInput!) {
+    updateMtwModuleSettings(input: $input) {
+      ${t}
+    }
+  }
+`;
+function i(e) {
+	return {
+		currency: e.defaultCurrency,
+		distanceUnit: e.distanceUnit,
+		weightUnit: e.weightUnit,
+		timeZone: e.timezone
+	};
+}
+var a = [{
+	value: "KM",
+	label: "Kilometres (km)"
+}, {
+	value: "MI",
+	label: "Miles (mi)"
+}], o = [{
+	value: "KG",
+	label: "Kilograms (kg)"
+}, {
+	value: "LB",
+	label: "Pounds (lb)"
+}], s = [
+	{
+		value: "LOW",
+		label: "Low"
+	},
+	{
+		value: "MEDIUM",
+		label: "Normal"
+	},
+	{
+		value: "HIGH",
+		label: "High"
+	},
+	{
+		value: "URGENT",
+		label: "Urgent"
+	},
+	{
+		value: "CRITICAL",
+		label: "Critical"
+	}
+];
+function c(e) {
+	switch (e) {
+		case "LOW": return "low";
+		case "HIGH": return "high";
+		case "URGENT":
+		case "CRITICAL": return "urgent";
+		default: return "normal";
+	}
+}
+var l = [
+	"USD",
+	"EUR",
+	"GBP",
+	"INR",
+	"AED",
+	"SGD",
+	"AUD",
+	"CAD",
+	"JPY",
+	"CNY"
+];
+function u(e) {
+	return typeof Intl.supportedValuesOf == "function" ? Intl.supportedValuesOf(e) : [];
+}
+function d(e) {
+	let t = new Set([...l, ...u("currency")]);
+	e && t.add(e);
+	let n = [...t].filter((e) => !l.includes(e)).sort();
+	return [...l, ...n];
+}
+function f(e) {
+	try {
+		let t = new Intl.DisplayNames(["en"], { type: "currency" }).of(e);
+		return t && t !== e ? `${e} — ${t}` : e;
+	} catch {
+		return e;
+	}
+}
+function p(e) {
+	let t = new Set(["UTC", ...u("timeZone")]);
+	return e && t.add(e), [...t].sort((e, t) => e === "UTC" ? -1 : t === "UTC" ? 1 : e.localeCompare(t));
+}
+function m() {
+	try {
+		return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
+	} catch {
+		return "UTC";
+	}
+}
+function h(e) {
+	let t = Number(e);
+	return !e.trim() || !Number.isInteger(t) || t < 1 || t > 720 ? "Enter a whole number of hours between 1 and 720." : null;
+}
+function g(e, t) {
+	let n = {};
+	return t.defaultCurrency !== void 0 && t.defaultCurrency !== e.defaultCurrency && (n.defaultCurrency = t.defaultCurrency), t.distanceUnit !== void 0 && t.distanceUnit !== e.distanceUnit && (n.distanceUnit = t.distanceUnit), t.weightUnit !== void 0 && t.weightUnit !== e.weightUnit && (n.weightUnit = t.weightUnit), t.timezone !== void 0 && t.timezone !== e.timezone && (n.timezone = t.timezone), t.defaultOrderPriority !== void 0 && t.defaultOrderPriority !== e.defaultOrderPriority && (n.defaultOrderPriority = t.defaultOrderPriority), t.defaultDeliveryWindowHours !== void 0 && t.defaultDeliveryWindowHours !== e.defaultDeliveryWindowHours && (n.defaultDeliveryWindowHours = t.defaultDeliveryWindowHours), n;
+}
+function _(e, t = /* @__PURE__ */ new Date()) {
+	let n = new Date(t.getTime() + e * 3600 * 1e3), r = (e) => String(e).padStart(2, "0");
+	return `${n.getFullYear()}-${r(n.getMonth() + 1)}-${r(n.getDate())}T${r(n.getHours())}:${r(n.getMinutes())}`;
+}
+//#endregion
+export { a as DISTANCE_UNIT_OPTIONS, n as MTW_MODULE_SETTINGS_QUERY, s as ORDER_PRIORITY_OPTIONS, r as UPDATE_MTW_MODULE_SETTINGS_MUTATION, o as WEIGHT_UNIT_OPTIONS, m as browserTimeZone, g as changedSettings, f as currencyLabel, d as currencyOptions, h as deliveryWindowError, _ as deliveryWindowValue, c as orderFormPriority, e as platformDefaults, p as timeZoneOptions, i as toFormatPreferences };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/microfe-movethewheels",
-  "version": "2026.1031.3",
+  "version": "2026.1031.5",
   "description": "Burdenoff MoveTheWheels Microfrontend - Logistics & Supply Chain Management Platform",
   "type": "module",
   "files": [
@@ -37,7 +37,7 @@
     "format": "prettier --write \"src/**/*.{ts,tsx}\"",
     "type:check": "bash scripts/build-limits.sh tsc --noEmit",
     "validate:schema-drift": "graphql-schema-drift",
-    "sanity": "bash scripts/build-limits.sh --gate bash -c 'bun run codegen && bun run validate:schema-drift && bun run lint:sanity && bun run format && bun run type:check && bun run verify:live-logistics-contract && bun run verify:empty-reuse-retry && bun run verify:empty-reuse-recovery && bun run verify:trip-utilization-input && bun run verify:trip-draft-context && bun run verify:stock-binding-input && bun run verify:stock-observation-input && bun run verify:pending-pick-input && bun run verify:pick-review-ack && bun run verify:driver-license-expiry && bun run verify:tracking-alerts && bun run verify:freight-input && bun run verify:freight-recovery && bun run verify:freight-commercial && bun run verify:freight-invoice && bun run verify:procedure-input && bun run verify:consolidation && bun run verify:multimodal-single-attempt && bun run verify:workspace-predispatch && bun run verify:tracking-quality-outcomes && bun run verify:shipment-status-authority && bun run verify:free-time-permissions && bun run verify:core-codegen && bun run verify:order-vehicle-hold && bun run verify:pallet-preview && bun run verify:entity-export && bun run verify:entity-import && bun run verify:consumed-fuel-preview && bun run build && bun run build-storybook'",
+    "sanity": "bash scripts/build-limits.sh --gate bash -c 'bun run codegen && bun run validate:schema-drift && bun run lint:sanity && bun run format && bun run type:check && bun run verify:live-logistics-contract && bun run verify:empty-reuse-retry && bun run verify:empty-reuse-recovery && bun run verify:trip-utilization-input && bun run verify:trip-draft-context && bun run verify:stock-binding-input && bun run verify:stock-observation-input && bun run verify:pending-pick-input && bun run verify:pick-review-ack && bun run verify:driver-license-expiry && bun run verify:tracking-alerts && bun run verify:freight-input && bun run verify:freight-recovery && bun run verify:freight-commercial && bun run verify:freight-invoice && bun run verify:procedure-input && bun run verify:consolidation && bun run verify:multimodal-single-attempt && bun run verify:workspace-predispatch && bun run verify:tracking-quality-outcomes && bun run verify:shipment-status-authority && bun run verify:free-time-permissions && bun run verify:core-codegen && bun run verify:order-vehicle-hold && bun run verify:pallet-preview && bun run verify:entity-export && bun run verify:entity-import && bun run verify:module-settings && bun run verify:consumed-fuel-preview && bun run build && bun run build-storybook'",
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build",
     "test:storybook": "vitest run --project=storybook",
@@ -74,6 +74,7 @@
     "verify:core-codegen": "bun test scripts/codegen.test.ts && node --test scripts/check-package-types.test.mjs",
     "verify:entity-export": "bun test scripts/check-entity-export.test.ts",
     "verify:entity-import": "bun test scripts/check-entity-import.test.ts",
+    "verify:module-settings": "bun test scripts/check-module-settings.test.ts",
     "verify:pallet-preview": "bun test scripts/check-pallet-preview.test.ts && bun scripts/verify-pallet-preview-hook.mjs",
     "verify:consumed-fuel-preview": "bun test scripts/check-consumed-fuel-preview.test.ts && bun scripts/verify-consumed-fuel-preview-hook.mjs && bun scripts/verify-consumed-fuel-preview-component.mjs"
   },

package/src/generated/tracking-quality-operations.ts

@@ -1259,6 +1259,13 @@ export type MtwDemandForecastVariance = {
   volumeVariance: Scalars['Int']['output'];
 };
 
+/** Unit MoveTheWheels shows distances in. */
+export type MtwDistanceUnit =
+  /** Kilometres */
+  | 'KM'
+  /** Miles */
+  | 'MI';
+
 export type MtwDriver = {
   __typename?: 'MtwDriver';
   baseSalary?: Maybe<Scalars['Float']['output']>;
@@ -2700,6 +2707,31 @@ export type MtwMarketplaceStats = {
   verifiedProviders: Scalars['Int']['output'];
 };
 
+/**
+ * Workspace operational defaults for MoveTheWheels (BOFF-10488): how amounts,
+ * distances, weights and times are shown, and what new orders start from.
+ * Company profile, notifications, two-factor authentication and integrations
+ * are platform settings and are not part of this type.
+ */
+export type MtwModuleSettings = {
+  __typename?: 'MtwModuleSettings';
+  /** ISO 4217 code amounts without their own currency are shown in. */
+  defaultCurrency: Scalars['String']['output'];
+  /** Hours from now a new order's suggested delivery time falls (1 to 720). */
+  defaultDeliveryWindowHours: Scalars['Int']['output'];
+  /** Priority a new order starts with. */
+  defaultOrderPriority: DeliveryPriority;
+  distanceUnit: MtwDistanceUnit;
+  /** False until the workspace saves its settings; the values are then the platform defaults. */
+  isCustomized: Scalars['Boolean']['output'];
+  /** IANA time zone dates and times are shown in. Null shows each viewer their own local time. */
+  timezone?: Maybe<Scalars['String']['output']>;
+  updatedAt?: Maybe<Scalars['DateTime']['output']>;
+  updatedBy?: Maybe<Scalars['ID']['output']>;
+  weightUnit: MtwWeightUnit;
+  workspaceId: Scalars['ID']['output'];
+};
+
 export type MtwMoveReviewSource = {
   __typename?: 'MtwMoveReviewSource';
   reference: Scalars['String']['output'];
@@ -4552,6 +4584,13 @@ export type MtwWarehouseStats = {
   total: Scalars['Int']['output'];
 };
 
+/** Unit MoveTheWheels shows weights in. */
+export type MtwWeightUnit =
+  /** Kilograms */
+  | 'KG'
+  /** Pounds */
+  | 'LB';
+
 export type Mutation = {
   __typename?: 'Mutation';
   _empty?: Maybe<Scalars['String']['output']>;
@@ -4658,6 +4697,8 @@ export type Mutation = {
   updateDriverStatus: MtwDriver;
   updateIntegration: MtwIntegration;
   updateInventoryItem: MtwInventoryItem;
+  /** Save the workspace's MoveTheWheels operational defaults. Every field is validated. */
+  updateMtwModuleSettings: MtwModuleSettings;
   updateRoute: MtwRoute;
   updateServiceOffering: MtwServiceOffering;
   updateServiceProvider: MtwServiceProvider;
@@ -5141,6 +5182,11 @@ export type MutationUpdateInventoryItemArgs = {
 };
 
 
+export type MutationUpdateMtwModuleSettingsArgs = {
+  input: UpdateMtwModuleSettingsInput;
+};
+
+
 export type MutationUpdateRouteArgs = {
   id: Scalars['ID']['input'];
   input: UpdateRouteInput;
@@ -5375,6 +5421,8 @@ export type Query = {
    * entity create permission.
    */
   mtwImportSpec: Array<MtwImportEntitySpec>;
+  /** The workspace's MoveTheWheels operational defaults; platform defaults when none were saved. */
+  mtwModuleSettings: MtwModuleSettings;
   mtwPalletGeometryPreview: MtwPalletGeometryPreview;
   mtwPickPreparation: MtwPickPreparation;
   mtwPickReview: MtwPickReview;
@@ -6647,6 +6695,20 @@ export type UpdateInventoryItemInput = {
   unitCost?: InputMaybe<Scalars['Float']['input']>;
 };
 
+/**
+ * Changes to the workspace's MoveTheWheels defaults. Omitted fields keep their
+ * current value. `timezone: null` (or an empty string) clears the time zone so
+ * each viewer sees their own local time.
+ */
+export type UpdateMtwModuleSettingsInput = {
+  defaultCurrency?: InputMaybe<Scalars['String']['input']>;
+  defaultDeliveryWindowHours?: InputMaybe<Scalars['Int']['input']>;
+  defaultOrderPriority?: InputMaybe<DeliveryPriority>;
+  distanceUnit?: InputMaybe<MtwDistanceUnit>;
+  timezone?: InputMaybe<Scalars['String']['input']>;
+  weightUnit?: InputMaybe<MtwWeightUnit>;
+};
+
 export type UpdateRouteInput = {
   actualDistance?: InputMaybe<Scalars['Float']['input']>;
   actualDuration?: InputMaybe<Scalars['Float']['input']>;

package/src/movethewheels/MoveTheWheelsRoot.tsx

@@ -24,8 +24,10 @@ import {
   Bot,
   Store,
   ArrowDownUp,
+  Settings,
 } from 'lucide-react';
 import { MoveTheWheelsProvider } from './providers/MoveTheWheelsProvider';
+import { ModuleSettingsProvider } from './providers/ModuleSettingsProvider';
 import { FeatureFlagProvider } from '@burdenoff/fe-libs/shared/feature-flags';
 import type { NavItem, MoveTheWheelsRootProps } from './types';
 import { MoveTheWheelsRoutes } from './MoveTheWheelsRoutes';
@@ -300,11 +302,20 @@ const NavRegistrar: FC<Pick<MoveTheWheelsRootProps, 'registerNavItems' | 'basePa
         },
         {
           id: 'mtw-ai-assistant',
-          label: tr('movethewheels.root.nav.aiAssistant', 'AI Assistant'),
-          path: joinPath(basePath, 'ai-assistant'),
+          label: tr('movethewheels.root.nav.aiOperations', 'AI Operations'),
+          // Shell-level shared AI operations page (fe-libs AiPage), not an
+          // MFE route — see BOFF-3897.
+          path: '/ai',
           icon: <Bot size={16} />,
           order: 13,
         },
+        {
+          id: 'mtw-settings',
+          label: tr('movethewheels.root.nav.settings', 'Settings'),
+          path: joinPath(basePath, 'settings'),
+          icon: <Settings size={16} />,
+          order: 99,
+        },
       ],
     };
 
@@ -365,9 +376,11 @@ export const MoveTheWheelsRoot: FC<MoveTheWheelsRootProps> = (props) => {
     <FeatureFlagProvider workspaceId={null} gateway="global" defaultEnabled={true}>
       <NavRegistrar registerNavItems={registerNavItems} basePath={basePath} />
       <MoveTheWheelsProvider {...props}>
-        <div className="movethewheels-root h-full">
-          <MoveTheWheelsRoutes />
-        </div>
+        <ModuleSettingsProvider>
+          <div className="movethewheels-root h-full">
+            <MoveTheWheelsRoutes />
+          </div>
+        </ModuleSettingsProvider>
       </MoveTheWheelsProvider>
     </FeatureFlagProvider>
   );

package/src/movethewheels/MoveTheWheelsRoutes.tsx

@@ -5,10 +5,11 @@
  * Uses lazy loading for code splitting.
  */
 
-import { Routes, Route, useNavigate } from 'react-router';
+import { Routes, Route, Navigate, useNavigate } from 'react-router';
 import { lazy, Suspense } from 'react';
 import { NotFoundPage } from '@burdenoff/fe-libs/shared/pages';
 import { useMoveTheWheels } from './providers/MoveTheWheelsProvider';
+import { useModuleSettings } from './providers/ModuleSettingsProvider';
 import { useTr } from './hooks';
 
 /**
@@ -73,6 +74,7 @@ const CustomersPage = lazy(() => import('./pages/CustomersPage'));
 const CustomerDetailsPage = lazy(() => import('./pages/CustomerDetailsPage'));
 const MarketplacePage = lazy(() => import('./pages/MarketplacePage'));
 const ImportExportPage = lazy(() => import('./pages/ImportExportPage'));
+const SettingsPage = lazy(() => import('./pages/SettingsPage'));
 const RoutesPage = lazy(() => import('./pages/RoutesPage'));
 const RouteDetailsPage = lazy(() => import('./pages/RouteDetailsPage'));
 const AnalyticsPage = lazy(() => import('./pages/AnalyticsPage'));
@@ -81,7 +83,6 @@ const FreightEstimatePage = lazy(() => import('./pages/FreightEstimatePage'));
 const FreightInvoicePage = lazy(() => import('./pages/FreightInvoicePage'));
 const ConsolidationPage = lazy(() => import('./pages/ConsolidationPage'));
 const LogisticsProceduresPage = lazy(() => import('./pages/LogisticsProceduresPage'));
-const AIAssistantPage = lazy(() => import('./pages/AIAssistantPage'));
 const DeliveryCapturePage = lazy(() => import('./pages/DeliveryCapturePage'));
 const MultiModalShipmentPage = lazy(() => import('./pages/MultiModalShipmentPage'));
 const ShippingRatesPage = lazy(() => import('./pages/ShippingRatesPage'));
@@ -96,6 +97,10 @@ const ConsumedFuelPreviewPage = lazy(() => import('./pages/ConsumedFuelPreviewPa
 const EmptyReusePage = lazy(() => import('./pages/EmptyReusePage'));
 
 export function MoveTheWheelsRoutes() {
+  // Subscribing here re-renders every page when the workspace's display
+  // defaults load or change, so amounts, units and dates follow them
+  // (BOFF-10488). The value itself is read through the shared formatters.
+  useModuleSettings();
   return (
     <Suspense fallback={<PageLoader />}>
       <Routes>
@@ -164,6 +169,9 @@ export function MoveTheWheelsRoutes() {
         {/* Bulk CSV/JSON import and dataset export (BOFF-3990) */}
         <Route path="import-export" element={<ImportExportPage />} />
 
+        {/* Workspace operational defaults: currency, units, time zone (BOFF-10488) */}
+        <Route path="settings" element={<SettingsPage />} />
+
         {/* Routes */}
         <Route path="routes" element={<RoutesPage />} />
         <Route path="routes/trip-utilization" element={<TripUtilizationPage />} />
@@ -180,8 +188,15 @@ export function MoveTheWheelsRoutes() {
         <Route path="finance/freight-estimates" element={<FreightEstimatePage />} />
         <Route path="finance/freight-invoice-comparisons" element={<FreightInvoicePage />} />
 
-        {/* AI Assistant */}
-        <Route path="ai-assistant" element={<AIAssistantPage />} />
+        {/*
+          AI Operations lives on the shell's shared /ai page (fe-libs AiPage:
+          per-product AI credits, recorded usage by model / surface / trigger,
+          and the workspace model + provider catalog). The old ai-assistant
+          page advertised capabilities the backend never had (BOFF-3897), so
+          this path only redirects existing links and bookmarks there. Chat
+          stays on the shell's AssistantWidget.
+        */}
+        <Route path="ai-assistant" element={<Navigate to="/ai" replace />} />
 
         {/* Catch-all - friendly 404 */}
         <Route path="*" element={<MoveTheWheelsNotFound />} />

package/src/movethewheels/pages/CreateOrderPage.tsx

@@ -4,7 +4,7 @@
  * Form for creating or editing orders.
  */
 
-import { useEffect, useState, type ChangeEvent } from 'react';
+import { useEffect, useRef, useState, type ChangeEvent } from 'react';
 import { useParams, useSearchParams } from 'react-router';
 import {
   Package,
@@ -43,6 +43,8 @@ import { useCustomer, useCustomers } from '../hooks/useCustomers';
 import { useRoute, useRoutes } from '../hooks/useRoutes';
 import { useProducts } from '../hooks/useInventory';
 import { useMoveTheWheels } from '../providers/MoveTheWheelsProvider';
+import { useModuleSettings } from '../providers/ModuleSettingsProvider';
+import { deliveryWindowValue, orderFormPriority } from '../utils/moduleSettings';
 import { joinPath, buildCustomerCreatePath } from '../utils/navigation';
 import { CustomerPicker } from '../components/CustomerPicker';
 import { EntityCombobox } from '../components/EntityCombobox';
@@ -118,11 +120,16 @@ export default function CreateOrderPage() {
   });
 
   const isEditing = !!orderId && !!order;
+  // Workspace defaults for new orders (BOFF-10488).
+  const { settings: moduleSettings } = useModuleSettings();
+  const defaultPriority = orderFormPriority(moduleSettings.defaultOrderPriority);
+  const deliveryWindowHours = moduleSettings.defaultDeliveryWindowHours;
+  const priorityTouched = useRef(false);
 
   const [selectedCustomer, setSelectedCustomer] = useState<Customer | null>(null);
   const [formData, setFormData] = useState({
     customerId: prefilledCustomerId || order?.customerId || '',
-    priority: order?.priority || 'normal',
+    priority: order?.priority || defaultPriority,
     routeId: order?.routeId || '',
     pickupAddress: {
       street: order?.pickupAddress.street || '',
@@ -308,9 +315,19 @@ export default function CreateOrderPage() {
   };
 
   const updateField = (field: string, value: unknown) => {
+    if (field === 'priority') priorityTouched.current = true;
     setFormData((prev) => ({ ...prev, [field]: value }));
   };
 
+  // The workspace defaults usually arrive after the first render; a new order
+  // picks up the default priority unless the user already chose one.
+  useEffect(() => {
+    if (orderId || priorityTouched.current) return;
+    setFormData((prev) =>
+      prev.priority === defaultPriority ? prev : { ...prev, priority: defaultPriority }
+    );
+  }, [orderId, defaultPriority]);
+
   const updateAddress = (
     type: 'pickupAddress' | 'deliveryAddress',
     field: string,
@@ -551,7 +568,9 @@ export default function CreateOrderPage() {
                     <SelectItem value="urgent">Urgent</SelectItem>
                   </SelectContent>
                 </Select>
-                <p className="text-xs text-text-secondary">Normal is selected by default.</p>
+                <p className="text-xs text-text-secondary">
+                  New orders start with this workspace&apos;s default priority.
+                </p>
               </div>
             </div>
           </EmphasisPanel>
@@ -879,9 +898,22 @@ export default function CreateOrderPage() {
                   updateField('scheduledDelivery', e.target.value)
                 }
               />
-              <p className="text-xs text-text-secondary">
-                Leave blank to dispatch as soon as a driver is available.
-              </p>
+              <div className="flex flex-wrap items-center gap-2">
+                <p className="text-xs text-text-secondary">
+                  Leave blank to dispatch as soon as a driver is available.
+                </p>
+                <Button
+                  type="button"
+                  variant="link"
+                  size="sm"
+                  className="h-auto p-0 text-xs"
+                  onClick={() =>
+                    updateField('scheduledDelivery', deliveryWindowValue(deliveryWindowHours))
+                  }
+                >
+                  Use the default window ({deliveryWindowHours} h from now)
+                </Button>
+              </div>
             </div>
             <div className="space-y-2 lg:col-span-1">
               <Label htmlFor="specialInstructions">Special instructions</Label>