# eshaabbasi/weasleyswizard_backend architecture

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

- Interactive diagram: https://gitdiagram.com/eshaabbasi/weasleyswizard_backend
- Repository: https://github.com/eshaabbasi/weasleyswizard_backend

## Overview

Weasleys’ Wizard Wheezes is a FastAPI marketplace backend for customers, shop owners, and admins. Customers authenticate, browse products from approved shops, and can review or favorite products; checkout validates stock and discounts, creates an order, and updates inventory. Owners manage shops and products and fulfill orders, while admins oversee shops, products, orders, and reviews. The map includes API routing, authorization, domain models, and persistence. Some subsystem links are supported by README descriptions or SOURCE INDEX references; unsampled implementations are not inferred beyond those sources.

Main entry points: [`main.py`](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/main.py) (FastAPI application), [`controllers/orders.py`](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/controllers/orders.py) (Checkout and orders), [`controllers/reviews.py`](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/controllers/reviews.py) (Reviews and favorites), [`database.py`](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/database.py) (Database sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_app["FastAPI application<br/>[main.py]"]
  node_users["Accounts<br/>[users.py]"]
  node_auth["Token authentication"]
  node_roles["Role authorization<br/>[require_role.py]"]
  node_serializers["Request and response schemas"]
end

subgraph group_commerce["Marketplace workflows"]
  node_shops["Shop administration<br/>[shops.py]"]
  node_products["Product catalog<br/>[products.py]"]
  node_orders["Checkout and orders<br/>[orders.py]"]
  node_reviews["Reviews and favorites<br/>[reviews.py]"]
end

subgraph group_data["Domain and persistence"]
  node_dbsession["Database sessions<br/>[database.py]"]
  node_configuration["Environment settings<br/>[environment.py]"]
  node_base["Model base<br/>[base.py]"]
  node_user_model["User records<br/>[user.py]"]
  node_shop_model["Shop records<br/>[shop.py]"]
  node_product_model["Product records<br/>[product.py]"]
  node_order_model["Order records<br/>[order.py]"]
  node_item_model["Order item records<br/>[item.py]"]
  node_review_model["Review records<br/>[review.py]"]
end

subgraph group_media["Media integration"]
  node_uploads["Image uploads<br/>[uploads.py]"]
  node_cloudinary["Cloudinary"]
end

node_client(("Marketplace users"))

node_client -->|"uses API"| node_app
node_app -->|"routes to"| node_users
node_app -->|"routes to"| node_shops
node_app -->|"routes to"| node_products
node_app -->|"routes to"| node_orders
node_app -->|"routes to"| node_reviews
node_app -->|"routes to"| node_uploads
node_users -->|"uses sessions"| node_dbsession
node_users -->|"queries users"| node_user_model
node_shops -->|"uses sessions"| node_dbsession
node_shops -->|"queries shops"| node_shop_model
node_shops -->|"checks owners"| node_user_model
node_products -->|"uses sessions"| node_dbsession
node_products -->|"queries products"| node_product_model
node_products -->|"checks shops"| node_shop_model
node_orders -->|"uses sessions"| node_dbsession
node_orders -->|"creates orders"| node_order_model
node_orders -->|"creates items"| node_item_model
node_orders -->|"checks stock"| node_product_model
node_orders -->|"filters shop orders"| node_shop_model
node_reviews -->|"uses sessions"| node_dbsession
node_reviews -->|"reads and writes"| node_review_model
node_reviews -->|"checks products"| node_product_model
node_reviews -->|"checks reviewers"| node_user_model
node_users -->|"uses schemas"| node_serializers
node_shops -->|"uses schemas"| node_serializers
node_products -->|"uses schemas"| node_serializers
node_orders -->|"uses schemas"| node_serializers
node_reviews -->|"uses schemas"| node_serializers
node_users -.->|"checks access"| node_roles
node_shops -->|"checks access"| node_roles
node_products -->|"checks access"| node_roles
node_orders -->|"checks access"| node_roles
node_reviews -->|"checks access"| node_roles
node_roles -->|"requires user"| node_auth
node_auth -->|"loads user"| node_dbsession
node_auth -->|"queries user"| node_user_model
node_dbsession -->|"reads database URL"| node_configuration
node_user_model -->|"reads token secret"| node_configuration
node_app -->|"creates tables"| node_base
node_user_model -->|"extends model base"| node_base
node_shop_model -.->|"extends model base"| node_base
node_product_model -->|"extends model base"| node_base
node_order_model -.->|"extends model base"| node_base
node_item_model -.->|"extends model base"| node_base
node_review_model -->|"extends model base"| node_base
node_uploads -.->|"uploads images"| node_cloudinary

click node_app "https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/main.py"
click node_users "https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/controllers/users.py"
click node_auth "https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/dependencies/get_current_user.py"
click node_roles "https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/dependencies/require_role.py"
click node_shops "https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/controllers/shops.py"
click node_products "https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/controllers/products.py"
click node_orders "https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/controllers/orders.py"
click node_reviews "https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/controllers/reviews.py"
click node_uploads "https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/controllers/uploads.py"
click node_serializers "https://github.com/eshaabbasi/weasleyswizard_backend/tree/master/serializers"
click node_dbsession "https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/database.py"
click node_configuration "https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/config/environment.py"
click node_base "https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/models/base.py"
click node_user_model "https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/models/user.py"
click node_shop_model "https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/models/shop.py"
click node_product_model "https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/models/product.py"
click node_order_model "https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/models/order.py"
click node_item_model "https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/models/item.py"
click node_review_model "https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/models/review.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_app,node_users,node_auth,node_roles,node_serializers,node_client toneBlue
class node_shops,node_products,node_orders,node_reviews toneAmber
class node_dbsession,node_configuration,node_base,node_user_model,node_shop_model,node_product_model,node_order_model,node_item_model,node_review_model toneMint
class node_uploads,node_cloudinary toneRose
```

## Components

### API and access

- [FastAPI application](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/main.py): `main.py`
- [Accounts](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/controllers/users.py): `controllers/users.py`
- [Token authentication](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/dependencies/get_current_user.py): `dependencies/get_current_user.py`
- [Role authorization](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/dependencies/require_role.py): `dependencies/require_role.py`
- [Request and response schemas](https://github.com/eshaabbasi/weasleyswizard_backend/tree/master/serializers): `serializers`

### Marketplace workflows

- [Shop administration](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/controllers/shops.py): `controllers/shops.py`
- [Product catalog](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/controllers/products.py): `controllers/products.py`
- [Checkout and orders](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/controllers/orders.py): `controllers/orders.py`
- [Reviews and favorites](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/controllers/reviews.py): `controllers/reviews.py`

### Domain and persistence

- [Database sessions](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/database.py): `database.py`
- [Environment settings](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/config/environment.py): `config/environment.py`
- [Model base](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/models/base.py): `models/base.py`
- [User records](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/models/user.py): `models/user.py`
- [Shop records](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/models/shop.py): `models/shop.py`
- [Product records](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/models/product.py): `models/product.py`
- [Order records](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/models/order.py): `models/order.py`
- [Order item records](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/models/item.py): `models/item.py`
- [Review records](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/models/review.py): `models/review.py`

### Media integration

- [Image uploads](https://github.com/eshaabbasi/weasleyswizard_backend/blob/master/controllers/uploads.py): `controllers/uploads.py`
- **Cloudinary**

### Other components

- **Marketplace users**

## Connections

- Marketplace users → FastAPI application: uses API (evidence: `README.md`)
- FastAPI application → Accounts: routes to (evidence: `main.py`)
- FastAPI application → Shop administration: routes to (evidence: `main.py`)
- FastAPI application → Product catalog: routes to (evidence: `main.py`)
- FastAPI application → Checkout and orders: routes to (evidence: `main.py`)
- FastAPI application → Reviews and favorites: routes to (evidence: `main.py`)
- FastAPI application → Image uploads: routes to (evidence: `main.py`)
- Accounts → Database sessions: uses sessions (evidence: `controllers/users.py`)
- Accounts → User records: queries users (evidence: `controllers/users.py`)
- Shop administration → Database sessions: uses sessions (evidence: `controllers/shops.py`)
- Shop administration → Shop records: queries shops (evidence: `controllers/shops.py`)
- Shop administration → User records: checks owners (evidence: `controllers/shops.py`)
- Product catalog → Database sessions: uses sessions (evidence: `controllers/products.py`)
- Product catalog → Product records: queries products (evidence: `controllers/products.py`)
- Product catalog → Shop records: checks shops (evidence: `controllers/products.py`)
- Checkout and orders → Database sessions: uses sessions (evidence: `controllers/orders.py`)
- Checkout and orders → Order records: creates orders (evidence: `controllers/orders.py`)
- Checkout and orders → Order item records: creates items (evidence: `controllers/orders.py`)
- Checkout and orders → Product records: checks stock (evidence: `controllers/orders.py`)
- Checkout and orders → Shop records: filters shop orders (evidence: `controllers/orders.py`)
- Reviews and favorites → Database sessions: uses sessions (evidence: `controllers/reviews.py`)
- Reviews and favorites → Review records: reads and writes (evidence: `controllers/reviews.py`)
- Reviews and favorites → Product records: checks products (evidence: `controllers/reviews.py`)
- Reviews and favorites → User records: checks reviewers (evidence: `controllers/reviews.py`)
- Accounts → Request and response schemas: uses schemas (evidence: `controllers/users.py`)
- Shop administration → Request and response schemas: uses schemas (evidence: `controllers/shops.py`)
- Product catalog → Request and response schemas: uses schemas (evidence: `controllers/products.py`)
- Checkout and orders → Request and response schemas: uses schemas (evidence: `controllers/orders.py`)
- Reviews and favorites → Request and response schemas: uses schemas (evidence: `controllers/reviews.py`)
- Accounts → Role authorization: checks access
- Shop administration → Role authorization: checks access (evidence: `controllers/shops.py`)
- Product catalog → Role authorization: checks access (evidence: `controllers/products.py`)
- Checkout and orders → Role authorization: checks access (evidence: `controllers/orders.py`)
- Reviews and favorites → Role authorization: checks access (evidence: `controllers/reviews.py`)
- Role authorization → Token authentication: requires user (evidence: `dependencies/require_role.py`)
- Token authentication → Database sessions: loads user (evidence: `dependencies/get_current_user.py`)
- Token authentication → User records: queries user (evidence: `dependencies/get_current_user.py`)
- Database sessions → Environment settings: reads database URL (evidence: `database.py`)
- User records → Environment settings: reads token secret (evidence: `models/user.py`)
- FastAPI application → Model base: creates tables (evidence: `main.py`)
- User records → Model base: extends model base (evidence: `models/user.py`)
- Shop records → Model base: extends model base (evidence: `models/shop.py`)
- Product records → Model base: extends model base (evidence: `models/product.py`)
- Order records → Model base: extends model base (evidence: `models/order.py`)
- Order item records → Model base: extends model base (evidence: `models/item.py`)
- Review records → Model base: extends model base (evidence: `models/review.py`)
- Image uploads → Cloudinary: uploads images (evidence: `README.md`)
