Vessel Allocations

Common Tasks

How to View Vessel Schedules (Vessel Grid)

Open the vessel allocation view to see all vessels and when they run, with utilization and blocked slots.

1. In the left sidebar, click Vessel Allocations
2. The page title is Vessel Allocations with subtitle "Manage vessel schedules and capacity"
3. Use the date range controls (chevron left/right) and the view mode toggle: Day, Week, or Month
4. The grid has rows = vessels (code, name, capacity), columns = dates. Each cell shows time slots with activity name, booked/capacity count, and utilization. "No trips" means no schedules for that day
5. A legend at the bottom explains colors: Empty (0%), Low (<50%), Medium (50-80%), High (80-99%), Full (100%), Blocked, and Overridden (amber left border with warning icon)

Result: You see which vessels are scheduled for which days and their utilization.

How to Override a Slot for a Specific Date

Change the time, cancel a departure, or adjust capacity for a single date without affecting other days.

1. On the vessel grid, click any time slot cell
2. The Slot Override Dialog opens showing the current schedule info (activity, time, capacity, and any existing override)
3. Choose an action:
   • Change time for this date — enter new start/end time and an optional reason (e.g., "Tide conditions")
   • Cancel this departure — hides this slot for the selected date only. A warning shows if guests are booked
   • Change capacity — set a different capacity for this date (e.g., equipment limitations)
4. Click Save Override (or Cancel Departure for cancellations)

Result: The slot shows an amber left border and warning icon indicating it is overridden. The base schedule remains unchanged for all other dates. To restore the original schedule, click the slot again and choose Restore base schedule.

How to Move a Slot Between Days (Drag and Drop)

Move a departure slot to a different day or vessel by dragging it on the grid.

1. On the vessel grid, click and hold a time slot (drag starts after ~8px of movement, so regular clicks still work)
2. Drag the slot to a different day column or vessel row. The target cell highlights in cyan when you hover over it
3. Release the slot. A confirmation dialog appears showing the source and target, and warns how many guests are booked on this departure
4. Click Confirm Move

Result: A TIME_CHANGE override is created on the target date. All SCHEDULED allocations (booked guests) are automatically moved to the new time. Guests who are already IN_PROGRESS or SERVED are not affected.

How to Manage Base Schedules for a Vessel

Add, edit, or delete the recurring time slots for a vessel directly from the Vessel Allocations page.

1. In the vessel column (leftmost), click the gear icon next to the vessel name
2. The Vessel Schedule Panel slides out showing all configured schedules (time, label, days of week, capacity override)
3. Click Add Schedule to create a new time slot. Set start/end time, label, days of week (click day chips to toggle), and optional capacity override
4. Click the pencil icon on an existing schedule to edit it, or the trash icon to delete it
5. Close the panel when done. The grid updates automatically

Result: The vessel's recurring schedules are updated. Changes apply to all future dates (subject to the days-of-week configuration). If future bookings exist, the system will auto-update SCHEDULED allocations when times change, or block deletion if bookings exist.

Note: You can also manage schedules from Service Management > edit service > Schedules tab. The Vessel Schedule Panel is a convenience shortcut.

Key Concepts

Vessel Grid vs Dive Board

Vessel Allocations is for schedule planning: which vessels run on which days, overriding/cancelling specific dates, and managing base schedules. Dive Board is the operational view for a single day: manifests, walk-ins, marking departed/served. Use Vessel Allocations to plan ahead; use Dive Board to run the day.

Base Schedules vs Overrides

A base schedule is a recurring time slot (e.g., "06:00 every day" or "14:00 weekdays only"). An override changes a single date: you can shift the time, change capacity, or cancel the departure entirely. Overrides are shown with an amber border in the grid. Removing an override restores the base schedule for that date.

Override Types

• Time Change — departure runs at a different time on this date (e.g., moved from 06:00 to 07:00 due to tides)
• Cancelled — departure is hidden for this date (bad weather, maintenance). Existing bookings need reassignment
• Capacity Change — different capacity for this date (e.g., equipment out of service reduces seats)

Drag and Drop

Slots can be dragged between day cells. This creates a TIME_CHANGE override and automatically updates booked guest allocations. Clicking still works normally — the drag only activates after moving the cursor 8 pixels, so clicks open the override dialog as expected.

Schedule Safety Guards

When editing a base schedule's time, any future SCHEDULED allocations are automatically updated to the new time. If allocations are already IN_PROGRESS or SERVED, the time change is blocked. Deleting a schedule is blocked if future bookings exist — cancel them first.

Troubleshooting

Vessel Not Showing in Grid

Cause: The vessel may not be a resource for the current business unit, or it has no schedules.

Fix: Click the gear icon on any vessel to open the schedule panel and add a schedule. Or go to Service Management to configure the vessel resource and its schedules.

Cannot Delete a Schedule

Cause: Future bookings exist on this schedule.

Fix: Cancel or reassign the future allocations first (use the Dive Board to manage individual bookings), then retry the deletion.

Cannot Change Schedule Time

Cause: Allocations that are IN_PROGRESS or SERVED exist in the future for this schedule.

Fix: Only SCHEDULED allocations can be auto-updated. Wait for in-progress trips to complete, or use per-date overrides instead of changing the base schedule.

Override Not Showing

Cause: The override may have been created for a different date, or the grid view doesn't include that date range.

Fix: Navigate to the correct date range. Overridden slots show an amber left border and a warning icon. Use the refresh button to reload data.