Planner Interface Reference
Route-level reference for the scheduler planner — regions, views, action bar, selection bar, and layout controls.
Before you start
- You need the route-level planner interface details behind Deucalion's scheduling workflows.
Expected outcome
You can identify every region, view, and control surface in the scheduler and understand what each one does.
What this route is for
The Scheduling route owns planning, assignment, deployment, backlog review, day-run construction, and fast drill-in to inspection and work-order detail routes. It is the most important office-to-field handoff route in the product.
Visibility and capability notes
| Item | Details |
|---|---|
| Route id | scheduling |
| Visibility | Customer-facing route; scheduler capability governs appearance in some workspaces |
| Capability notes | Sensitive to engineer field-work eligibility and route-aware AI availability |
| Direct inbound | Shell nav, dashboard, map, inspection and work-order planning handoffs, site-scoped scheduling launches |
Main regions
| Region | Position | What it does |
|---|---|---|
| Filter bar | Top | Controls which jobs appear across all regions |
| Primary workspace | Left | The main planning surface (board, day timeline, week timeline, or map) |
| Guidance rail | Right | Capacity warnings, route suggestions, deployment activity, recent changes |
| Planner list | Bottom | 19-column sortable table with focus tabs and selection checkboxes |
| Selection bar | Overlay (bottom) | Appears when jobs are selected; shows count and bulk actions |
| Dialog layer | Modal overlay | Quick view, bulk update, task, day run, batch inspection, recurring import, warnings, engineer rules |
Views
| View | Component | Description |
|---|---|---|
| Board | SchedulingBoardView.jsx | Kanban lanes by engineer + unassigned backlog |
| Day timeline | SchedulingDayTimelineView.jsx | 06:00-22:00 hourly grid, engineer rows |
| Week timeline | SchedulingWeekTimelineView.jsx | 7 day columns, engineer grouping |
| Map | SchedulingMapAssist.jsx | Leaflet clustered markers, sidebar site list |
View state persists in both the URL (view param) and localStorage.
Action bar
| Button | What it does |
|---|---|
| New Task | Opens the task creation dialog |
| Batch Inspections | Opens the batch inspection creation dialog |
| Build Day Run | Opens the day-run builder dialog |
| Import | Opens the recurring import dialog |
| Export | Exports the current filtered job set |
| Refresh | Forces a full data refresh |
| AI Assistant | Launches AI Assistant with the current scheduler context |
Selection bar
Appears when one or more jobs are selected:
| Button | What it does |
|---|---|
| N selected | Shows the count of selected jobs |
| Bulk Edit | Opens the bulk update dialog |
| Deploy | Opens the deployment preview and apply flow |
| Clear | Deselects all jobs |
Job cards
Job cards appear in the board and timeline views. Each card shows:
| Element | Content |
|---|---|
| Title | Job title (linked to detail page) |
| Site name | Site where the work takes place |
| Duration | Estimated duration (e.g. "2h 30m") |
| Priority indicator | Colour-coded priority level |
| Status badge | Current status |
| Warning icon | Warning count; red for blocking |
| Operational badges | Crew size, equipment, OOH, access notes |
| Deployment indicator | Deployment state with acceptance: Draft, Ready, Deployed ✓ (acknowledged), or Deployed ○ (awaiting) |
| Checkbox | Selection for bulk actions |
Planner list
A 19-column sortable DataTable with the following columns:
| # | Column | Sortable |
|---|---|---|
| 1 | Checkbox | — |
| 2 | Job type icon | ✓ |
| 3 | Title | ✓ |
| 4 | Assignee | ✓ |
| 5 | Scheduled date | ✓ |
| 6 | Duration | ✓ |
| 7 | Priority | ✓ |
| 8 | Status | ✓ |
| 9 | Crew size | ✓ |
| 10 | Equipment | — |
| 11 | OOH | ✓ |
| 12 | Warnings | ✓ |
| 13 | Window start | ✓ |
| 14 | Window end | ✓ |
| 15 | Flex days | ✓ |
| 16 | Deployment state | ✓ |
| 17 | Site | ✓ |
| 18 | System | ✓ |
| 19 | Postcode | ✓ |
Focus tabs
| Tab | Filter applied |
|---|---|
| All | No additional filter |
| Blocked | validationWarnings contains a blocking warning |
| Flagged | validationWarnings is non-empty |
| Unassigned | engineerIds is empty |
| Unscheduled | scheduledDate is null AND targetMonth is null |
| Draft | deploymentState is draft |
| Ready | deployReady is true |
| Deployed | deploymentState is deployed |
| Awaiting | Deployed but engineerAcknowledgedAt is null |
| Acknowledged | Deployed and engineerAcknowledgedAt is set |
Keyboard navigation
| Key | Action |
|---|---|
| Arrow keys | Navigate between job cards or list rows |
| Enter | Open Quick View for focused job |
| Space | Toggle selection checkbox |
| Home / End | Jump to first / last item |
| Escape | Close active dialog |
Inbound links
- Shell Scheduling navigation
- Dashboard header and cards
- Map site popup
- Work-order or inspection planning prompts
- Scheduler-aware warning links from site or planner context
Outbound links
#/sites?siteId=...from warning and context actions- Job
detailHrefroutes into#/inspections?...and#/work-orders?... #/ai-assistantwith planner context
Bulk Operations and Deployment
Edit multiple jobs at once, manage the draft-to-deployed lifecycle, and understand how scheduled work reaches the field.
Filters and URL State Reference
Complete reference for all scheduler filter parameters, URL state management, focus tabs, and mutual-clearing behaviour.