# chauhansahab2525/offlinepay architecture

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

- Interactive diagram: https://gitdiagram.com/chauhansahab2525/offlinepay
- Repository: https://github.com/chauhansahab2525/offlinepay

## Overview

OfflinePay simulates an offline payment lifecycle: a sender creates an encrypted packet, phones forward it over a TTL-limited mesh, and a bridge uploads it to the backend for validation, duplicate detection, and settlement. The repository also exposes REST and dashboard capabilities, PIN checks, and a transaction ledger. Relationships below follow the README’s documented flow; source excerpts were not provided, so implementation-level calls and wiring are not verified.

Main entry points: [`src/main/java/com/demo/upimesh/model/MeshPacket.java`](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/model/MeshPacket.java) (Encrypted packet), [`src/main/java/com/demo/upimesh/service/MeshSimulatorService.java`](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/service/MeshSimulatorService.java) (Mesh forwarding), [`src/main/java/com/demo/upimesh/service/VirtualDevice.java`](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/service/VirtualDevice.java) (Phone device), [`src/main/java/com/demo/upimesh/service/BridgeIngestionService.java`](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/service/BridgeIngestionService.java) (Bridge upload)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingress["Payment ingress"]
  node_packet["Encrypted packet<br/>[MeshPacket.java]"]
  node_crypto["Packet encryption"]
  node_mesh["Mesh forwarding"]
  node_phone["Phone device<br/>[VirtualDevice.java]"]
  node_bridge["Bridge upload"]
end

subgraph group_backend["Backend processing"]
  node_backend_app["Spring backend"]
  node_api["REST API<br/>[ApiController.java]"]
  node_validation["Packet validation"]
  node_pin["PIN verification<br/>[PinService.java]"]
  node_dedupe["Duplicate detection"]
  node_settlement["Payment settlement"]
  node_instruction["Payment instruction"]
  node_config["Application configuration<br/>[AppConfig.java]"]
  node_key_holder["Server key holder"]
end

subgraph group_state["Accounts and ledger"]
  node_transaction["Transaction record<br/>[Transaction.java]"]
  node_transaction_repo["Transaction repository"]
  node_account["Account<br/>[Account.java]"]
  node_account_repo["Account repository"]
  node_mysql[("MySQL ledger")]
end

subgraph group_interface["User interfaces"]
  node_dashboard_controller["Dashboard controller"]
  node_dashboard["Live dashboard<br/>[dashboard.html]"]
  node_demo["Demo flow<br/>[DemoService.java]"]
end

node_sender(("Sender"))

node_sender -->|"creates"| node_packet
node_packet -->|"forwards via"| node_mesh
node_mesh -->|"gossips through"| node_phone
node_phone -->|"reaches"| node_bridge
node_bridge -->|"uploads to"| node_backend_app
node_backend_app -->|"validates"| node_validation
node_validation -->|"checks duplicates"| node_dedupe
node_dedupe -->|"allows settlement"| node_settlement
node_crypto -->|"encrypts"| node_packet
node_settlement -->|"records payment"| node_transaction
node_transaction -->|"stored in"| node_mysql
node_dashboard_controller -->|"serves"| node_dashboard

