# hemantkumarlearning/django-e-commerce-platform architecture

> Architecture diagram of the GitHub repository hemantkumarlearning/django-e-commerce-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hemantkumarlearning/django-e-commerce-platform
- Repository: https://github.com/hemantkumarlearning/django-e-commerce-platform

## Overview

##### Project Type and Purpose
- This is a full-stack e-commerce web application built with Django and Django REST Framework (DRF).
- It serves a static HTML/CSS/JavaScript frontend (under `frontend/`) and exposes a JSON API for product browsing, cart management, authentication, and (future) Stripe payments.

##### File-Structure Analysis
- Top-level directories:
- `ecommerce/` — Django project settings, URL routing, WSGI/ASGI entrypoints
- `store/` — Core Django app: models, serializers, views, URLs, migrations, admin
- `frontend/` — Static assets (CSS/JS) and Django template files
- Key files:
- `manage.py` — Django CLI entrypoint
- `requirements.txt` & `Dockerfile` — Dependency list and containerization
- `ecommerce/urls.py` registers API routes (e.g., `/api/` and Swagger docs) and template-serving paths
- Architectural patterns:
- MVC (Django handles Models, Views, Templates)
- RESTful API layer (DRF serializers + viewsets)
- Token-based authentication for API security
- Planned external integration: Stripe payment gateway

##### Essential Details
- Explicitly show the Django project structure: separate “ecommerce/” settings & routing from “store/” business-logic layer.
- Django admin panel as a back-office component.
- Future-state Stripe integration to underscore ongoing development.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        Browser["Client Browser"]:::frontend
        FrontendStatic["Frontend Static Layer\n(HTML/CSS/JS)"]:::frontend
        Templates["Django Templates"]:::frontend
        CSS["CSS Files"]:::frontend
        JS["JavaScript Files"]:::frontend
    end

    %% Django Application Layer
    subgraph "Django Application" 
        direction TB
        Settings["Django Settings"]:::backend
        URLRouter["URL Routing & API Gateway"]:::backend
        TemplateEngine["Template Engine"]:::backend
        DRFAPI["DRF API Layer"]:::backend
        AuthModule["Authentication Module"]:::backend
        AdminPanel["Admin Interface"]:::backend
        WSGI["WSGI Entry Point"]:::backend
        ASGI["ASGI Entry Point"]:::backend
        CLIEntrypoint["manage.py\n(Django CLI)"]:::backend
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        DB[(Database)]:::db
        Models["Core Models"]:::db
        Migrations["Database Migrations"]:::db
    end

    %% External Services Layer
    subgraph "External Services"
        direction TB
        Stripe["Stripe Payment API"]:::external
        Swagger["Swagger UI (API Docs)"]:::external
    end

    %% Infrastructure Files
    Requirements["requirements.txt"]:::infra
    DockerfileNode["Dockerfile"]:::infra

    %% Connections
    Browser -->|navigates to URL| URLRouter
    URLRouter -->|serves HTML| TemplateEngine
    TemplateEngine -->|renders Templates| FrontendStatic
    FrontendStatic --> Templates
    FrontendStatic --> CSS
    FrontendStatic --> JS

    Browser -->|AJAX calls| DRFAPI
    DRFAPI -->|issues token| AuthModule
    AuthModule -->|token stored in browser| Browser

    DRFAPI -->|reads/writes| Models
    Models -->|migration scripts| Migrations
    DRFAPI --> DB
    DRFAPI -->|checkout request| Stripe
    URLRouter --> AdminPanel

    Swagger -->|docs of| DRFAPI

    Settings --> URLRouter
    Settings --> DB
    CLIEntrypoint --> Settings
    WSGI --> Settings
    ASGI --> Settings

    Requirements --- Settings
    DockerfileNode --- Settings

    %% Click Events
    click FrontendStatic "https://github.com/hemantkumarlearning/django-e-commerce-platform/tree/main/frontend/"
    click Templates "https://github.com/hemantkumarlearning/django-e-commerce-platform/tree/main/frontend/templates/"
    click CSS "https://github.com/hemantkumarlearning/django-e-commerce-platform/tree/main/frontend/css/"
    click JS "https://github.com/hemantkumarlearning/django-e-commerce-platform/tree/main/frontend/js/"
    click Settings "https://github.com/hemantkumarlearning/django-e-commerce-platform/blob/main/ecommerce/settings.py"
    click URLRouter "https://github.com/hemantkumarlearning/django-e-commerce-platform/blob/main/ecommerce/urls.py"
    click WSGI "https://github.com/hemantkumarlearning/django-e-commerce-platform/blob/main/ecommerce/wsgi.py"
    click ASGI "https://github.com/hemantkumarlearning/django-e-commerce-platform/blob/main/ecommerce/asgi.py"
    click CLIEntrypoint "https://github.com/hemantkumarlearning/django-e-commerce-platform/blob/main/manage.py"
    click Requirements "https://github.com/hemantkumarlearning/django-e-commerce-platform/blob/main/requirements.txt"
    click DockerfileNode "https://github.com/hemantkumarlearning/django-e-commerce-platform/tree/main/Dockerfile"
    click Models "https://github.com/hemantkumarlearning/django-e-commerce-platform/blob/main/store/models.py"
    click Migrations "https://github.com/hemantkumarlearning/django-e-commerce-platform/tree/main/store/migrations/"
    click DRFAPI "https://github.com/hemantkumarlearning/django-e-commerce-platform/blob/main/store/serializers.py"
    click DRFAPI "https://github.com/hemantkumarlearning/django-e-commerce-platform/blob/main/store/views.py"
    click DRFAPI "https://github.com/hemantkumarlearning/django-e-commerce-platform/blob/main/store/urls.py"
    click AdminPanel "https://github.com/hemantkumarlearning/django-e-commerce-platform/blob/main/store/admin.py"
    click URLRouter "https://github.com/hemantkumarlearning/django-e-commerce-platform/blob/main/store/apps.py"
    click URLRouter "https://github.com/hemantkumarlearning/django-e-commerce-platform/blob/main/store/tests.py"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#007ACC,color:#000
    classDef backend fill:#DFF2BF,stroke:#4F8A10,color:#000
    classDef db fill:#FFE5B4,stroke:#CC7A00,color:#000
    classDef external fill:#E0E0E0,stroke:#7A7A7A,color:#000
    classDef infra fill:#F5F5F5,stroke:#999999,color:#000
```
