# stablelife11-commits/business-erp-frontend architecture

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

## Overview

This is an Android ERP client for managing sales, purchases, inventory, customer and supplier accounts, and reports through a remote API. Users enter through the app’s login/dashboard flow, then navigate to operational screens, submit or retrieve records, and view account details or reports. The graph groups screens by domain and includes the shared API and data-model layers. Several screens and report capabilities are represented by their exact enclosing directory because their implementation was not excerpted; links are limited to relationships visible in the supplied excerpts or source index.

Main entry points: [`app/src/main/java/com/business/erp/api/ApiClient.java`](https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/api/ApiClient.java) (API client), [`app/src/main/java/com/business/erp/api/ApiService.java`](https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/api/ApiService.java) (API endpoints), [`app/src/main/java/com/business/erp/activity/SaleDetailsActivity.java`](https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/activity/SaleDetailsActivity.java) (Sale details and PDF), [`app/src/main/java/com/business/erp/activity/AddSaleActivity.java`](https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/activity/AddSaleActivity.java) (Create sale)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App navigation"]
  node_dashboard["Dashboard and login"]
  node_domain_screens["Operations and reports"]
end

subgraph group_sales["Sales operations"]
  node_sale_entry["Create sale"]
  node_sale_details["Sale details and PDF"]
  node_sale_item_adapter["Sale item display"]
  node_sale_list["Sales listing<br/>[SaleActivity.java]"]
end

subgraph group_accounts["Accounts and purchasing"]
  node_purchase_entry["Create purchase"]
  node_customer_account["Customer ledger"]
  node_supplier_account["Supplier outstanding"]
  node_supplier_payment["Supplier payments"]
end

subgraph group_platform["API and data"]
  node_models["ERP data models"]
  node_api_client["API client<br/>[ApiClient.java]"]
  node_api_contract["API endpoints<br/>[ApiService.java]"]
end

node_user(("ERP user"))
node_backend[("ERP backend")]

node_user -->|"uses"| node_dashboard
node_dashboard -->|"navigates"| node_domain_screens
node_sale_entry -->|"requests data"| node_api_client
node_sale_entry -->|"builds sale"| node_models
node_sale_details -->|"sets adapter"| node_sale_item_adapter
node_sale_details -->|"loads sale"| node_api_client
node_sale_list -->|"opens details"| node_sale_details
node_purchase_entry -->|"submits purchase"| node_api_client
node_customer_account -->|"loads account"| node_api_client
node_supplier_account -->|"loads balances"| node_api_client
node_supplier_payment -->|"records payment"| node_api_client
node_api_client -->|"creates service"| node_api_contract
node_api_contract -->|"calls endpoints"| node_backend
node_api_contract -->|"exchanges records"| node_models

