CoralByte Website Project

A Django-based e-commerce site for computer hardware — catalog browsing, cart/wishlist/compare, checkout, and an account area.

Prerequisites

• Python 3.x
• pip (Python package installer)
• virtualenv

Setup

1. Clone the repository:

   git clone https://github.com/izzilan/coralbyte.git coralbyte
   cd coralbyte

2. Create a virtual environment (optional but recommended):

   python -m venv .venv

   Activate it:

   # Windows
   .venv\Scripts\activate
   
   # Mac/Linux
   source .venv/bin/activate

3. Install the dependencies:

   pip install -r requirements.txt

4. Apply the migrations:

   python manage.py migrate

5. Load the demo catalog data (categories, products, builds, reviews):

   python manage.py load_products

6. Create a superuser:

   python manage.py createsuperuser

7. Run the development server:

   python manage.py runserver

8. Access the application:

   Open your web browser and go to http://127.0.0.1:8000/.

Project Structure

• manage.py: Django's command-line utility for administrative tasks.
• config/: Project settings and configuration.
  • settings.py, urls.py, wsgi.py, asgi.py
• catalog/: Products, categories, builds, reviews, and questions.
  • models.py, views.py, admin.py, urls.py
  • management/commands/load_products.py: seeds the database from fixtures/products_raw.json.
  • migrations/: Database migrations.
• cart/: Session-based cart, wishlist, and compare list.
• accounts/: Login, registration, and account pages.
• orders/: Checkout and order history.
• pages/: Static/marketing pages (home, deals, builder, finder, etc.).
• templates/: HTML templates, shared by all apps.
• static/: CSS and JS assets.
• media/: Uploaded category/product photos (created automatically; not committed).
• requirements.txt: List of dependencies.

Additional Information

• Admin Panel: Access the admin panel at http://127.0.0.1:8000/admin/ using the superuser credentials. Category and product photos can be uploaded there.
• Static & Media Files: Static assets are served from static/; user-uploaded images are served from media/ in development. Ensure both are configured correctly for production (STATIC_ROOT, MEDIA_ROOT, and a proper file host).

For more information, refer to the Django documentation. "# coralbyte"