# stabix-protocol/stabix-backend architecture

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

## Overview

StabiX Backend is a PostgreSQL-backed financial/asset service layer, with repository modules for users, assets, networks, wallets, transactions, deposits, withdrawals, fees, and ledger records. The visible runtime workflow is service-to-repository access to persisted records; the excerpts show query-oriented lookups, including transaction and deposit/withdrawal history. No HTTP routes or request handlers are shown, so an initiating API workflow cannot be traced. The graph separates the legacy database pool used by the repositories from the newer PostgreSQL adapter. Service/repository links are supported by the source index; unsampled implementation details are not inferred.

Main entry points: [`database/db.js`](https://github.com/stabix-protocol/stabix-backend/blob/main/database/db.js) (Legacy DB pool), [`src/infrastructure/database/postgres.js`](https://github.com/stabix-protocol/stabix-backend/blob/main/src/infrastructure/database/postgres.js) (PostgreSQL adapter), [`src/repositories/userRepository.js`](https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/userRepository.js) (User repository), [`src/repositories/assetRepository.js`](https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/assetRepository.js) (Asset repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity_catalog["Identity and catalog"]
  node_users_service["User service<br/>[userService.js]"]
  node_users_repo["User repository<br/>[userRepository.js]"]
  node_assets_service["Asset service<br/>[assetService.js]"]
  node_assets_repo["Asset repository<br/>[assetRepository.js]"]
  node_networks_service["Network service<br/>[networkService.js]"]
  node_networks_repo["Network repository"]
  node_asset_network_service["Asset-network service"]
  node_asset_network_repo["Asset-network repository"]
end

subgraph group_wallet_accounts["Wallet accounts"]
  node_wallet_service["Wallet service<br/>[walletService.js]"]
  node_wallet_repo["Wallet repository"]
  node_balance_service["Balance service"]
  node_balance_repo["Balance repository"]
end

subgraph group_financial_records["Financial records"]
  node_transaction_service["Transaction service"]
  node_transaction_repo["Transaction repository"]
  node_deposit_service["Deposit service<br/>[depositService.js]"]
  node_deposit_repo["Deposit repository"]
  node_withdrawal_service["Withdrawal service"]
  node_withdrawal_repo["Withdrawal repository"]
  node_fee_service["Fee service<br/>[feeService.js]"]
  node_fee_repo["Fee repository<br/>[feeRepository.js]"]
  node_ledger_service["Ledger service<br/>[ledgerService.js]"]
  node_ledger_repo["Ledger repository"]
end

subgraph group_persistence["Persistence"]
  node_legacy_pool[("Legacy DB pool<br/>[db.js]")]
  node_pg_adapter["PostgreSQL adapter<br/>[postgres.js]"]
  node_db_repository["DB repository helper<br/>[dbRepository.js]"]
  node_environment["Environment config<br/>[env.js]"]
end

node_postgres[("PostgreSQL")]

node_users_service -->|"delegates to"| node_users_repo
node_users_repo -->|"queries"| node_legacy_pool
node_assets_service -->|"delegates to"| node_assets_repo
node_assets_repo -->|"queries"| node_legacy_pool
node_networks_service -->|"delegates to"| node_networks_repo
node_networks_repo -->|"queries"| node_legacy_pool
node_asset_network_service -->|"delegates to"| node_asset_network_repo
node_asset_network_repo -->|"queries"| node_legacy_pool
node_wallet_service -->|"delegates to"| node_wallet_repo
node_wallet_repo -->|"queries"| node_legacy_pool
node_balance_service -->|"delegates to"| node_balance_repo
node_balance_repo -->|"queries"| node_legacy_pool
node_transaction_service -->|"delegates to"| node_transaction_repo
node_transaction_repo -->|"queries"| node_legacy_pool
node_deposit_service -->|"delegates to"| node_deposit_repo
node_deposit_repo -->|"queries"| node_legacy_pool
node_withdrawal_service -->|"delegates to"| node_withdrawal_repo
node_withdrawal_repo -->|"queries"| node_legacy_pool
node_fee_service -->|"delegates to"| node_fee_repo
node_fee_repo -->|"queries"| node_legacy_pool
node_ledger_service -->|"delegates to"| node_ledger_repo
node_ledger_repo -->|"queries"| node_legacy_pool
node_legacy_pool -->|"connects to"| node_postgres
node_pg_adapter -->|"reads config"| node_environment
node_pg_adapter -->|"connects to"| node_postgres
node_db_repository -->|"uses adapter"| node_pg_adapter

click node_users_service "https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/userService.js"
click node_users_repo "https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/userRepository.js"
click node_assets_service "https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/assetService.js"
click node_assets_repo "https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/assetRepository.js"
click node_networks_service "https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/networkService.js"
click node_networks_repo "https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/networkRepository.js"
click node_asset_network_service "https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/assetNetworkService.js"
click node_asset_network_repo "https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/assetNetworkRepository.js"
click node_wallet_service "https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/walletService.js"
click node_wallet_repo "https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/walletRepository.js"
click node_balance_service "https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/walletBalanceService.js"
click node_balance_repo "https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/walletBalanceRepository.js"
click node_transaction_service "https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/transactionService.js"
click node_transaction_repo "https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/transactionRepository.js"
click node_deposit_service "https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/depositService.js"
click node_deposit_repo "https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/depositRepository.js"
click node_withdrawal_service "https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/withdrawalService.js"
click node_withdrawal_repo "https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/withdrawalRepository.js"
click node_fee_service "https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/feeService.js"
click node_fee_repo "https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/feeRepository.js"
click node_ledger_service "https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/ledgerService.js"
click node_ledger_repo "https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/ledgerRepository.js"
click node_legacy_pool "https://github.com/stabix-protocol/stabix-backend/blob/main/database/db.js"
click node_pg_adapter "https://github.com/stabix-protocol/stabix-backend/blob/main/src/infrastructure/database/postgres.js"
click node_db_repository "https://github.com/stabix-protocol/stabix-backend/blob/main/src/shared/dbRepository.js"
click node_environment "https://github.com/stabix-protocol/stabix-backend/blob/main/src/config/env.js"

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_users_service,node_users_repo,node_assets_service,node_assets_repo,node_networks_service,node_networks_repo,node_asset_network_service,node_asset_network_repo toneBlue
class node_wallet_service,node_wallet_repo,node_balance_service,node_balance_repo,node_postgres toneAmber
class node_transaction_service,node_transaction_repo,node_deposit_service,node_deposit_repo,node_withdrawal_service,node_withdrawal_repo,node_fee_service,node_fee_repo,node_ledger_service,node_ledger_repo toneMint
class node_legacy_pool,node_pg_adapter,node_db_repository,node_environment toneRose
```

## Components

### Identity and catalog

- [User service](https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/userService.js): `src/services/userService.js`
- [User repository](https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/userRepository.js): `src/repositories/userRepository.js`
- [Asset service](https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/assetService.js): `src/services/assetService.js`
- [Asset repository](https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/assetRepository.js): `src/repositories/assetRepository.js`
- [Network service](https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/networkService.js): `src/services/networkService.js`
- [Network repository](https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/networkRepository.js): `src/repositories/networkRepository.js`
- [Asset-network service](https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/assetNetworkService.js): `src/services/assetNetworkService.js`
- [Asset-network repository](https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/assetNetworkRepository.js): `src/repositories/assetNetworkRepository.js`

### Wallet accounts

- [Wallet service](https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/walletService.js): `src/services/walletService.js`
- [Wallet repository](https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/walletRepository.js): `src/repositories/walletRepository.js`
- [Balance service](https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/walletBalanceService.js): `src/services/walletBalanceService.js`
- [Balance repository](https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/walletBalanceRepository.js): `src/repositories/walletBalanceRepository.js`

### Financial records

- [Transaction service](https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/transactionService.js): `src/services/transactionService.js`
- [Transaction repository](https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/transactionRepository.js): `src/repositories/transactionRepository.js`
- [Deposit service](https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/depositService.js): `src/services/depositService.js`
- [Deposit repository](https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/depositRepository.js): `src/repositories/depositRepository.js`
- [Withdrawal service](https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/withdrawalService.js): `src/services/withdrawalService.js`
- [Withdrawal repository](https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/withdrawalRepository.js): `src/repositories/withdrawalRepository.js`
- [Fee service](https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/feeService.js): `src/services/feeService.js`
- [Fee repository](https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/feeRepository.js): `src/repositories/feeRepository.js`
- [Ledger service](https://github.com/stabix-protocol/stabix-backend/blob/main/src/services/ledgerService.js): `src/services/ledgerService.js`
- [Ledger repository](https://github.com/stabix-protocol/stabix-backend/blob/main/src/repositories/ledgerRepository.js): `src/repositories/ledgerRepository.js`

### Persistence

- [Legacy DB pool](https://github.com/stabix-protocol/stabix-backend/blob/main/database/db.js): `database/db.js`
- [PostgreSQL adapter](https://github.com/stabix-protocol/stabix-backend/blob/main/src/infrastructure/database/postgres.js): `src/infrastructure/database/postgres.js`
- [DB repository helper](https://github.com/stabix-protocol/stabix-backend/blob/main/src/shared/dbRepository.js): `src/shared/dbRepository.js`
- [Environment config](https://github.com/stabix-protocol/stabix-backend/blob/main/src/config/env.js): `src/config/env.js`

### Other components

- **PostgreSQL**

## Connections

- User service → User repository: delegates to (evidence: `src/services/userService.js`)
- User repository → Legacy DB pool: queries (evidence: `src/repositories/userRepository.js`)
- Asset service → Asset repository: delegates to (evidence: `src/services/assetService.js`)
- Asset repository → Legacy DB pool: queries (evidence: `src/repositories/assetRepository.js`)
- Network service → Network repository: delegates to (evidence: `src/services/networkService.js`)
- Network repository → Legacy DB pool: queries (evidence: `src/repositories/networkRepository.js`)
- Asset-network service → Asset-network repository: delegates to (evidence: `src/services/assetNetworkService.js`)
- Asset-network repository → Legacy DB pool: queries (evidence: `src/repositories/assetNetworkRepository.js`)
- Wallet service → Wallet repository: delegates to (evidence: `src/services/walletService.js`)
- Wallet repository → Legacy DB pool: queries (evidence: `src/repositories/walletRepository.js`)
- Balance service → Balance repository: delegates to (evidence: `src/services/walletBalanceService.js`)
- Balance repository → Legacy DB pool: queries (evidence: `src/repositories/walletBalanceRepository.js`)
- Transaction service → Transaction repository: delegates to (evidence: `src/services/transactionService.js`)
- Transaction repository → Legacy DB pool: queries (evidence: `src/repositories/transactionRepository.js`)
- Deposit service → Deposit repository: delegates to (evidence: `src/services/depositService.js`)
- Deposit repository → Legacy DB pool: queries (evidence: `src/repositories/depositRepository.js`)
- Withdrawal service → Withdrawal repository: delegates to (evidence: `src/services/withdrawalService.js`)
- Withdrawal repository → Legacy DB pool: queries (evidence: `src/repositories/withdrawalRepository.js`)
- Fee service → Fee repository: delegates to (evidence: `src/services/feeService.js`)
- Fee repository → Legacy DB pool: queries (evidence: `src/repositories/feeRepository.js`)
- Ledger service → Ledger repository: delegates to (evidence: `src/services/ledgerService.js`)
- Ledger repository → Legacy DB pool: queries (evidence: `src/repositories/ledgerRepository.js`)
- Legacy DB pool → PostgreSQL: connects to (evidence: `database/db.js`)
- PostgreSQL adapter → Environment config: reads config (evidence: `src/infrastructure/database/postgres.js`)
- PostgreSQL adapter → PostgreSQL: connects to (evidence: `src/infrastructure/database/postgres.js`)
- DB repository helper → PostgreSQL adapter: uses adapter (evidence: `src/shared/dbRepository.js`)
