diff --git a/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-add.png b/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-add.png
index f5bf551a..f3a5e057 100644
Binary files a/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-add.png and b/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-add.png differ
diff --git a/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-detail.png b/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-detail.png
index 1a5be82a..0cd62c6d 100644
Binary files a/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-detail.png and b/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-detail.png differ
diff --git a/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-edit.png b/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-edit.png
index 53ad9890..80fb28ce 100644
Binary files a/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-edit.png and b/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-edit.png differ
diff --git a/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-empty.png b/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-empty.png
index 888665b5..6487de7d 100644
Binary files a/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-empty.png and b/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-empty.png differ
diff --git a/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-error.png b/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-error.png
index f453475d..36602c27 100644
Binary files a/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-error.png and b/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-error.png differ
diff --git a/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-filter.png b/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-filter.png
index bc5a0bc2..9f45bb9b 100644
Binary files a/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-filter.png and b/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-filter.png differ
diff --git a/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-inactive.png b/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-inactive.png
index 9c1201a3..80bcdb86 100644
Binary files a/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-inactive.png and b/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-inactive.png differ
diff --git a/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-list.png b/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-list.png
index 9ccc65ca..f724fe2d 100644
Binary files a/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-list.png and b/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-list.png differ
diff --git a/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-mobile-navigation.png b/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-mobile-navigation.png
index 50f03dbf..fb262589 100644
Binary files a/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-mobile-navigation.png and b/e2e/__screenshots__/vendors/vendors.visual.spec.ts/vendor-mobile-navigation.png differ
diff --git a/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-detail.png b/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-detail.png
index ffa12f37..fe49083c 100644
Binary files a/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-detail.png and b/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-detail.png differ
diff --git a/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-empty.png b/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-empty.png
index b21a8ded..3fcea96e 100644
Binary files a/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-empty.png and b/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-empty.png differ
diff --git a/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-error.png b/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-error.png
index 907f118a..ca5acc44 100644
Binary files a/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-error.png and b/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-error.png differ
diff --git a/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-filters.png b/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-filters.png
index 97a77e79..c1d2bd63 100644
Binary files a/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-filters.png and b/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-filters.png differ
diff --git a/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-list.png b/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-list.png
index d2e41781..8fb56c7f 100644
Binary files a/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-list.png and b/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-list.png differ
diff --git a/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-mobile-navigation.png b/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-mobile-navigation.png
index d812c670..c046b9c5 100644
Binary files a/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-mobile-navigation.png and b/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-mobile-navigation.png differ
diff --git a/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-new.png b/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-new.png
index 13e7ffe3..35e6b135 100644
Binary files a/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-new.png and b/e2e/__screenshots__/work-orders/work-orders.visual.spec.ts/wo-new.png differ
diff --git a/e2e/work-orders/wo-number-sh-placeholder.spec.ts b/e2e/work-orders/wo-number-sh-placeholder.spec.ts
new file mode 100644
index 00000000..f2211583
--- /dev/null
+++ b/e2e/work-orders/wo-number-sh-placeholder.spec.ts
@@ -0,0 +1,121 @@
+import { expect, test, type Page, type Route } from "@playwright/test";
+
+const FROZEN_NOW = "2026-08-19T15:00:00.000Z";
+
+const TEST_USER = {
+ token: "wo-number-sh-placeholder-e2e-token",
+ expiration: "2030-01-01T00:00:00.000Z",
+ email: "admin@seahavenind.com",
+ userRoles: "Admin",
+ phoneNumber: "5551234567",
+ fullname: "Work Order E2E Admin",
+ id: "1",
+};
+
+async function fulfillJson(route: Route, body: unknown, status = 200) {
+ await route.fulfill({ status, contentType: "application/json", body: JSON.stringify(body) });
+}
+
+async function hideQueryDevtools(page: Page) {
+ await page.addStyleTag({
+ content:
+ ".tsqd-parent-container { display: none !important; pointer-events: none !important; }",
+ });
+ await page.locator(".tsqd-parent-container").evaluateAll((nodes) => {
+ for (const node of nodes) {
+ node.remove();
+ }
+ });
+}
+
+const REAL_ROW = {
+ id: 1000,
+ woNumber: "12345678901",
+ workOrderType: 2,
+ siteCode: "DAL1",
+ lifecycleStatusLabel: "Scheduled",
+ scheduledDate: "2026-08-19",
+ dispatcherId: "1",
+ dispatcherName: "Pat Dispatcher",
+ pm: "HVAC",
+};
+
+async function mockBoard(page: Page, patches: unknown[]) {
+ await page.route(
+ (url) => url.pathname.startsWith("/api/"),
+ async (route) => {
+ const request = route.request();
+ const url = request.url();
+ if (request.method() !== "GET") {
+ patches.push({ url, body: request.postDataJSON() });
+ await fulfillJson(route, {}, 500);
+ return;
+ }
+ if (url.includes("workorders/board/search")) {
+ await fulfillJson(route, { items: [REAL_ROW], totalCount: 1, page: 0, pageSize: 50 });
+ return;
+ }
+ if (url.includes("workorders/board")) {
+ await fulfillJson(route, {
+ weekStart: "2026-08-17",
+ weekEnd: "2026-08-21",
+ counts: { returned: 1, total: 1 },
+ unscheduled: [],
+ scheduled: [REAL_ROW],
+ });
+ return;
+ }
+ await fulfillJson(route, { data: [], items: [] });
+ },
+ );
+}
+
+test.describe("inline WO number SH placeholder", () => {
+ test.setTimeout(60_000);
+
+ test.beforeEach(async ({ page }) => {
+ await page.clock.install({ time: new Date(FROZEN_NOW) });
+ await page.clock.resume();
+ await page.addInitScript((user) => {
+ localStorage.setItem("auth", JSON.stringify(user));
+ }, TEST_USER);
+ });
+
+ test("keeps a typed SH number on a new inline row and blocks downgrading a saved real number", async ({
+ page,
+ }) => {
+ const mutations: unknown[] = [];
+ await mockBoard(page, mutations);
+ await page.goto("/workorders");
+ await hideQueryDevtools(page);
+ await expect(page.getByRole("heading", { name: "Work Orders" })).toBeVisible({
+ timeout: 20_000,
+ });
+ await expect(page.getByText("12345678901").first()).toBeVisible();
+
+ await page
+ .getByRole("button", { name: /Add WO/ })
+ .first()
+ .click();
+ await page
+ .getByText(/^Insert WO #/)
+ .first()
+ .click();
+ const draftInput = page.getByLabel("Work order number");
+ await draftInput.fill("SH00001");
+ await draftInput.press("Enter");
+ await expect(draftInput).toHaveCount(0);
+ await expect(page.getByText("SH00001", { exact: true })).toBeVisible();
+ await expect(page.getByText(/must be 11 digits/)).toHaveCount(0);
+
+ await page.getByText("12345678901", { exact: true }).first().click();
+ const savedInput = page.getByLabel("Work order number");
+ await savedInput.fill("SH00009");
+ await savedInput.press("Enter");
+ await expect(
+ page.getByText("Cannot replace an APM work order number with an internal number"),
+ ).toBeVisible();
+ await expect(page.getByText("12345678901", { exact: true }).first()).toBeVisible();
+ expect(mutations).toEqual([]);
+ });
+});
diff --git a/e2e/work-orders/work-orders.visual.spec.ts b/e2e/work-orders/work-orders.visual.spec.ts
index 547723a6..17f8d49b 100644
--- a/e2e/work-orders/work-orders.visual.spec.ts
+++ b/e2e/work-orders/work-orders.visual.spec.ts
@@ -204,6 +204,12 @@ async function openWorkOrderPage(page: Page, mode: "default" | "empty" | "error"
});
}
+async function expectWorkOrderPageReady(page: Page) {
+ await expect(page.getByRole("heading", { name: "Work Orders" })).toBeVisible({
+ timeout: 90_000,
+ });
+}
+
async function expectStableScreenshot(page: Page, name: string) {
await page.waitForTimeout(250);
await page.evaluate(
@@ -217,15 +223,18 @@ async function expectStableScreenshot(page: Page, name: string) {
}
test.describe("Work Orders deterministic pixel regression", () => {
+ test.setTimeout(120_000);
+
test("list", async ({ page }) => {
await openWorkOrderPage(page);
- await expect(page.getByRole("heading", { name: "Work Orders" })).toBeVisible();
+ await expectWorkOrderPageReady(page);
await expect(page.getByText("WO-501").first()).toBeVisible();
await expectStableScreenshot(page, "wo-list.png");
});
test("filters", async ({ page }) => {
await openWorkOrderPage(page);
+ await expectWorkOrderPageReady(page);
await page.getByRole("button", { name: "Advanced Filters" }).click();
await expect(page.getByRole("dialog", { name: "Advanced Filters" })).toBeVisible();
await expectStableScreenshot(page, "wo-filters.png");
@@ -233,6 +242,7 @@ test.describe("Work Orders deterministic pixel regression", () => {
test("new", async ({ page }) => {
await openWorkOrderPage(page);
+ await expectWorkOrderPageReady(page);
await page.getByRole("button", { name: "New WO" }).click();
await expect(page.getByRole("heading", { name: "Type & schedule" })).toBeVisible();
await expectStableScreenshot(page, "wo-new.png");
@@ -240,6 +250,7 @@ test.describe("Work Orders deterministic pixel regression", () => {
test("detail", async ({ page }) => {
await openWorkOrderPage(page);
+ await expectWorkOrderPageReady(page);
const row = page.locator("#wo-row-1");
await row.hover();
await row.getByRole("button", { name: "View details" }).click();
@@ -249,7 +260,7 @@ test.describe("Work Orders deterministic pixel regression", () => {
test("empty", async ({ page }) => {
await openWorkOrderPage(page, "empty");
- await expect(page.getByRole("heading", { name: "Work Orders" })).toBeVisible();
+ await expectWorkOrderPageReady(page);
await page.getByLabel("Search work orders").fill("zz");
await expect(page.getByText("No work orders match your search")).toBeVisible();
await expectStableScreenshot(page, "wo-empty.png");
@@ -257,7 +268,7 @@ test.describe("Work Orders deterministic pixel regression", () => {
test("error", async ({ page }) => {
await openWorkOrderPage(page, "error");
- await expect(page.getByRole("heading", { name: "Work Orders" })).toBeVisible();
+ await expectWorkOrderPageReady(page);
const alert = page.getByRole("main").getByRole("alert");
await expect(alert).toBeVisible();
await expect(alert).toContainText(/server error/i);
@@ -267,6 +278,7 @@ test.describe("Work Orders deterministic pixel regression", () => {
test("mobile", async ({ page }) => {
await page.setViewportSize({ width: 390, height: 844 });
await openWorkOrderPage(page);
+ await expectWorkOrderPageReady(page);
await expect(page.getByText("WO-501").first()).toBeVisible();
await expectStableScreenshot(page, "wo-mobile.png");
diff --git a/src/api/api-paths.ts b/src/api/api-paths.ts
index 33db519b..9b9e3e33 100644
--- a/src/api/api-paths.ts
+++ b/src/api/api-paths.ts
@@ -77,6 +77,9 @@ export const API_PATHS = {
deleteEmployees: "Employee/DeleteEmployees",
dropdown: "Employee/Dropdown",
},
+ teamMember: {
+ getList: "User",
+ },
contact: {
getList: "Contact/GetContactList",
getContacts: "Contact/GetContacts",
@@ -155,6 +158,9 @@ export const API_PATHS = {
update: "DropdownOptions/Update",
delete: "DropdownOptions",
},
+ services: {
+ list: "services",
+ },
user: {
list: "User",
},
diff --git a/src/app/(protected)/team-members/_components/team-members-table.tsx b/src/app/(protected)/team-members/_components/team-members-table.tsx
new file mode 100644
index 00000000..125fa434
--- /dev/null
+++ b/src/app/(protected)/team-members/_components/team-members-table.tsx
@@ -0,0 +1,110 @@
+import {
+ Avatar,
+ Button,
+ CircularProgress,
+ Paper,
+ Table,
+ TableBody,
+ TableCell,
+ TableContainer,
+ TableHead,
+ TableRow,
+ Typography,
+} from "@mui/material";
+import type { TeamMemberListItem } from "@/domain/team-members/types/team-member";
+
+const HEADINGS = ["Team Member", "Role", "Service Area", "Phone", "Email", "Color", "Status"];
+
+function memberStatusLabel(status: TeamMemberListItem["status"]) {
+ return status === "Active" ? "Active" : "Inactive";
+}
+
+export function TeamMembersTable({
+ rows,
+ isLoading,
+ hasError,
+ tab,
+ onOpen,
+}: {
+ rows: TeamMemberListItem[];
+ isLoading: boolean;
+ hasError: boolean;
+ tab: "active" | "inactive";
+ onOpen: (member: TeamMemberListItem) => void;
+}) {
+ return (
+
+
+
+
+ {HEADINGS.map((heading) => (
+
+ {heading}
+
+ ))}
+
+ Actions
+
+
+
+
+ {isLoading ? (
+
+
+
+
+
+ ) : hasError ? (
+
+
+ Unable to load team members
+
+ Check your connection and try again.
+
+
+
+ ) : rows.length === 0 ? (
+
+
+ No {tab} team members found
+
+ Try a different search, or add a new team member.
+
+
+
+ ) : (
+ rows.map((member) => (
+ onOpen(member)}
+ sx={{ cursor: "pointer" }}
+ >
+ {member.name || "—"}
+ {member.role || "—"}
+ {member.serviceArea || "—"}
+ {member.phone || "—"}
+ {member.email || "—"}
+
+
+
+ {memberStatusLabel(member.status)}
+
+
+
+
+ ))
+ )}
+
+
+
+ );
+}
diff --git a/src/app/(protected)/team-members/index.tsx b/src/app/(protected)/team-members/index.tsx
new file mode 100644
index 00000000..8ce620a3
--- /dev/null
+++ b/src/app/(protected)/team-members/index.tsx
@@ -0,0 +1,193 @@
+import { useState } from "react";
+import { useDebounce } from "@/hooks/use-debounce";
+import { useTeamMembersList } from "@/domain/team-members/use-cases/use-team-members-list";
+import type { TeamMemberListItem } from "@/domain/team-members/types/team-member";
+import {
+ Alert,
+ Avatar,
+ Box,
+ Button,
+ Chip,
+ Dialog,
+ DialogActions,
+ DialogContent,
+ DialogTitle,
+ Drawer,
+ IconButton,
+ Stack,
+ Tab,
+ Tabs,
+ TextField,
+ Typography,
+} from "@mui/material";
+import CloseIcon from "@mui/icons-material/Close";
+import { TeamMembersTable } from "./_components/team-members-table";
+
+type StatusTab = "active" | "inactive";
+
+const STATUS_LABELS: Record = {
+ active: "Active",
+ inactive: "Inactive",
+};
+
+function MemberStatus({ status }: { status: TeamMemberListItem["status"] }) {
+ return ;
+}
+
+function TeamMemberDrawer({
+ member,
+ onClose,
+}: {
+ member: TeamMemberListItem | null;
+ onClose: () => void;
+}) {
+ return (
+
+
+
+ Team Member
+
+
+
+
+ {member !== null && (
+
+
+
+ {member.name.slice(0, 1).toUpperCase() || "?"}
+
+
+ {member.name || "—"}
+ {member.role || "—"}
+
+
+
+
+ Service Area: {member.serviceArea || "—"}
+
+
+ Phone: {member.phone || "—"}
+
+
+ Email: {member.email || "—"}
+
+
+ )}
+
+
+ );
+}
+
+export default function TeamMembersListPage() {
+ const [search, setSearch] = useState("");
+ const [tab, setTab] = useState("active");
+ const [selectedMember, setSelectedMember] = useState(null);
+ const [addMemberOpen, setAddMemberOpen] = useState(false);
+ const debouncedSearch = useDebounce(search, 300).trim().toLowerCase();
+ const { data, isLoading, error } = useTeamMembersList();
+ const allMembers = data?.items ?? [];
+
+ const activeCount = allMembers.filter((member) => member.status === "Active").length;
+ const inactiveCount = allMembers.length - activeCount;
+ const rows = allMembers
+ .filter((member) => member.status === STATUS_LABELS[tab])
+ .filter((member) => !debouncedSearch || member.name.toLowerCase().includes(debouncedSearch));
+
+ return (
+
+
+
+
+ Team Members
+
+
+ {allMembers.length} team member{allMembers.length === 1 ? "" : "s"} · {activeCount}{" "}
+ active
+
+
+
+ setSearch(event.target.value)}
+ placeholder="Search team member…"
+ aria-label="Search team member"
+ sx={{ width: 224 }}
+ />
+
+
+
+
+ setTab(value)}
+ aria-label="Team member status"
+ >
+
+
+
+
+ {Boolean(error) && (
+
+ {error instanceof Error ? error.message : "Failed to load team members"}
+
+ )}
+
+
+
+
+
+
+
+ {rows.length} {tab} team member{rows.length === 1 ? "" : "s"}
+ {debouncedSearch ? " · filtered" : ""}
+
+
+ {activeCount} active · {inactiveCount} inactive
+
+
+
+ setSelectedMember(null)} />
+
+
+ );
+}
diff --git a/src/app/(protected)/workorders/_components/list/table/build-inline-draft-create-input.ts b/src/app/(protected)/workorders/_components/list/table/build-inline-draft-create-input.ts
index 2e6dceb9..0058d354 100644
--- a/src/app/(protected)/workorders/_components/list/table/build-inline-draft-create-input.ts
+++ b/src/app/(protected)/workorders/_components/list/table/build-inline-draft-create-input.ts
@@ -28,6 +28,7 @@ export function buildInlineDraftCreateInput(
scheduledOn: draft.scheduledOn,
dueDate: draft.dueDate,
pm: draft.pm,
+ serviceId: null,
extraServices: draft.extraServices ?? [],
avetaRequired: Boolean(draft.avetaRequired),
pmNote: draft.serviceNotes ?? "",
diff --git a/src/app/(protected)/workorders/_components/list/table/cells/editable-wo-number-cell.tsx b/src/app/(protected)/workorders/_components/list/table/cells/editable-wo-number-cell.tsx
index 39744598..9273a5e8 100644
--- a/src/app/(protected)/workorders/_components/list/table/cells/editable-wo-number-cell.tsx
+++ b/src/app/(protected)/workorders/_components/list/table/cells/editable-wo-number-cell.tsx
@@ -3,6 +3,12 @@ import { toast } from "react-toastify";
import { workOrdersApi } from "@/domain/work-orders/api/work-orders-api";
import type { WorkOrderTableRow } from "@/domain/work-orders/types/work-order-table-row";
import { findDuplicateWoNumberRow } from "@/domain/work-orders/utils/find-duplicate-wo-number-row";
+import {
+ WO_NUMBER_DOWNGRADE_MESSAGE,
+ WO_NUMBER_FORMAT_MESSAGE,
+ isValidBoardWoNumber,
+ isWoNumberDowngrade,
+} from "@/domain/work-orders/utils/wo-number-input";
import { EditableWONumberInput } from "./editable-wo-number-input";
import { HighlightText } from "./highlight-text";
import { AddOnPill, CarriedOverCounterPill, RescheduleCounterPill } from "./wo-counter-pills";
@@ -26,6 +32,9 @@ type EditableWONumberCellProps = {
requiredPlaceholder?: string;
};
+/** Inline-create rows pass this id; their number is draft state, never a saved WO number. */
+const UNSAVED_DRAFT_ID = "draft";
+
async function resolveDuplicateWoNumber(
draft: string,
allOrders: WorkOrderTableRow[],
@@ -88,8 +97,14 @@ export function EditableWONumberCell({
setEditing(false);
return;
}
- if (draft.length !== 11) {
- toast("Work order number must be exactly 11 digits");
+ if (!isValidBoardWoNumber(draft)) {
+ toast(WO_NUMBER_FORMAT_MESSAGE);
+ return;
+ }
+ if (String(currentId) !== UNSAVED_DRAFT_ID && isWoNumberDowngrade(value, draft)) {
+ toast.error(WO_NUMBER_DOWNGRADE_MESSAGE);
+ setDraft(value);
+ setEditing(false);
return;
}
setIsChecking(true);
@@ -122,14 +137,14 @@ export function EditableWONumberCell({
const handleBlur = () => {
if (isChecking) return;
- if (draft !== value && draft.length === 11) {
+ if (draft !== value && isValidBoardWoNumber(draft)) {
commit();
return;
}
setEditing(false);
};
- const invalid = editing && draft.length > 0 && draft.length !== 11;
+ const invalid = editing && draft.length > 0 && !isValidBoardWoNumber(draft);
if (locked) {
return (
diff --git a/src/app/(protected)/workorders/_components/list/table/cells/editable-wo-number-input.tsx b/src/app/(protected)/workorders/_components/list/table/cells/editable-wo-number-input.tsx
index f4becca8..1ef6512e 100644
--- a/src/app/(protected)/workorders/_components/list/table/cells/editable-wo-number-input.tsx
+++ b/src/app/(protected)/workorders/_components/list/table/cells/editable-wo-number-input.tsx
@@ -1,3 +1,5 @@
+import { sanitizeBoardWoNumberInput } from "@/domain/work-orders/utils/wo-number-input";
+
type EditableWONumberInputProps = {
draft: string;
invalid: boolean;
@@ -21,9 +23,8 @@ export function EditableWONumberInput({
onChange(event.target.value.replace(/\D/g, "").slice(0, 11))}
+ onChange={(event) => onChange(sanitizeBoardWoNumberInput(event.target.value))}
onFocus={(event) => event.target.select()}
onClick={(event) => event.stopPropagation()}
onKeyDown={(event) => {
@@ -36,7 +37,7 @@ export function EditableWONumberInput({
}
}}
onBlur={onBlur ?? onCommit}
- placeholder="12345678901"
+ placeholder="e.g. 12345678901 or SH00001"
aria-label="Work order number"
aria-invalid={invalid}
className="font-mono focus:outline-none"
diff --git a/src/app/(protected)/workorders/_components/list/table/cells/pm-type-picker-popover.tsx b/src/app/(protected)/workorders/_components/list/table/cells/pm-type-picker-popover.tsx
index 1df4a262..8f7d75a6 100644
--- a/src/app/(protected)/workorders/_components/list/table/cells/pm-type-picker-popover.tsx
+++ b/src/app/(protected)/workorders/_components/list/table/cells/pm-type-picker-popover.tsx
@@ -39,7 +39,7 @@ export function PmTypePickerPopover({
autoFocus
value={search}
onChange={(e) => onSearchChange(e.target.value)}
- placeholder="Search PM type…"
+ placeholder="Search service…"
className="w-full rounded border border-border bg-[var(--color-bg-surface)] px-2 py-1 text-xs text-[var(--color-text-primary)] focus:outline-none"
/>
diff --git a/src/app/(protected)/workorders/_components/wizard/new-wo-wizard.tsx b/src/app/(protected)/workorders/_components/wizard/new-wo-wizard.tsx
index 4d92a8f0..039770ac 100644
--- a/src/app/(protected)/workorders/_components/wizard/new-wo-wizard.tsx
+++ b/src/app/(protected)/workorders/_components/wizard/new-wo-wizard.tsx
@@ -82,7 +82,10 @@ export function NewWoWizard({
locationDetail={wizard.locationDetail}
locationDetailLoading={wizard.locationDetailLoading}
locationDetailError={wizard.locationDetailError}
- services={wizard.problems.map((p) => ({ id: p.id, value: p.value }))}
+ services={wizard.services.map((service) => ({
+ id: service.id,
+ value: service.name,
+ }))}
showErrors={wizard.showErrors}
svcOpen={wizard.svcOpen}
onSvcOpenChange={wizard.setSvcOpen}
diff --git a/src/app/(protected)/workorders/_components/wizard/use-new-wo-wizard-controller.ts b/src/app/(protected)/workorders/_components/wizard/use-new-wo-wizard-controller.ts
index 908c6d1a..0a5f394b 100644
--- a/src/app/(protected)/workorders/_components/wizard/use-new-wo-wizard-controller.ts
+++ b/src/app/(protected)/workorders/_components/wizard/use-new-wo-wizard-controller.ts
@@ -2,8 +2,6 @@ import { useEffect } from "react";
import { guardDialogClose } from "@/lib/dialog-guard";
-import { useDropdownOptionsByCategory } from "@/domain/settings/dropdown-options/use-cases/use-dropdown-options-by-category";
-
import type { WorkOrderTableRow } from "@/domain/work-orders/types/work-order-table-row";
import type { WorkOrderWizardDraft } from "@/domain/work-orders/types/work-order-wizard";
@@ -16,6 +14,7 @@ import { useCreateWorkOrderFromWizard } from "@/domain/work-orders/use-cases/use
import { useNewWoWizardDraft } from "@/app/(protected)/workorders/_components/wizard/use-new-wo-wizard-draft";
import { useWizardDuplicateActions } from "@/app/(protected)/workorders/_components/wizard/use-wizard-duplicate-actions";
import { useWizardPocAutofill } from "@/app/(protected)/workorders/_components/wizard/use-wizard-poc-autofill";
+import { useServicesForWorkOrderType } from "@/domain/services/use-cases/use-services-for-work-order-type";
type UseNewWoWizardControllerArgs = {
open: boolean;
@@ -32,7 +31,7 @@ export function useNewWoWizardController({
const draftState = useNewWoWizardDraft(open);
const { data: locations = [] } = useLocationSites();
- const { data: problems = [] } = useDropdownOptionsByCategory("Problem");
+ const { data: registryServices = [] } = useServicesForWorkOrderType(draftState.draft.type);
const {
data: locationDetail,
isLoading: locationDetailLoading,
@@ -78,7 +77,7 @@ export function useNewWoWizardController({
...draftState,
patchDraft,
locations,
- problems,
+ services: registryServices,
locationDetail,
locationDetailLoading,
locationDetailError,
diff --git a/src/app/(protected)/workorders/_components/wizard/wizard-step-location-service-select.tsx b/src/app/(protected)/workorders/_components/wizard/wizard-step-location-service-select.tsx
index bfefcf5d..baadd66e 100644
--- a/src/app/(protected)/workorders/_components/wizard/wizard-step-location-service-select.tsx
+++ b/src/app/(protected)/workorders/_components/wizard/wizard-step-location-service-select.tsx
@@ -32,8 +32,10 @@ export function WizardStepLocationServiceSelect({
nextPm !== draft.pm ? { vendorId: "", vendorName: "", techPhone: "" } : {};
const selectSvc = (p: string) => {
+ const selected = services.find((service) => service.value === p);
onPatch({
pm: p,
+ serviceId: selected?.id ?? null,
extraServices: [],
...clearVendorIfPrimaryChanged(p),
});
@@ -48,7 +50,7 @@ export function WizardStepLocationServiceSelect({
icon={
}
- searchPlaceholder="Search PM type…"
+ searchPlaceholder="Search services…"
options={services.map((s) => {
const Icon = getPmTypeIcon(s.value);
return {
diff --git a/src/app/(protected)/workorders/_components/wizard/wizard-step-type-schedule.tsx b/src/app/(protected)/workorders/_components/wizard/wizard-step-type-schedule.tsx
index 400ad771..7a655742 100644
--- a/src/app/(protected)/workorders/_components/wizard/wizard-step-type-schedule.tsx
+++ b/src/app/(protected)/workorders/_components/wizard/wizard-step-type-schedule.tsx
@@ -270,9 +270,23 @@ export function WizardStepTypeSchedule({
{
+ const typeChanged = t !== draft.type;
onPatch({
type: t,
severity: nextSeverityForType(draft.type, t, draft.severity),
+ // A registry service is scoped to its work-order type, so a service picked
+ // under the previous type fails backend ResolveServiceAsync (SH-187/#131).
+ // Clear the service (and its vendor, filtered by the service) on a type change.
+ ...(typeChanged
+ ? {
+ pm: "",
+ serviceId: null,
+ extraServices: [],
+ vendorId: "",
+ vendorName: "",
+ techPhone: "",
+ }
+ : {}),
});
}}
/>
diff --git a/src/config/menu.ts b/src/config/menu.ts
index 3974c0dc..c5b6fce4 100644
--- a/src/config/menu.ts
+++ b/src/config/menu.ts
@@ -10,6 +10,7 @@ import {
Bell,
BarChart3,
Star,
+ Users,
} from "lucide-react";
export type NavItemDef = {
@@ -58,6 +59,10 @@ export const navGroups: NavGroup[] = [
{ label: "Sites", icon: MapPin, path: "/locations" },
],
},
+ {
+ title: "TEAM",
+ items: [{ label: "Team Members", icon: Users, path: "/team-members" }],
+ },
// {
// title: "INTERNAL",
// items: [{ label: "Documents", icon: FileText, path: "/documents" }],
diff --git a/src/domain/services/api/services-api.ts b/src/domain/services/api/services-api.ts
new file mode 100644
index 00000000..58ba217c
--- /dev/null
+++ b/src/domain/services/api/services-api.ts
@@ -0,0 +1,30 @@
+import { apiGet } from "@/api/api";
+import { API_PATHS } from "@/api/api-paths";
+import { handleApiResponse } from "@/api/handle-api-response";
+import { mapServices } from "@/domain/services/mappers/service-mapper";
+import type { Service } from "@/domain/services/types/service";
+import { WORK_ORDER_TYPE_API } from "@/domain/work-orders/types/work-order-board";
+import type { WOType } from "@/domain/work-orders/types/work-order-wizard";
+
+const TYPE_TO_API: Record, number> = {
+ PM: WORK_ORDER_TYPE_API.PM,
+ Reactive: WORK_ORDER_TYPE_API.Reactive,
+ Emergency: WORK_ORDER_TYPE_API.Emergency,
+};
+
+export const servicesApi = {
+ getActive: async (): Promise => {
+ const data = await apiGet(API_PATHS.services.list, {
+ searchParams: { isActive: true },
+ });
+ return mapServices(handleApiResponse(data));
+ },
+
+ getActiveForWorkOrderType: async (workOrderType: WOType): Promise => {
+ if (workOrderType === "Overdue") return [];
+ const data = await apiGet(API_PATHS.services.list, {
+ searchParams: { isActive: true, workOrderType: TYPE_TO_API[workOrderType] },
+ });
+ return mapServices(handleApiResponse(data));
+ },
+};
diff --git a/src/domain/services/mappers/service-mapper.ts b/src/domain/services/mappers/service-mapper.ts
new file mode 100644
index 00000000..4b6d6f6e
--- /dev/null
+++ b/src/domain/services/mappers/service-mapper.ts
@@ -0,0 +1,71 @@
+import type { Service } from "@/domain/services/types/service";
+import type { WOType } from "@/domain/work-orders/types/work-order-wizard";
+
+function asRecord(raw: unknown): Record {
+ return typeof raw === "object" && raw !== null ? (raw as Record) : {};
+}
+
+function readId(item: Record): string | number {
+ const value = item.id ?? item.Id;
+ return typeof value === "string" || typeof value === "number" ? value : "";
+}
+
+function readString(item: Record, ...keys: string[]): string {
+ for (const key of keys) {
+ const value = item[key];
+ if (typeof value === "string") return value.trim();
+ }
+ return "";
+}
+
+function readBool(item: Record, ...keys: string[]): boolean {
+ for (const key of keys) {
+ const value = item[key];
+ if (typeof value === "boolean") return value;
+ }
+ return false;
+}
+
+function mapWorkOrderType(value: unknown): WOType | null {
+ if (typeof value === "number") {
+ return value === 2 ? "PM" : value === 3 ? "Emergency" : value === 6 ? "Reactive" : null;
+ }
+ if (typeof value === "string") {
+ const normalized = value.trim().toLowerCase();
+ return normalized === "pm" || normalized === "preventivemaintenance"
+ ? "PM"
+ : normalized === "emergency"
+ ? "Emergency"
+ : normalized === "reactive"
+ ? "Reactive"
+ : null;
+ }
+ return null;
+}
+
+export function mapService(raw: unknown): Service {
+ const item = asRecord(raw);
+ const types = item.supportedWorkOrderTypes ?? item.SupportedWorkOrderTypes;
+ return {
+ id: readId(item),
+ name: readString(item, "name", "Name"),
+ trade: readString(item, "trade", "Trade"),
+ iconKey: readString(item, "iconKey", "IconKey"),
+ requiresCompletionDocument: readBool(
+ item,
+ "requiresCompletionDocument",
+ "RequiresCompletionDocument",
+ ),
+ isActive: readBool(item, "isActive", "IsActive"),
+ supportedWorkOrderTypes: Array.isArray(types)
+ ? types.flatMap((value) => {
+ const mapped = mapWorkOrderType(value);
+ return mapped ? [mapped] : [];
+ })
+ : [],
+ };
+}
+
+export function mapServices(raw: unknown): Service[] {
+ return Array.isArray(raw) ? raw.map(mapService).filter((service) => service.id !== "") : [];
+}
diff --git a/src/domain/services/types/service.ts b/src/domain/services/types/service.ts
new file mode 100644
index 00000000..fa7a87d9
--- /dev/null
+++ b/src/domain/services/types/service.ts
@@ -0,0 +1,11 @@
+import type { WOType } from "@/domain/work-orders/types/work-order-wizard";
+
+export interface Service {
+ id: string | number;
+ name: string;
+ trade: string;
+ iconKey: string;
+ requiresCompletionDocument: boolean;
+ isActive: boolean;
+ supportedWorkOrderTypes: WOType[];
+}
diff --git a/src/domain/services/use-cases/use-services-for-work-order-type.ts b/src/domain/services/use-cases/use-services-for-work-order-type.ts
new file mode 100644
index 00000000..6dd8d4ac
--- /dev/null
+++ b/src/domain/services/use-cases/use-services-for-work-order-type.ts
@@ -0,0 +1,25 @@
+import { useQuery, type UseQueryResult } from "@tanstack/react-query";
+import { servicesApi } from "@/domain/services/api/services-api";
+import type { Service } from "@/domain/services/types/service";
+import type { WOType } from "@/domain/work-orders/types/work-order-wizard";
+import { queryKeys } from "@/infra/query-key/query-key";
+
+export function useServicesForWorkOrderType(
+ workOrderType: WOType | "",
+): UseQueryResult {
+ const effectiveType = workOrderType || "PM";
+ return useQuery({
+ queryKey: queryKeys.services.byWorkOrderType(effectiveType),
+ queryFn: () => servicesApi.getActiveForWorkOrderType(effectiveType),
+ enabled: effectiveType !== "Overdue",
+ staleTime: 60 * 1000,
+ });
+}
+
+export function useActiveServices(): UseQueryResult {
+ return useQuery({
+ queryKey: queryKeys.services.active(),
+ queryFn: () => servicesApi.getActive(),
+ staleTime: 60 * 1000,
+ });
+}
diff --git a/src/domain/team-members/api/team-members-api.ts b/src/domain/team-members/api/team-members-api.ts
new file mode 100644
index 00000000..9b58b486
--- /dev/null
+++ b/src/domain/team-members/api/team-members-api.ts
@@ -0,0 +1,13 @@
+import { apiGet } from "@/api/api";
+import { API_PATHS } from "@/api/api-paths";
+import { handleApiResponse } from "@/api/handle-api-response";
+import { mapTeamMemberListItems } from "@/domain/team-members/mappers/team-member-mapper";
+import type { TeamMemberListResult } from "@/domain/team-members/types/team-member";
+
+export const teamMembersApi = {
+ getList: async (): Promise => {
+ const data = await apiGet(API_PATHS.teamMember.getList);
+ const items = handleApiResponse(data);
+ return { items: mapTeamMemberListItems(Array.isArray(items) ? items : []) };
+ },
+};
diff --git a/src/domain/team-members/mappers/team-member-mapper.ts b/src/domain/team-members/mappers/team-member-mapper.ts
new file mode 100644
index 00000000..ada426ce
--- /dev/null
+++ b/src/domain/team-members/mappers/team-member-mapper.ts
@@ -0,0 +1,45 @@
+import type { TeamMemberListItem } from "@/domain/team-members/types/team-member";
+
+function readString(record: Record, ...keys: string[]): string {
+ for (const key of keys) {
+ const value = record[key];
+ if (typeof value === "string") return value;
+ if (typeof value === "number") return String(value);
+ }
+ return "";
+}
+
+function readBoolean(record: Record, ...keys: string[]): boolean {
+ for (const key of keys) {
+ const value = record[key];
+ if (typeof value === "boolean") return value;
+ if (typeof value === "string") return value.toLowerCase() === "true";
+ }
+ return false;
+}
+
+export function mapTeamMemberListItem(raw: unknown): TeamMemberListItem {
+ const record = (typeof raw === "object" && raw !== null ? raw : {}) as Record;
+ const id = record.id ?? record.Id;
+ const status =
+ readString(record, "status", "Status").toLowerCase() === "inactive" ||
+ readBoolean(record, "isDeleted", "IsDeleted")
+ ? "Inactive"
+ : "Active";
+
+ return {
+ id: typeof id === "string" || typeof id === "number" ? id : "",
+ name: readString(record, "name", "Name"),
+ role: readString(record, "role", "Role", "roleName", "RoleName"),
+ serviceArea: readString(record, "serviceArea", "ServiceArea", "locations", "Locations"),
+ phone: readString(record, "phone", "Phone"),
+ email: readString(record, "email", "Email"),
+ color: readString(record, "color", "Color"),
+ status,
+ isAccountOwner: readBoolean(record, "isAccountOwner", "IsAccountOwner"),
+ };
+}
+
+export function mapTeamMemberListItems(rawItems: unknown[]): TeamMemberListItem[] {
+ return rawItems.map(mapTeamMemberListItem);
+}
diff --git a/src/domain/team-members/types/team-member.ts b/src/domain/team-members/types/team-member.ts
new file mode 100644
index 00000000..9aafdb97
--- /dev/null
+++ b/src/domain/team-members/types/team-member.ts
@@ -0,0 +1,15 @@
+export interface TeamMemberListItem {
+ id: string | number;
+ name: string;
+ role: string;
+ serviceArea: string;
+ phone: string;
+ email: string;
+ color: string;
+ status: "Active" | "Inactive";
+ isAccountOwner: boolean;
+}
+
+export interface TeamMemberListResult {
+ items: TeamMemberListItem[];
+}
diff --git a/src/domain/team-members/use-cases/use-team-members-list.ts b/src/domain/team-members/use-cases/use-team-members-list.ts
new file mode 100644
index 00000000..b22f95e0
--- /dev/null
+++ b/src/domain/team-members/use-cases/use-team-members-list.ts
@@ -0,0 +1,11 @@
+import { useQuery, type UseQueryResult } from "@tanstack/react-query";
+import { teamMembersApi } from "@/domain/team-members/api/team-members-api";
+import type { TeamMemberListResult } from "@/domain/team-members/types/team-member";
+import { queryKeys } from "@/infra/query-key/query-key";
+
+export function useTeamMembersList(): UseQueryResult {
+ return useQuery({
+ queryKey: queryKeys.teamMembers.list(),
+ queryFn: teamMembersApi.getList,
+ });
+}
diff --git a/src/domain/work-orders/mappers/assign-wizard-service-poc-fields.ts b/src/domain/work-orders/mappers/assign-wizard-service-poc-fields.ts
index 32e87840..e45381e7 100644
--- a/src/domain/work-orders/mappers/assign-wizard-service-poc-fields.ts
+++ b/src/domain/work-orders/mappers/assign-wizard-service-poc-fields.ts
@@ -19,6 +19,10 @@ export function assignWizardServicePocFields(
payload.primaryService = primaryService;
}
+ if (draft.serviceId != null) {
+ payload.serviceId = draft.serviceId;
+ }
+
const serviceNotes = trimOrUndefined(draft.pmNote);
if (serviceNotes) {
diff --git a/src/domain/work-orders/mappers/work-order-table-row-mapper.ts b/src/domain/work-orders/mappers/work-order-table-row-mapper.ts
index d1d4afc3..2f019989 100644
--- a/src/domain/work-orders/mappers/work-order-table-row-mapper.ts
+++ b/src/domain/work-orders/mappers/work-order-table-row-mapper.ts
@@ -400,6 +400,7 @@ export function mapWorkOrderTableRow(raw: unknown): WorkOrderTableRow {
locationId:
typeof locationIdRaw === "string" || typeof locationIdRaw === "number" ? locationIdRaw : "",
pm: readString(item, "pm", "PM", "problem", "Problem", "service", "Service", "trade", "Trade"),
+ serviceId: readNumber(item, "serviceId", "ServiceId"),
serviceNotes: readString(item, "serviceNotes", "ServiceNotes", "pmNote", "PmNote"),
extraServices: readStringArray(item, "extraServices", "ExtraServices"),
vendorId: vendorIdNum != null ? String(vendorIdNum) : "",
diff --git a/src/domain/work-orders/types/work-order-board.ts b/src/domain/work-orders/types/work-order-board.ts
index 4c5606b4..b7f2693a 100644
--- a/src/domain/work-orders/types/work-order-board.ts
+++ b/src/domain/work-orders/types/work-order-board.ts
@@ -105,6 +105,8 @@ export interface WorkOrderBoardCreatePayload {
trade?: string;
/** Primary service label; persisted as board `pm`. */
primaryService?: string;
+ /** Registry service identity; the backend validates active/type-compatible selections. */
+ serviceId?: string | number;
/** Services beyond primary; order preserved. */
extraServices?: string[];
/** Issue detail from Service & Notes (`pmNote` in draft). */
@@ -171,6 +173,7 @@ export interface WorkOrderBoardRowApi {
originalDate?: string | null;
originalWeek?: string | null;
workOrderType?: number | null;
+ serviceId?: number | null;
isPastDue?: boolean;
siteCode?: string | null;
locationName?: string | null;
diff --git a/src/domain/work-orders/types/work-order-table-row.ts b/src/domain/work-orders/types/work-order-table-row.ts
index d362f931..179f6c95 100644
--- a/src/domain/work-orders/types/work-order-table-row.ts
+++ b/src/domain/work-orders/types/work-order-table-row.ts
@@ -60,6 +60,7 @@ export interface WorkOrderTableRow {
location: string;
locationId: string | number;
pm: string;
+ serviceId?: string | number | null;
/** Issue detail from Service & Notes. */
serviceNotes: string;
/** Additional services beyond primary `pm`. */
diff --git a/src/domain/work-orders/types/work-order-wizard.ts b/src/domain/work-orders/types/work-order-wizard.ts
index f13b387e..ca1e94ad 100644
--- a/src/domain/work-orders/types/work-order-wizard.ts
+++ b/src/domain/work-orders/types/work-order-wizard.ts
@@ -37,6 +37,8 @@ export interface WorkOrderWizardDraft {
scheduledOn: string;
dueDate: string;
pm: string;
+ /** Registry service selected for this work order; null keeps the optional field empty. */
+ serviceId: string | number | null;
/** Extra services beyond primary `pm` (Service & Notes). */
extraServices: string[];
/** Free-text note attached to the service (Service & Notes). */
@@ -82,6 +84,7 @@ export const EMPTY_WIZARD_DRAFT: WorkOrderWizardDraft = {
scheduledOn: "",
dueDate: "",
pm: "",
+ serviceId: null,
extraServices: [],
pmNote: "",
avetaRequired: false,
diff --git a/src/domain/work-orders/utils/wo-number-input.ts b/src/domain/work-orders/utils/wo-number-input.ts
new file mode 100644
index 00000000..7f3ae624
--- /dev/null
+++ b/src/domain/work-orders/utils/wo-number-input.ts
@@ -0,0 +1,33 @@
+import { isRealWoNumber } from "@/domain/work-orders/utils/wo-closability";
+
+/** Board WO numbers are an 11-digit APM number or an SH placeholder of at most 11 characters. */
+export const BOARD_WO_NUMBER_MAX_LENGTH = 11;
+
+export const WO_NUMBER_FORMAT_MESSAGE =
+ "Work order number must be 11 digits or an SH number (e.g. SH00001)";
+
+export const WO_NUMBER_DOWNGRADE_MESSAGE =
+ "Cannot replace an APM work order number with an internal number";
+
+export function sanitizeBoardWoNumberInput(raw: string): string {
+ return raw
+ .replace(/[^a-zA-Z0-9]/g, "")
+ .toUpperCase()
+ .slice(0, BOARD_WO_NUMBER_MAX_LENGTH);
+}
+
+export function isProvisionalWoNumber(woNumber: string): boolean {
+ return /^SH/i.test(woNumber.trim());
+}
+
+export function isValidBoardWoNumber(woNumber: string): boolean {
+ return /^\d{11}$/.test(woNumber) || /^SH\d{1,9}$/i.test(woNumber);
+}
+
+/**
+ * Only an already-saved real APM number is protected from being replaced by an
+ * SH placeholder. A brand-new WO has no saved number, so the rule never applies there.
+ */
+export function isWoNumberDowngrade(savedWoNumber: string, nextWoNumber: string): boolean {
+ return isRealWoNumber(savedWoNumber) && isProvisionalWoNumber(nextWoNumber);
+}
diff --git a/src/infra/query-key/query-key.ts b/src/infra/query-key/query-key.ts
index c4a9e284..e094cf8b 100644
--- a/src/infra/query-key/query-key.ts
+++ b/src/infra/query-key/query-key.ts
@@ -47,6 +47,10 @@ export const queryKeys = {
[...queryKeys.employees.all, "list", params ?? {}] as const,
detail: (id: string | number) => [...queryKeys.employees.all, "detail", id] as const,
},
+ teamMembers: {
+ all: ["teamMembers"] as const,
+ list: () => [...queryKeys.teamMembers.all, "list"] as const,
+ },
dashboard: {
all: ["dashboard"] as const,
stats: () => [...queryKeys.dashboard.all, "stats"] as const,
@@ -56,6 +60,12 @@ export const queryKeys = {
byCategory: (category: string, parent?: string) =>
[...queryKeys.dropdownOptions.all, "byCategory", category, parent ?? ""] as const,
},
+ services: {
+ all: ["services"] as const,
+ active: () => [...queryKeys.services.all, "active"] as const,
+ byWorkOrderType: (workOrderType: string) =>
+ [...queryKeys.services.all, "byWorkOrderType", workOrderType] as const,
+ },
locations: {
all: ["locations"] as const,
list: (params?: Record) =>
diff --git a/src/test/app/(protected)/workorders/editable-wo-number-cell-sh-placeholder.test.tsx b/src/test/app/(protected)/workorders/editable-wo-number-cell-sh-placeholder.test.tsx
new file mode 100644
index 00000000..ad16d2e8
--- /dev/null
+++ b/src/test/app/(protected)/workorders/editable-wo-number-cell-sh-placeholder.test.tsx
@@ -0,0 +1,105 @@
+import { fireEvent, screen, waitFor } from "@testing-library/react";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { toast } from "react-toastify";
+import { EditableWONumberCell } from "@/app/(protected)/workorders/_components/list/table/cells/editable-wo-number-cell";
+import { workOrdersApi } from "@/domain/work-orders/api/work-orders-api";
+import { renderWithProviders } from "@/test/test-utils";
+
+vi.mock("react-toastify", () => {
+ const toastFn = Object.assign(vi.fn(), { error: vi.fn(), success: vi.fn() });
+ return { toast: toastFn };
+});
+
+vi.mock("@/domain/work-orders/api/work-orders-api", () => ({
+ workOrdersApi: { findByWoNumber: vi.fn() },
+}));
+
+function renderCell(value: string, currentId: string | number) {
+ const onSave = vi.fn();
+ renderWithProviders(
+ ,
+ );
+ return onSave;
+}
+
+function typeAndCommit(nextValue: string) {
+ fireEvent.click(screen.getByText(/./, { selector: "span" }));
+ const input = screen.getByLabelText("Work order number");
+ fireEvent.change(input, { target: { value: nextValue } });
+ fireEvent.keyDown(input, { key: "Enter" });
+}
+
+describe("EditableWONumberCell SH placeholder numbers", () => {
+ beforeEach(() => {
+ vi.mocked(workOrdersApi.findByWoNumber).mockResolvedValue(null as never);
+ vi.mocked(toast).mockClear();
+ vi.mocked(toast.error).mockClear();
+ });
+
+ it("saves a freshly typed SH number on a brand-new inline work order", async () => {
+ const onSave = renderCell("", "draft");
+
+ typeAndCommit("SH00001");
+
+ await waitFor(() => expect(onSave).toHaveBeenCalledWith("SH00001"));
+ expect(toast).not.toHaveBeenCalled();
+ expect(toast.error).not.toHaveBeenCalled();
+ });
+
+ it("keeps a typed SH prefix instead of stripping it to digits", () => {
+ renderCell("", "draft");
+
+ fireEvent.click(screen.getByText("-"));
+ const input = screen.getByLabelText("Work order number");
+ fireEvent.change(input, { target: { value: "sh00001" } });
+
+ expect(input).toHaveValue("SH00001");
+ });
+
+ it("does not treat an unsaved inline draft number as a real number to protect", async () => {
+ const onSave = renderCell("12345678901", "draft");
+
+ typeAndCommit("SH00002");
+
+ await waitFor(() => expect(onSave).toHaveBeenCalledWith("SH00002"));
+ });
+
+ it("blocks replacing a saved real APM number with an SH number", async () => {
+ const onSave = renderCell("12345678901", 42);
+
+ typeAndCommit("SH00001");
+
+ await waitFor(() =>
+ expect(toast.error).toHaveBeenCalledWith(
+ "Cannot replace an APM work order number with an internal number",
+ ),
+ );
+ expect(onSave).not.toHaveBeenCalled();
+ expect(screen.getByText("12345678901")).toBeInTheDocument();
+ });
+
+ it("lets a saved SH number be replaced by a real 11-digit number", async () => {
+ const onSave = renderCell("SH00001", 42);
+
+ typeAndCommit("12345678901");
+
+ await waitFor(() => expect(onSave).toHaveBeenCalledWith("12345678901"));
+ });
+
+ it("still rejects a numeric number that is not 11 digits", () => {
+ const onSave = renderCell("", "draft");
+
+ typeAndCommit("12345");
+
+ expect(toast).toHaveBeenCalledWith(
+ "Work order number must be 11 digits or an SH number (e.g. SH00001)",
+ );
+ expect(onSave).not.toHaveBeenCalled();
+ });
+});
diff --git a/src/test/app/(protected)/workorders/service-picker-search-placeholder.test.tsx b/src/test/app/(protected)/workorders/service-picker-search-placeholder.test.tsx
new file mode 100644
index 00000000..7a2d7fa1
--- /dev/null
+++ b/src/test/app/(protected)/workorders/service-picker-search-placeholder.test.tsx
@@ -0,0 +1,56 @@
+import { fireEvent, render, screen } from "@testing-library/react";
+import { describe, expect, it, vi } from "vitest";
+import { WizardStepLocationServiceSelect } from "@/app/(protected)/workorders/_components/wizard/wizard-step-location-service-select";
+import { PmTypePickerPopover } from "@/app/(protected)/workorders/_components/list/table/cells/pm-type-picker-popover";
+import {
+ EMPTY_WIZARD_DRAFT,
+ type WorkOrderWizardDraft,
+} from "@/domain/work-orders/types/work-order-wizard";
+
+describe("service picker search placeholder", () => {
+ it("uses a type-neutral search placeholder in the wizard service picker", () => {
+ const draft: WorkOrderWizardDraft = { ...EMPTY_WIZARD_DRAFT, pm: "" };
+
+ render(
+ ,
+ );
+
+ fireEvent.click(screen.getByRole("button", { name: /select service/i }));
+
+ expect(screen.getByPlaceholderText("Search services…")).toBeTruthy();
+ expect(screen.queryByPlaceholderText("Search PM type…")).toBeNull();
+ });
+
+ it("uses a type-neutral search placeholder in the table service picker popover", () => {
+ const anchor = document.createElement("button");
+
+ render(
+ ,
+ );
+
+ expect(screen.getByPlaceholderText("Search service…")).toBeTruthy();
+ expect(screen.queryByPlaceholderText("Search PM type…")).toBeNull();
+ });
+});
diff --git a/src/test/app/(protected)/workorders/wizard-service-clears-vendor.test.tsx b/src/test/app/(protected)/workorders/wizard-service-clears-vendor.test.tsx
index 3812fb63..c46f95df 100644
--- a/src/test/app/(protected)/workorders/wizard-service-clears-vendor.test.tsx
+++ b/src/test/app/(protected)/workorders/wizard-service-clears-vendor.test.tsx
@@ -79,6 +79,7 @@ describe("WizardStepLocationServiceSelect — vendor clear on service change", (
expect(onPatch).toHaveBeenCalledWith({
pm: "Electrical",
+ serviceId: "3",
extraServices: [],
vendorId: "",
vendorName: "",
diff --git a/src/test/app/(protected)/workorders/wizard-step-type-schedule-clears-service.test.tsx b/src/test/app/(protected)/workorders/wizard-step-type-schedule-clears-service.test.tsx
new file mode 100644
index 00000000..9c9582ee
--- /dev/null
+++ b/src/test/app/(protected)/workorders/wizard-step-type-schedule-clears-service.test.tsx
@@ -0,0 +1,69 @@
+import { fireEvent, render, screen } from "@testing-library/react";
+import { describe, expect, it, vi } from "vitest";
+import { WizardStepTypeSchedule } from "@/app/(protected)/workorders/_components/wizard/wizard-step-type-schedule";
+import {
+ EMPTY_WIZARD_DRAFT,
+ type WorkOrderWizardDraft,
+} from "@/domain/work-orders/types/work-order-wizard";
+
+const USERS = [{ id: "sarah", name: "Sarah Chen" }];
+
+describe("WizardStepTypeSchedule — service clear on type change", () => {
+ it("clears the service and its vendor when the work-order type changes", () => {
+ const onPatch = vi.fn();
+ const draft: WorkOrderWizardDraft = {
+ ...EMPTY_WIZARD_DRAFT,
+ type: "PM",
+ pm: "HVAC",
+ serviceId: "1",
+ extraServices: ["Plumbing"],
+ vendorId: "9",
+ vendorName: "Old Vendor",
+ techPhone: "555-0100",
+ };
+
+ render(
+ ,
+ );
+
+ fireEvent.click(screen.getByRole("button", { name: /Reactive/ }));
+
+ expect(onPatch).toHaveBeenCalledWith(
+ expect.objectContaining({
+ type: "Reactive",
+ pm: "",
+ serviceId: null,
+ extraServices: [],
+ vendorId: "",
+ vendorName: "",
+ techPhone: "",
+ }),
+ );
+ });
+
+ it("keeps the selected service when the same type is re-selected", () => {
+ const onPatch = vi.fn();
+ const draft: WorkOrderWizardDraft = {
+ ...EMPTY_WIZARD_DRAFT,
+ type: "PM",
+ pm: "HVAC",
+ serviceId: "1",
+ extraServices: ["Plumbing"],
+ vendorId: "9",
+ vendorName: "Old Vendor",
+ techPhone: "555-0100",
+ };
+
+ render(
+ ,
+ );
+
+ fireEvent.click(screen.getByRole("button", { name: /Scheduled preventive maintenance/ }));
+
+ const patch = onPatch.mock.calls[0][0] as Partial;
+ expect(patch).not.toHaveProperty("pm");
+ expect(patch).not.toHaveProperty("serviceId");
+ expect(patch).not.toHaveProperty("extraServices");
+ expect(patch).not.toHaveProperty("vendorId");
+ });
+});
diff --git a/src/test/domain/services/api/services-api.test.ts b/src/test/domain/services/api/services-api.test.ts
new file mode 100644
index 00000000..ab558d03
--- /dev/null
+++ b/src/test/domain/services/api/services-api.test.ts
@@ -0,0 +1,48 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { API_PATHS } from "@/api/api-paths";
+
+const apiGet = vi.fn();
+
+vi.mock("@/api/api", () => ({
+ apiGet: (...args: unknown[]) => apiGet(...args),
+}));
+
+import { servicesApi } from "@/domain/services/api/services-api";
+
+describe("servicesApi", () => {
+ beforeEach(() => {
+ apiGet.mockReset();
+ });
+
+ it("loads active services filtered by the selected work-order type", async () => {
+ apiGet.mockResolvedValue([
+ {
+ id: 7,
+ name: "HVAC inspection",
+ trade: "HVAC",
+ iconKey: "hvac-inspection",
+ isActive: true,
+ supportedWorkOrderTypes: [2, "Reactive"],
+ },
+ ]);
+
+ const services = await servicesApi.getActiveForWorkOrderType("PM");
+
+ expect(apiGet).toHaveBeenCalledWith(API_PATHS.services.list, {
+ searchParams: { isActive: true, workOrderType: 2 },
+ });
+ expect(services[0]).toMatchObject({
+ id: 7,
+ name: "HVAC inspection",
+ trade: "HVAC",
+ supportedWorkOrderTypes: ["PM", "Reactive"],
+ });
+ });
+
+ it("does not request services for the unsupported Overdue type", async () => {
+ const services = await servicesApi.getActiveForWorkOrderType("Overdue");
+
+ expect(apiGet).not.toHaveBeenCalled();
+ expect(services).toEqual([]);
+ });
+});
diff --git a/src/test/domain/team-members/team-member-mapper.test.ts b/src/test/domain/team-members/team-member-mapper.test.ts
new file mode 100644
index 00000000..7bfb208d
--- /dev/null
+++ b/src/test/domain/team-members/team-member-mapper.test.ts
@@ -0,0 +1,28 @@
+import { describe, expect, it } from "vitest";
+import { mapTeamMemberListItem } from "@/domain/team-members/mappers/team-member-mapper";
+
+describe("mapTeamMemberListItem", () => {
+ it("maps the existing User list response and derives inactive state", () => {
+ expect(
+ mapTeamMemberListItem({
+ Id: "u1",
+ Name: "Alex Smith",
+ RoleName: "Dispatcher",
+ Locations: "Central",
+ Email: "alex@example.com",
+ Status: "Inactive",
+ IsAccountOwner: true,
+ }),
+ ).toEqual({
+ id: "u1",
+ name: "Alex Smith",
+ role: "Dispatcher",
+ serviceArea: "Central",
+ phone: "",
+ email: "alex@example.com",
+ color: "",
+ status: "Inactive",
+ isAccountOwner: true,
+ });
+ });
+});
diff --git a/src/test/domain/work-orders/api/work-orders-api.test.ts b/src/test/domain/work-orders/api/work-orders-api.test.ts
index 0d0002f3..e295ed9d 100644
--- a/src/test/domain/work-orders/api/work-orders-api.test.ts
+++ b/src/test/domain/work-orders/api/work-orders-api.test.ts
@@ -140,6 +140,25 @@ describe("workOrdersApi.createFromBoard", () => {
locationId: 9,
});
});
+
+ it("includes the registry service id when selected in the wizard", async () => {
+ await workOrdersApi.createFromBoard({
+ ...EMPTY_WIZARD_DRAFT,
+ type: "Reactive",
+ siteCode: "BK5",
+ pm: "HVAC inspection",
+ serviceId: 7,
+ });
+
+ expect(apiPost).toHaveBeenCalledWith(
+ API_PATHS.workOrder.boardCreate,
+ expect.objectContaining({
+ workOrderType: 6,
+ primaryService: "HVAC inspection",
+ serviceId: 7,
+ }),
+ );
+ });
});
describe("workOrdersApi.update", () => {