# ahmedbakrycode/cashier_app architecture

> Architecture diagram of the GitHub repository ahmedbakrycode/cashier_app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ahmedbakrycode/cashier_app
- Repository: https://github.com/ahmedbakrycode/cashier_app

## Overview

This is a Flutter point-of-sale app with Android-specific QR scanning and receipt/report printing. The tree indicates broad cashier, catalog, payment, customer, and kitchen-display capabilities, but no Dart source excerpts or detailed README workflow were supplied, so their internal flow cannot be verified. The graph therefore shows those domains without invented call chains; the evidenced Android printer and scanner links are shown separately.

Main entry points: [`android/app/src/main/kotlin/com/genteam/poshigh/App.kt`](https://github.com/ahmedbakrycode/cashier_app/blob/main/android/app/src/main/kotlin/com/genteam/poshigh/App.kt) (Android App Runtime), [`android/app/src/main/kotlin/com/genteam/poshigh/MainActivity.kt`](https://github.com/ahmedbakrycode/cashier_app/blob/main/android/app/src/main/kotlin/com/genteam/poshigh/MainActivity.kt) (Android POS Bridge), [`android/app/src/main/kotlin/com/genteam/poshigh/QrScannerActivity.kt`](https://github.com/ahmedbakrycode/cashier_app/blob/main/android/app/src/main/kotlin/com/genteam/poshigh/QrScannerActivity.kt) (QR Scanner), [`android/app/src/main/kotlin/com/genteam/poshigh/util/UIUtils.kt`](https://github.com/ahmedbakrycode/cashier_app/blob/main/android/app/src/main/kotlin/com/genteam/poshigh/util/UIUtils.kt) (Native Toasts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sales["POS Operations"]
  node_cashier["Till &amp; Checkout"]
  node_payments["Payments"]
  node_products["Products &amp; Pricing"]
  node_tables["Tables &amp; Orders"]
  node_customers["Customers"]
  node_discounts["Discounts &amp; Fees"]
  node_coupons["Coupons"]
  node_auth["Authentication"]
  node_checkin["Staff Check-in"]
  node_devices["Device Setup"]
  node_tillreports["Till Reports"]
end

subgraph group_kitchen["Kitchen Display"]
  node_kdsorders["Kitchen Orders"]
  node_kdshome["Kitchen Display"]
  node_kdshistory["Order History"]
  node_kdssummary["Kitchen Summary"]
  node_cashierdevices["Cashier Devices"]
end

subgraph group_platform["Platform Integrations"]
  node_localsrv["Local Cashier Server"]
  node_nativeapp["Android App Runtime<br/>[App.kt]"]
  node_nativebridge["Android POS Bridge<br/>[MainActivity.kt]"]
  node_qrscan["QR Scanner"]
  node_appdirs["App Storage Paths<br/>[AppDirs.kt]"]
  node_uiutils["Native Toasts<br/>[UIUtils.kt]"]
  node_pluginreg["macOS Plugin Registration"]
end

node_user(("POS Operator"))
node_printer["POS Printer SDK"]

node_nativeapp -->|"shows status"| node_uiutils
node_nativeapp -->|"connects to"| node_printer
node_nativebridge -->|"prints receipts"| node_printer
node_nativebridge -->|"references scanner"| node_qrscan

click node_cashier "https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/till"
click node_payments "https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/payment"
click node_products "https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/products"
click node_tables "https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/tables"
click node_customers "https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/customers"
click node_discounts "https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/discounts"
click node_coupons "https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/coupons"
click node_auth "https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/auth"
click node_checkin "https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/check_in_out"
click node_devices "https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/device"
click node_tillreports "https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/print_summary"
click node_kdsorders "https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/kds/order_body"
click node_kdshome "https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/kds/kds_home"
click node_kdshistory "https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/kds/order_history"
click node_kdssummary "https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/kds/summary"
click node_cashierdevices "https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/kds/cashier_devices"
click node_localsrv "https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/local_cashier_server"
click node_nativeapp "https://github.com/ahmedbakrycode/cashier_app/blob/main/android/app/src/main/kotlin/com/genteam/poshigh/App.kt"
click node_nativebridge "https://github.com/ahmedbakrycode/cashier_app/blob/main/android/app/src/main/kotlin/com/genteam/poshigh/MainActivity.kt"
click node_qrscan "https://github.com/ahmedbakrycode/cashier_app/blob/main/android/app/src/main/kotlin/com/genteam/poshigh/QrScannerActivity.kt"
click node_appdirs "https://github.com/ahmedbakrycode/cashier_app/blob/main/android/app/src/main/kotlin/com/genteam/poshigh/appio/AppDirs.kt"
click node_uiutils "https://github.com/ahmedbakrycode/cashier_app/blob/main/android/app/src/main/kotlin/com/genteam/poshigh/util/UIUtils.kt"
click node_pluginreg "https://github.com/ahmedbakrycode/cashier_app/blob/main/macos/Flutter/GeneratedPluginRegistrant.swift"

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_cashier,node_payments,node_products,node_tables,node_customers,node_discounts,node_coupons,node_auth,node_checkin,node_devices,node_tillreports toneBlue
class node_kdsorders,node_kdshome,node_kdshistory,node_kdssummary,node_cashierdevices toneAmber
class node_localsrv,node_nativeapp,node_nativebridge,node_qrscan,node_appdirs,node_uiutils,node_pluginreg toneMint
class node_user,node_printer toneIndigo
```

## Components

### POS Operations

- [Till & Checkout](https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/till): `lib/features/till`
- [Payments](https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/payment): `lib/features/payment`
- [Products & Pricing](https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/products): `lib/features/products`
- [Tables & Orders](https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/tables): `lib/features/tables`
- [Customers](https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/customers): `lib/features/customers`
- [Discounts & Fees](https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/discounts): `lib/features/discounts`
- [Coupons](https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/coupons): `lib/features/coupons`
- [Authentication](https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/auth): `lib/features/auth`
- [Staff Check-in](https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/check_in_out): `lib/features/check_in_out`
- [Device Setup](https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/device): `lib/features/device`
- [Till Reports](https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/print_summary): `lib/features/print_summary`

### Kitchen Display

- [Kitchen Orders](https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/kds/order_body): `lib/features/kds/order_body`
- [Kitchen Display](https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/kds/kds_home): `lib/features/kds/kds_home`
- [Order History](https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/kds/order_history): `lib/features/kds/order_history`
- [Kitchen Summary](https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/kds/summary): `lib/features/kds/summary`
- [Cashier Devices](https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/kds/cashier_devices): `lib/features/kds/cashier_devices`

### Platform Integrations

- [Local Cashier Server](https://github.com/ahmedbakrycode/cashier_app/tree/main/lib/features/local_cashier_server): `lib/features/local_cashier_server`
- [Android App Runtime](https://github.com/ahmedbakrycode/cashier_app/blob/main/android/app/src/main/kotlin/com/genteam/poshigh/App.kt): `android/app/src/main/kotlin/com/genteam/poshigh/App.kt`
- [Android POS Bridge](https://github.com/ahmedbakrycode/cashier_app/blob/main/android/app/src/main/kotlin/com/genteam/poshigh/MainActivity.kt): `android/app/src/main/kotlin/com/genteam/poshigh/MainActivity.kt`
- [QR Scanner](https://github.com/ahmedbakrycode/cashier_app/blob/main/android/app/src/main/kotlin/com/genteam/poshigh/QrScannerActivity.kt): `android/app/src/main/kotlin/com/genteam/poshigh/QrScannerActivity.kt`
- [App Storage Paths](https://github.com/ahmedbakrycode/cashier_app/blob/main/android/app/src/main/kotlin/com/genteam/poshigh/appio/AppDirs.kt): `android/app/src/main/kotlin/com/genteam/poshigh/appio/AppDirs.kt`
- [Native Toasts](https://github.com/ahmedbakrycode/cashier_app/blob/main/android/app/src/main/kotlin/com/genteam/poshigh/util/UIUtils.kt): `android/app/src/main/kotlin/com/genteam/poshigh/util/UIUtils.kt`
- [macOS Plugin Registration](https://github.com/ahmedbakrycode/cashier_app/blob/main/macos/Flutter/GeneratedPluginRegistrant.swift): `macos/Flutter/GeneratedPluginRegistrant.swift`

### Other components

- **POS Operator**
- **POS Printer SDK**

## Connections

- Android App Runtime → Native Toasts: shows status (evidence: `android/app/src/main/kotlin/com/genteam/poshigh/App.kt`)
- Android App Runtime → POS Printer SDK: connects to (evidence: `android/app/src/main/kotlin/com/genteam/poshigh/App.kt`)
- Android POS Bridge → POS Printer SDK: prints receipts (evidence: `android/app/src/main/kotlin/com/genteam/poshigh/MainActivity.kt`)
- Android POS Bridge → QR Scanner: references scanner (evidence: `android/app/src/main/kotlin/com/genteam/poshigh/MainActivity.kt`)
