Roles & platforms
| Role | Typical device | Shell UI | Primary areas |
|---|---|---|---|
| Service manager | Mac (Catalyst) or iPad | Sidebar navigation | Schedule board, Assign, Transfer import of field returns |
| Employee / contractor | iPhone | Bottom tabs | Jobs queue, Transfer import/export, field diagnostics |
| Surveyor (same app) | Any | Adaptive | Surveys + optional survey-type work orders |
One universal app (iPhone + iPad + Mac Catalyst). Managers get a wide sidebar layout automatically on Mac and regular-width iPad; field techs get a compact tab bar on iPhone.
| Platform | Build |
|---|---|
| iPhone / iPad | Native iOS |
| Mac desktop | Mac Catalyst (SUPPORTS_MACCATALYST = YES, device family includes 6) |
Default Mac window size: ~1280×840. Work-order share/import uses the system share sheet and Files on all platforms.
Work-order file exchange (no cloud required)
Portable packages move assignment data to contractors and field returns back to the office — without a shared cloud account.
Data handoff to contractors
Manager (iPad / Mac)
.msworkorder
.msworkorder both ways
Worker / contractor (iPhone)
Outbound data: assignment, vessel, marina/slip, appointment, type-specific fields (claim #, referral, etc.). Return data: diagnostics, progress timeline, photos, cost lines, completion status. See workflow training for the full work-order lifecycle chart.
Life of a work order (summary)
.msworkorder- Not automatic SMS parsing of free text — the attachment file is the interface (reliable, structured, same as IM/CRS transfer files).
- Managers can still text a short note; the authoritative assignment is the
.msworkorderpackage.
App Store vs firm license (recommended)
| Channel | Use |
|---|---|
| Public App Store | Independent techs and small firms |
| Unlisted / org invoice (optional later) | Yard-branded deployments |
Bundle identity
- IAP:
grego.mst.sub.monthly/grego.mst.sub.annual. Bundle ID:grego.MarineServiceTech - Document type:
com.grego.marineservicetech.workorder/.msworkorder
Privacy
Exports contain customer boat names, locations, and job notes. Share only with intended recipients. See privacy-policy.md.