adam/shoc-frontend-new
1
0
Fork 0
mirror of https://github.com/Sea-Haven-Industries/shoc-frontend-new.git synced 2026-09-30 13:53:12 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2
shoc-frontend-new/docs/work-orders/pending-be-contract.md
Arthur Bassi 88216520d8
Some checks are pending
CI / ci (push) Waiting to run
Details
CI / governance (push) Waiting to run
Details
Deploy / deploy (push) Waiting to run
Details
fix(vendors): align Vendors list UI with design specs (SH-219) (#92) 
* docs(work-orders): add pending BE contract checklist for design parity gaps

* fix(vendors): align list header, Total Jobs, and Filters with design (SH-219)

* test(vendors): align e2e subtitle with SH-219 technicians copy

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-07 11:12:45 -03:00

3.6 KiB
Raw Blame History

Pending BE contract (WO design parity gaps)

Local checklist for FE branches off dev. Confirm with backend before shipping PR3/PR5 to production. Until confirmed, FE may use typed clients + mocks.

Board row / PATCH

Field Needed by Notes
completedDate on GET /board and /board/search rows PR1, PR4 PATCH field: "completedDate" expected; confirm GET includes ISO date
severity (1–5 | null) on row, create, PATCH PR2, PR5 Required for Emergency/Reactive; PATCH field: "severity"
upliftSummary on row PR3, PR4, PR5 { hasUplift, pendingCount, primaryStatus? }
hasPendingUplift on row/detail PR4 Prefer server 422 on Completed / completion-doc when pending
additionalContacts[] PR6 { name, phone, notes? }[] on create/detail/PATCH
isAddOn PR5 (filter) Indicator, not a WO type (SH-126)

Proposed WO-scoped uplift endpoints (confirm vs NTE uplifts queue)

Method Path Body
GET workorders/{id}/uplifts —
POST workorders/{id}/uplifts { amount, notes, attachments? }
POST workorders/{id}/uplifts/{upliftId}/cancel —
POST workorders/{id}/uplifts/{upliftId}/revoke { reason? }

Statuses (design): pending | approved | auto_approved | rejected | cancelled | revoked.

Search query params (GET workorders/board/search)

Param Meaning
severities multi 1–5
rescheduled / carriedOver boolean (≥2 counters)
addOn boolean (isAddOn)
flagColors multi #RRGGBB
internalOnly WO# starts with SH
avetaOnly if avetaRequired exists
hasUplift + upliftStatuses uplift filters

Already documented in board-search-api.md: datePreset, sites, types, overdue, dispatchers, statuses, pmTypes, vendorIds, docStatuses.

Comments

Field Needed by
POST { text, mentions?: string[] } PR9
Response includes mentions for highlight PR9

Vendor

Item Needed by
Create technician under company (confirm existing vendors API) PR7

Optional

Item Needed by
422 on duplicate WO number (global) PR8 (FE dialog works without it)