#Contractor shifts and profile

Module id: MOD-CONTRACTOR-SHIFTS
Doc profile: capability

Contractors browse and claim open marketplace shifts, manage their My shifts membership (including cancel), and maintain profile fields, documents, and preferred-company visibility on /contractor/shifts. Shared Detailed job view and Row actions stay owned by MOD-COMPANY-SHIFTS — this module consumes Row actions by slot and uses a local detail group, not a forked company reusable.

#Purpose

Signed-in contractors need one authenticated home to find claimable work, open shift detail, claim or cancel membership, and keep identity documents and skills current. Observable outcomes are membership writes on shifts / profiles (contractor lists and shift lists), optional company notification on cancel (in-app and/or Postmark after the grace window), profile and documents persistence under owner RLS, and a 15-minute grace schedule hook at claim time (worker body owned by MOD-TIME-TRACKING).

#Scope boundaries

#Actors

#Capability composition

One host route with mutually exclusive panels driven by URL tab. Empty tab or myshifts shows My shifts; shiftlist shows the marketplace list; detail shows local shift detail; contractors shows profile. Nested query shift={id} binds detail. Shared Row actions mounts inside My shifts rows; company Detailed job view is not instantiated here.

Bubble evidence for panels and workflows is under Traceability / IR evidence.

#Primary journeys

Journeys are reconstructed from contractor_shifts_profile PageLoaded / ButtonClicked workflows (ChangePage, Show-Hide, MakeChangeCurrentUser, ChangeThing, ScheduleAPIEvent, NewThing notification, connectors). Chat thread UI and grace-delay approve recursion stay out of scope where noted.

#J1 — Enter contractor shifts and switch panels

1. A signed-in contractor opens /contractor/shifts (with or without tab).
2. Signed-out visitors redirect to /; admin visitors redirect to /admin; company visitors redirect to /company/shifts.
3. Empty tab or tab=myshifts shows My shifts; tab=shiftlist shows the open-shift list; tab=detail shows local detail; tab=contractors shows profile.
4. URL message=welcome shows Welcome popup; message=unapproved shows the unapproved claim-pending popup.
5. Session/role read failure shows a clear error or redirect — never a blank authenticated shell.

#J2 — Browse, filter, and open shift detail

1. On tab=shiftlist, the contractor sees search placeholder “Search for job” and filter labels Region, Company, Skill set, Select shift date, Select rate.
2. The open-shifts list loads claimable marketplace shifts not already on the contractor’s membership, with columns Job Title, Location, Company (plus Shift Time / Shift Date / HR / Action per list chrome).
3. Empty list shows “No result found.”; load/filter failures are visible.
4. Opening a row navigates to /contractor/shifts?tab=detail&shift={id} and shows the local detailed view (Skillset, Location, Start Date/Time, Wisconsin time, Hours required, Hourly Rate, Description, Claim / Cancel / Message).
5. Detail does not mount or fork the company Detailed job view reusable.

#J3 — Claim an open shift

1. On detail, Claim opens Popup Claim Shift with confirm copy, Confirm / Discard, and the 15-minute grace warning.
2. If profiles.approved is false, claim stays blocked (unapproved popup / disabled claim) — no membership writes.
3. Confirm adds the contractor to the shift’s contractor list, adds the shift to the contractor’s shift membership, schedules the 15-minute grace delay job, stores the schedule id on the user, and hides the popup.
4. Discard closes without membership writes.
5. Message creates a chat row for contractor + shift company and navigates to /chat (thread UI remains MOD-CHAT).
6. Mutation failures show inline/page errors; grace worker body beyond enqueue is MOD-TIME-TRACKING.

#J4 — Manage My shifts and cancel

1. On My shifts, Upcoming vs Completed shifts toggles list mode (active_shifts vs closed_shifts) — only one mode active.
2. The list shows the contractor’s membership rows (Shift Name, Location, HR, Company, Skillset, Worked Hours, Date) or “No result found.”
3. Details reuses the same local detail panel (tab=detail&shift={id}) — no second detail tree.
4. My shifts rows slot shared Row actions (company-owned) behind the existing instance marker — no contractor-only fork of the definition.
5. Cancel opens Popup Cancel Shift; Confirm removes membership lists, records cancellation reason, adjusts dependability from the negatives option, cancels any pending grace schedule, may create an in-app company notification when the grace schedule id is empty, may send company Postmark/connector email when Current Date/Time is after shift start + 15 minutes, and removes the shift from Upcoming immediately on success.
6. Cancel/notification failures map once and stay visible.