click node_dashboard "https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/activity/DashboardActivity.java"
click node_domain_screens "https://github.com/stablelife11-commits/business-erp-frontend/tree/main/app/src/main/java/com/business/erp/activity"
click node_sale_entry "https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/activity/AddSaleActivity.java"
click node_sale_details "https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/activity/SaleDetailsActivity.java"
click node_sale_item_adapter "https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/adapter/SaleItemAdapter.java"
click node_sale_list "https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/activity/SaleActivity.java"
click node_purchase_entry "https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/activity/AddPurchaseActivity.java"
click node_customer_account "https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/activity/CustomerDetailsActivity.java"
click node_supplier_account "https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/activity/SupplierOutstandingActivity.java"
click node_supplier_payment "https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/activity/SupplierPaymentActivity.java"
click node_models "https://github.com/stablelife11-commits/business-erp-frontend/tree/main/app/src/main/java/com/business/erp/model"
click node_api_client "https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/api/ApiClient.java"
click node_api_contract "https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/api/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_dashboard,node_domain_screens,node_user toneBlue
class node_sale_entry,node_sale_details,node_sale_item_adapter,node_sale_list,node_backend toneAmber
class node_purchase_entry,node_customer_account,node_supplier_account,node_supplier_payment toneMint
class node_models,node_api_client,node_api_contract toneRose
```

## Components

### App navigation

- [Dashboard and login](https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/activity/DashboardActivity.java): `app/src/main/java/com/business/erp/activity/DashboardActivity.java`
- [Operations and reports](https://github.com/stablelife11-commits/business-erp-frontend/tree/main/app/src/main/java/com/business/erp/activity): `app/src/main/java/com/business/erp/activity`

### Sales operations

- [Create sale](https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/activity/AddSaleActivity.java): `app/src/main/java/com/business/erp/activity/AddSaleActivity.java`
- [Sale details and PDF](https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/activity/SaleDetailsActivity.java): `app/src/main/java/com/business/erp/activity/SaleDetailsActivity.java`
- [Sale item display](https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/adapter/SaleItemAdapter.java): `app/src/main/java/com/business/erp/adapter/SaleItemAdapter.java`
- [Sales listing](https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/activity/SaleActivity.java): `app/src/main/java/com/business/erp/activity/SaleActivity.java`

### Accounts and purchasing

- [Create purchase](https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/activity/AddPurchaseActivity.java): `app/src/main/java/com/business/erp/activity/AddPurchaseActivity.java`
- [Customer ledger](https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/activity/CustomerDetailsActivity.java): `app/src/main/java/com/business/erp/activity/CustomerDetailsActivity.java`
- [Supplier outstanding](https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/activity/SupplierOutstandingActivity.java): `app/src/main/java/com/business/erp/activity/SupplierOutstandingActivity.java`
- [Supplier payments](https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/activity/SupplierPaymentActivity.java): `app/src/main/java/com/business/erp/activity/SupplierPaymentActivity.java`

### API and data

- [ERP data models](https://github.com/stablelife11-commits/business-erp-frontend/tree/main/app/src/main/java/com/business/erp/model): `app/src/main/java/com/business/erp/model`
- [API client](https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/api/ApiClient.java): `app/src/main/java/com/business/erp/api/ApiClient.java`
- [API endpoints](https://github.com/stablelife11-commits/business-erp-frontend/blob/main/app/src/main/java/com/business/erp/api/ApiService.java): `app/src/main/java/com/business/erp/api/ApiService.java`

### Other components

- **ERP user**
- **ERP backend**

## Connections

- ERP user → Dashboard and login: uses
- Dashboard and login → Operations and reports: navigates (evidence: `app/src/main/java/com/business/erp/activity/DashboardActivity.java`)
- Create sale → API client: requests data (evidence: `app/src/main/java/com/business/erp/activity/AddSaleActivity.java`)
- Create sale → ERP data models: builds sale (evidence: `app/src/main/java/com/business/erp/activity/AddSaleActivity.java`)
- Sale details and PDF → Sale item display: sets adapter (evidence: `app/src/main/java/com/business/erp/activity/SaleDetailsActivity.java`)
- Sale details and PDF → API client: loads sale (evidence: `app/src/main/java/com/business/erp/activity/SaleDetailsActivity.java`)
- Sales listing → Sale details and PDF: opens details
- Create purchase → API client: submits purchase (evidence: `app/src/main/java/com/business/erp/activity/AddPurchaseActivity.java`)
- Customer ledger → API client: loads account (evidence: `app/src/main/java/com/business/erp/activity/CustomerDetailsActivity.java`)
- Supplier outstanding → API client: loads balances (evidence: `app/src/main/java/com/business/erp/activity/SupplierOutstandingActivity.java`)
- Supplier payments → API client: records payment (evidence: `app/src/main/java/com/business/erp/activity/SupplierPaymentActivity.java`)
- API client → API endpoints: creates service (evidence: `app/src/main/java/com/business/erp/api/ApiClient.java`)
- API endpoints → ERP backend: calls endpoints (evidence: `app/src/main/java/com/business/erp/api/ApiService.java`)
- API endpoints → ERP data models: exchanges records (evidence: `app/src/main/java/com/business/erp/api/ApiService.java`)
