Clinician workspace
What it does
Clinician workspace is the internal front door for care providers. It aggregates read-only views over the platform — my-patients panel, clinical inbox, unified worklist, and unified patient chart — while writes still go through the owning engines.
Where to find it
| Screen | Path | Permission |
|---|---|---|
| Workspace home | /workspace | workspace.status.read |
| My patients panel | /workspace/panel | workspace.panel.read |
| Clinical inbox | /workspace/inbox | workspace.inbox.read |
| Unified worklist | /workspace/worklists | workspace.worklist.read |
| Patient chart | /workspace/patients/{id}/chart | workspace.chart.read |
| Shifts, leave, credentials (self-service) | /workforce/staff-portal | Linked from workspace; workforce portal permissions |
Clinical staff landing from My staff portal (/workforce/portal) are routed to My patients
when their user type is provider/clinical.
My patients panel
The panel lists patients you may act on in the current facility workspace. Membership is derived on the server from facility assignments, effective scope, and recent encounters — it is never a stored list you can edit here.
- Use pagination at the bottom; totals reflect the filtered in-scope set only.
- Enable Public display (hide names) when showing the screen where others can read over your shoulder. Names are redacted on the server; the UI shows “Patient (name hidden)” rather than a fake name.
- Scope indication shows how many assigned facilities contribute to the panel.
- Use Open chart (when permitted) to load the unified workspace chart at
/workspace/patients/{id}/chart— one call with per-section availability markers.
Click a patient name (when shown) to open the demographic patient record at /patients/{id}.
Patient chart
Open from My patients → Open chart or directly at /workspace/patients/{id}/chart when you hold
workspace.chart.read.
The chart assembles these sections in one request:
- Clinical summary
- Summary panel (allergies and other dashboard strips)
- Active medications
- Open orders
- Referrals
- Upcoming appointments
If a source is unavailable, the section says so explicitly — an empty medications list means none recorded, not “could not load”. Allergy status shows Recorded, No known allergies, or Not recorded distinctly.
Clinical inbox
The inbox merges pending result reviews and workflow tasks assigned to you. Abnormal results sort to the top; the server may flag unavailable sources when an upstream engine cannot be reached.
- Use Acknowledge on result-review rows — the workspace delegates to clinical; sign-offs are not stored in the UI.
- Use Complete on workflow-task rows when you have
workspace.inbox.write. - Pagination totals reflect the merged set across sources.
Unified worklist
The worklist merges queue items assigned to you, workflow tasks, and your open orders
(PLACED / IN_PROGRESS). Queue rows keep the queue engine's service order.
- Start on queue rows moves the item to
IN_SERVICE(requiresworkspace.worklist.write). - Complete on workflow rows delegates to the workflow engine.
- Order rows are read-only here — fulfil them in the owning module.