eIPS Fidelity Web Application

"The Beast" is a web application used by the Department of Psychiatry at UNC-Chapel Hill to collect and examine data from various mental health agencies across North Carolina to help find employment for those who are struggling with mental health and/or substance use disorders.

The intended goal of "The Beast" is to make the data collection more streamline for our client.

Project Structure

"The Beast" utilizes the MEAN stack.

• MongoDB
• Express.js
• Angular
• Node.js

The frontend web application is built up using Angular and Survey.js.
The backend API is built up using Node.js, Express.js, and mongoose for database connection.
The database is MongoDB.

Programming Languages
Frontend: HTML/CSS, Typescript
Backend: TypeScript

Frontend Structure

The frontend has component folders for each required survey. Within those folders there are more specific components that relate to adding data and displaying group or individual data. More details in code comments.

There is also a model folder, with instances that relate to each survey for data interfacing/modeling purposes, and a service folder that has components for HTTP to the backend API connections.

Resources used for the frontend:

Connecting Angular to a Node.js application
Creating a dynamic Angular Mat Table

Backend Structure

The backend follows a RESTful API structure.

Resources used for the backend:

RESTful API structure
Express Routing

Note: Please include your gmail address and app password in .env file in the root folder: EMAIL_PASSWORD=##### EMAIL_USERNAME=#####

Starting the application

In it's current state, the application is not running on a server so it must be run on localhost.

We recommend cloning and accessing the repo through GitHub Desktop.

Once you have the repo...

Open the repo in whatever IDE you choose to use

To download all dependencies needed for frontend, open a terminal and run:

cd my-app
npm install

To download all dependencies needed for backend, open a terminal and run:

cd api
npm install

Upon completion, open a terminal and run the following to start the backend server:

cd api
npx tsx src/app.ts

In another terminal, run the following to start the frontend server:

cd my-app
ng serve

Make sure you have your MongoDB server running as well:

brew services start [email protected]

Now you can open the web page in your localhost browser.

To stop the MongoDB server:

brew services stop [email protected]

More detailed breakdown of the application was provided to the client.