#J5 — Update contractor profile and documents

1. On tab=contractors, profile shows General Information (legal names, email, skills summary, four skill-set options, state, city, dependability score) and document uploaders.
2. Seven uploaders map 1:1 to document types: driver’s license, resume, mask fit test, diplomas, hearing examination OSHA, references from two foreman/managers, specialty credentials.
3. Picture uploader updates preview; Save persists profile image plus name, skills summary, skill set, state, and city.
4. State/City use onboarding CSC helpers (no private CSC headers in the SPA); changing state clears city.
5. Optional password fields run UpdateCredentials only when filled and matching.
6. “See which companies prefer me” opens Popup Companies listing preferred companies (Company Name, Location, Important Contacts) — do not read the empty current_contractors_info type.
7. Save/upload failures show visible errors; lists/docs stay unchanged on failure.

#Vertical slices (decompose)

#Key UI states

#Navigation contracts

#Style and fidelity

Contractor shifts uses the cabinet workspace outlet. Transcribe visible copy and stamp data-bubble-id on migrated roots: page, Shift list, My shifts, local detail, profile, claim/cancel/welcome/unapproved/companies popups, filter group, and primary RG roots. Shared tokens come from the app-level stylesheet that SHELL-LAYOUT (MOD-SHELL) delivers out of IR styles (ir/slices/styles____part_all.json — 49 styles, 8 color tokens, 1 font token); this cycle's module map has no separate design-system module, so do not defer a token to one. Preserve Wisconsin time copy on detail date/time fields.

#Failure modes

#Needs human clarification

#Traceability

#Source → target naming (under Traceability)

#IR evidence

#Module evidence roots

• bTHMg — contractor_shifts_profile page (/pages/bTHMh); Shift list, My shifts, local detail, profile, claim/cancel/welcome workflows
• Shared segments (consume, do not fork): bTIgC DetailedViewJob (company-only instances), bTHTn RGaction (instance bTHUp on this page)
• Data: shifts, documents, current_contractors_info (dead empty type)

Supporting segments: ir/slices/bTHMh____root.json, ir/slices/bTHMh__elements____remaining_children.json, ir/slices/bTHMh__elements__bTHQp__elements____remaining_children.json, ir/slices/bTHMh__workflows____part_A.json, ir/slices/edef_bTIgD____root.json, ir/slices/edef_bTHTo____root.json, options tabs / nav / sort / rate_filter / docs_type / reason_of_cancellation / skill_set.

#Path-key ↔ inventory id aliases

#Panel visibility (URL tab)

Preserve SHELL’s split: sidebar My shifts uses nav myshifts; sidebar Shifts uses tabs shiftlist.

#Claim confirm chain (bTKFR)

1. MakeChangeCurrentUser — add shift to shifts_list_custom_shifts when not already present
2. ChangeThing — add CurrentUser to shift contractor_list_user
3. ScheduleAPIEvent — API bTKPV at Current Date/Time + 15 minutes (params user + shift)
4. ChangeThing — store schedule id on user schedule_15_min_delay_text
5. Hide claim popup

#Cancel confirm chain (bTKVg)

1. Optional NewThing notification to company when grace schedule id empty (bTNLS) — separate in-app path
2. CancelScheduledAPIEvent when schedule id present
3. ChangeThing — remove from contractor/show lists; set reason; add to cancel list
4. MakeChangeCurrentUser — clear schedule id; remove shift membership; subtract dependability via negatives cancel-within-4-hours option
5. Conditional Postmark/connector notify (bTNMm) when ElementParent.data_start_date plus 15 minutes is less than Current Date/Time — i.e. after the 15-minute grace window past shift start (fires when (start + 15m) < now, not within 15 minutes of start)
6. Reset inputs + hide popup

#Option sets (db_value → display)

#Privacy / residuals

• current_contractors_info — dead empty type; preferred companies use preferred_list_user only.
• bTIgC — answered structurally: no instance on this page; local detail only.
• Membership and dependability writes require server-authorized paths (MON-CLIENT-WRITES).
• Grace-delay worker / tracking approve recursion remains MOD-TIME-TRACKING.

#Decompose refs

• CSHIFT-BROWSE-APPLY
• CSHIFT-MYSHIFTS
• CSHIFT-PROFILE