Skip to content

JawadHamdan03/HopeConnect2025

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


HopeConnect Logo

HopeConnect 2025

Empowering Orphan Support through Technology

🚀 View Demo          🐞 Report Bug



Description of the image


🌟 About the Project

HopeConnect 2025 is a humanitarian web platform that connects donors, sponsors, volunteers, and orphanages. It offers a centralized system for sponsorship, donation tracking, delivery logistics, and NGO partnerships. The goal is to provide a transparent, efficient, and scalable tool for orphan support and welfare.


📚 Table of Contents

  1. Introduction
  2. Built With
  3. Getting Started
  4. Main Features
  5. Roles
  6. API Documentation
  7. Demo
  8. Contact

🔨 Built With

NodeJS
ExpressJS
MySQL
Postman
GitHub


🚀 Getting Started

⚙️ Running the Project

1. Clone the Repository:

git clone https://github.com/JawadHamdan03/HopeConnect2025.git

2. Install Dependencies:

npm install

3. Environment Configuration:

This project uses a .env file for environment variables. Ensure you have the following in your .env file:

PORT=8000
DB_HOST=localhost
DB_USER=root
DB_PASSWORD=123456
DB_NAME=hopeconnect
JWT_SECRET=123456
EMAIL_USER=
EMAIL_PASS=
NEWS_API_KEY=6c759e017da24b0d94628f382f277d75

⚠️ Make sure your MySQL server is running and the database hopeconnect is created before starting the app.

4. Run the Application:

npm start

⚙️ Main Features

🎁 Donation Management

  • Add and track in-kind donations (clothes, food, supplies)
  • Delivery logistics & status tracking (admin-controlled)

🧒 Orphan Sponsorship

  • Sponsors can support orphans financially (monthly/yearly)
  • Track sponsorships, view orphan profiles

🚚 Delivery System

  • Admin can schedule & track delivery of donations
  • Includes driver info, coordinates, and status

💸 Revenue Model & Sustainability

  • Records small transaction fees on donations
  • Admin can manage partners and view revenue summaries

🌍 Partner Integration

  • Manage NGO, charity, or foundation partnerships
  • Public listing & admin-level controls

👥 Roles

  • 👤 Admin – full control over platform
  • 💸 Sponsor – provides recurring financial support
  • 🎁 Donor – gives in-kind donations
  • 🧑‍🔧 Volunteer – assigned to orphanage tasks

📡 API Documentation

All API endpoints are tested and documented using Postman.
📄 Click here to view Postman Documentation


🎥 Demo

Watch the platform in action and explore the workflow.
🔗 View Demo on Google Drive


📱 Contact

(⬆️ Back to top)

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors