g0tazu / oe-module-nursing
OpenEMR Nursing Module - Inpatient dashboard, ICU nursing forms (fluid balance, nutrition, SOFA, APACHE II, care plan) and vital signs
Package info
github.com/GustavoOtazu/oe-module-nursing
Type:openemr-module
pkg:composer/g0tazu/oe-module-nursing
Requires
- php: >=8.2
- openemr/oe-module-installer-plugin: ^0.1.0
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
- openemr/openemr: <8.1.0
Replaces
None
README
An OpenEMR module for the nursing record of an intensive care unit: an inpatient list, ten nursing forms, ICU severity scores and a vital signs dashboard. It is installed as a custom module and does not modify any OpenEMR file, so OpenEMR can be updated and the module keeps working.
It was developed as an undergraduate thesis project at the Facultad Politécnica, Universidad Nacional de Asunción (Paraguay), together with the ICU of the Instituto de Previsión Social (IPS). The interface is translated into Spanish.
Features
Inpatient list (top menu Nursing)
- Current admissions with record number, ward, bed and admission date; discharge and death registration.
- A form selector per patient, with direct access to OpenEMR's vitals form for that admission.
- A card in the patient summary showing whether the patient is admitted, where and since when.
Location history (button Location and transfers)
- Ward, bed and service are not overwritten: each transfer closes the current location and opens a new one, and the admission keeps the full history.
- A bed can be reserved before the patient arrives (e.g. still in the ED); the current location changes only when the arrival is recorded.
- Data entry errors are corrected without recording a transfer, keeping who corrected them and when.
- Location changes made outside the module (e.g. by the hospital information system) are detected and recorded.
form_encounterkeeps only the current location; the history is in the module's own tablenursing_admission_movement.
Teams of the ICU stay (same screen, section Teams)
- The primary team is always the ICU team, which decides admission and discharge (the module is for the ICU). The unit within the ICU comes in the department.
- Shared care: other teams that also follow the patient (e.g. General Surgery after an operation). They do not block the ICU discharge, which is the ICU team's decision, but the discharge warns that they are still following the patient. Their participation in the stay ends with the discharge or before, when the team stops following the patient.
- Consultations: a specialty is asked for an opinion; it does not take over the care and does not affect the discharge. The request, the answer and the recommendation stay recorded.
- Each shared care team and each answered consultation can record the professional (optional): the physician of the team that follows the patient, or the one who answered.
- The inpatient list shows the shared care teams and the pending consultations of each patient.
- Stored in the module's own table
nursing_admission_team. The distinction between shared care and consultations follows a comment in the module's RFC (openemr/openemr#11426).
Nursing forms (each one also available from the encounter)
- Wound care, applications, care bundle, nursing evaluation (with Glasgow), mechanical ventilation record.
- Fluid balance, nutrition, SOFA score, APACHE II score, nursing care plan and progress note.
- Every form shows, below it, the previous records of the same form in the admission.
- Each record can be printed as a PDF; signed records become read-only.
Scores and prefill
- Glasgow, fluid balance, SOFA (Vincent et al., 1996) and APACHE II (Knaus et al., 1985) are calculated on the server; the form shows a live preview.
- SOFA and APACHE II prefill the data already recorded (vital signs, nursing evaluations, ventilation records, fluid balances, previous scores), proposing the worst value of the scale's window: the last 24 h for SOFA, the first 24 h of the admission for APACHE II.
- Vital signs are chosen as one whole take of OpenEMR's vitals form: the worst take is preselected, the nurse can pick another one, and the take used is saved with the score.
- Systems or variables without data are shown as No data (they add 0 points), and APACHE II warns when the temperature was not taken rectally.
Vital signs dashboard
- One card per inpatient with the latest take, a warning when it is older than 6 hours, and Chart.js charts of the admission's evolution.
Admission API (for the hospital information system)
- Adds the resource
nursing_admissionto OpenEMR's standard REST API, so the SIH web service (ips_ws) keeps the admissions up to date through the API (OAuth2) instead of writing to the database. The standard API creates patients and encounters but cannot set the admission data this module adds. GET /apis/default/api/nursing_admission?nro_registro=…or?origen=sih&estado=abierta,POST /apis/default/api/nursing_admission(admission: patient UUID, record number, admission date and location) andPUT /apis/default/api/nursing_admission/{nro_registro}(location change and/or discharge).- Same rules as the inpatient screens: an admission is an Inpatient encounter with its form row and location history; a transfer is recorded in the history (source SIH web service); a discharge fills
date_endand closes the history. Repeating a request does not duplicate anything, and a patient who already has another open admission is rejected (409) for a person to review. - Scopes
user/nursing_admission.read/.write(or.crus); the user also needs thepatients/medACL.
Requirements
- OpenEMR 8.1 or later
- PHP 8.2 or later
Installation
- From the OpenEMR directory:
composer require g0tazu/oe-module-nursing
Composer places it ininterface/modules/custom_modules/oe-module-nursing. - In OpenEMR, go to Administration → Modules → Manage Modules, find the module among the unregistered ones and click Register, Install and Enable. Installing creates the tables, registers the forms and loads the translations.
- The Nursing menu appears at the top.
Vital signs are recorded in OpenEMR's own vitals form; the module reads them from there.
Updating
composer update g0tazu/oe-module-nursing
Then, in Manage Modules, Disable and Enable the module. Enabling it runs its sql/install.sql again, which only adds what an older installation is missing (new tables, columns, forms and translations) and does not change existing data.
Development
The scoring classes (src/Scoring), the vital-sign take scoring, the location history rules and the team rules have unit tests in tests/. They need PHPUnit and OpenEMR's autoloader; NursingCardTest also needs an OpenEMR database.
License
GNU General Public License v3.0. See LICENSE.