Health Records Tracker App

A fully customizable full‑stack application for tracking patient health records. This platform is built for healthcare providers to manage patient information and records in a secure and modern interface.

Features

• Patient Management: Create, update, delete, and list patients.
• Record Management: Track health records such as allergies, vaccinations, diagnoses, etc.
• Customizable UI & Backend: Easily adjust branding, themes, and API functionality.
• Modern Technology Stack:
  • Backend: Node.js, Express, MongoDB (Mongoose), Helmet, CORS.
  • Frontend: React with Material UI (MUI), Axios.

Technology Stack

• Backend: Node.js, Express, MongoDB (Mongoose), dotenv, helmet, cors.
• Frontend: React, Material UI (MUI), Axios.
• Database: MongoDB

Directory Structure

health-records-tracker/
├── backend/
│   ├── package.json
│   ├── .env
│   ├── server.js
│   ├── config/
│   │   └── db.js
│   ├── models/
│   │   ├── Patient.js
│   │   └── Record.js
│   └── routes/
│       ├── patients.js
│       └── records.js
├── frontend/
│   ├── package.json
│   ├── public/
│   │   └── index.html
│   └── src/
│       ├── index.js
│       ├── App.js
│       ├── config.js
│       ├── components/
│       │   ├── Header.js
│       │   ├── Footer.js
│       │   ├── PatientList.js
│       │   ├── PatientForm.js
│       │   ├── RecordList.js
│       │   └── RecordForm.js
│       └── styles/
│           └── main.css
└── README.md

Getting Started

Prerequisites

• Node.js (v14+)
• npm (v6+)
• MongoDB (local instance or hosted)

Backend Setup

1. Navigate to the backend directory:

   cd backend

2. Install dependencies:

   npm install

3. Create a .env file in the backend directory with the following content (adjust values as needed):

   PORT=5000
   MONGO_URI=mongodb://localhost:27017/health_records_db
   APP_NAME=HealthRecordsTracker

4. Start the backend server:

• For development:

  npm run dev

• For production:

  npm start

5. API Endpoints:

• Health Check: GET http://localhost:5000/api/health
• Patients: http://localhost:5000/api/patients
• Records: http://localhost:5000/api/records

Frontend Setup

1. Navigate to the frontend directory:

   cd frontend

2. Install dependencies:

   npm install

3. Customize settings:
   Open src/config.js and update:

• backendUrl: URL of your backend server.
• appName: Your application name.

4. Start the frontend development server:

   npm start

   The app will run on http://localhost:3000.

Production Build

Backend

• Ensure your environment variables are set and run:

  npm start

Frontend

1. Build the React app:

   npm run build

2. Deploy:
   Serve the contents of the build folder to your preferred hosting platform.

Customization

• Branding:
  Change the application name and other branding details in the backend .env file and in the frontend src/config.js.
• UI Adjustments:
  Customize Material UI components in the src/components/ folder and adjust global styles in src/styles/main.css.
• Backend Modifications:
  Extend models and routes in the backend folder as needed to support additional features or changes.

Contributing

Feel free to fork this repository and submit pull requests with improvements or customizations. For bugs or feature requests, please open an issue.

License

This project is licensed under the MIT License.

Authors

The UNC-Chapel Hill Google Developer Student Club (GDSC) Team is behind this project.