Volunteer Management System (Laravel)

This is a volunteer coordination web application built using Laravel. The system is designed to help manage volunteers, their assignments, work locations, and tasks in a simple and efficient way. It is a final project for the WEBC 3301 course.

---

📌 Features

• ✅ User Authentication
  • Login / Logout
• 📍 Work Locations Management
  • Add, edit, delete, and view locations (e.g., hospitals, distribution centers, etc.)
• 📋 Task Management
  • Add, edit, delete, and view tasks (e.g., ambulance, administration, monitoring)
• 🧑‍🤝‍🧑 Volunteer Management
  • Add, edit, delete, and view volunteer data
• 🔁 Volunteer Assignment
  • Assign volunteers to predefined tasks at specific work locations

---

🧰 Technologies Used

• Laravel 10.x
• PHP 8.x
• MySQL
• Bootstrap (Frontend template)
• Eloquent ORM and Relationships
• Laravel Web Routes

---

🗂️ Project Structure

/app
    /Http
        /Controllers
        /Requests
        /Resources
/config
/database
    /migrations
    /seeders
/public
/resources
    /views
/routes
    web.php
.env.example
composer.json
package.json

---

🌐 Web Routes (Sample)

Authentication

• /login – Show login form
• /logout – Logout user
• /dashboard – Main dashboard after login

Work Locations

• /locations – List all locations
• /locations/create – Add new location
• /locations/{id}/edit – Edit location

Tasks

• /tasks – List all tasks
• /tasks/create – Add new task
• /tasks/{id}/edit – Edit task

Volunteers

• /volunteers – List all volunteers
• /volunteers/create – Add new volunteer
• /volunteers/{id}/edit – Edit volunteer

Assignments

• /assignments – Assign volunteer to task/location

---

🚀 Installation Guide

1. Clone the Repository

   git clone https://github.com/yourusername/volunteer-management-system-laravel.git
   cd volunteer-management-system-laravel

2. Install Dependencies

   composer install
   

3. Configure Environment

   cp .env.example .env
   php artisan key:generate

4. Set up Database

   • Update .env file with your DB credentials
   • Run:

     php artisan migrate
     php artisan db:seed

5. Run the Server

   php artisan serve

---

🧪 Testing

To test the application:

• Use the web browser to navigate between routes.
• Login using admin credentials.
• Test CRUD operations for locations, tasks, volunteers, and assignments through the interface.

---

📸 Screenshots

• Login page
• Dashboard
• Task management
• Volunteer list
• Assignment interface
• Location management

---

📚 License

This project is created for educational purposes only as part of the WEBC 3301 Final Project.

---

👤 Author

Aya Nabil Saleem Alharazin
Computer Science – Islamic University of Gaza