• Stars
    star
    181
  • Rank 212,110 (Top 5 %)
  • Language
    JavaScript
  • Created over 7 years ago
  • Updated over 7 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

NodeJS web app for managing patients and planning their distribution across hospital’s rooms.

App picture

Description 👈

It's a web application for managing hospitals rooms and determining the patient's priority for isolation. The app provides a centralised hub for managing the patients and planning their distribution across hospital’s rooms.

It allows nurses to keep track of the patients and their diseases in real time and to have an overview over the patients and rooms, and better manage the rooms assignment across patients.

Live demo 🚀

https://nhs-app.herokuapp.com/

  • username: admin
  • password: admin

Youtube video

Youtube video

Prerequisites

Installing - easy 🔌

  1. Download the repository
git clone https://github.com/margiki/NHS-nodejs-webapp
  1. Open the Terminal (Linux & MacOS) or PowerShell (Windows) and change directory to the project folder.
  2. Type ‘npm install’ in the Terminal (PowerShell) and press Enter. All the dependencies would be installed.
  3. Go back to the Terminal (PowerShell) and be sure that you are pointing inside the project folder. To open the application, type ‘node app.js’ and press Enter.
  4. The application should be live on the local port 3000.
  5. Type http://localhost:3000/ into a browser.
  6. To login use the username: admin and the password: admin
  7. Now you should be inside the application

How to use it 📖

Dashboard

Data about patients and rooms is available here. The page is split into three tables.

Dashboard

Dashboard

To clear the red warning sign you need to go on the patient’s personal page. To do that, you have to double click on his name. By clicking on the ‘Update button’ on the bottom of the page, the patient’s diagnosis in updated for the next 24 hours (consequently, the red warning sign disappears).

Add patient page

You can add a new patient in the system with his personal details and his diseases. The application automatically computes the score of the patient based on the entered diseases

Add patient page

Patient page

Double click on a patient name on the dashboard to get here. Patient page

System settings

The control center of the application. It allows users to manage the diseases & rooms of the Hospital and create new accounts

System Settings

App Modules and Code organisation

Modules

Module Core Patients Diseases Rooms
Functionality - login system - add / delete patients - add / delete diseases - assign rooms to patients
. - add users - update patient's diagnosis - assign disease to patients - add / remove rooms
. - view dashboard - view patient’s page
. . - retrieve patient's information

Code organisation 📂

Folder Content Responsability
/public Contains the public files, such as CSS, fonts and scripts.
/routes Manage the HTTP requests. Is divided into smaller modules responsible for disjoint tasks.
. /app.js Renders dashboard page
. /disease.js Responsible for diseases
. /login.js Responsible for logging in
. /patients.js Responsible for patients
. /rooms.js Responsible for rooms
. /settings.js Renders settings page
. /users.js Add new users and logout
/server Defines the database and Schemas
. /db/mongoose.js Database settings
. /models Defines Schemas
/views Render pages
. /layouts The core layout; each page is rendered inside the layout
. /(other files) Contains specific visual changes for every page

Technologies

Backend

Nodejs - ExpressJS

Frontend

jQuery

Database

MongoDB - Mongoose

Databse Schema

Database schema

The available application is connected to a MongoDB database online. If you want to change the database to another one, you need to go: NHS app folder -> server -> db -> mongoose.js

Inside the file, you need to change the database link from mongoose.connect("mongodb://admin:[email protected]:45220/nhs-app"); to mongoose.connect("your-database-link");

REST Apis

The backend and frontend communicate through REST Apis. On the frontend, we make Ajax requests using jQuery to the following routes:

URI Returns
/app/getdiseases returns information about all diseases in the system
/app/getpatients returns information about all patients in the system
/app/getpatient/:hospitalNumber returns information about a specific patient
/app/getrooms returns information about the rooms in the system

Known bugs 🐛

  1. On some mobiles devices (iPhone, iPad) assigning rooms to patients is not working because mobile browsers doesn’t interpret the double-click. Also, the user can’t enter the patient's page because of the same reason. However, on LG mobile devices this feature works.

License

Free to use, copy and distribute. 💸