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;
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>.
Step 4: 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.