# feriverau/prtfl_ecom architecture

> Architecture diagram of the GitHub repository feriverau/prtfl_ecom, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/feriverau/prtfl_ecom
- Repository: https://github.com/feriverau/prtfl_ecom

## Overview

This Django storefront supports product discovery (catalog, categories, search, offers, and compatibility), session-backed cart management, checkout and order history, plus account registration, email activation, login, and profiles. The graph follows sampled view-to-service calls and the models they access. The README is empty, so unsampled capabilities and wiring are omitted; some relationships are established only by the source index.

Main entry points: [`mysite/users/views.py`](https://github.com/feriverau/prtfl_ecom/blob/main/mysite/users/views.py) (Account views), [`mysite/orders/views.py`](https://github.com/feriverau/prtfl_ecom/blob/main/mysite/orders/views.py) (Checkout and orders), [`mysite/cart/views.py`](https://github.com/feriverau/prtfl_ecom/blob/main/mysite/cart/views.py) (Cart endpoints), [`mysite/orders/models.py`](https://github.com/feriverau/prtfl_ecom/blob/main/mysite/orders/models.py) (Addresses and orders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Product catalog"]
  node_catalog_views["Catalog views<br/>[views.py]"]
end

subgraph group_commerce["Cart and checkout"]
  node_cart_views["Cart endpoints<br/>[views.py]"]
  node_cart_service["Session cart<br/>[cart.py]"]
  node_order_views["Checkout and orders<br/>[views.py]"]
  node_address_form["Address form<br/>[forms.py]"]
end

subgraph group_accounts["Customer accounts"]
  node_user_views["Account views<br/>[views.py]"]
  node_user_forms["Account forms<br/>[forms.py]"]
  node_activation_token["Activation tokens<br/>[token.py]"]
  node_auth_signals["Profile signals<br/>[signals.py]"]
end

subgraph group_platform["Shared domain data"]
  node_product_data[("Products and categories<br/>[models.py]")]
  node_order_data[("Addresses and orders<br/>[models.py]")]
  node_user_data[("User profiles<br/>[models.py]")]
end

node_shopper(("Shopper"))
node_django_auth["Django authentication"]

node_shopper -->|"browses"| node_catalog_views
node_catalog_views -->|"queries"| node_product_data
node_shopper -.->|"updates cart"| node_cart_views
node_cart_views -->|"delegates to"| node_cart_service
node_cart_views -->|"looks up product"| node_product_data
node_shopper -.->|"checks out"| node_order_views
node_order_views -->|"reads cart"| node_cart_service
node_order_views -->|"creates and reads"| node_order_data
node_order_views -->|"validates address"| node_address_form
node_order_data -->|"references products"| node_product_data
node_shopper -->|"manages account"| node_user_views
node_user_views -->|"validates updates"| node_user_forms
node_user_views -->|"updates profile"| node_user_data
node_user_views -->|"issues and checks"| node_activation_token
node_user_views -->|"loads history"| node_order_data
node_user_views -->|"authenticates"| node_django_auth
node_user_views -->|"sends activation email"| node_shopper
node_auth_signals -->|"creates profile"| node_user_data

click node_catalog_views "https://github.com/feriverau/prtfl_ecom/blob/main/mysite/myapp/views.py"
click node_product_data "https://github.com/feriverau/prtfl_ecom/blob/main/mysite/myapp/models.py"
click node_cart_views "https://github.com/feriverau/prtfl_ecom/blob/main/mysite/cart/views.py"
click node_cart_service "https://github.com/feriverau/prtfl_ecom/blob/main/mysite/cart/cart.py"
click node_order_views "https://github.com/feriverau/prtfl_ecom/blob/main/mysite/orders/views.py"
click node_order_data "https://github.com/feriverau/prtfl_ecom/blob/main/mysite/orders/models.py"
click node_address_form "https://github.com/feriverau/prtfl_ecom/blob/main/mysite/orders/forms.py"
click node_user_views "https://github.com/feriverau/prtfl_ecom/blob/main/mysite/users/views.py"
click node_user_forms "https://github.com/feriverau/prtfl_ecom/blob/main/mysite/users/forms.py"
click node_user_data "https://github.com/feriverau/prtfl_ecom/blob/main/mysite/users/models.py"
click node_activation_token "https://github.com/feriverau/prtfl_ecom/blob/main/mysite/users/token.py"
click node_auth_signals "https://github.com/feriverau/prtfl_ecom/blob/main/mysite/users/signals.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_catalog_views toneBlue
class node_cart_views,node_cart_service,node_order_views,node_address_form toneAmber
class node_user_views,node_user_forms,node_activation_token,node_auth_signals toneMint
class node_product_data,node_order_data,node_user_data toneRose
class node_shopper,node_django_auth toneIndigo
```

## Components

### Product catalog

- [Catalog views](https://github.com/feriverau/prtfl_ecom/blob/main/mysite/myapp/views.py): `mysite/myapp/views.py`

### Cart and checkout

- [Cart endpoints](https://github.com/feriverau/prtfl_ecom/blob/main/mysite/cart/views.py): `mysite/cart/views.py`
- [Session cart](https://github.com/feriverau/prtfl_ecom/blob/main/mysite/cart/cart.py): `mysite/cart/cart.py`
- [Checkout and orders](https://github.com/feriverau/prtfl_ecom/blob/main/mysite/orders/views.py): `mysite/orders/views.py`
- [Address form](https://github.com/feriverau/prtfl_ecom/blob/main/mysite/orders/forms.py): `mysite/orders/forms.py`

### Customer accounts

- [Account views](https://github.com/feriverau/prtfl_ecom/blob/main/mysite/users/views.py): `mysite/users/views.py`
- [Account forms](https://github.com/feriverau/prtfl_ecom/blob/main/mysite/users/forms.py): `mysite/users/forms.py`
- [Activation tokens](https://github.com/feriverau/prtfl_ecom/blob/main/mysite/users/token.py): `mysite/users/token.py`
- [Profile signals](https://github.com/feriverau/prtfl_ecom/blob/main/mysite/users/signals.py): `mysite/users/signals.py`

### Shared domain data

- [Products and categories](https://github.com/feriverau/prtfl_ecom/blob/main/mysite/myapp/models.py): `mysite/myapp/models.py`
- [Addresses and orders](https://github.com/feriverau/prtfl_ecom/blob/main/mysite/orders/models.py): `mysite/orders/models.py`
- [User profiles](https://github.com/feriverau/prtfl_ecom/blob/main/mysite/users/models.py): `mysite/users/models.py`

### Other components

- **Shopper**
- **Django authentication**

## Connections

- Shopper → Catalog views: browses
- Catalog views → Products and categories: queries (evidence: `mysite/myapp/views.py`)
- Shopper → Cart endpoints: updates cart
- Cart endpoints → Session cart: delegates to (evidence: `mysite/cart/views.py`)
- Cart endpoints → Products and categories: looks up product (evidence: `mysite/cart/views.py`)
- Shopper → Checkout and orders: checks out
- Checkout and orders → Session cart: reads cart (evidence: `mysite/orders/views.py`)
- Checkout and orders → Addresses and orders: creates and reads (evidence: `mysite/orders/views.py`)
- Checkout and orders → Address form: validates address (evidence: `mysite/orders/views.py`)
- Addresses and orders → Products and categories: references products (evidence: `mysite/orders/models.py`)
- Shopper → Account views: manages account
- Account views → Account forms: validates updates (evidence: `mysite/users/views.py`)
- Account views → User profiles: updates profile (evidence: `mysite/users/views.py`)
- Account views → Activation tokens: issues and checks (evidence: `mysite/users/views.py`)
- Account views → Addresses and orders: loads history (evidence: `mysite/users/views.py`)
- Account views → Django authentication: authenticates (evidence: `mysite/users/views.py`)
- Account views → Shopper: sends activation email (evidence: `mysite/users/views.py`)
- Profile signals → User profiles: creates profile (evidence: `mysite/users/signals.py`)
