SEA Salon Full Stack using Django + Basic Front-end

This repository created for a selection at Software Engineering Academy by Compfest Academy 2024 🔥🔥

The project is already deployed on pythonanywhere, so you can see the website by clicking this URL:

https://xstynwx.pythonanywhere.com/

Table of Contents

1. Project Overview
2. Prerequisite
3. How to Use Website
4. Website Information
5. Owner

Project Overview

Website Name

SEA Salon

Explanation

Introducing SEA Salon, a rising star in the salon industry known for their outstanding services and excellent reviews. With a rapidly growing clientele and a stellar reputation, SEA Salon is your premier destination for all your beauty needs. Because of this, SEA Salon has gained a lot of customers. To handle the new customers, the SEA Salon management team has decided to develop a new SEA Salon Application. This app lets users easily browse available services, select their preferred stylist, and book appointments quickly. With a user-friendly interface and seamless booking integration, making a reservation with a top stylist has never been easier! The task will be divided into five progressive levels. The higher the level, the more points you can earn. Note that each level builds on the previous one, so you must complete the earlier levels before proceeding to the higher ones.

Technology and Infrastructure

Fullstack using Django + Basic Front-end

Details:

• Back-end: Django
• Database: Database SQlite
• Front-end: HTML, CSS, JavaScript, and jQuery

Prerequisite

1. Python 3.x has been installed in your system.
2. Pip (package manager for Python) has been installed in your system.
3. Git has been installed in your system (If you prefer to use Git)

How to Use Website

Therefore, this is the guidelines to use the website

Step 1: Download Repository (Local / Fork Repository)

Users can download this repository locally or fork / copy this repository to their personal repository

Meanwhile, if the user wants to clone the repository via URL, the user can use the following URL:

https://github.com/StyNW7/SEASalon.git

User can also Clone this repository (Remember the main branch is: master not main)

git clone https://github.com/StyNW7/SEASalon.git

Step 2: Virtual Environment (Optional)

If you prefer to use Virtual Environment, You can use this step to create a Virtual Environment:

python -m venv env

To activate and use the Virtual Environment on Windows

.\env\Scripts\activate

To activate and use the Virtual Environment on MacOS / Linux

source env/bin/activate

However, this repository is also offer a Virtual Environment Folder (just in case you don't download the Virtual Environment Folder)

Step 3: Move to the main Folder (seasalon)

When you have download or clone the repository, you should cd to the main folder which is seasalon

Use this at Terminal:

cd seasalon

Step 4: Install Dependencies

This step is crucial to use the website. Firstly, You should install all of dependencies used in this Website

Run this code in the terminal

pip install -r requirements.txt

Step 5: Database Setup (Optional)

I already provide the database, however if there is any changes You want to change, you should run this code

Just run this code (run in the terminal):

python manage.py makemigrations
python manage.py migrate

Step 6: Run the Server

If you have already follow the step given above, the server can be run using this (run in the terminal):

python manage.py runserver

After that, the server is starting to run and You can click the localhost server like this:

Starting development server at http://127.0.0.1:8000/

Or you can also open your browser and type http://127.0.0.1:8000/ manually

However, if you are using different localhost server, you can go to your own localhost server port

Website Information

Register and Login

User can register a new account, however user can only make a new Customer Account

And then user can login using the existing account

Creating Admin User

If You want to create a new Admin user, you must follow this step:

Run this on Terminal:

python manage.py create_custom_user

Just input the data and make sure that the username and any other fields is unique from other data in the Database

After Creating Custom User succeed, You can login on the Website using the username and passsword you make and that user surely have an Admin role.

Account example

If you want to testing the customer and admin role, you can just use this Account:

Customer Role

username: customer1
password: Customer123

Admin Role

username: thomas
password: Admin123

Hope this documentation and the guide useful and helpful to use the website!

Translation

I also provide Documentation Translation in Indonesian right here:

Indonesian Translation

Owner

This Repository is created by:

• Stanley Nathanael Wijaya

Soli Deo Gloria ✨✨