click node_packet "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/model/MeshPacket.java"
click node_crypto "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/crypto/HybridCryptoService.java"
click node_mesh "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/service/MeshSimulatorService.java"
click node_phone "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/service/VirtualDevice.java"
click node_bridge "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/service/BridgeIngestionService.java"
click node_backend_app "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/UpiMeshApplication.java"
click node_api "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/controller/ApiController.java"
click node_validation "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/service/BridgeIngestionService.java"
click node_pin "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/security/PinService.java"
click node_dedupe "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/service/IdempotencyService.java"
click node_settlement "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/service/SettlementService.java"
click node_instruction "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/model/PaymentInstruction.java"
click node_transaction "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/model/Transaction.java"
click node_transaction_repo "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/model/TransactionRepository.java"
click node_account "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/model/Account.java"
click node_account_repo "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/model/AccountRepository.java"
click node_dashboard_controller "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/controller/DashboardController.java"
click node_dashboard "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/resources/templates/dashboard.html"
click node_demo "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/service/DemoService.java"
click node_config "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/config/AppConfig.java"
click node_key_holder "https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/crypto/ServerKeyHolder.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_packet,node_crypto,node_mesh,node_phone,node_bridge toneBlue
class node_backend_app,node_api,node_validation,node_pin,node_dedupe,node_settlement,node_instruction,node_config,node_key_holder toneAmber
class node_transaction,node_transaction_repo,node_account,node_account_repo,node_mysql toneMint
class node_dashboard_controller,node_dashboard,node_demo toneRose
class node_sender toneIndigo
```

## Components

### Payment ingress

- [Encrypted packet](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/model/MeshPacket.java): `src/main/java/com/demo/upimesh/model/MeshPacket.java`
- [Packet encryption](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/crypto/HybridCryptoService.java): `src/main/java/com/demo/upimesh/crypto/HybridCryptoService.java`
- [Mesh forwarding](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/service/MeshSimulatorService.java): `src/main/java/com/demo/upimesh/service/MeshSimulatorService.java`
- [Phone device](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/service/VirtualDevice.java): `src/main/java/com/demo/upimesh/service/VirtualDevice.java`
- [Bridge upload](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/service/BridgeIngestionService.java): `src/main/java/com/demo/upimesh/service/BridgeIngestionService.java`

### Backend processing

- [Spring backend](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/UpiMeshApplication.java): `src/main/java/com/demo/upimesh/UpiMeshApplication.java`
- [REST API](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/controller/ApiController.java): `src/main/java/com/demo/upimesh/controller/ApiController.java`
- [Packet validation](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/service/BridgeIngestionService.java): `src/main/java/com/demo/upimesh/service/BridgeIngestionService.java`
- [PIN verification](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/security/PinService.java): `src/main/java/com/demo/upimesh/security/PinService.java`
- [Duplicate detection](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/service/IdempotencyService.java): `src/main/java/com/demo/upimesh/service/IdempotencyService.java`
- [Payment settlement](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/service/SettlementService.java): `src/main/java/com/demo/upimesh/service/SettlementService.java`
- [Payment instruction](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/model/PaymentInstruction.java): `src/main/java/com/demo/upimesh/model/PaymentInstruction.java`
- [Application configuration](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/config/AppConfig.java): `src/main/java/com/demo/upimesh/config/AppConfig.java`
- [Server key holder](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/crypto/ServerKeyHolder.java): `src/main/java/com/demo/upimesh/crypto/ServerKeyHolder.java`

### Accounts and ledger

- [Transaction record](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/model/Transaction.java): `src/main/java/com/demo/upimesh/model/Transaction.java`
- [Transaction repository](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/model/TransactionRepository.java): `src/main/java/com/demo/upimesh/model/TransactionRepository.java`
- [Account](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/model/Account.java): `src/main/java/com/demo/upimesh/model/Account.java`
- [Account repository](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/model/AccountRepository.java): `src/main/java/com/demo/upimesh/model/AccountRepository.java`
- **MySQL ledger**

### User interfaces

- [Dashboard controller](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/controller/DashboardController.java): `src/main/java/com/demo/upimesh/controller/DashboardController.java`
- [Live dashboard](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/resources/templates/dashboard.html): `src/main/resources/templates/dashboard.html`
- [Demo flow](https://github.com/chauhansahab2525/offlinepay/blob/main/src/main/java/com/demo/upimesh/service/DemoService.java): `src/main/java/com/demo/upimesh/service/DemoService.java`

### Other components

- **Sender**

## Connections

- Sender → Encrypted packet: creates (evidence: `README.md`)
- Encrypted packet → Mesh forwarding: forwards via (evidence: `README.md`)
- Mesh forwarding → Phone device: gossips through (evidence: `README.md`)
- Phone device → Bridge upload: reaches (evidence: `README.md`)
- Bridge upload → Spring backend: uploads to (evidence: `README.md`)
- Spring backend → Packet validation: validates (evidence: `README.md`)
- Packet validation → Duplicate detection: checks duplicates (evidence: `README.md`)
- Duplicate detection → Payment settlement: allows settlement (evidence: `README.md`)
- Packet encryption → Encrypted packet: encrypts (evidence: `README.md`)
- Payment settlement → Transaction record: records payment (evidence: `README.md`)
- Transaction record → MySQL ledger: stored in (evidence: `README.md`)
- Dashboard controller → Live dashboard: serves (evidence: `README.md`)
