Admin Reference
Scheduling Route Reference
Understand the planner’s board, timeline, map, selection actions, quick-view tools, and dynamic handoffs into sites, inspections, work orders, and AI context.
Before you start
- You need the route-level planner behaviors behind Deucalion’s scheduling workflows.
Expected outcome
You can use the scheduler deliberately across board, timeline, and map views, and understand how deployed work reaches the engineer app.
What this route is for
Scheduling owns planning, assignment, deployment, backlog review, day-run construction, and fast drill-in to inspection and work-order detail routes.
Visibility and capability notes
| Item | Details |
|---|---|
| Route id | scheduling |
| Visibility | Customer-facing route, but scheduler capability still governs whether it appears in some workspaces. |
| Capability notes | The route is also sensitive to engineer field-work eligibility and route-aware AI availability. |
| Direct inbound | Shell nav, dashboard, map, inspection and work-order planning handoffs, and site-scoped scheduling launches. |
Main regions, views, and dialogs
| Surface | What it does |
|---|---|
| Planner views | board, timeline, and map answer different planning questions. |
| List mode | Optional list-style queue beside or inside the planner context. |
| Guidance and activity rail | Surfaces warnings, planner guidance, and current context. |
| Selection region | Appears when jobs are selected for bulk actions. |
| Dialog layer | Warnings, engineer rules, quick view, task, bulk update, day run, recurring import, and batch inspection workflows. |
Key actions
- Reassign, reschedule, or drag work across the planner.
- Open quick view for one job without leaving the planner.
- Build day runs.
- Run batch inspection planning.
- Maintain engineer rules.
- Start recurring imports.
- Export scheduled work.
- Refresh the scheduler workspace.
- Launch AI Assistant with the current slice or selected jobs.
Filters and URL state
| State group | Params |
|---|---|
| Date window | start, end, timelineDate, timelineMode |
| Core filters | engineerId, siteId, jobType, status, q, focus |
| View and panels | view, list, listMode, filters, guidance, guide, panel |
| Selection | selected |
focussupports operational slices such asall,blocked,flagged,unassigned,unscheduled,draft,ready, anddeployed.- Scheduler state is heavily hash-backed so office teams can reopen the same planning slice directly.
Outputs and side effects
- Changes assignment, scheduling, deployment, and selected-job state.
- Opens and completes planning workflows such as day runs, recurring imports, and bulk updates.
- Sends live work visibility to engineers once jobs are deployed and assigned correctly.
- Exports scheduled work for external coordination.
Inbound links
- Shell
Schedulingnavigation. - 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
Indirect handoffs
- Engineer rules and field-work eligibility control who can appear as an assignee.
- Site completeness and access notes shape whether the planner can be used confidently.
- Deployed work becomes the engineer app’s live day-run reality, so scheduling errors propagate fast.
Troubleshooting
| Symptom | What to check |
|---|---|
| A field user is missing from the assignee picker | Confirm field work is enabled. This is often an eligibility rule, not a user-sync problem. |
| A deploy action is blocked | Review warning and deploy-preview guidance first. |
| The wrong slice keeps reopening | Check the hash state for saved view, focus, and date params. |
| Jobs are visible in the planner but not to engineers | Confirm assignment, deployment state, and the correct workspace membership. |
Map Route Reference
Understand the site map’s filters, popup actions, and spatial handoffs into sites, scheduler, inspections, work orders, and defects.
Inspections Route Reference
Understand the inspection queue, create and detail dialogs, reassignment and rescheduling flows, and certificate or quote handoffs.