CBC-Hostel-Web-App

Project Purpose

This open-source project is an application which enables easy handling of data regarding the hostels. The main objectives of this application is to maintain and manage the hostels information easily, to avoid complexity, to reduce time and human effort in data processing and maintaining the admin and students' information. This project deals with the problems of managing hostels and avoid the problems which occur when carried manually; connecting the business to custmers, digitally.

Contributors	Role
Chisombiri Nlewedim	Product Lead & Development
Akinosi Eniola	Design and Development
Oketola Samuel	Development
Adeniyi Joshua	Development
Adegoke Fuad	Development
Chi-ife Ileka	Development
Hamjad Idris	Development
Ojekunle Micheal	Design and Development
Benedict Nwoko	Development
Ajiboye Fiyin	Design and Development
Janet Olukotun	Design and Development
Alvin	Development
Hollas	Development

Basic Website Structure

• Landing Page
• Company's Page
• Hostel's Page
• User login and signup page
• User dashboard page
• Appointment page
• Terms and conditions page

Sections Maintained

• Header(navigation and logo)

To Contribute here(Version control)

Step 1: Click on Fork at the top right corner Step 2: Clone your forked repository Step 3: cd into the cloned folder | GrowersBrains Step 4: git remote add upstream https://github.com/Jplayskeys/CBC-Hostel-Web-App Step 5: git pull upstream "branch" Step 6: Check out to the task/feature branch | git checkout -b <NAME_OF_THE_TASK> Creating a pull request(when done with your code/changes) Step 1: Run: git add . Step 2: Run: git commit -m "" Step 3: git push origin <BRANCH_NAME>. Go to the repository on your profile As soon as you get there, you are going to see a green ‘compare and create a pull request’ Click on it, and type your message, click on create pull request! Thanks to: @chisombiri

Brief Sitemap

Landing Page

The landing page contains the basic details of the company. These includes:

• About
• Hostels
• Admin
• Activities
• Contact

User login and signup page

This is the page where the user does the basic documentation of herself. It contains a form which allow users to input their details.

The table below shows the form sections and input that are in the section

Section	Inputs
Login page	User Email
	User Password
Signup Page	User Full Name
	User Email
	User Number
	User Hostel
	User Gender
	User Marital Status
	User Age
	User Occupation
	User Disabilities
	User Next Of Kin
	Next of kin's Email
	Next of kin's Number
	Next of kin's Address

Hostels Page

The hostels page showcases hostel and bedspaces available for accomdation. It consists of quality images of hostels, address of each hostel and prices of the hostels available.

User dashboard page

This is the page that contains the graphical report of various data relevant to the user. It has five sections, namely:

• Biodata
• Payment
• Activities
• Reviews
• Terms and conditions

Terms and Conditions Page

This page clearly states the terms and conditions also with the rules and regulation guiding the hostels. It also talks about the refund policy of the hostels.