# smagic205/thunderfood architecture

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

- Interactive diagram: https://gitdiagram.com/smagic205/thunderfood
- Repository: https://github.com/smagic205/thunderfood

## Overview

This repository is a partial ThunderFood food-commerce implementation: a Spring Boot backend with a commerce-oriented persistence model and two React frontend apps. The visible frontend screens are still the default Vite starter, and the sampled backend exposes entities rather than API or service workflows. Thus the intended customer journey can only be represented as modeled domain stages, not as a verified running user-to-result flow. The diagram includes the principal entities and their evidenced JPA relationships; API, payment-provider, and frontend-to-backend links are not shown because the available source does not establish them.

Main entry points: [`backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Order.java`](https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Order.java) (Customer order), [`backend_thunderfood/src/main/java/com/thunderfood/backend/entity/User.java`](https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/User.java) (User account), [`backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Product.java`](https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Product.java) (Product catalog), [`backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Review.java`](https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Review.java) (Product review)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend apps"]
  node_webapp["Customer web app<br/>[App.tsx]"]
  node_adminapp["Admin app<br/>[App.tsx]"]
end

subgraph group_identity["Identity and profiles"]
  node_user["User account<br/>[User.java]"]
  node_role["Role<br/>[Role.java]"]
  node_address["Delivery address<br/>[Address.java]"]
end

subgraph group_commerce["Commerce model"]
  node_category["Food category<br/>[Category.java]"]
  node_product["Product catalog<br/>[Product.java]"]
  node_cart["Shopping cart<br/>[Cart.java]"]
  node_cartitem["Cart items<br/>[CartItem.java]"]
  node_voucher["Discount voucher<br/>[Voucher.java]"]
  node_order["Customer order<br/>[Order.java]"]
  node_orderitem["Order line items<br/>[OrderItem.java]"]
  node_payment["Payment record<br/>[Payment.java]"]
  node_review["Product review<br/>[Review.java]"]
end

subgraph group_backend["Backend persistence"]
  node_application["Spring Boot app"]
  node_schema[("Relational schema")]
end

node_customer(("Customer"))
node_admin(("Admin user"))

node_customer -->|"uses"| node_webapp
node_admin -->|"uses"| node_adminapp
node_user -->|"has role"| node_role
node_address -->|"belongs to"| node_user
node_product -->|"categorized by"| node_category
node_cart -->|"belongs to"| node_user
node_cartitem -->|"belongs to"| node_cart
node_cartitem -->|"references"| node_product
node_order -->|"placed by"| node_user
node_order -->|"ships to"| node_address
node_order -->|"may apply"| node_voucher
node_orderitem -->|"belongs to"| node_order
node_orderitem -->|"references"| node_product
node_payment -->|"records payment for"| node_order
node_review -->|"reviews"| node_product
node_review -->|"authored by"| node_user
node_review -->|"may reference"| node_order

click node_webapp "https://github.com/smagic205/thunderfood/blob/main/frontend/apps/web/src/App.tsx"
click node_adminapp "https://github.com/smagic205/thunderfood/blob/main/frontend/apps/admin/src/App.tsx"
click node_application "https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/BackendThunderfoodApplication.java"
click node_user "https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/User.java"
click node_role "https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Role.java"
click node_address "https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Address.java"
click node_category "https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Category.java"
click node_product "https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Product.java"
click node_cart "https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Cart.java"
click node_cartitem "https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/CartItem.java"
click node_voucher "https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Voucher.java"
click node_order "https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Order.java"
click node_orderitem "https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/OrderItem.java"
click node_payment "https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Payment.java"
click node_review "https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Review.java"
click node_schema "https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/resources/db/migration/V1__init_schema.sql"

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_webapp,node_adminapp,node_admin toneBlue
class node_user,node_role,node_address toneAmber
class node_category,node_product,node_cart,node_cartitem,node_voucher,node_order,node_orderitem,node_payment,node_review toneMint
class node_application,node_schema toneRose
class node_customer toneIndigo
```

## Components

### Frontend apps

- [Customer web app](https://github.com/smagic205/thunderfood/blob/main/frontend/apps/web/src/App.tsx): `frontend/apps/web/src/App.tsx`
- [Admin app](https://github.com/smagic205/thunderfood/blob/main/frontend/apps/admin/src/App.tsx): `frontend/apps/admin/src/App.tsx`

### Identity and profiles

- [User account](https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/User.java): `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/User.java`
- [Role](https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Role.java): `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Role.java`
- [Delivery address](https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Address.java): `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Address.java`

### Commerce model

- [Food category](https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Category.java): `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Category.java`
- [Product catalog](https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Product.java): `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Product.java`
- [Shopping cart](https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Cart.java): `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Cart.java`
- [Cart items](https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/CartItem.java): `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/CartItem.java`
- [Discount voucher](https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Voucher.java): `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Voucher.java`
- [Customer order](https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Order.java): `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Order.java`
- [Order line items](https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/OrderItem.java): `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/OrderItem.java`
- [Payment record](https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Payment.java): `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Payment.java`
- [Product review](https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Review.java): `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Review.java`

### Backend persistence

- [Spring Boot app](https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/java/com/thunderfood/backend/BackendThunderfoodApplication.java): `backend_thunderfood/src/main/java/com/thunderfood/backend/BackendThunderfoodApplication.java`
- [Relational schema](https://github.com/smagic205/thunderfood/blob/main/backend_thunderfood/src/main/resources/db/migration/V1__init_schema.sql): `backend_thunderfood/src/main/resources/db/migration/V1__init_schema.sql`

### Other components

- **Customer**
- **Admin user**

## Connections

- Customer → Customer web app: uses
- Admin user → Admin app: uses
- User account → Role: has role (evidence: `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/User.java`)
- Delivery address → User account: belongs to (evidence: `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Address.java`)
- Product catalog → Food category: categorized by (evidence: `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Product.java`)
- Shopping cart → User account: belongs to (evidence: `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Cart.java`)
- Cart items → Shopping cart: belongs to (evidence: `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/CartItem.java`)
- Cart items → Product catalog: references (evidence: `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/CartItem.java`)
- Customer order → User account: placed by (evidence: `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Order.java`)
- Customer order → Delivery address: ships to (evidence: `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Order.java`)
- Customer order → Discount voucher: may apply (evidence: `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Order.java`)
- Order line items → Customer order: belongs to (evidence: `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/OrderItem.java`)
- Order line items → Product catalog: references (evidence: `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/OrderItem.java`)
- Payment record → Customer order: records payment for (evidence: `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Payment.java`)
- Product review → Product catalog: reviews (evidence: `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Review.java`)
- Product review → User account: authored by (evidence: `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Review.java`)
- Product review → Customer order: may reference (evidence: `backend_thunderfood/src/main/java/com/thunderfood/backend/entity/Review.java`)
