nhs-app v1.0.0
Description :point_left:
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 :rocket:
https://nhs-app.herokuapp.com/
- username: admin
- password: admin
Youtube video
Prerequisites
- Node.js 6.9.1 or later - install from https://nodejs.org/
Installing - easy :electric_plug:
- Download the repository
git clone https://github.com/margiki/NHS-nodejs-webapp- Open the Terminal (Linux & MacOS) or PowerShell (Windows) and change directory to the project folder.
- Type ‘npm install’ in the Terminal (PowerShell) and press Enter. All the dependencies would be installed.
- 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.
- The application should be live on the local port 3000.
- Type http://localhost:3000/ into a browser.
- To login use the username: admin and the password: admin
- Now you should be inside the application
How to use it :book:
Dashboard
Data about patients and rooms is available here. The page is split into three tables.
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
Patient page
Double click on a patient name on the dashboard to get here.
System settings
The control center of the application. It allows users to manage the diseases & rooms of the Hospital and create new accounts
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 :open_file_folder:
| 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
Frontend
Database
Databse 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:admin123@ds145220.mlab.com: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 :bug:
- 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. :money_with_wings:
1 year ago