# thesyncoder/full-stack-ecommerce-spring-boot-react architecture

> Architecture diagram of the GitHub repository thesyncoder/full-stack-ecommerce-spring-boot-react, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/thesyncoder/full-stack-ecommerce-spring-boot-react
- Repository: https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react

## Overview

FlamUp is a React and Spring Boot clothing e-commerce application. A shopper enters through the frontend, registers or logs in, browses and searches clothing, and can add items to a cart and view that cart. The sampled catalog code calls product and order API paths; backend controllers delegate to services, which use repositories for product, cart, and order data. The README identifies PostgreSQL, but database wiring is not shown in the excerpts. Several backend endpoints and the cart-page request flow were not sampled, so those links are left unasserted or marked unverified.

Main entry points: [`frontend/src/App.js`](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/App.js) (React app and routes), [`frontend/src/Pages/Products.js`](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/Pages/Products.js) (Product browsing), [`frontend/src/context.js`](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/context.js) (Auth context), [`src/main/java/com/flamup/spring/Services/CartService.java`](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Services/CartService.java) (Cart service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Storefront"]
  node_app["React app and routes<br/>[App.js]"]
  node_authstate["Auth context<br/>[context.js]"]
  node_authcheck["Authentication check"]
  node_home["Home page<br/>[home.js]"]
  node_appbar["Store navigation<br/>[AppBar.js]"]
end

subgraph group_identity["Identity"]
  node_login["Login page<br/>[login.js]"]
  node_register["Registration page<br/>[Register.js]"]
  node_authcontroller["Auth controller"]
  node_registrationcontroller["Registration controller"]
  node_registration["Registration service"]
  node_userservice["User service"]
end

subgraph group_catalog["Catalog"]
  node_products["Product browsing<br/>[Products.js]"]
  node_dresscard["Product card<br/>[DressShow.js]"]
  node_productcontroller["Product controller"]
  node_productservice["Product service"]
end

subgraph group_commerce["Cart and orders"]
  node_cartpage["Cart page<br/>[CartScreen.js]"]
  node_cartcontroller["Cart controller"]
  node_cartservice["Cart service<br/>[CartService.java]"]
end

subgraph group_backend["Backend data"]
  node_userrepo["User repository"]
  node_userentity["User account"]
  node_productrepo["Product repository"]
  node_product["Clothing product<br/>[Product.java]"]
  node_cartrepo["Cart repository"]
  node_orderrepo["Order repository"]
  node_cartmodel["Shopping cart<br/>[ShoppingCart.java]"]
  node_ordermodel["Order item<br/>[OrderItem.java]"]
end

node_shopper(("Shopper"))
node_database[("PostgreSQL")]

node_shopper -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_register
node_app -->|"routes to"| node_products
node_app -->|"routes to"| node_cartpage
node_app -->|"checks session"| node_authcheck
node_app -->|"provides"| node_authstate
node_products -->|"reads"| node_authstate
node_home -->|"reads"| node_authstate
node_login -->|"reads"| node_authstate
node_products -->|"renders"| node_appbar
node_products -->|"renders"| node_dresscard
node_appbar -->|"reads"| node_authstate
node_products -.->|"requests catalog"| node_productcontroller
node_products -.->|"requests orders"| node_cartcontroller
node_productcontroller -->|"delegates"| node_productservice
node_productservice -->|"queries"| node_productrepo
node_registrationcontroller -->|"delegates"| node_registration
node_registration -->|"registers user"| node_userservice
node_authcontroller -->|"uses"| node_userservice
node_userservice -->|"reads and saves"| node_userrepo
node_cartcontroller -->|"delegates"| node_cartservice
node_cartservice -->|"reads and saves"| node_cartrepo
node_cartservice -->|"reads and saves"| node_orderrepo
node_cartservice -->|"looks up products"| node_productrepo
node_productrepo -.->|"persists products"| node_database
node_cartrepo -.->|"persists carts"| node_database
node_orderrepo -.->|"persists orders"| node_database

click node_app "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/App.js"
click node_authstate "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/context.js"
click node_authcheck "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/Service/AuthenticationService.js"
click node_home "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/Pages/home.js"
click node_login "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/Pages/login.js"
click node_register "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/Pages/Register.js"
click node_authcontroller "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Controllers/AuthController.java"
click node_registrationcontroller "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Controllers/RegistrationController.java"
click node_registration "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Services/RegistrationService.java"
click node_userservice "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/auth/AppUserService.java"
click node_userrepo "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Repositories/ApplicationUserRepository.java"
click node_userentity "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Models/ApplicationUser.java"
click node_products "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/Pages/Products.js"
click node_appbar "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/Components/AppBar.js"
click node_dresscard "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/Components/DressShow.js"
click node_productcontroller "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Controllers/ProductController.java"
click node_productservice "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Services/ProductService.java"
click node_productrepo "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Repositories/ProductRepository.java"
click node_product "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Models/Product.java"
click node_cartpage "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/Pages/CartScreen.js"
click node_cartcontroller "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Controllers/CartServiceController.java"
click node_cartservice "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Services/CartService.java"
click node_cartrepo "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Repositories/CartRepository.java"
click node_orderrepo "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Repositories/OrderRepository.java"
click node_cartmodel "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Models/ShoppingCart.java"
click node_ordermodel "https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Models/OrderItem.java"

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_authstate,node_authcheck,node_home,node_appbar toneBlue
class node_login,node_register,node_authcontroller,node_registrationcontroller,node_registration,node_userservice,node_database toneAmber
class node_products,node_dresscard,node_productcontroller,node_productservice toneMint
class node_cartpage,node_cartcontroller,node_cartservice toneRose
class node_userrepo,node_userentity,node_productrepo,node_product,node_cartrepo,node_orderrepo,node_cartmodel,node_ordermodel,node_shopper toneIndigo
```

## Components

### Storefront

- [React app and routes](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/App.js): `frontend/src/App.js`
- [Auth context](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/context.js): `frontend/src/context.js`
- [Authentication check](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/Service/AuthenticationService.js): `frontend/src/Service/AuthenticationService.js`
- [Home page](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/Pages/home.js): `frontend/src/Pages/home.js`
- [Store navigation](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/Components/AppBar.js): `frontend/src/Components/AppBar.js`

### Identity

- [Login page](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/Pages/login.js): `frontend/src/Pages/login.js`
- [Registration page](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/Pages/Register.js): `frontend/src/Pages/Register.js`
- [Auth controller](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Controllers/AuthController.java): `src/main/java/com/flamup/spring/Controllers/AuthController.java`
- [Registration controller](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Controllers/RegistrationController.java): `src/main/java/com/flamup/spring/Controllers/RegistrationController.java`
- [Registration service](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Services/RegistrationService.java): `src/main/java/com/flamup/spring/Services/RegistrationService.java`
- [User service](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/auth/AppUserService.java): `src/main/java/com/flamup/spring/auth/AppUserService.java`

### Catalog

- [Product browsing](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/Pages/Products.js): `frontend/src/Pages/Products.js`
- [Product card](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/Components/DressShow.js): `frontend/src/Components/DressShow.js`
- [Product controller](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Controllers/ProductController.java): `src/main/java/com/flamup/spring/Controllers/ProductController.java`
- [Product service](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Services/ProductService.java): `src/main/java/com/flamup/spring/Services/ProductService.java`

### Cart and orders

- [Cart page](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/frontend/src/Pages/CartScreen.js): `frontend/src/Pages/CartScreen.js`
- [Cart controller](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Controllers/CartServiceController.java): `src/main/java/com/flamup/spring/Controllers/CartServiceController.java`
- [Cart service](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Services/CartService.java): `src/main/java/com/flamup/spring/Services/CartService.java`

### Backend data

- [User repository](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Repositories/ApplicationUserRepository.java): `src/main/java/com/flamup/spring/Repositories/ApplicationUserRepository.java`
- [User account](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Models/ApplicationUser.java): `src/main/java/com/flamup/spring/Models/ApplicationUser.java`
- [Product repository](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Repositories/ProductRepository.java): `src/main/java/com/flamup/spring/Repositories/ProductRepository.java`
- [Clothing product](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Models/Product.java): `src/main/java/com/flamup/spring/Models/Product.java`
- [Cart repository](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Repositories/CartRepository.java): `src/main/java/com/flamup/spring/Repositories/CartRepository.java`
- [Order repository](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Repositories/OrderRepository.java): `src/main/java/com/flamup/spring/Repositories/OrderRepository.java`
- [Shopping cart](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Models/ShoppingCart.java): `src/main/java/com/flamup/spring/Models/ShoppingCart.java`
- [Order item](https://github.com/thesyncoder/full-stack-ecommerce-spring-boot-react/blob/https/src/main/java/com/flamup/spring/Models/OrderItem.java): `src/main/java/com/flamup/spring/Models/OrderItem.java`

### Other components

- **Shopper**
- **PostgreSQL**

## Connections

- Shopper → React app and routes: uses
- React app and routes → Home page: routes to (evidence: `frontend/src/App.js`)
- React app and routes → Login page: routes to (evidence: `frontend/src/App.js`)
- React app and routes → Registration page: routes to (evidence: `frontend/src/App.js`)
- React app and routes → Product browsing: routes to (evidence: `frontend/src/App.js`)
- React app and routes → Cart page: routes to (evidence: `frontend/src/App.js`)
- React app and routes → Authentication check: checks session (evidence: `frontend/src/App.js`)
- React app and routes → Auth context: provides (evidence: `frontend/src/App.js`)
- Product browsing → Auth context: reads (evidence: `frontend/src/Pages/Products.js`)
- Home page → Auth context: reads (evidence: `frontend/src/Pages/home.js`)
- Login page → Auth context: reads (evidence: `frontend/src/Pages/login.js`)
- Product browsing → Store navigation: renders (evidence: `frontend/src/Pages/Products.js`)
- Product browsing → Product card: renders (evidence: `frontend/src/Pages/Products.js`)
- Store navigation → Auth context: reads (evidence: `frontend/src/Components/AppBar.js`)
- Product browsing → Product controller: requests catalog
- Product browsing → Cart controller: requests orders
- Product controller → Product service: delegates (evidence: `src/main/java/com/flamup/spring/Controllers/ProductController.java`)
- Product service → Product repository: queries (evidence: `src/main/java/com/flamup/spring/Services/ProductService.java`)
- Registration controller → Registration service: delegates (evidence: `src/main/java/com/flamup/spring/Controllers/RegistrationController.java`)
- Registration service → User service: registers user (evidence: `src/main/java/com/flamup/spring/Services/RegistrationService.java`)
- Auth controller → User service: uses (evidence: `src/main/java/com/flamup/spring/Controllers/AuthController.java`)
- User service → User repository: reads and saves (evidence: `src/main/java/com/flamup/spring/auth/AppUserService.java`)
- Cart controller → Cart service: delegates (evidence: `src/main/java/com/flamup/spring/Controllers/CartServiceController.java`)
- Cart service → Cart repository: reads and saves (evidence: `src/main/java/com/flamup/spring/Services/CartService.java`)
- Cart service → Order repository: reads and saves (evidence: `src/main/java/com/flamup/spring/Services/CartService.java`)
- Cart service → Product repository: looks up products (evidence: `src/main/java/com/flamup/spring/Services/CartService.java`)
- Product repository → PostgreSQL: persists products
- Cart repository → PostgreSQL: persists carts
- Order repository → PostgreSQL: persists orders
