volunteersPlacement - Volunteer Management and Scheduling System

volunteersPlacement is a web application for managing and scheduling volunteers and their transport. The system allows for the management of volunteers and their weekly transport schedules. The application uses Angular for the client-side and .NET Core for the server-side.

Table of Contents

• Introduction
• Features
• Getting Started
  • Prerequisites
  • Installation
  • Running the Application
• Project Structure
• Contributing

Introduction

volunteersPlacement is designed to help organizations manage volunteers efficiently and schedule them for transport on a weekly basis.

Features

• View a list of volunteers
• Update volunteer details
• Add new volunteers
• Delete volunteers
• For each day, the available volunteers for that day are displayed
• An indication of each day that is inserted.

Getting Started

Prerequisites

To run this project, you need to have the following software installed:

• Node.js (with npm)
• Angular CLI
• .NET Core SDK

Installation

1. Clone the repository:

   git clone https://github.com/nechamale/volunteersPlacement.git
   cd volunteersPlacement

2. Install client dependencies:

   cd client
   npm install

3. Install server dependencies:

   cd ../server
   dotnet restore

Running the Application

1. Start the .NET Core API:

   cd server
   dotnet run

   The API will typically run on http://localhost:5183.

2. Start the Angular application:

   cd ../client
   ng serve

   The Angular app will typically run on http://localhost:4200.

3. Access the application: Open your browser and navigate to http://localhost:4200.

Project Structure

volunteersPlacement/
│
├── client/                            # Angular client application
│   ├── src/                           # Source files
│   │   ├── app/                       # Angular moduls and services
|   |   |   ├── scheduling/            # modul scheduling
|   |   |   ├── volunteers/            # modul volunteers          
|   |   |   ├── app-routing.module.ts  # page of routing    
|   |   |   ├── app-routing.module.ts  # main file    
│   │   ├── assets/                    # Static assets
│   │   ├── environments/              # Environment configuration
│   │   ├── proxy.conf.json            # proxy file
│   │   ├── index.html                 # Main HTML file
│   │   ├── main.ts                    # Main entry point
│   │   └── styles.css                 # Global styles
│   ├── angular.json                   # Angular configuration
│   ├── package.json                   # npm dependencies and scripts
│   └── README.md                      # Client README
│        
├── server/                            # .NET Core API
│   ├── Controllers/                   # API Controllers
│   ├── Services/                      # Service for API
│   ├── Models/                        # Data models
│   ├── Program.cs                     # Main program entry point
│   ├── Startup.cs                     # Application startup configuration
│   └── appsettings.json               # Application settings
│
├── .gitignore                         # Git ignore file
├── README.md                          # Project README

License

This project is licensed under the MIT License. See the LICENSE file for more details.

User Interface

Volunteers Page:

Edit page:

Scheduling Page: