Staff Worklist module: one queue for unsigned results, overdue orders, unanswered referrals and visit prep (testers wanted)

Hi all. I’ve published a module that puts the work that tends to fall through the cracks into one list across all patients, so staff don’t have to check four separate reports:

Tab Listed when Leaves the list when
Results to sign A result came in and nobody has signed it A clinician signs it
No result yet An order has no final result after 7 days (1 day for urgent) A result arrives, or the order is completed or cancelled
Referral replies An outgoing referral has no Reply Date after 14 days Someone enters the reply date
Care gaps, upcoming visits A patient seen in the next 2 days has clinical reminders due The visit passes or the reminders are met

It only reads clinical data. Each row opens the OpenEMR screen where the work is done, and the item disappears once that work is recorded. Staff can assign, snooze or dismiss items with a reason, and every change is logged. Unsigned results can’t be dismissed, and critical ones can’t be snoozed. A critical result left unsigned for 4 hours gets a red banner. Items are grouped by site, and each user can narrow the list to the sites they work at.

Install (PHP 8.3 or later), from the OpenEMR directory:

composer require anun333/oe-module-staff-worklist

Then go to Modules › Manage Modules, and Register, Install and Enable it. A Worklist menu entry appears next to Messages. FOOTPRINT.md in the repository lists everything installing it adds: three tables of its own, one background-service row, no change to core tables and no outbound network.

Status: a pre-release, tested on 8.4.1 and current master with synthetic data only. I don’t know yet how it behaves on a real clinic’s data, which is why I’m posting.

What would help:

  • Try it on a test copy of your database and tell me which counts look wrong, or which items shouldn’t be there.
  • If you’d rather not install anything, tools/profile-counts.sql in the repo is a read-only query that returns clinic-wide counts only, with no patient details: how old the unsigned-results backlog is, and how often referral replies get recorded. Those numbers would tell me whether the default thresholds make sense.
  • Tell me which of the four tabs your staff would actually use, and what’s missing.

The referral tab follows the Reply Date on the Referral form for now. The longer-term plan is FHIR Task status, discussed in Future Direction for SDOH Referral Development.

Code, issues and docs: GitHub - anun333/oe-module-staff-worklist: One queue of outstanding staff work across patients for OpenEMR: unsigned results, orders with no result, referrals with no reply, care gaps for upcoming visits · GitHub

I built it with help from Claude Code (an AI coding assistant) and reviewed and tested the result myself.