WellHealth – A Comprehensive Mental Wellness & Professional Consultation Platform

Overview

WellHealth is a comprehensive mental wellness platform that enables individuals to assess, monitor, and improve their mental well-being while connecting with qualified healthcare professionals through an integrated digital ecosystem.

The system provides separate dashboards for Users, Doctors, and Administrators, enabling a complete wellness ecosystem.

---

Key Features

User Features

• Secure Authentication & Authorization
• Personal Dashboard
• Wellness Journey Tracking
• Journal Management
• Mood Tracking
• PHQ-9 Depression Assessment
• GAD-7 Anxiety Assessment
• PSS-10 Stress Assessment
• WHO-5 Well-Being Assessment
• Appointment Booking
• Notification Center
• Profile Management
• Wellness Analytics

Doctor Features

• Doctor Dashboard
• Appointment Management
• Availability Management
• User Assessment Review
• Wellness Monitoring
• Consultation Notes
• Follow-Up Recommendations

Admin Features

• User Management
• Doctor Management
• Appointment Monitoring
• Assessment Analytics
• Platform Analytics
• Communication & Email Center
• Notification Management

---

Technology Stack

Frontend

• React.js
• React Router
• Axios
• Recharts
• CSS3
• Context API

Backend

• Node.js
• Express.js
• MongoDB
• Mongoose
• JWT Authentication
• Nodemailer

Database

MongoDB

---

System Modules

Authentication Module

Features:

• Registration
• Login
• JWT Authentication
• Role-Based Access Control
• Password Management

Roles:

• Student
• Doctor
• Admin

---

Journal Module

Users can:

• Create Journals
• Edit Journals
• Delete Journals
• Mark Journals as Private
• Share Journals with Doctors
• Track Mood Entries

Journal Features:

• Timeline View
• Calendar View
• Mood Filters
• Activity Statistics

---

Assessment Module

The platform supports four validated assessments.

PHQ-9

Purpose:

Depression Screening

Range:

0–27

Categories:

• Minimal
• Mild
• Moderate
• Moderately Severe
• Severe

---

GAD-7

Purpose:

Anxiety Screening

Range:

0–21

Categories:

• Minimal
• Mild
• Moderate
• Severe

---

PSS-10

Purpose:

Perceived Stress Measurement

Range:

0–40

Categories:

• Low Stress
• Moderate Stress
• High Stress

---

WHO-5

Purpose:

Well-Being Measurement

Range:

0–25

Categories:

• Poor Well-Being
• Good Well-Being

---

Wellness Index

The Wellness Index combines all four assessments into a single score.

Formula:

Wellness Index =

(PHQ × 0.3)

• (GAD × 0.3)
• (PSS × 0.2)
• (WHO × 0.2)

Range:

0–100

Categories:

• 80–100: Excellent
• 60–79: Good
• 40–59: Moderate
• 20–39: Concerning
• 0–19: Critical

---

Appointment Module

Features:

• Doctor Discovery
• Doctor Profiles
• Slot Booking
• Appointment Tracking

Appointment Flow:

Requested → Confirmed → Completed → Reviewed

---

Doctor Notes Module

Doctors can:

• Create Session Notes
• Add Recommendations
• Schedule Follow-Ups
• Track User Progress

---

Notification Module

Notification Types:

• Assessment
• Appointment
• Journal
• Doctor Note
• System

Categories:

• Today
• Yesterday
• This Week
• Older

---

Communication & Email Center

Features:

• Email Templates
• Automated Emails
• Appointment Confirmation Emails
• Appointment Reminder Emails
• Assessment Result Emails
• Email Logs
• Email Analytics

---

Database Collections

Users

{
  _id,
  role,
  name,
  email,
  password,
  profile
}

Assessments

{
  _id,
  userId,
  type,
  score,
  severity,
  interpretation,
  recommendation,
  answers,
  completedAt
}

Journals

{
  _id,
  userId,
  title,
  content,
  mood,
  visibility,
  createdAt
}

Appointments

{
  _id,
  userId,
  doctorId,
  date,
  status,
  notes
}

DoctorAvailability

{
  _id,
  doctorId,
  availableSlots
}

DoctorNotes

{
  _id,
  appointmentId,
  doctorId,
  userId,
  notes,
  recommendations,
  followUpRequired,
  followUpDate
}

Notifications

{
  _id,
  userId,
  type,
  title,
  message,
  read
}

EmailTemplates

{
  _id,
  name,
  category,
  subject,
  body,
  variables
}

EmailCampaigns

{
  _id,
  title,
  audience,
  templateId,
  status,
  scheduledAt
}

EmailLogs

{
  _id,
  recipient,
  subject,
  status,
  sentAt,
  openedAt
}

---

Dashboard Structure

User Dashboard

• Wellness Index
• Quick Actions
• Assessment Summary
• Mood Check-In
• Upcoming Appointments
• Recent Activities
• Trend Charts

---

Doctor Dashboard

• Today's Sessions
• Assigned Users
• Pending Notes
• User Activity Feed
• User Wellness Summary

---

Admin Dashboard

• User Statistics
• Appointment Statistics
• Assessment Statistics
• Latest Registrations
• Latest Appointments
• Latest Assessments
• Email & Communication Center

---

UI/UX Design Principles

Design Inspiration:

• Linear
• Stripe
• Vercel
• Notion

Features:

• Responsive Layout
• Modern Dashboard Design
• Smooth Animations
• Empty States
• Loading Skeletons
• Semantic Color System
• Accessibility Support

---

Installation

Clone Repository

git clone https://github.com/yourusername/wellhealth.git

Install Frontend Dependencies

cd frontend
npm install

Install Backend Dependencies

cd backend
npm install

Environment Variables

Create a .env file inside backend:

PORT=5000

MONGO_URI=your_mongodb_connection

JWT_SECRET=your_secret

EMAIL_USER=your_email

EMAIL_PASS=your_password

Run Backend

npm run dev

Run Frontend

npm run dev

---

Future Enhancements

• Organization & Workplace Wellness
• Healthcare Provider Integration
• Mobile Applications
• Teleconsultation
• Multi-language Support
• Wearable Device Integration
• Wellness Resource Library

---

Academic Information

Project Type: Full Stack Development (FSD-2)

Tech Stack: React + Express + MongoDB

Architecture: Role-Based Multi-User Mental Wellness Platform

Developed For: General Mental Wellness & Doctor Consultation Management