# stablelife11-commits/customershoppingapp architecture

> Architecture diagram of the GitHub repository stablelife11-commits/customershoppingapp, 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/stablelife11-commits/customershoppingapp
- Repository: https://github.com/stablelife11-commits/customershoppingapp

## Overview

This Android retail-shopping app takes a signed-in customer from browsing products and categories through cart management and checkout to order confirmation and history. Authentication stores credentials and user details in a local session; checkout submits an order through the API. The graph also preserves profile and customer-management capabilities visible in the repository tree. Several repository and ViewModel implementations were not excerpted, so links involving them are marked unverified rather than presented as inspected call paths.

Main entry points: [`app/src/main/java/com/retail/customershoppingapp/MainActivity.java`](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/MainActivity.java) (App navigation), [`app/src/main/java/com/retail/customershoppingapp/session/SessionManager.java`](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/session/SessionManager.java) (Session storage), [`app/src/main/java/com/retail/customershoppingapp/network/ApiService.java`](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/network/ApiService.java) (API contract), [`app/src/main/java/com/retail/customershoppingapp/ui/checkout/CheckoutActivity.java`](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/checkout/CheckoutActivity.java) (Checkout and placement)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App navigation"]
  node_main["App navigation<br/>[MainActivity.java]"]
  node_auth_ui["Sign-in and registration"]
  node_profile["Account profile"]
end

subgraph group_shopping["Product discovery"]
  node_home["Home browsing<br/>[HomeFragment.java]"]
  node_categories["Category browsing"]
  node_product_ui["Product listing and detail"]
  node_product_vm["Product state and filtering"]
  node_product_repo["Product data access"]
end

subgraph group_commerce["Cart and orders"]
  node_cart_ui["Cart screen<br/>[CartFragment.java]"]
  node_cart_vm["Cart state<br/>[CartViewModel.java]"]
  node_cart_repo["Cart operations"]
  node_cart_state["Cart items<br/>[CartItem.java]"]
  node_checkout["Checkout and placement"]
  node_order_vm["Order state"]
  node_order_repo["Order data access"]
  node_order_ui["Order history and details"]
  node_success["Order confirmation"]
end

subgraph group_platform["Identity and networking"]
  node_auth_vm["Authentication state<br/>[AuthViewModel.java]"]
  node_auth_repo["Authentication access"]
  node_customer_repo["Customer data access"]
  node_session["Session storage"]
  node_preferences[("Local preferences")]
  node_retrofit["HTTP client"]
  node_api["API contract<br/>[ApiService.java]"]
end

node_shopper(("Shopper"))
node_backend{{"Retail backend"}}

node_shopper -->|"opens app"| node_main
node_main -->|"routes unauthenticated"| node_auth_ui
node_main -->|"loads default"| node_home
node_main -->|"routes navigation"| node_categories
node_main -->|"routes navigation"| node_cart_ui
node_main -->|"routes navigation"| node_order_ui
node_main -->|"routes navigation"| node_profile
node_shopper -->|"signs in"| node_auth_ui
node_auth_ui -->|"submits credentials"| node_auth_vm
node_auth_vm -.->|"delegates auth"| node_auth_repo
node_auth_repo -->|"calls auth endpoints"| node_api
node_auth_repo -->|"saves login"| node_session
node_session -->|"reads and writes"| node_preferences
node_home -->|"loads products"| node_product_vm
node_categories -->|"loads category products"| node_product_vm
node_product_ui -->|"fetches and filters"| node_product_vm
node_product_vm -.->|"loads product data"| node_product_repo
node_product_repo -.->|"requests catalog"| node_api
node_product_ui -->|"adds selected item"| node_cart_vm
node_cart_ui -->|"uses cart state"| node_cart_vm
node_cart_vm -->|"delegates cart operations"| node_cart_repo
node_cart_repo -->|"persists cart"| node_session
node_cart_repo -->|"manages items"| node_cart_state
node_cart_ui -->|"starts checkout"| node_checkout
node_checkout -->|"reads and clears cart"| node_cart_vm
node_checkout -->|"reads customer details"| node_session
node_checkout -->|"submits order"| node_order_vm
node_order_vm -.->|"creates order"| node_order_repo
node_order_repo -.->|"sends order requests"| node_api
node_checkout -->|"opens on success"| node_success
node_order_ui -->|"loads order history"| node_order_vm
node_profile -->|"reads account session"| node_session
node_customer_repo -.->|"uses customer endpoints"| node_api
node_retrofit -->|"configures auth"| node_session
node_retrofit -->|"creates service"| node_api
node_api -->|"defines HTTP operations"| node_backend

