# shabareesh390/forage-midas architecture

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

- Interactive diagram: https://gitdiagram.com/shabareesh390/forage-midas
- Repository: https://github.com/shabareesh390/forage-midas

## Overview

Midas is a Spring Boot transaction-processing service. Its main workflow consumes Kafka transactions, checks sender and recipient accounts and available funds, optionally requests an incentive, updates balances, and records the transaction. A separate REST endpoint returns a user’s balance. The excerpts show the listener’s calls and repository interfaces; database configuration and broker setup are not shown, so infrastructure details beyond the listener subscription are omitted.

Main entry points: [`src/main/java/com/jpmc/midascore/TransactionListener.java`](https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/TransactionListener.java) (Transaction listener), [`src/main/java/com/jpmc/midascore/repository/UserRepository.java`](https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/repository/UserRepository.java) (User repository), [`src/main/java/com/jpmc/midascore/controller/BalanceController.java`](https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/controller/BalanceController.java) (Balance endpoint), [`src/main/java/com/jpmc/midascore/repository/TransactionRepository.java`](https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/repository/TransactionRepository.java) (Transaction repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_processing["Transaction processing"]
  node_listener["Transaction listener"]
  node_application["Spring Boot app"]
end

subgraph group_accounts["Accounts and balance"]
  node_balance_controller["Balance endpoint"]
end

subgraph group_persistence["Persistence model"]
  node_user_repository["User repository"]
  node_transaction_repository["Transaction repository"]
  node_user_record["User record<br/>[UserRecord.java]"]
  node_transaction_record["Transaction record"]
  node_database_conduit["Database conduit"]
end

subgraph group_contracts["Data contracts"]
  node_balance_contract["Balance response<br/>[Balance.java]"]
  node_transaction_contract["Transaction message<br/>[Transaction.java]"]
  node_incentive_contract["Incentive response<br/>[Incentive.java]"]
end

node_kafka(("Kafka broker"))
node_incentive_api["Incentive API"]
node_balance_client(("Balance client"))

node_kafka -->|"dispatches"| node_listener
node_listener -->|"consumes"| node_transaction_contract
node_listener -->|"looks up and saves"| node_user_repository
node_listener -->|"records transaction"| node_transaction_repository
node_listener -->|"requests incentive"| node_incentive_api
node_incentive_api -->|"returns"| node_incentive_contract
node_listener -->|"updates accounts"| node_user_record
node_listener -->|"creates record"| node_transaction_record
node_balance_client -->|"requests balance"| node_balance_controller
node_balance_controller -->|"looks up user"| node_user_repository
node_balance_controller -->|"returns balance"| node_balance_contract
node_database_conduit -->|"saves user"| node_user_repository
node_user_repository -->|"persists"| node_user_record
node_transaction_repository -->|"persists"| node_transaction_record

click node_listener "https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/TransactionListener.java"
click node_balance_controller "https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/controller/BalanceController.java"
click node_balance_contract "https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/foundation/Balance.java"
click node_user_repository "https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/repository/UserRepository.java"
click node_transaction_repository "https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/repository/TransactionRepository.java"
click node_user_record "https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/entity/UserRecord.java"
click node_transaction_record "https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/entity/TransactionRecord.java"
click node_transaction_contract "https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/foundation/Transaction.java"
click node_incentive_contract "https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/foundation/Incentive.java"
click node_database_conduit "https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/component/DatabaseConduit.java"
click node_application "https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/MidasCoreApplication.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_listener,node_application,node_balance_client toneBlue
class node_balance_controller toneAmber
class node_user_repository,node_transaction_repository,node_user_record,node_transaction_record,node_database_conduit,node_incentive_api toneMint
class node_balance_contract,node_transaction_contract,node_incentive_contract toneRose
class node_kafka toneIndigo
```

## Components

### Transaction processing

- [Transaction listener](https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/TransactionListener.java): `src/main/java/com/jpmc/midascore/TransactionListener.java`
- [Spring Boot app](https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/MidasCoreApplication.java): `src/main/java/com/jpmc/midascore/MidasCoreApplication.java`

### Accounts and balance

- [Balance endpoint](https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/controller/BalanceController.java): `src/main/java/com/jpmc/midascore/controller/BalanceController.java`

### Persistence model

- [User repository](https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/repository/UserRepository.java): `src/main/java/com/jpmc/midascore/repository/UserRepository.java`
- [Transaction repository](https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/repository/TransactionRepository.java): `src/main/java/com/jpmc/midascore/repository/TransactionRepository.java`
- [User record](https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/entity/UserRecord.java): `src/main/java/com/jpmc/midascore/entity/UserRecord.java`
- [Transaction record](https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/entity/TransactionRecord.java): `src/main/java/com/jpmc/midascore/entity/TransactionRecord.java`
- [Database conduit](https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/component/DatabaseConduit.java): `src/main/java/com/jpmc/midascore/component/DatabaseConduit.java`

### Data contracts

- [Balance response](https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/foundation/Balance.java): `src/main/java/com/jpmc/midascore/foundation/Balance.java`
- [Transaction message](https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/foundation/Transaction.java): `src/main/java/com/jpmc/midascore/foundation/Transaction.java`
- [Incentive response](https://github.com/shabareesh390/forage-midas/blob/flow/src/main/java/com/jpmc/midascore/foundation/Incentive.java): `src/main/java/com/jpmc/midascore/foundation/Incentive.java`

### Other components

- **Kafka broker**
- **Incentive API**
- **Balance client**

## Connections

- Kafka broker → Transaction listener: dispatches (evidence: `src/main/java/com/jpmc/midascore/TransactionListener.java`)
- Transaction listener → Transaction message: consumes (evidence: `src/main/java/com/jpmc/midascore/TransactionListener.java`)
- Transaction listener → User repository: looks up and saves (evidence: `src/main/java/com/jpmc/midascore/TransactionListener.java`)
- Transaction listener → Transaction repository: records transaction (evidence: `src/main/java/com/jpmc/midascore/TransactionListener.java`)
- Transaction listener → Incentive API: requests incentive (evidence: `src/main/java/com/jpmc/midascore/TransactionListener.java`)
- Incentive API → Incentive response: returns
- Transaction listener → User record: updates accounts (evidence: `src/main/java/com/jpmc/midascore/TransactionListener.java`)
- Transaction listener → Transaction record: creates record (evidence: `src/main/java/com/jpmc/midascore/TransactionListener.java`)
- Balance client → Balance endpoint: requests balance (evidence: `src/main/java/com/jpmc/midascore/controller/BalanceController.java`)
- Balance endpoint → User repository: looks up user (evidence: `src/main/java/com/jpmc/midascore/controller/BalanceController.java`)
- Balance endpoint → Balance response: returns balance (evidence: `src/main/java/com/jpmc/midascore/controller/BalanceController.java`)
- Database conduit → User repository: saves user (evidence: `src/main/java/com/jpmc/midascore/component/DatabaseConduit.java`)
- User repository → User record: persists (evidence: `src/main/java/com/jpmc/midascore/repository/UserRepository.java`)
- Transaction repository → Transaction record: persists (evidence: `src/main/java/com/jpmc/midascore/repository/TransactionRepository.java`)
