shoc-frontend-new/src/domain/work-orders/api/work-orders-api.ts
Arthur Bassi a0cf7b9ef0
Feat/vite typescript migration (#16)
* chore: add eslint, prettier, husky and commitlint tooling

* ci: add GitHub Actions workflow for lint and build

* build: migrate from CRA to Vite with TypeScript config

* docs: add architecture plan and design system documentation

* fix: scope ESLint to new components and hooks directories

* feat: add HTTP client, query cache and shared utilities

* feat: add theme system and global application styles

* feat: add shared UI, layout and domain badge components

* feat: add auth domain, provider and login page

* feat: add app shell, file-based routing and bootstrap

* feat: add protected layout and dashboard module

* feat: add accounts CRUD module

* feat: add assets CRUD module

* feat: add contacts CRUD module

* feat: add employees CRUD module

* feat: add locations CRUD module

* feat: add calendar events module

* feat: add follow-ups CRUD module

* feat: add PM schedules CRUD module

* feat: add work orders module with dispatch modals

* feat: add vendors CRUD and portal token panel

* feat: add vendor purchase orders module

* feat: add uplifts queue module

* feat: add settings for dropdowns and task templates

* feat: add vendor portal routes and signature capture

* test: add Vitest setup and Playwright login e2e spec

* chore: remove legacy CRA pages, Redux store and JS hooks

* chore: update gitignore and env example for Vite

* docs: translate pt-BR docs and Cursor rules to English

* fix(ci): fix login e2e session mock and prettier formatting

* fix(build): use mjs router script for Node 20 CI compatibility

* chore: remove migration scripts and unused generouted router

* fix(auth): restore JWT and align CRUD with backend routes

* fix(api): add no-content helpers and align paths with backend

* fix(accounts): align detail and mutation payloads with backend

* fix(contacts): resolve detail via GetContacts and map address DTOs

* fix(work-orders): align routes, delete body, and create payload

* fix(vendors): delete vendors via REST route

* fix(pm-schedules): handle empty save and delete responses

* fix(employees): add fallbacks for detail and dropdown calls

* chore(calendar): disable routes until backend exists

* chore(env): switch tracked env vars to Vite prefixes

* fix(api): align frontend contracts with backend review findings

Correct Work Order getById query param, asset site options via Location API,
Employee JobTitleId payload, and remove stale API paths.

* fix(employees,pm-schedules): align forms with backend API contracts

Align PM Schedule form and save payload with PMSchedule_DTO fields.
Bind employee Job Title select to jobTitleId for create/update payloads.
Add regression tests for both flows.

* fix(pm-schedules): gate edit/delete for Dev API contract

Production Dev API exposes only GetList and Save.

Hide unsupported edit/delete UI and block the edit route.

Add regression tests for disabled actions.

* docs(env): document VITE_API_URL must include /api suffix

* refactor(api): extract shared API prefix URL resolution

* feat(build): fail build on misconfigured absolute VITE_API_URL

* test(api): cover API URL contract and prefix resolution

* feat(auth): disable login submit until email and password are valid

* test(auth): align login tests with disabled submit behavior

* Feat/ab/menu-and-header (#17)

* chore(deps): add lucide-react for layout icon migration

* feat(auth): add getPrimaryUserRole helper for header display

* style(theme): add sidebar active tokens and nav group typography

* refactor(menu): migrate nav icons to lucide and trim menu groups

* feat(layout): redesign sidebar, topbar, and admin shell viewport

* chore(menu): hide Reports and Documents from sidebar

---------

Co-authored-by: Arthur Bassi <arthur.winiarski.ranger@outlook.com>

* ci: add frontend PR quality baseline (#18)

* chore(deps): add lucide-react for layout icon migration

* feat(auth): add getPrimaryUserRole helper for header display

* style(theme): add sidebar active tokens and nav group typography

* refactor(menu): migrate nav icons to lucide and trim menu groups

* feat(layout): redesign sidebar, topbar, and admin shell viewport

* chore(menu): hide Reports and Documents from sidebar

* ci: add PR quality baseline checks

* ci: avoid self-matching standards guard

* ci: split frontend quality gates

---------

Co-authored-by: Arthur Bassi <arthur.winiarski.ranger@outlook.com>

---------

Co-authored-by: Arthur Bassi <arthur.winiarski.ranger@outlook.com>
Co-authored-by: Alexandre Brandizzi <alex_brandizzi@hotmail.com>
2026-06-18 14:41:17 -03:00

280 lines
9 KiB
TypeScript

import { API_PATHS } from "@/api/api-paths";
import { apiDelete, apiGet, apiPost } from "@/api/api";
import { handleApiResponse, handlePaginatedResponse } from "@/api/handle-api-response";
import {
mapDispatchComment,
mapDispatchDetail,
mapDispatchSignoff,
mapDispatchToVendorPayload,
mapEmployeeOptions,
mapLocationOptions,
mapTaskListTemplates,
mapUpdateDispatchPayload,
mapVendorDropdownItems,
mapWorkOrderComment,
mapWorkOrderDetail,
mapWorkOrderFormToCreatePayload,
mapWorkOrderFormToUpdatePayload,
mapWorkOrderListItems,
} from "@/domain/work-orders/mappers/work-order-mapper";
import type { WorkOrderFormSchemaValues } from "@/domain/work-orders/schemas/work-order-schema";
import type {
DispatchDetail,
DispatchToVendorPayload,
EmployeeOption,
LocationOption,
TaskListTemplate,
UpdateDispatchPayload,
VendorDropdownItem,
WorkOrderComment,
WorkOrderDetail,
WorkOrderFormValues,
WorkOrderUser,
WorkOrdersListParams,
WorkOrdersListResult,
} from "@/domain/work-orders/types/work-order";
function buildSearchParams(params: WorkOrdersListParams): Record<string, string | number> {
const searchParams: Record<string, string | number> = {
search: params.search ?? "",
page: params.page ?? 1,
pageSize: params.pageSize ?? 12,
};
if (params.sortBy) {
searchParams.sortBy = params.sortBy;
}
if (params.sortDir) {
searchParams.sortDir = params.sortDir;
}
if (params.status) {
searchParams.status = params.status;
}
if (params.assignee) {
searchParams.assignee = params.assignee;
}
if (params.locationId) {
searchParams.locationId = params.locationId;
}
return searchParams;
}
function mapUser(raw: unknown): WorkOrderUser {
const item = (typeof raw === "object" && raw !== null ? raw : {}) as Record<string, unknown>;
const id = item.id ?? item.Id;
const name =
(typeof item.name === "string" ? item.name : undefined) ??
(typeof item.Name === "string" ? item.Name : undefined) ??
(typeof item.userName === "string" ? item.userName : "") ??
"";
return {
id: typeof id === "string" || typeof id === "number" ? id : "",
name,
};
}
export const workOrdersApi = {
getList: async (params: WorkOrdersListParams = {}): Promise<WorkOrdersListResult> => {
const searchParams = buildSearchParams(params);
const data = await apiGet<unknown>(API_PATHS.workOrder.getList, { searchParams });
const paginated = handlePaginatedResponse<unknown>(data, {
page: params.page,
pageSize: params.pageSize,
});
return {
items: mapWorkOrderListItems(paginated.items),
totalCount: paginated.totalCount,
page: paginated.page,
pageSize: paginated.pageSize,
};
},
fetchUsers: async (): Promise<WorkOrderUser[]> => {
const data = await apiGet<unknown>(API_PATHS.user.list);
const users = handleApiResponse<unknown[]>(data);
return Array.isArray(users) ? users.map(mapUser) : [];
},
getById: async (id: string | number): Promise<WorkOrderDetail> => {
const data = await apiGet<unknown>(API_PATHS.workOrder.getById, {
searchParams: { id },
});
return mapWorkOrderDetail(handleApiResponse(data));
},
create: async (
values: WorkOrderFormSchemaValues | WorkOrderFormValues,
): Promise<WorkOrderDetail> => {
const payload = mapWorkOrderFormToCreatePayload(values);
const data = await apiPost<unknown>(API_PATHS.workOrder.addWorkorder, payload);
return mapWorkOrderDetail(handleApiResponse(data));
},
update: async (
id: string | number,
values: WorkOrderFormSchemaValues | WorkOrderFormValues,
): Promise<WorkOrderDetail> => {
const payload = mapWorkOrderFormToUpdatePayload(id, values);
const data = await apiPost<unknown>(API_PATHS.workOrder.editWorkorder, payload);
return mapWorkOrderDetail(handleApiResponse(data));
},
delete: async (id: string | number): Promise<void> => {
await apiDelete(API_PATHS.workOrder.deleteWorkorder, {
json: { Id: Number(id) },
});
},
addComment: async (
workOrderId: string | number,
text: string,
commentType: string,
): Promise<WorkOrderComment> => {
const data = await apiPost<unknown>(API_PATHS.workOrder.addCommentJson, {
WorkorderId: workOrderId,
Text: text,
CommentType: commentType,
});
return mapWorkOrderComment(handleApiResponse(data));
},
changeStatus: async (id: string | number, status: string): Promise<void> => {
await apiPost<unknown>(API_PATHS.workOrder.changeStatus, undefined, {
searchParams: { id, status },
});
},
changeAssignment: async (id: string | number, assignTo: string | number): Promise<void> => {
await apiPost<unknown>(API_PATHS.workOrder.changeAssignment, undefined, {
searchParams: { id, assignTo: assignTo || "" },
});
},
fetchLocations: async (): Promise<LocationOption[]> => {
const data = await apiGet<unknown>(API_PATHS.contact.getLocations);
const items = handleApiResponse<unknown[]>(data);
return Array.isArray(items) ? mapLocationOptions(items) : [];
},
fetchEmployeesDropdown: async (): Promise<EmployeeOption[]> => {
try {
const data = await apiGet<unknown>(API_PATHS.employee.dropdown);
const items = handleApiResponse<unknown[]>(data);
return Array.isArray(items) ? mapEmployeeOptions(items) : [];
} catch {
const data = await apiGet<unknown>(API_PATHS.employee.getList, {
searchParams: { page: 1, pageSize: 1000 },
});
const paginated = handlePaginatedResponse<unknown>(data);
const items = paginated.items.map((item) => {
const record = (typeof item === "object" && item !== null ? item : {}) as Record<
string,
unknown
>;
const firstName = String(record.firstName ?? record.FirstName ?? "");
const lastName = String(record.lastName ?? record.LastName ?? "");
return {
id: record.id ?? record.Id,
name: `${firstName} ${lastName}`.trim(),
};
});
return mapEmployeeOptions(items);
}
},
fetchVendorsDropdown: async (trade?: string, siteZip?: string): Promise<VendorDropdownItem[]> => {
const searchParams: Record<string, string> = {};
if (trade) {
searchParams.trade = trade;
}
if (siteZip) {
searchParams.siteZip = siteZip;
}
const data = await apiGet<unknown>(API_PATHS.vendor.dropdown, {
searchParams: Object.keys(searchParams).length > 0 ? searchParams : undefined,
});
const items = handleApiResponse<unknown[]>(data);
return Array.isArray(items) ? mapVendorDropdownItems(items) : [];
},
fetchTaskTemplates: async (): Promise<TaskListTemplate[]> => {
const data = await apiGet<unknown>(API_PATHS.taskListTemplate.list);
const items = handleApiResponse<unknown[]>(data);
return Array.isArray(items) ? mapTaskListTemplates(items) : [];
},
dispatchToVendor: async (payload: DispatchToVendorPayload): Promise<void> => {
await apiPost<unknown>(
API_PATHS.workOrder.dispatchToVendor,
mapDispatchToVendorPayload(payload),
);
},
getDispatchById: async (id: string | number): Promise<DispatchDetail> => {
const data = await apiGet<unknown>(`${API_PATHS.workOrder.getDispatch}/${id}`);
return mapDispatchDetail(handleApiResponse(data));
},
updateDispatch: async (payload: UpdateDispatchPayload): Promise<void> => {
await apiPost<unknown>(API_PATHS.workOrder.updateDispatch, mapUpdateDispatchPayload(payload));
},
addDispatchComment: async (
dispatchId: string | number,
text: string,
sendEmail = true,
): Promise<DispatchDetail["comments"][number]> => {
const data = await apiPost<unknown>(API_PATHS.workOrder.addDispatchComment, {
DispatchId: dispatchId,
Text: text,
SendEmail: sendEmail,
});
return mapDispatchComment(handleApiResponse(data));
},
updateChecklistItem: async (
id: string | number,
isCompleted: boolean,
completedBy: string,
): Promise<void> => {
await apiPost<unknown>(API_PATHS.workOrder.updateChecklistItem, {
Id: id,
IsCompleted: isCompleted,
CompletedBy: completedBy,
});
},
addChecklistItem: async (dispatchId: string | number, itemText: string): Promise<void> => {
await apiPost<unknown>(API_PATHS.workOrder.addChecklistItem, {
DispatchId: dispatchId,
ItemText: itemText,
});
},
addDispatchSignoff: async (
dispatchId: string | number,
signoffType: string,
name: string,
signature: string,
signatureMethod: string,
): Promise<DispatchDetail["signoffs"][number]> => {
const data = await apiPost<unknown>(API_PATHS.workOrder.addDispatchSignoff, {
DispatchId: dispatchId,
SignoffType: signoffType,
Name: name,
Signature: signature,
SignatureMethod: signatureMethod,
});
return mapDispatchSignoff(handleApiResponse(data));
},
verifyDispatch: async (dispatchId: string | number): Promise<void> => {
await apiPost<unknown>(API_PATHS.workOrder.verifyDispatch, undefined, {
searchParams: { dispatchId },
});
},
};