Shifts

The Shifts module manages personnel scheduling, shift signups, and shift trades. It is handled by the ShiftsController.

Shift Lifecycle

Create Shift → Assign Groups/Roles → Set Days → Personnel Signup → Trades → Process

Shift List

Authorization: Shift_View policy

Displays all shifts with visibility based on whether the user is a department admin or group admin.

Creating Shifts

Authorization: Shift_Create policy

Shift Configuration

Field	Description
Shift Name	Display name
Shift Code	Short code identifier
Color	Color for calendar display
Start Time	Shift start time
End Time	Shift end time
Assignment Type	How personnel are assigned (e.g., "Assigned")

Group Assignments

Shifts are associated with specific station groups. Each group-shift assignment includes:

• Role requirements — Specify which personnel roles are needed and how many
• Personnel assignments — Pre-assign specific people to groups

Date Selection

Shift days specify the actual dates the shift is active.

Events

Fires ShiftCreatedEvent on creation.

Editing Shifts

Authorization: Shift_Update policy

Editing is split into three separate views:

Edit Shift Details

• Name, code, color, start/end time
• Personnel assignments
• Fires ShiftUpdatedEvent

Edit Shift Days

• Add or modify shift dates
• Fires ShiftDaysAddedEvent

Edit Shift Groups

• Modify group assignments and role requirements

Deleting Shifts

Authorization: Shift_Delete policy

Validates department ownership before deletion.

Shift Signup

Authorization: Shift_View policy

Personnel can sign up for shift days:

Signup Process

1. View available shift day with group needs
2. Check if already signed up (respects multi-group signup setting)
3. Sign up for a specific group within the shift day
4. Receive signup confirmation

Multi-Group Signup

When enabled in department settings, personnel can sign up for shift days under groups other than their own.

Viewing a Shift Day

Authorization: Shift_View policy

The shift day view shows:

• All signups per group
• Role requirement fulfillment
• Open needs (unfilled roles)

Your Shifts

Authorization: Shift_View policy

Shows the current user's:

• Upcoming shift signups
• Open trade requests directed at them

Shift Trades

The trade system enables personnel to swap shifts:

Trade Workflow

1. Request Trade → 2. Other User Processes → 3. Propose Days → 4. Accept/Reject → 5. Complete

1. Request Trade

Action: RequestTrade

• Select a shift signup to trade
• Choose target personnel
• Fires ShiftTradeRequestedEvent

2. Process Trade

Action: ProcessTrade

• View trade request details
• Propose alternate shift days
• Fires ShiftTradeProposedEvent

3. Reject Trade

Action: RejectTrade

• Provide a rejection reason
• Fires ShiftTradeRejectedEvent

4. Finish Trade

Action: FinishTrade

• Complete the trade by selecting a user or target signup
• Fires ShiftTradeFilledEvent

Shift Staffing

Authorization: Shift_View policy

The staffing view allows assigning specific personnel to shifts:

• Admin users see all shifts
• Non-admin users see only their group's shifts
• Supports per-day, per-group personnel assignments

Shift Calendar

Authorization: Shift_View policy

Calendar Views

• All Shifts Calendar — Shows all shift days across all shifts
• Single Shift Calendar — Calendar view for a specific shift

Calendar Data

Calendar items include:

• Fill status (fully staffed vs. needs)
• User signup status
• Group requirement details
• Color-coded by shift
• Links to signup/view pages

Workshift Integration: Workshift days are also displayed on the shift calendar alongside traditional shifts.

Data Endpoints

Endpoint	Purpose
GetShiftCalendarItems	Calendar items for all shifts + workshifts
GetShiftCalendarItemsForShift	Calendar items for one shift
GetShiftCalendarItemTypes	Shift types with colors for calendar legend
GetPersonnelForShift	Personnel assigned to a shift (optionally by group)
GetShiftGroups	Groups assigned to a shift
GetShiftDays	Shift days with processed status
GetShiftJson	Full shift object
GetShiftsForDepartmentJson	All shifts (id, name)
GetPersonnelNotOnShiftDay	Personnel matching role requirements but not signed up
GetShiftDaysUserIsOn	Shift days the current user is on

Interactions with Other Modules

Module	Interaction
Dispatch	Shift-based dispatch replaces group dispatch with shift personnel
Groups	Shifts reference groups for assignments
Personnel Roles	Role requirements define shift needs
Dashboard	Staffing levels affected by shift assignments
Calendar	Shift days displayed on shift calendar
Workshifts	Workshift days integrated into shift calendar
Department	Multi-group signup and dispatch settings
Reports	Shift readiness report analyzes fulfillment