# stablelife11-commits/sellerapp architecture

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

## Overview

This Android seller app supports sign-in and a token-authenticated workflow for viewing dashboard statistics, managing products and variant stock, reviewing sales, and processing returns. UI screens call a Retrofit API service; DTOs represent the backend request and response payloads, while session tokens are persisted locally and added to authenticated requests. The API definitions show sales retrieval and creation, although the sampled UI does not establish a sale-entry screen. Relationships below rely on sampled calls and SOURCE INDEX references; unsampled details are not inferred.

Main entry points: [`app/src/main/java/com/retail/seller/data/network/ApiClient.java`](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/network/ApiClient.java) (API client), [`app/src/main/java/com/retail/seller/data/network/ApiService.java`](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/network/ApiService.java) (Backend endpoints), [`app/src/main/java/com/retail/seller/MainActivity.java`](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/MainActivity.java) (App navigation), [`app/src/main/java/com/retail/seller/ui/products/ProductsFragment.java`](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/products/ProductsFragment.java) (Product list)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App navigation"]
  node_main["App navigation<br/>[MainActivity.java]"]
end

subgraph group_seller_workflows["Seller workflows"]
  node_login["Sign in<br/>[LoginActivity.java]"]
  node_dashboard["Dashboard"]
  node_products["Product list"]
  node_product_editor["Add product"]
  node_stock_editor["Update stock"]
  node_product_adapter["Product display"]
  node_variant_adapter["Variant display"]
  node_sales["Sales list<br/>[SalesFragment.java]"]
  node_sale_adapter["Sale display<br/>[SaleAdapter.java]"]
  node_returns["Process return"]
end

subgraph group_network["API and session"]
  node_api_client["API client<br/>[ApiClient.java]"]
  node_api_service["Backend endpoints<br/>[ApiService.java]"]
  node_auth_interceptor["Auth interceptor"]
  node_token_manager[("Session storage<br/>[TokenManager.java]")]
end

subgraph group_contracts["API contracts"]
  node_auth_dto["Auth payloads"]
  node_product_dto["Product payloads"]
  node_stock_dto["Stock request"]
  node_sales_dto["Sales payloads"]
  node_return_dto["Return payloads"]
end

node_seller(("Seller"))
node_backend["Retail backend"]

node_seller -->|"signs in"| node_login
node_login -->|"requests service"| node_api_client
node_login -->|"saves session"| node_token_manager
node_login -->|"opens app"| node_main
node_main -->|"checks session"| node_token_manager
node_main -->|"routes unauthenticated"| node_login
node_main -->|"loads default"| node_dashboard
node_main -->|"routes navigation"| node_products
node_main -->|"routes navigation"| node_sales
node_dashboard -->|"fetches stats"| node_api_client
node_dashboard -->|"opens editor"| node_product_editor
node_dashboard -->|"starts return"| node_returns
node_products -->|"loads products"| node_api_client
node_products -->|"binds product list"| node_product_adapter
node_products -->|"opens editor"| node_product_editor
node_products -->|"opens stock editor"| node_stock_editor
node_product_adapter -->|"renders variants"| node_variant_adapter
node_product_editor -->|"creates product"| node_api_client
node_stock_editor -->|"updates stock"| node_api_client
node_sales -->|"loads sales"| node_api_client
node_sales -->|"binds sales"| node_sale_adapter
node_sales -->|"starts return"| node_returns
node_returns -->|"submits return"| node_api_client
node_api_client -->|"creates service"| node_api_service
node_api_client -->|"configures requests"| node_auth_interceptor
node_auth_interceptor -->|"reads token"| node_token_manager
node_api_service -->|"calls endpoints"| node_backend
node_api_service -->|"uses auth payloads"| node_auth_dto
node_api_service -->|"uses product payloads"| node_product_dto
node_api_service -->|"uses stock request"| node_stock_dto
node_api_service -->|"uses sales payloads"| node_sales_dto
node_api_service -->|"uses return payloads"| node_return_dto
node_token_manager -->|"stores session fields"| node_auth_dto

