Brigham and Women's Hospital Request Management System

A comprehensive full-stack Java-based hospital operations platform designed to streamline workflows across an entire healthcare facility. The application provides secure request management, real-time updates, user administration, interactive navigation, and cross-platform support.

Features

Request Management

• View, create, assign, edit, and complete hospital service requests.
• Support for patent transport, equipment sanitation, security, medicine transport, food delivery, etc.
• Real-time request status updates and notification system via Google Firebase.
• Request history and auditing management.

Authentication & Security

• Secure user authentication using SHA-256.
• Role-based permission hierarchy and access control.
• Two-factor authentication (2FA).
• Secure session handling.

Account Personalization

• Admin-managed account permission levels.
• User profile personalization (e.g. theme, profile photo, name, etc.)
• Authentication Method & 2FA (SMS, Password, RFID scan, Email)

Interactive Hospital Map

• Live modifiable hospital map.
• Dashboard for map summary per hospital floor.
• Interactive navigation and A* pathfinding between hospital locations.
• Filters and Fuzzy Search.

---

Technology Stack

• Java
• JavaFX + SceneBuilder
• SQL
• Gradle
• Google Firebase
• Extras
  • FuzzyWuzzy
  • Twillo
  • Arduino
  • Apache Derby
  • SI4J
  • OpenCSV

---

User Manual

Logging In

1. Launch the application.
2. Enter your username and password.
3. Complete two-factor authentication if prompted.
4. After successful authentication, the dashboard will load.

Creating a Request

1. Open one of the request pages.
2. On the left, enter information required for a new request.
3. Select the assignee, location, and time due if applicable.
4. Submit the request.

Viewing Requests

• View active requests on request pages or in an All Requests page
• Find sorted requests by priority (Low, Med, High, OVERDUE)
• Monitor request status in real time
• (Admin) View requests history or completed

Completing Requests

1. Open an assigned request on a request page or assigned requests page.
2. Perform the requested task.
3. Update the request status to IN PROGRESS | COMPLETED | DISMISSED.

(Administrator-only) Managing Users

• Create user accounts via accounts page
• Reset passwords
• Assign roles
• Manage permissions
• Enforce two-factor authentication

Using the Hospital Map

• Search for rooms
• Locate departments
• Find locations with active requests
• Generate live active route to follow for handling the request
• Navigate between floors
• Filter types of icons on display
• (Admin only) Manage location positions

Notifications

• New assignments
• Request updates
• When a request completes
• Administrative announcements / custom toast

---

Security Considerations

• Role-based hierarchical authorization and permissions
  • NOTE: Employee permissions should be explicitly segregated to follow HIPAA regulations
• Secure authentication with SHA256
• Two-factor authentication or Multi-factor authentication
• Real-time session validation
• Administrative permission controls

---

Building the Project

Prerequisites

• Java JDK 11+
• Gradle
• Shadowjar

Build

In Gradle, run shadowjar utility.

The generated application will be located in:

build/shadowjar/

---

Running

Run the generated JAR (or open the file):

java -jar build/libs/<application>-shadowjar.jar

---

Configurations

Firebase

The application uses Firebase for real-time synchronization and retrieving initial data. To use, perform the following steps:

• Receive a service-account.json from an administrator or from Firebase project key generation
• Place service-account.json (ensure renamed to exact match) in src/main/resources/
• Build project with Gradle

Never make these credentials public.

---

Development

Running Tests

gradle test

Code Coverage

JaCoCo is configured to measure automated test coverage.

Coverage reports can be generated using:

gradle jacocoTestReport

Code Formatting

Spotless is configured to enforce consistent Java formatting. To automatically format code:

gradle spotlessApply

To verify formatting:

gradle spotlessCheck