# djakonystar/smartshop architecture

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

## Overview

SmartShop is an Android business-management app for sales, customers, inventory, payments, and finance. The principal workflow is a business user recording a sale from a product catalog, assembling the basket, and managing resulting orders and sales; other major branches cover customer accounts, warehouse/product management, and finance reporting. The excerpts show selected UI-to-view-model interactions and client navigation. The README documents the broader capabilities, but API wiring and several feature internals were not sampled, so those connections are omitted or marked unverified.

Main entry points: [`app/src/main/java/uz/texnopos/elektrolife/ui/newsale/NewSaleFragment.kt`](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/newsale/NewSaleFragment.kt) (New sale), [`app/src/main/java/uz/texnopos/elektrolife/ui/client/ClientFragment.kt`](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/client/ClientFragment.kt) (Client directory), [`app/src/main/java/uz/texnopos/elektrolife/data/retrofit/ApiInterface.kt`](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/data/retrofit/ApiInterface.kt) (Backend API), [`app/src/main/java/uz/texnopos/elektrolife/ui/main/MainFragment.kt`](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/main/MainFragment.kt) (Main screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App navigation"]
  node_signin["Sign in<br/>[SignInFragment.kt]"]
  node_home["Main screen<br/>[MainFragment.kt]"]
  node_settings[("User settings<br/>[Settings.kt]")]
end

subgraph group_selling["Sales and inventory"]
  node_new_sale["New sale<br/>[NewSaleFragment.kt]"]
  node_catalog["Sale catalog"]
  node_basket["Sale basket<br/>[Basket.kt]"]
  node_orders["Orders<br/>[OrderFragment.kt]"]
  node_sales["Sales history<br/>[SalesFragment.kt]"]
  node_warehouse["Warehouse"]
  node_product["Add product"]
  node_transaction["Stock transaction"]
end

subgraph group_customers["Customer accounts"]
  node_clients["Client directory<br/>[ClientFragment.kt]"]
  node_client_detail["Client account"]
  node_client_sales["Client purchases"]
  node_client_payments["Client payments"]
  node_new_payment["Record payment"]
end

subgraph group_finance["Finance"]
  node_finance["Finance overview<br/>[FinanceFragment.kt]"]
  node_reports["Finance reports<br/>[ReportsFragment.kt]"]
  node_income_expense["Income and expenses"]
end

node_user(("Business user"))
node_api["Backend API<br/>[ApiInterface.kt]"]

node_user -->|"signs in"| node_signin
node_user -.->|"opens app"| node_home
node_home -->|"reads language"| node_settings
node_home -->|"resets basket"| node_basket
node_user -->|"records sale"| node_new_sale
node_new_sale -->|"loads categories"| node_catalog
node_new_sale -.->|"adds products"| node_basket
node_user -.->|"manages orders"| node_orders
node_user -->|"reviews sales"| node_sales
node_user -->|"checks stock"| node_warehouse
node_user -->|"adds product"| node_product
node_product -->|"opens transaction"| node_transaction
node_user -->|"manages clients"| node_clients
node_clients -->|"opens account"| node_client_detail
node_client_detail -->|"shows purchases"| node_client_sales
node_client_detail -->|"shows payments"| node_client_payments
node_clients -->|"starts payment"| node_new_payment
node_user -->|"records payment"| node_new_payment
node_user -->|"views finance"| node_finance
node_finance -->|"opens reports"| node_reports
node_user -->|"records finances"| node_income_expense
node_new_sale -.->|"submits sale"| node_api
node_clients -.->|"requests clients"| node_api
node_warehouse -.->|"requests inventory"| node_api
node_finance -.->|"requests finance data"| node_api

click node_signin "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/signin/SignInFragment.kt"
click node_home "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/main/MainFragment.kt"
click node_settings "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/settings/Settings.kt"
click node_new_sale "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/newsale/NewSaleFragment.kt"
click node_catalog "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/newsale/CategoriesViewModel.kt"
click node_basket "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/newsale/Basket.kt"
click node_orders "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/newsale/order/OrderFragment.kt"
click node_sales "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/sales/SalesFragment.kt"
click node_warehouse "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/warehouse/WarehouseFragment.kt"
click node_product "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/newproduct/NewProductFragment.kt"
click node_transaction "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/dialog/TransactionDialog.kt"
click node_clients "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/client/ClientFragment.kt"
click node_client_detail "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/client/detail/ClientDetailFragment.kt"
click node_client_sales "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/client/detail/sale/ClientSalesFragment.kt"
click node_client_payments "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/client/detail/payment/ClientPaymentFragment.kt"
click node_new_payment "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/newpayment/NewPaymentFragment.kt"
click node_finance "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/finance/FinanceFragment.kt"
click node_reports "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/finance/reports/ReportsFragment.kt"
click node_income_expense "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/finance/income/IncomeAddFragment.kt"
click node_api "https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/data/retrofit/ApiInterface.kt"

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_signin,node_home,node_settings,node_user toneBlue
class node_new_sale,node_catalog,node_basket,node_orders,node_sales,node_warehouse,node_product,node_transaction toneAmber
class node_clients,node_client_detail,node_client_sales,node_client_payments,node_new_payment,node_api toneMint
class node_finance,node_reports,node_income_expense toneRose
```

## Components

### App navigation

- [Sign in](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/signin/SignInFragment.kt): `app/src/main/java/uz/texnopos/elektrolife/ui/signin/SignInFragment.kt`
- [Main screen](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/main/MainFragment.kt): `app/src/main/java/uz/texnopos/elektrolife/ui/main/MainFragment.kt`
- [User settings](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/settings/Settings.kt): `app/src/main/java/uz/texnopos/elektrolife/settings/Settings.kt`

### Sales and inventory

- [New sale](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/newsale/NewSaleFragment.kt): `app/src/main/java/uz/texnopos/elektrolife/ui/newsale/NewSaleFragment.kt`
- [Sale catalog](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/newsale/CategoriesViewModel.kt): `app/src/main/java/uz/texnopos/elektrolife/ui/newsale/CategoriesViewModel.kt`
- [Sale basket](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/newsale/Basket.kt): `app/src/main/java/uz/texnopos/elektrolife/ui/newsale/Basket.kt`
- [Orders](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/newsale/order/OrderFragment.kt): `app/src/main/java/uz/texnopos/elektrolife/ui/newsale/order/OrderFragment.kt`
- [Sales history](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/sales/SalesFragment.kt): `app/src/main/java/uz/texnopos/elektrolife/ui/sales/SalesFragment.kt`
- [Warehouse](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/warehouse/WarehouseFragment.kt): `app/src/main/java/uz/texnopos/elektrolife/ui/warehouse/WarehouseFragment.kt`
- [Add product](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/newproduct/NewProductFragment.kt): `app/src/main/java/uz/texnopos/elektrolife/ui/newproduct/NewProductFragment.kt`
- [Stock transaction](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/dialog/TransactionDialog.kt): `app/src/main/java/uz/texnopos/elektrolife/ui/dialog/TransactionDialog.kt`

### Customer accounts

- [Client directory](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/client/ClientFragment.kt): `app/src/main/java/uz/texnopos/elektrolife/ui/client/ClientFragment.kt`
- [Client account](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/client/detail/ClientDetailFragment.kt): `app/src/main/java/uz/texnopos/elektrolife/ui/client/detail/ClientDetailFragment.kt`
- [Client purchases](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/client/detail/sale/ClientSalesFragment.kt): `app/src/main/java/uz/texnopos/elektrolife/ui/client/detail/sale/ClientSalesFragment.kt`
- [Client payments](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/client/detail/payment/ClientPaymentFragment.kt): `app/src/main/java/uz/texnopos/elektrolife/ui/client/detail/payment/ClientPaymentFragment.kt`
- [Record payment](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/newpayment/NewPaymentFragment.kt): `app/src/main/java/uz/texnopos/elektrolife/ui/newpayment/NewPaymentFragment.kt`

### Finance

- [Finance overview](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/finance/FinanceFragment.kt): `app/src/main/java/uz/texnopos/elektrolife/ui/finance/FinanceFragment.kt`
- [Finance reports](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/finance/reports/ReportsFragment.kt): `app/src/main/java/uz/texnopos/elektrolife/ui/finance/reports/ReportsFragment.kt`
- [Income and expenses](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/ui/finance/income/IncomeAddFragment.kt): `app/src/main/java/uz/texnopos/elektrolife/ui/finance/income/IncomeAddFragment.kt`

### Other components

- **Business user**
- [Backend API](https://github.com/djakonystar/smartshop/blob/master/app/src/main/java/uz/texnopos/elektrolife/data/retrofit/ApiInterface.kt): `app/src/main/java/uz/texnopos/elektrolife/data/retrofit/ApiInterface.kt`

## Connections

- Business user → Sign in: signs in (evidence: `app/src/main/java/uz/texnopos/elektrolife/ui/signin/SignInFragment.kt`)
- Business user → Main screen: opens app
- Main screen → User settings: reads language (evidence: `app/src/main/java/uz/texnopos/elektrolife/ui/main/MainFragment.kt`)
- Main screen → Sale basket: resets basket (evidence: `app/src/main/java/uz/texnopos/elektrolife/ui/main/MainFragment.kt`)
- Business user → New sale: records sale
- New sale → Sale catalog: loads categories (evidence: `app/src/main/java/uz/texnopos/elektrolife/ui/newsale/NewSaleFragment.kt`)
- New sale → Sale basket: adds products
- Business user → Orders: manages orders
- Business user → Sales history: reviews sales
- Business user → Warehouse: checks stock
- Business user → Add product: adds product
- Add product → Stock transaction: opens transaction (evidence: `app/src/main/java/uz/texnopos/elektrolife/ui/newproduct/NewProductFragment.kt`)
- Business user → Client directory: manages clients
- Client directory → Client account: opens account (evidence: `app/src/main/java/uz/texnopos/elektrolife/ui/client/ClientFragment.kt`)
- Client account → Client purchases: shows purchases (evidence: `app/src/main/java/uz/texnopos/elektrolife/ui/client/detail/ClientDetailFragment.kt`)
- Client account → Client payments: shows payments (evidence: `app/src/main/java/uz/texnopos/elektrolife/ui/client/detail/ClientDetailFragment.kt`)
- Client directory → Record payment: starts payment (evidence: `app/src/main/java/uz/texnopos/elektrolife/ui/client/ClientFragment.kt`)
- Business user → Record payment: records payment
- Business user → Finance overview: views finance
- Finance overview → Finance reports: opens reports (evidence: `app/src/main/java/uz/texnopos/elektrolife/ui/finance/FinanceFragment.kt`)
- Business user → Income and expenses: records finances
- New sale → Backend API: submits sale
- Client directory → Backend API: requests clients
- Warehouse → Backend API: requests inventory
- Finance overview → Backend API: requests finance data
