1: Setup

create venv pip install -r requirements.txt

2: Database

• make sure you have mysql server installed
• create a schema called shopping with utf8 charset and utf8_unicode_ci collection

3: Env

create .env file based on .env.example in the main directory \ change to your own MySQL username, password

4: Run App

To run the full application (backend + frontend):

python run_app.py

5: Run Backend API on your local machine

• open terminal and use uvicorn app.backend.main:app --reload
• open 127.0.0.1:8000/docs on your browser

6: Admin Dashboard

The application includes an admin dashboard with the following features:

• User Management: View and delete regular user accounts
• Shop Owner Management: View and delete shop owner accounts, including viewing their shops
• Category Management: Create, update, and delete product categories

Default Admin Credentials

• Username/Email: admin@example.com
• Password: admin

The default admin user is automatically created on first run of the application.