WebShop web application

Student Information

• Name: Yuto Kvist
• Email: Yuto.kvist@abo.fi

---

Implemented Requirements

The following requirements from the project specification have been implemented and are available for evaluation:

• 1. Project folder
• 2. Backend
• 3. Frontend
• 4. Automatic DB population
• 5. Browse
• 6. Create account
• 7. Login
• 8. Add item
• 9. Add to cart
• 11. Remove from cart
• 12. Pay
• 13. Routing
• 14. Edit account
• 15. Display inventory
• 16. Edit item
• Clean look and performance

❌ Not implemented:

• Search functionality

---

Notes

• A quantity field was introduced for items.
• This makes the purchase logic slightly more complex; buying all available quantities at once may not always work as expected.
• Apart from the quantity-related behavior, all other functionalities work according to the project requirements.
• Most navigation can be done through the navigation bar, from which all existing pages in the project are accessible.
• The implementation should be sufficient for full points (5/5), unless some requirements are interpreted or implemented incorrectly.

---

How to Run the Project

Backend

• Framework: Django
• Database: SQLite
• Provides:
  • JSON API for the shop
  • Landing page
• Automatic database population is triggered from the NavBar

Backend Setup

cd backend
python -m venv venv
source venv/bin/activate   
pip install -r requirements.txt
python manage.py migrate
python manage.py runserver

• Open a second terminal and navigate to the frontend folder

Frontend Setup

npm install
npm start
npm run dev

Environment Variables

⚠️ Important: This project requires .env files for both the backend and frontend to run correctly. These files are not included in the repository and must be created manually.

---

Backend (/backend/.env)

Create a .env file in the backend folder with the following variable:

DJANGO_SECRET_KEY=your_secret_key_here

Frontend (/frontend/.env)

Create a .env file in the frontend folder with the following variable:

VITE_API_URL=http://127.0.0.1:8000

• This should point to the Django backend API.

• Adjust the URL if the backend runs on a different host or port.