Today
Today's Field Summary
Review open work, overdue inspections, and field status before crews head out.
Workspace setup
No assets have been imported yet.
Import an editable GIS asset layer first, or load sample field data to try maps, work orders, inspections, and reports before connecting a real municipal workspace.
Current Focus
No asset selectedPick a hydrant or sewer line to see details, save notes, or create work.
Search
Find Asset
Search by asset ID or choose a simple saved view.
List
Asset List
This table is the keyboard and screen-reader alternative to the map. Search or filter assets, select a row to open the asset panel, then use row actions to change status, create a work order, or start an inspection without using map markers.
- Use asset search and saved views to find records.
- Press Enter on a focused row to select that asset.
- Use the action buttons for status, work orders, and inspections.
Loading asset registry...
| Asset ID | Type | Status | Open Work | Last Inspection | Updated | Action |
|---|
No assets match the current search or saved view. Clear the filters, import an asset layer, or load sample field data to populate the registry.
Active map filters
Location has not been requested.
The map is interactive and may require pointer gestures. Keyboard users can search assets, use saved views, open the asset table, and use Focus on map actions to reach the same asset workflows.
Map legend
Today
Today's Field Summary
Start here to dispatch crews, review overdue work, catch failed inspections, and confirm the workspace is ready for field use.
- 0 Open work orders
- 0 In Progress
- 0 Assigned to crews
- 0 Overdue work
- 0 Failed inspections needing follow-up
- 0 Pending sync changes
Priority queue
Priority Queue
Urgent open work orders, failed inspections, and assets already marked needs service.
No urgent work, failed inspections, or needs-service assets are loaded right now. Items appear here when due dates, inspection results, or asset status need field attention.
Your work
Assigned to You
Active work orders assigned to the signed-in user, sorted by priority and due date.
No work orders are assigned to you right now. Assignments appear here after work orders are assigned to your user or email.
Assigned work
Assigned Work
Active work orders assigned to a crew or operator, sorted by priority and due date.
No assigned work is loaded yet. Create a work order and choose an assignee so supervisors can see what crews own today.
Due dates
Overdue Work
Open or in-progress work orders that have passed their due date.
No overdue work orders are loaded. Due dates on active work will surface here when they pass.
Inspections
Failed Inspection Follow-Ups
Failed inspections without a linked follow-up work order.
No failed inspections are waiting for follow-up. Failed results will appear here until follow-up work is created.
Recent activity
Recent Activity
Latest asset updates, created work orders, completed inspections, import runs, and admin changes from this workspace.
No recent activity is loaded yet. Update an asset, create a work order, submit an inspection, run an import, or save admin settings to build this activity trail.
Sync
Sync Status
Sync state is based on the current data source and connection status.
Offline queue
Queued Offline Changes
Offline asset updates, work orders, inspections, notes, and evidence metadata will appear here until they sync.
Map shortcuts
Quick Map Shortcuts
Jump to the map view crews need before they leave the yard.
Work
Field Work Board
Dispatch work by status, priority, due date, assignee, and linked infrastructure location.
Open
Needs triage or assignment 0 itemsCreate a work order from a selected asset when a repair, inspection follow-up, or service request needs triage.
In Progress
Crew accepted and active 0 itemsUse Start Work on an open item once a crew accepts the task and is heading to the asset location.
Completed
Finished or ready for review 0 itemsMark field work complete after crews finish the task so it appears in reports and closeout review.
Loading work order board...
No work orders have been created yet. Start by selecting an asset on the map, then create a work order tied to that infrastructure location.
Work detail
Select a work order
Choose a work order from the board or list to review crew assignment, due date, linked asset, notes, comments, and attachments.
- Status
- Not selected
- Priority
- Not selected
- Due date
- Not selected
- Assignee
- Not selected
- Linked asset
- Not selected
Notes
Notes will appear here when a work order is selected.
Linked asset preview
- Asset ID
- Not selected
- Type
- Not selected
- Status
- Not selected
Select a work order to see its linked asset.
Comments
Comments will appear here after a crew member adds the first work-order comment.
Attachments
Attachments will appear here after work-order evidence files are implemented.
Statuses
Work Status Guide
- Open Needs assignment, scope confirmation, or triage.
- In progress Field crew acknowledged and work is active.
- Completed Repair done, awaiting reporting or quality review.
Crew tips
Assigning Work
Traffic control
Plan Register
0 plans | 0 ready | 0 active | 0 scheduled devices
Loading traffic plans...
Saved traffic control plans will appear here with status, linked work, setup date, and device counts.
Builder
Traffic Control Plan Builder
Device schedule
Signs, Cones, Barriers, and Flaggers
Select a template to preview the device schedule.
Printable summary
TAC sign metadata
Temporary Condition Sign Catalog
Metadata is summarized from the TAC Sign Pattern Manual temporary-condition sign pages. No sign artwork is stored in the app.
Template workflow
Municipal Inspection Workflow
Select the asset, choose the municipal inspection template, record the field result, complete the checklist, attach evidence, and submit the record for reporting or follow-up work.
Current inspection
Select an asset from the map or asset list before submitting an inspection.
- Linked asset
- Template
- Result
- Evidence
- Submit
Quality controls
Inspection QA Snapshot
Quality score is a completeness signal for saved inspections. It starts at 100 and drops when records fail, omit findings, omit photo evidence, or save without a checklist.
- 0% Average completeness score
- 0% Failed inspection rate
- 0 Follow-up work orders
No QA flags need review. Continue saving inspections with notes and evidence photos; failed or low-quality submissions will appear here.
Trend watch
Inspection Compliance Trends
No weekly inspection trend exists yet. Start an inspection for a linked hydrant, sewer line, or manhole to begin tracking pass and fail movement.
Template adherence
Template Compliance
No template compliance records exist yet. Run the first inspection, then review whether the hydrant or sewer template is producing complete field records.
Field history
Recent Inspections
Loading inspection records...
Completed inspections will appear here with the template, result, severity, linked asset, inspector, date, and evidence. Choose a template, link an asset, complete the checklist, and save the first field inspection.
Supervisor reports
Reports
See where work is piling up, what needs attention first, which assets are causing repeat calls, and whether crews are closing work on time.
Report filters apply to records currently loaded in this browser. Filters run on currently loaded workspace records in this browser. They are not server-side historical queries.
Exports
CSV and PDF exports will include the currently filtered manager summary, waiting work, overdue attention list, completed work trend, inspection issues, asset workload, and crew assignments.
Loading report metrics...
- 0 Open jobs to manage
- 0 Jobs closed this week
- 0% Overdue share
- 0% Inspections needing action
Open jobs
How long requests have been waiting
Backlog aging appears after work orders are created. Add work order created dates so supervisors can see which requests are starting to stall.
Needs attention
Jobs to review before they slip further
Overdue risk appears after active work orders have due dates and priorities. Add both so high-risk items can be surfaced before they slip.
Work completed
Are crews closing work each week?
Closure trend appears after work orders are marked completed. Close finished field work to build the four-week throughput view.
Inspection issues
What inspections need follow-up?
Inspection reporting appears after inspections are submitted. Save inspection result, template, evidence, and linked asset data so supervisors can review completion, failures, follow-up work, and template pass rates.
Work by asset type
Which infrastructure is driving work?
Asset type workload appears after work orders are linked to mapped assets. Link work to hydrants, valves, manholes, sewer lines, or water assets to see demand by infrastructure class.
Asset condition
Which assets are healthy or need service?
Asset condition reporting appears after mapped assets are loaded. Add asset status, open work, and inspection dates to see in-service, needs-service, unknown, open-work, and last-inspected coverage.
Repeat problem spots
Where are issues happening again?
Geographic clustering is not implemented yet. Hot spots will appear here when the same asset has repeated work orders or failed inspections in the loaded report data.
Crew assignments
Who has open work right now?
Crew load appears after work orders are assigned. Add assignees so supervisors can compare active work by crew or operator.
Admin access required
GIS Imports require an Admin role
Imports can create or update municipal asset records, record GIS source details, and affect field workflows. Ask a workspace admin or owner to run imports, review data mapping, or grant the appropriate role.
Admin ingest
Imports (Admin)
Use this workflow to prepare a municipal GIS or asset dataset and decide whether it should become editable operational assets or remain a read-only reference map overlay. Current static support is partial: configured demo imports can run, while file preview and validation are shown as admin workflow placeholders.
- 1. Upload Choose whether the source is an editable asset layer or reference GIS overlay.
- 2. Preview Review sample records before any commit.
- 3. Map Fields Match source columns to TraverseOps fields.
- 4. Validate Check IDs, coordinates, duplicates, and status values.
- 5. Confirm Review what will be created or updated.
- 6. Results View committed records and import history.
Upload
Choose the dataset and source
Preview
Sample records
This step will show sample rows, geometry type, coordinate coverage, and record counts before any changes are saved.
Map Fields
Match source fields to TraverseOps
- Asset ID
- Required unique identifier
- Status
- Map to In service, Needs service, or Unknown
- Geometry
- Point, line, polygon, or coordinates
Validate
Checks before commit
- Asset IDs present and unique.
- Coordinates or geometry available.
- Status values mapped to supported conditions.
- Duplicate records and missing required fields reviewed.
Confirm
Review import impact
This step will summarize creates, updates, skipped records, warnings, and the target workspace before commit. The current button commits only supported configured imports.
Results
Import outcome
Results will show committed record counts, validation warnings, failed rows, and links back to the map and import history.
GeoJSON import guidance
What admins should check before committing GeoJSON
CSV import guidance
Expected columns for spreadsheet-style asset imports
CSV import is not fully wired in this static workflow yet, but the wizard is structured for files where each row represents one editable operational asset with coordinates and mapped fields. Large spreadsheets used only for GIS context should be treated as reference overlays or reviewed before import.
Shapefile import planned
Expected support once backend processing exists
Shapefile import does not work in the current static app. It will require backend support to unpack a .zip, read .shp, .shx, .dbf, and .prj files, reproject geometry when needed, and run validation before committing records.
Loading import runs...
No import runs have been logged yet. Start with one editable asset layer for operational field work, choose its dataset type, record the source file and validation notes, then commit the supported import or save the run history for admin review. Large read-only GIS context layers can be logged as overlays instead of imported as editable assets.
Import history
Saved runs show dataset source, import outcome, counts, timing, owner, and notes from supported import activity. Rollback requires cloud import tracking and is not available for local/demo import logs.
| Dataset | Source Type | Status | Imported Count | Error Count | Started By | Started At | Completed At | Notes | Action |
|---|
Import rules
Recommended Source Handling
- Hydrants Import as editable operational assets when crews need to update status, complete inspections, attach photos, or open work orders on individual hydrants.
- Large GIS layers Serve parcels, boundaries, supply areas, and very large mains datasets as read-only map overlays unless crews need direct write access to individual features.
- Operational versus reference Operational assets are searchable records that crews change; reference GIS layers provide map context and may be loaded from hosted GeoJSON or bbox layer APIs.
- Validation notes Record transforms, source dates, and QA assumptions inside each import run.
Advanced / Developer notes
Editable/searchable operational layers are stored in the configured records backend so inspections, work orders, notes, and evidence can attach to each asset. Large read-only reference GIS layers can stay as hosted GeoJSON overlays or use the bbox layer API for map display.
Layer model
Layer Strategy
Admin access required
Workspace Administration requires an Admin role
Admin pages control users, roles, crews, templates, imports, map layers, organization settings, billing placeholders, and audit review. Ask a workspace admin or owner to make changes or update your role.
Admin console
Workspace Administration
Configure the municipal workspace in small, reviewable sections. Features that require cloud administration or billing systems are shown as placeholders until those services are connected.
Users & Roles
Role Matrix
Use roles to keep shared devices read-only, allow field editors to update operational records, and reserve imports and settings for administrators.
| Capability | Viewer | Editor | Admin |
|---|---|---|---|
| View assets and maps | Yes | Yes | Yes |
| Update status and notes | No | Yes | Yes |
| Create assets and configure layers | No | No | Yes |
| Access imports and admin settings | No | No | Yes |
Crews
Crew Assignments
Crews group field users so supervisors can assign work to a team, filter work-order boards and reports by crew, and compare workload across operators.
Asset Types
Operational Asset Registry
Inspection Templates
Template Library
Templates define checklist items, required evidence, result options, severity, and whether failed inspections create follow-up work. Required checklist items should be completed before submission; failed results can require photos, findings, severity, and follow-up settings.
Work Order Settings
Rules and Follow-Up Defaults
These settings shape how municipal work orders move through the field queue, how priority is interpreted, when due dates become risky, and what happens after failed inspections.
Loading admin settings...
Workspace settings are using the current defaults. Review inspection rules before field rollout, invite the municipal users who need access, and save changes when policy decisions are final.
Map Layers
Layer Visibility and Sources
Map layer administration should distinguish editable operational assets from read-only reference overlays.
Imports
Data Ingest Governance
- Operational asset imports Use for records crews will inspect, update, and connect to work orders.
- Reference GIS overlays Use for large read-only context layers that should not become editable assets.
- Rollback planning Rollback requires cloud import tracking before it can be safely enabled.
Organization Settings
Organization Profile
Organization settings identify the municipality, workspace URL slug, default timezone, administrative contact, and support contact shown to staff.
Billing
Plan and Usage
Billing should summarize the current plan, users, asset limits, storage limits, and billing contact. Payment collection is not implemented in TraverseOps yet.
Plan records are not connected. Use this as a read-only placeholder until billing storage exists.
Production billing should show invited users, active users, and role mix.
Limits should account for editable operational assets and large read-only GIS overlays separately.
Storage should include evidence photos, import files, reports, and retained audit history.
A cloud workspace should store the municipal billing or administrative contact for plan notices.
Audit Logs
Workspace Activity
Audit logs help administrators review imports, settings changes, asset edits, work-order activity, inspection submissions, and user changes.
Filters apply to audit rows currently loaded in this workspace. Cloud audit history uses the normalized audit_logs table when connected.
No audit rows loaded.