Prince Booking is designed and developed to automate the booking system of the restaurant so that customer can book table online and the restaurant can grow their business.
Prince Booking Application allows a small to medium size restaurant-business owner to extend their business to online and automate the reservation system. So that, people can know about the restaurant and see what's they are offering, besides they can also make reservations for them or their friends and family.
- Design and develop a reservation system to expand the restaurant business online.
- Construct a secure and comprehensive backend structure following the MVC design pattern.
- Include a SQL(relational) database to store restaurant data.
- Construct super-admin access on the system to allow make the required changes.
- Develop restaurant-admin access on the system to manage the restaurant and bookings.
- Enhance productivity and efficiency in the booking system to increase customer sales and customer retention.
- Simplify the reservation model to reduce manual work.
- Build user-friendly and intuitive UI that is responsive to ensure a better user experience.
- Handle errors in such a way that other developers can easily understand the issue.
- Allow customers to find out more information about all the services provided by the restaurant.
- Allow customers to contact the restaurant admin.
- Store contact information to the database.
For this application we've used SQL database(SQLlite for development & PostgresDB for production) to store and access any associated data.
Following diagram shows the database models and the relationship between them.
![Wireframe3](readme/src/images/wireframe 3.png)
A detailed breakdown of all the features of the PrinceRestaurant Booking Application.
URL: {host}
or {host}/home
- A dynamic navbar with 'Home', 'Contact Us', 'Food Menu' and not authenticated('Login', 'Signup') nav links.
- If a user is authenticated and not admin, the nav menu changed to 'Home', 'Contact Us', 'Food Menu', avatar(User Reservations, Update Profile, Logout).
- If a user is authenticated and admin, nav menu changed to 'Home', 'Contact Us', 'Food Menu', avatar(Admin Dashboard, User Reservations, Update Profile, Logout).
- A hero section slider of food images with a 'Book now' action button.
- Ten items of food menu with thumbnails and price.
- Food menu thumbnails have a popup view upon click.
- A section with the 'Contact Us' call to action button.
- A Footer with some information about the restaurant.
- In a smaller display, all links will be contained in a hamburger dropdown icon.
URL: {host}/food-menu/all/
- Title section with parallax background.
- Contains offer section with 'Book Now' call to action button.
- Contains all the items on the food menu with thumbnails, ingredients, and prices.
Food Menu (View Food Menu page)
![food-menu](readme/src/images/food-menu.png)
URL: {host}/accounts/login/
- Login form with required fields.
- Show messages on wrong credentials.
- Redirect to requested page after succesful login.
- Contains register button on the page.
URL: {host}/accounts/signup/
- Signup form with required fields.
- Show messages on wrong credentials or exists user.
- Redirect to profile update after succesful signup.
- Contains login link on the page.
Login requied
URL: {host}/profile/update/
- Profile Update form with fields.
- User is able to add avater and more information.
- Show messages on wrong credentials.
- Redirect to profile update after succesful submission.
Login requied
URL: {host}/reservations/make_a_reservation/
- Contains date select widget form to select a reservation date.
- Show validation error if date is not selected.
- On next contains time and table-size select widget.
- On next contains short message widget and accept T&C field(requied).
- On successfull reservation user redirect to success page.
- User can not make duplicate reservation.
- On duplicate reservation, user redirect to the same page with error message.
Login requied
URL: {host}/reservations/my-reservations/
- Contains all the successful reservations(upcoming) of the requested user.
- User can cancel their already made reservations.
- After successful cancellation user will be rediredted on the same page.
- If user has no reservation a "No reservation" message will be displayed on the page.
URL: {host}/contact/
- Contains contact information of the restaurant(comes from backend).
- User can send message by filling the form.
- After successful submission user will be redirected to the same page.
Login requied User must be admin
URL: {host}/reservations/admin/dashboard
- Contains the restaurant information(comes from backend).
- Admin can update restaurant information.
- Contains all the tables with information, next reservation and action button.
- Admin can add, upade and delete table.
Admin Dashboard (View Admin Dashboard page)
Add Table (View Add Table page)
Add Table Success Message(View Success Message)
Login requied User must be admin
URL: {host}/reservations/admin/{}/
todays|upcoming|past
- Admin can manage all reservations on this page.
- Admin can view and cancel todays reservations.
- Admin can view and cancel upcoming reservations.
- Admin can view and cancel past reservations.
Login requied User must be admin
URL: {host}/food-menu/admin/
- An admin can manage all the created menu items on this page.
- A page with all the created food menus.
- Admin can update and delete food menu.
Login requied User must be super_admin
URL: {host}/reservations/admin/
- Only a super admin can manage restaurant admins.
- Super admin can add, update and delete a restaurant admin.
- Restaurant admin can able to manage the restaurant.
Only super_admin and restaurant admin can login
URL: {host}/radmin/login/
- This page contains admin login form.
- Successful login will redirect to admin dashboard.
- Can browse the home/index page and view some of the food menus.
- User can send direct messages or contact the restaurant.
- Users can view restaurant information.
- Can browse and view all the food items the restaurant is offering.
- User can signup into the system to become a customer.
- Signed up user can log in to the system.
- User can make a reservation.
- User can make multiple table reservations.
- User can cancel the upcoming reservation.
- User can view all the pages that a guest user can.
- User can view the successful reservations by making him.
- A user can not make a duplicate reservation.
- A customer can not access the admin dashboard.
- Restaurant-admin can access the radmin-login page.
- Restaurant-admin can access the admin dashboard.
- Admin can manage upcoming reservations.
- Admin can cancel reservations of a customer.
- Admin can delete past reservations.
- Admin can update restaurant information.
- Admin can add, update and delete tables.
- Admin can add, update and delete food menus.
- A super-admin get all the functionalities a restaurant admin has.
- Super admin can add, update and delete restaurant-admin.
- Super admin can manage restaurant admins.
- Super admin can view all the pages.
- Only a super admin has access to admins' management pages.
- Python
- Javascript
- HTML
- CSS
- Django
- Django allauth
- Jquery
- Validate.js
- Bootstrap
- SQLite: Used for local development.
- PostgresSQL: Used for production.
- Git: Version controlling.
- Github: Repository hosting.
- Git Pod
- Debug toolbar
- Django extentions
- Pylint
- Flake8
- JSlint
- Prettier
- Neovim
- VS Code
- Iterm2
- Google fonts
- Jshint.com/ - Used for validation of Javascript code.
- Validator.w3.org- Used for validation of HTML code.
- PyGraphviz - Used for generating database schema.
- Google Chrome DevTools - Used for testing website responsiveness.
Errors are handled during the development process.
- Unit tested each app to handle unexpected errors.
- Manually tested frontend pages to avoid client-side errors.
- Tested templet syntax error to handle template syntax errors.
- Used console to handle known errors.
- Used Chrome DevTools.
-
Log in to Heroku Go to https://www.heroku.com/ and login/signup
-
Create a new app Give a unique name to your app, leave other options as it is and click on the Create app button.
-
Connect to GitHub
-
Find your repo Enter your repo name and click on the search button.
-
Connect to your repo Find your repo and click on the Connect button.
❗Make sure You have python3 and pip installed on your machine.
- Create a folder where you want to clone the project and cd into it.
ℹ️ Optional but better to use a virtual environment for every project.
If don’t have any virtual environment manager installed in your machine then install one. (I will use pipenv)
For installing pipenv run
pip install pipenv
- Now clone the project and navigate to BinBlogger-master
git clone https://github.com/SteveAlsamarae/Restaurant-Booking-APP.git .
- Activate the virtual environment
pipenv shell
- Install all the dependencies for the project.
pip install -r requirements/local.txt
-
Make sure in
manage.py
andRestaurantBookingApp/wsgi.py
, you are usingRestaurantBookingApp.settings.local
for local development and for production useRestaurantBookingApp.settings.prod
. -
Make sure you are in the project's root directory then run the following command in your terminal.
python manage.py create_env
- Now run the following command
python manage.py makemigrations
python manage.py migrate
python manage.py loaddata restaurant.json
- Now create a superuser
python manage.py createsuperuser
- If all gone well you can now start the server
python manage.py runserver
This projects contains unit test for each app as well as test for templates.
- For testing all apps run,
python manage.py test
- For testing users app run,
python manage.py test users
- For testing food_menus app run,
python manage.py test food_menus
- For testing reservation app run,
python manage.py test reservation
- For testing contact app and templates run,
Test for templates is in contact app's tests folder.
python manage.py test contact