click node_main "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/MainActivity.java"
click node_auth_ui "https://github.com/stablelife11-commits/customershoppingapp/tree/main/app/src/main/java/com/retail/customershoppingapp/ui/auth"
click node_profile "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/profile/ProfileFragment.java"
click node_home "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/home/HomeFragment.java"
click node_categories "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/category/CategoriesFragment.java"
click node_product_ui "https://github.com/stablelife11-commits/customershoppingapp/tree/main/app/src/main/java/com/retail/customershoppingapp/ui/product"
click node_product_vm "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/product/ProductViewModel.java"
click node_product_repo "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/repository/ProductRepository.java"
click node_cart_ui "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/cart/CartFragment.java"
click node_cart_vm "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/cart/CartViewModel.java"
click node_cart_repo "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/repository/CartRepository.java"
click node_cart_state "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/model/cart/CartItem.java"
click node_checkout "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/checkout/CheckoutActivity.java"
click node_order_vm "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/order/OrderViewModel.java"
click node_order_repo "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/repository/OrderRepository.java"
click node_order_ui "https://github.com/stablelife11-commits/customershoppingapp/tree/main/app/src/main/java/com/retail/customershoppingapp/ui/order"
click node_success "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/checkout/OrderSuccessActivity.java"
click node_auth_vm "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/auth/AuthViewModel.java"
click node_auth_repo "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/repository/AuthRepository.java"
click node_customer_repo "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/repository/CustomerRepository.java"
click node_session "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/session/SessionManager.java"
click node_retrofit "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/network/RetrofitClient.java"
click node_api "https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/network/ApiService.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_main,node_auth_ui,node_profile toneBlue
class node_home,node_categories,node_product_ui,node_product_vm,node_product_repo toneAmber
class node_cart_ui,node_cart_vm,node_cart_repo,node_cart_state,node_checkout,node_order_vm,node_order_repo,node_order_ui,node_success toneMint
class node_auth_vm,node_auth_repo,node_customer_repo,node_session,node_preferences,node_retrofit,node_api toneRose
class node_shopper,node_backend toneIndigo
```

## Components

### App navigation

- [App navigation](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/MainActivity.java): `app/src/main/java/com/retail/customershoppingapp/MainActivity.java`
- [Sign-in and registration](https://github.com/stablelife11-commits/customershoppingapp/tree/main/app/src/main/java/com/retail/customershoppingapp/ui/auth): `app/src/main/java/com/retail/customershoppingapp/ui/auth`
- [Account profile](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/profile/ProfileFragment.java): `app/src/main/java/com/retail/customershoppingapp/ui/profile/ProfileFragment.java`

### Product discovery

- [Home browsing](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/home/HomeFragment.java): `app/src/main/java/com/retail/customershoppingapp/ui/home/HomeFragment.java`
- [Category browsing](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/category/CategoriesFragment.java): `app/src/main/java/com/retail/customershoppingapp/ui/category/CategoriesFragment.java`
- [Product listing and detail](https://github.com/stablelife11-commits/customershoppingapp/tree/main/app/src/main/java/com/retail/customershoppingapp/ui/product): `app/src/main/java/com/retail/customershoppingapp/ui/product`
- [Product state and filtering](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/product/ProductViewModel.java): `app/src/main/java/com/retail/customershoppingapp/ui/product/ProductViewModel.java`
- [Product data access](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/repository/ProductRepository.java): `app/src/main/java/com/retail/customershoppingapp/repository/ProductRepository.java`

### Cart and orders

- [Cart screen](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/cart/CartFragment.java): `app/src/main/java/com/retail/customershoppingapp/ui/cart/CartFragment.java`
- [Cart state](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/cart/CartViewModel.java): `app/src/main/java/com/retail/customershoppingapp/ui/cart/CartViewModel.java`
- [Cart operations](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/repository/CartRepository.java): `app/src/main/java/com/retail/customershoppingapp/repository/CartRepository.java`
- [Cart items](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/model/cart/CartItem.java): `app/src/main/java/com/retail/customershoppingapp/model/cart/CartItem.java`
- [Checkout and placement](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/checkout/CheckoutActivity.java): `app/src/main/java/com/retail/customershoppingapp/ui/checkout/CheckoutActivity.java`
- [Order state](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/order/OrderViewModel.java): `app/src/main/java/com/retail/customershoppingapp/ui/order/OrderViewModel.java`
- [Order data access](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/repository/OrderRepository.java): `app/src/main/java/com/retail/customershoppingapp/repository/OrderRepository.java`
- [Order history and details](https://github.com/stablelife11-commits/customershoppingapp/tree/main/app/src/main/java/com/retail/customershoppingapp/ui/order): `app/src/main/java/com/retail/customershoppingapp/ui/order`
- [Order confirmation](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/checkout/OrderSuccessActivity.java): `app/src/main/java/com/retail/customershoppingapp/ui/checkout/OrderSuccessActivity.java`

### Identity and networking

- [Authentication state](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/ui/auth/AuthViewModel.java): `app/src/main/java/com/retail/customershoppingapp/ui/auth/AuthViewModel.java`
- [Authentication access](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/repository/AuthRepository.java): `app/src/main/java/com/retail/customershoppingapp/repository/AuthRepository.java`
- [Customer data access](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/repository/CustomerRepository.java): `app/src/main/java/com/retail/customershoppingapp/repository/CustomerRepository.java`
- [Session storage](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/session/SessionManager.java): `app/src/main/java/com/retail/customershoppingapp/session/SessionManager.java`
- **Local preferences**
- [HTTP client](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/network/RetrofitClient.java): `app/src/main/java/com/retail/customershoppingapp/network/RetrofitClient.java`
- [API contract](https://github.com/stablelife11-commits/customershoppingapp/blob/main/app/src/main/java/com/retail/customershoppingapp/network/ApiService.java): `app/src/main/java/com/retail/customershoppingapp/network/ApiService.java`

### Other components

- **Shopper**
- **Retail backend**

## Connections

- Shopper → App navigation: opens app (evidence: `app/src/main/java/com/retail/customershoppingapp/MainActivity.java`)
- App navigation → Sign-in and registration: routes unauthenticated (evidence: `app/src/main/java/com/retail/customershoppingapp/MainActivity.java`)
- App navigation → Home browsing: loads default (evidence: `app/src/main/java/com/retail/customershoppingapp/MainActivity.java`)
- App navigation → Category browsing: routes navigation (evidence: `app/src/main/java/com/retail/customershoppingapp/MainActivity.java`)
- App navigation → Cart screen: routes navigation (evidence: `app/src/main/java/com/retail/customershoppingapp/MainActivity.java`)
- App navigation → Order history and details: routes navigation (evidence: `app/src/main/java/com/retail/customershoppingapp/MainActivity.java`)
- App navigation → Account profile: routes navigation (evidence: `app/src/main/java/com/retail/customershoppingapp/MainActivity.java`)
- Shopper → Sign-in and registration: signs in (evidence: `app/src/main/java/com/retail/customershoppingapp/ui/auth/RegisterActivity.java`)
- Sign-in and registration → Authentication state: submits credentials (evidence: `app/src/main/java/com/retail/customershoppingapp/ui/auth/RegisterActivity.java`)
- Authentication state → Authentication access: delegates auth (evidence: `app/src/main/java/com/retail/customershoppingapp/ui/auth/AuthViewModel.java`)
- Authentication access → API contract: calls auth endpoints (evidence: `app/src/main/java/com/retail/customershoppingapp/repository/AuthRepository.java`)
- Authentication access → Session storage: saves login (evidence: `app/src/main/java/com/retail/customershoppingapp/repository/AuthRepository.java`)
- Session storage → Local preferences: reads and writes (evidence: `app/src/main/java/com/retail/customershoppingapp/session/SessionManager.java`)
- Home browsing → Product state and filtering: loads products (evidence: `app/src/main/java/com/retail/customershoppingapp/ui/home/HomeFragment.java`)
- Category browsing → Product state and filtering: loads category products (evidence: `app/src/main/java/com/retail/customershoppingapp/ui/category/CategoriesFragment.java`)
- Product listing and detail → Product state and filtering: fetches and filters (evidence: `app/src/main/java/com/retail/customershoppingapp/ui/product/ProductListActivity.java`)
- Product state and filtering → Product data access: loads product data (evidence: `app/src/main/java/com/retail/customershoppingapp/ui/product/ProductViewModel.java`)
- Product data access → API contract: requests catalog (evidence: `app/src/main/java/com/retail/customershoppingapp/repository/ProductRepository.java`)
- Product listing and detail → Cart state: adds selected item (evidence: `app/src/main/java/com/retail/customershoppingapp/ui/product/ProductListActivity.java`)
- Cart screen → Cart state: uses cart state (evidence: `app/src/main/java/com/retail/customershoppingapp/ui/cart/CartFragment.java`)
- Cart state → Cart operations: delegates cart operations (evidence: `app/src/main/java/com/retail/customershoppingapp/ui/cart/CartViewModel.java`)
- Cart operations → Session storage: persists cart (evidence: `app/src/main/java/com/retail/customershoppingapp/repository/CartRepository.java`)
- Cart operations → Cart items: manages items (evidence: `app/src/main/java/com/retail/customershoppingapp/repository/CartRepository.java`)
- Cart screen → Checkout and placement: starts checkout (evidence: `app/src/main/java/com/retail/customershoppingapp/ui/cart/CartFragment.java`)
- Checkout and placement → Cart state: reads and clears cart (evidence: `app/src/main/java/com/retail/customershoppingapp/ui/checkout/CheckoutActivity.java`)
- Checkout and placement → Session storage: reads customer details (evidence: `app/src/main/java/com/retail/customershoppingapp/ui/checkout/CheckoutActivity.java`)
- Checkout and placement → Order state: submits order (evidence: `app/src/main/java/com/retail/customershoppingapp/ui/checkout/CheckoutActivity.java`)
- Order state → Order data access: creates order (evidence: `app/src/main/java/com/retail/customershoppingapp/ui/order/OrderViewModel.java`)
- Order data access → API contract: sends order requests (evidence: `app/src/main/java/com/retail/customershoppingapp/repository/OrderRepository.java`)
- Checkout and placement → Order confirmation: opens on success (evidence: `app/src/main/java/com/retail/customershoppingapp/ui/checkout/CheckoutActivity.java`)
- Order history and details → Order state: loads order history (evidence: `app/src/main/java/com/retail/customershoppingapp/ui/order/OrderHistoryFragment.java`)
- Account profile → Session storage: reads account session (evidence: `app/src/main/java/com/retail/customershoppingapp/ui/profile/ProfileFragment.java`)
- Customer data access → API contract: uses customer endpoints (evidence: `app/src/main/java/com/retail/customershoppingapp/repository/CustomerRepository.java`)
- HTTP client → Session storage: configures auth (evidence: `app/src/main/java/com/retail/customershoppingapp/network/RetrofitClient.java`)
- HTTP client → API contract: creates service (evidence: `app/src/main/java/com/retail/customershoppingapp/network/RetrofitClient.java`)
- API contract → Retail backend: defines HTTP operations (evidence: `app/src/main/java/com/retail/customershoppingapp/network/ApiService.java`)