click node_main "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/MainActivity.java"
click node_login "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/auth/LoginActivity.java"
click node_dashboard "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/dashboard/DashboardFragment.java"
click node_products "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/products/ProductsFragment.java"
click node_product_editor "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/products/AddProductActivity.java"
click node_stock_editor "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/products/UpdateStockBottomSheet.java"
click node_product_adapter "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/products/ProductAdapter.java"
click node_variant_adapter "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/products/VariantAdapter.java"
click node_sales "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/sales/SalesFragment.java"
click node_sale_adapter "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/sales/SaleAdapter.java"
click node_returns "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/returns/ReturnProcessActivity.java"
click node_api_client "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/network/ApiClient.java"
click node_api_service "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/network/ApiService.java"
click node_auth_interceptor "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/network/AuthInterceptor.java"
click node_token_manager "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/network/TokenManager.java"
click node_auth_dto "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/model/AuthResponseDto.java"
click node_product_dto "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/model/ProductResponseDto.java"
click node_stock_dto "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/model/StockUpdateRequestDto.java"
click node_sales_dto "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/model/SaleResponseDto.java"
click node_return_dto "https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/model/ReturnRequestDto.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 toneBlue
class node_login,node_dashboard,node_products,node_product_editor,node_stock_editor,node_product_adapter,node_variant_adapter,node_sales,node_sale_adapter,node_returns toneAmber
class node_api_client,node_api_service,node_auth_interceptor,node_token_manager toneMint
class node_auth_dto,node_product_dto,node_stock_dto,node_sales_dto,node_return_dto toneRose
class node_seller,node_backend toneIndigo
```

## Components

### App navigation

- [App navigation](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/MainActivity.java): `app/src/main/java/com/retail/seller/MainActivity.java`

### Seller workflows

- [Sign in](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/auth/LoginActivity.java): `app/src/main/java/com/retail/seller/ui/auth/LoginActivity.java`
- [Dashboard](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/dashboard/DashboardFragment.java): `app/src/main/java/com/retail/seller/ui/dashboard/DashboardFragment.java`
- [Product list](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/products/ProductsFragment.java): `app/src/main/java/com/retail/seller/ui/products/ProductsFragment.java`
- [Add product](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/products/AddProductActivity.java): `app/src/main/java/com/retail/seller/ui/products/AddProductActivity.java`
- [Update stock](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/products/UpdateStockBottomSheet.java): `app/src/main/java/com/retail/seller/ui/products/UpdateStockBottomSheet.java`
- [Product display](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/products/ProductAdapter.java): `app/src/main/java/com/retail/seller/ui/products/ProductAdapter.java`
- [Variant display](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/products/VariantAdapter.java): `app/src/main/java/com/retail/seller/ui/products/VariantAdapter.java`
- [Sales list](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/sales/SalesFragment.java): `app/src/main/java/com/retail/seller/ui/sales/SalesFragment.java`
- [Sale display](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/sales/SaleAdapter.java): `app/src/main/java/com/retail/seller/ui/sales/SaleAdapter.java`
- [Process return](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/ui/returns/ReturnProcessActivity.java): `app/src/main/java/com/retail/seller/ui/returns/ReturnProcessActivity.java`

### API and session

- [API client](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/network/ApiClient.java): `app/src/main/java/com/retail/seller/data/network/ApiClient.java`
- [Backend endpoints](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/network/ApiService.java): `app/src/main/java/com/retail/seller/data/network/ApiService.java`
- [Auth interceptor](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/network/AuthInterceptor.java): `app/src/main/java/com/retail/seller/data/network/AuthInterceptor.java`
- [Session storage](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/network/TokenManager.java): `app/src/main/java/com/retail/seller/data/network/TokenManager.java`

### API contracts

- [Auth payloads](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/model/AuthResponseDto.java): `app/src/main/java/com/retail/seller/data/model/AuthResponseDto.java`
- [Product payloads](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/model/ProductResponseDto.java): `app/src/main/java/com/retail/seller/data/model/ProductResponseDto.java`
- [Stock request](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/model/StockUpdateRequestDto.java): `app/src/main/java/com/retail/seller/data/model/StockUpdateRequestDto.java`
- [Sales payloads](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/model/SaleResponseDto.java): `app/src/main/java/com/retail/seller/data/model/SaleResponseDto.java`
- [Return payloads](https://github.com/stablelife11-commits/sellerapp/blob/main/app/src/main/java/com/retail/seller/data/model/ReturnRequestDto.java): `app/src/main/java/com/retail/seller/data/model/ReturnRequestDto.java`

### Other components

- **Seller**
- **Retail backend**

## Connections

- Seller → Sign in: signs in (evidence: `app/src/main/java/com/retail/seller/ui/auth/LoginActivity.java`)
- Sign in → API client: requests service (evidence: `app/src/main/java/com/retail/seller/ui/auth/LoginActivity.java`)
- Sign in → Session storage: saves session (evidence: `app/src/main/java/com/retail/seller/ui/auth/LoginActivity.java`)
- Sign in → App navigation: opens app (evidence: `app/src/main/java/com/retail/seller/ui/auth/LoginActivity.java`)
- App navigation → Session storage: checks session (evidence: `app/src/main/java/com/retail/seller/MainActivity.java`)
- App navigation → Sign in: routes unauthenticated (evidence: `app/src/main/java/com/retail/seller/MainActivity.java`)
- App navigation → Dashboard: loads default (evidence: `app/src/main/java/com/retail/seller/MainActivity.java`)
- App navigation → Product list: routes navigation (evidence: `app/src/main/java/com/retail/seller/MainActivity.java`)
- App navigation → Sales list: routes navigation (evidence: `app/src/main/java/com/retail/seller/MainActivity.java`)
- Dashboard → API client: fetches stats (evidence: `app/src/main/java/com/retail/seller/ui/dashboard/DashboardFragment.java`)
- Dashboard → Add product: opens editor (evidence: `app/src/main/java/com/retail/seller/ui/dashboard/DashboardFragment.java`)
- Dashboard → Process return: starts return (evidence: `app/src/main/java/com/retail/seller/ui/dashboard/DashboardFragment.java`)
- Product list → API client: loads products (evidence: `app/src/main/java/com/retail/seller/ui/products/ProductsFragment.java`)
- Product list → Product display: binds product list (evidence: `app/src/main/java/com/retail/seller/ui/products/ProductsFragment.java`)
- Product list → Add product: opens editor (evidence: `app/src/main/java/com/retail/seller/ui/products/ProductsFragment.java`)
- Product list → Update stock: opens stock editor (evidence: `app/src/main/java/com/retail/seller/ui/products/ProductsFragment.java`)
- Product display → Variant display: renders variants (evidence: `app/src/main/java/com/retail/seller/ui/products/ProductAdapter.java`)
- Add product → API client: creates product (evidence: `app/src/main/java/com/retail/seller/ui/products/AddProductActivity.java`)
- Update stock → API client: updates stock (evidence: `app/src/main/java/com/retail/seller/ui/products/UpdateStockBottomSheet.java`)
- Sales list → API client: loads sales (evidence: `app/src/main/java/com/retail/seller/ui/sales/SalesFragment.java`)
- Sales list → Sale display: binds sales (evidence: `app/src/main/java/com/retail/seller/ui/sales/SalesFragment.java`)
- Sales list → Process return: starts return (evidence: `app/src/main/java/com/retail/seller/ui/sales/SalesFragment.java`)
- Process return → API client: submits return (evidence: `app/src/main/java/com/retail/seller/ui/returns/ReturnProcessActivity.java`)
- API client → Backend endpoints: creates service (evidence: `app/src/main/java/com/retail/seller/data/network/ApiClient.java`)
- API client → Auth interceptor: configures requests (evidence: `app/src/main/java/com/retail/seller/data/network/ApiClient.java`)
- Auth interceptor → Session storage: reads token (evidence: `app/src/main/java/com/retail/seller/data/network/AuthInterceptor.java`)
- Backend endpoints → Retail backend: calls endpoints (evidence: `app/src/main/java/com/retail/seller/data/network/ApiService.java`)
- Backend endpoints → Auth payloads: uses auth payloads (evidence: `app/src/main/java/com/retail/seller/data/network/ApiService.java`)
- Backend endpoints → Product payloads: uses product payloads (evidence: `app/src/main/java/com/retail/seller/data/network/ApiService.java`)
- Backend endpoints → Stock request: uses stock request (evidence: `app/src/main/java/com/retail/seller/data/network/ApiService.java`)
- Backend endpoints → Sales payloads: uses sales payloads (evidence: `app/src/main/java/com/retail/seller/data/network/ApiService.java`)
- Backend endpoints → Return payloads: uses return payloads (evidence: `app/src/main/java/com/retail/seller/data/network/ApiService.java`)
- Session storage → Auth payloads: stores session fields (evidence: `app/src/main/java/com/retail/seller/data/network/TokenManager.java`)
