Dive Planner

Summary: Plan and manage courses, sessions, dives, and staff schedules in a unified calendar.

Audience & Prerequisites: Operations and instructors with scheduling permissions; course products configured.

UI Paths:

  • Planner → Calendar (planner)

  • Dive Planner (server-driven instances + sessions view)

  • Unified Dive Planner (combined courses/voyages view, if enabled)

Step-by-step

  1. Navigate and choose a view

  • Planner header shows Today, Previous, Next, and a date picker.

  • Views: Day, Week, Month (Month may show “not yet implemented” in some builds).

  • The header shows the formatted current date or “Week of …”.

  1. Create events (courses/dives/regular)

  • Use New Course Instance from instances lists, or open the event creation flow in the planner.

  • Event types: Course, Dive, Regular.

  • Fields:

    • Title, Date, Start/End time, Location, Notes, All-day (optional).

    • Course: Course (from catalog), Instructor (when available).

    • Dive: Dive Site, Max Depth, Max Participants (optional).

  • Submit creates the event via the relevant API and refreshes the calendar.

  1. Manage course instances and sessions (Dive Planner page)

  • Instances list is filtered to Active/Scheduled (includes Completed when appropriate).

  • Sessions are loaded for visible instances; morning/afternoon defaults if generated.

  • Calendar sync: if connected, sessions can be synced to Google Calendar.

  1. Browse and filter

  • Search: filter instances by name, course name, or code.

  • Status filters: Active, Scheduled, Completed, Cancelled.

  • In the planner, switch Day/Week/Month and use the date picker to navigate.

  1. Inspect and edit events

  • Click an event card to open details: time, location, type, staff.

  • Use Edit to open the event edit modal; Save updates and closes it.

Results & Where to Verify

  • New/updated events appear immediately in the planner (Day/Week/Month views).

  • Course instances and sessions appear on the Dive Planner timeline and (optionally) in Google Calendar.

  • Course Products: configure products and pricing.

  • Course Instances: create and manage scheduled runs.

  • Assign Divers: assign staff and participants to specific operations.

Troubleshooting

  • Month View not implemented: use Day or Week views.

  • No events loaded: check date filters and company context; ensure products/instances exist.

  • Calendar sync: verify Google Calendar connection in Settings.

Permissions

  • Scheduling access required. Editing and creation may require elevated roles.

Last updated