Skip to content

abhishekbvs/Swachh-Amrita

Repository files navigation

Swachh Amrita

Gitter

Hello people, Thank You for being here. We really appreciate you for joining us to clean our mother earth. The main aim of this project is to keep our environment clean by bringing more awareness among the people about the disposal of waste. Clean-up drives are conducted for cleaning the environment and for bringing more awareness. So we came up with a great idea for making clean-up drives more productive and to engage people at large scale.

This is a web application for clean-up drives which enables event creation and registrations in a very easy way. Are you interested in sponsoring, conducting or volunteering for an event. Then contact us right now. If you code and wish to contribute. Then, you are in the right place, this is a free and open source software, go through the documentation to know more about the key features of the application and start your contributions today.

This web application is built to provide easy management and registration of events for the authorities conducting the event and the students who are taking part in the event. This application is mainly focused on the events with green initiatives like clean up drives. Basically, events are scheduled and shown on the website and interested students can register.

There are different roles in the web application namely Event Managers, Volunteers, Participants and Administrator. Users are supposed to sign up for the first time. Admin will give access to users as event managers or volunteers after contacting him according to the requirement. They can create events and add teams and assign volunteers to each and every team. Students can directly register for the event and join a particular team. Then volunteers of the particular event can manage their team like check in and check out the participants during the event. Event Managers can manage the event and see the statistics of the registrations of a particular event.

It is easy to manage data and event managers will get a clear picture on the registration status and it has many more benefits like events are scheduled neatly, registration status is shown to the students and they can revert their seat anytime until registrations closes. Teams can be formed as needed and essentially the history of all the events, registrations and participants are recorded securely and can be used for any purposes later on.

How it Works ?

Go through this link for the presentation on this project.

Pages

There are different pages in the web application and each of them have their own functionalities.

Home Page

In the home page, we can see all the published events with their titles, date and time, and registrations status and will be redirected to a particular event page after clicking on the title of the event

About Page

The aim of the project is described and the ways people can help us to support and improve this project.

Contact Page

If people have any queries, they need to fill this form and submit it. Event Managers, volunteers who are interested can contact the admin and can get their accounts.

For now, we have limeted this application for our college students. So, they can fill their details and submit it. If all the validations are passed, their account is created and redirected to the sign-in page.

Sign-in Page

Users can sign in with their credentials and after validation, they will be redirected to their respective dashboards

Event Page

The event page has all the details of the event and team details are shown with total seats and seats left. Participants can register by clicking on a particular team’s register button and can also see the team details.

Team Page

Team page has all the details and volunteers of the team. Registered members of that particular team are also shown. Particular user can choose a team and register if the

Dashboards

According to their role, the views of the dashboard are changed. Basically, the profile of the logged-in user is shown with their complete details and on the other side, they can see their privileges available to them. Every user can edit their own details and can reset their password if needed.

Administrator Dashboard

The administrator will get all the unresolved queries and can mark them resolved. User details can be seen and Administrator can assign or change roles of a particular user as needed.

Manage Users

Administrator can see the details of the user after clicking on the view button in Admin dashboard page. Administrator can update the details of a user, delete a user and can change the role of a user

Event Manager Dashboard

Event Manager can create an event and can view the events created by him. They can manage the events like updating, publishing and ending the Event. They can see the overall registrations statistics and can close registrations whenever it is necessary.

Events Creation

Event Managers create events by filling the form. Event title, from date time and to date time, description and can add teams filling team, place details and size as needed. Volunteers can be assigned to each team from the volunteer's list.

Events Management

View the Details of the event Update Event Publish / Unpublish Events Close / Open Registrations End / Reopen Event

Volunteer Dashboard

Volunteers can see all the teams that he was assigned by a particular event managers Volunteer can see his team details and can take attendance of the participants in his team.

Volunteers can check-in and check-out the participants in Volunteers Attendance Page.

Participant Dashboard

Participants can view all the events that are registered by him. They can see the event details, backout from an event if he is not able to join before the registrations close.

Installation Instructions

  1. Place the folder in Apache root directory
  2. Install the Packages using composer
  3. Create a DB and dump the provided sql file for sample data
  4. Now the site will be live at http://localhost/swachh-amrita/web/