# hadighany25/u-pay-bank architecture

> Architecture diagram of the GitHub repository hadighany25/u-pay-bank, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hadighany25/u-pay-bank
- Repository: https://github.com/hadighany25/u-pay-bank

## Overview

U-Pay is a payment and account-management backend with a browser-based customer/admin interface. Its main flow is HTTP requests entering the Express server, being dispatched through feature routes and controllers, and updating account or transaction records; the server also exposes Socket.IO updates. The tree indicates broader capabilities including merchant payments, escrow, payroll, U-Fund, cards, communications, and gateway integration. Several of those modules were not excerpted, so their route-to-controller links are shown as unverified rather than inferred.

Main entry points: [`U-Pay Backend/server.js`](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/server.js) (HTTP and sockets), [`U-Pay Backend/middleware/authMiddleware.js`](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/middleware/authMiddleware.js) (Access middleware), [`U-Pay Backend/controllers/merchantController.js`](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/controllers/merchantController.js) (Merchant payments), [`U-Pay Backend/controllers/transactionController.js`](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/controllers/transactionController.js) (Payment operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and access"]
  node_server["HTTP and sockets<br/>[server.js]"]
  node_auth_routes["Authentication routes<br/>[authRoutes.js]"]
  node_auth_controller["Identity and profile<br/>[authController.js]"]
  node_auth_guard["Access middleware<br/>[authMiddleware.js]"]
end

subgraph group_money["Payments and accounts"]
  node_account_routes["Account routes<br/>[accountRoutes.js]"]
  node_account_controller["Account management"]
  node_transaction_routes["Transaction routes"]
  node_transaction_controller["Payment operations"]
  node_user_store[("User accounts<br/>[User.js]")]
  node_transaction_store[("Transaction records<br/>[Transaction.js]")]
end

subgraph group_services["Product services"]
  node_merchant_routes["Merchant routes<br/>[merchantRoutes.js]"]
  node_merchant_controller["Merchant payments"]
  node_merchant_store[("Merchant profiles<br/>[Merchant.js]")]
  node_other_routes["Specialized API routes"]
  node_other_controllers["Specialized services"]
  node_payroll_worker["Payroll processing"]
  node_payroll_schedule["Payroll scheduler<br/>[payrollCron.js]"]
end

subgraph group_operations["Administration"]
  node_system_service["System settings<br/>[systemService.js]"]
  node_admin_routes["Admin routes<br/>[adminRoutes.js]"]
  node_admin_controller["Administration<br/>[adminController.js]"]
  node_admin_ui["Admin browser UI"]
  node_system_store[("System settings store<br/>[System.js]")]
end

node_client(("API client"))
node_frontend["Customer browser UI"]

node_client -->|"sends requests"| node_server
node_frontend -.->|"calls API"| node_server
node_admin_ui -.->|"calls API"| node_server
node_server -->|"mounts routes"| node_auth_routes
node_server -->|"mounts routes"| node_transaction_routes
node_server -->|"mounts routes"| node_account_routes
node_server -->|"mounts routes"| node_merchant_routes
node_server -->|"mounts routes"| node_admin_routes
node_server -->|"mounts routes"| node_other_routes
node_auth_routes -->|"dispatches to"| node_auth_controller
node_auth_routes -->|"protects routes"| node_auth_guard
node_account_routes -->|"dispatches to"| node_account_controller
node_account_routes -->|"protects routes"| node_auth_guard
node_transaction_routes -->|"dispatches to"| node_transaction_controller
node_transaction_routes -->|"protects routes"| node_auth_guard
node_merchant_routes -->|"dispatches to"| node_merchant_controller
node_merchant_routes -->|"protects routes"| node_auth_guard
node_admin_routes -->|"dispatches to"| node_admin_controller
node_admin_routes -->|"checks roles"| node_auth_guard
node_auth_controller -->|"reads and writes"| node_user_store
node_transaction_controller -->|"updates balances"| node_user_store
node_transaction_controller -->|"records payments"| node_transaction_store
node_transaction_controller -->|"resolves merchants"| node_merchant_store
node_merchant_controller -->|"manages profiles"| node_merchant_store
node_merchant_controller -->|"records charges"| node_transaction_store
node_merchant_controller -->|"reads account owners"| node_user_store
node_auth_guard -->|"checks system status"| node_system_service
node_system_service -->|"reads settings"| node_system_store
node_admin_controller -->|"uses settings"| node_system_service
node_admin_controller -->|"manages users"| node_user_store
node_admin_controller -->|"queries transactions"| node_transaction_store
node_admin_routes -->|"dispatches merchant actions"| node_merchant_controller
node_other_routes -.->|"dispatches to"| node_other_controllers
node_payroll_schedule -->|"runs payroll"| node_payroll_worker
node_server -->|"loads scheduler"| node_payroll_schedule

click node_server "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/server.js"
click node_auth_routes "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/routes/authRoutes.js"
click node_auth_controller "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/controllers/authController.js"
click node_auth_guard "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/middleware/authMiddleware.js"
click node_account_routes "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/routes/accountRoutes.js"
click node_account_controller "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/controllers/accountController.js"
click node_transaction_routes "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/routes/transactionRoutes.js"
click node_transaction_controller "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/controllers/transactionController.js"
click node_user_store "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/models/User.js"
click node_transaction_store "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/models/Transaction.js"
click node_merchant_routes "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/routes/merchantRoutes.js"
click node_merchant_controller "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/controllers/merchantController.js"
click node_merchant_store "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/models/Merchant.js"
click node_other_routes "https://github.com/hadighany25/u-pay-bank/tree/main/U-Pay%20Backend/routes"
click node_other_controllers "https://github.com/hadighany25/u-pay-bank/tree/main/U-Pay%20Backend/controllers"
click node_payroll_worker "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/services/payrollProcessor.js"
click node_payroll_schedule "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/cron/payrollCron.js"
click node_system_service "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/services/systemService.js"
click node_admin_routes "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/routes/adminRoutes.js"
click node_admin_controller "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/controllers/adminController.js"
click node_admin_ui "https://github.com/hadighany25/u-pay-bank/tree/main/public/admin/js"
click node_system_store "https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/models/System.js"
click node_frontend "https://github.com/hadighany25/u-pay-bank/tree/main/public/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_server,node_auth_routes,node_auth_controller,node_auth_guard,node_client,node_frontend toneBlue
class node_account_routes,node_account_controller,node_transaction_routes,node_transaction_controller,node_user_store,node_transaction_store toneAmber
class node_merchant_routes,node_merchant_controller,node_merchant_store,node_other_routes,node_other_controllers,node_payroll_worker,node_payroll_schedule toneMint
class node_system_service,node_admin_routes,node_admin_controller,node_admin_ui,node_system_store toneRose
```

## Components

### Entry and access

- [HTTP and sockets](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/server.js): `U-Pay Backend/server.js`
- [Authentication routes](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/routes/authRoutes.js): `U-Pay Backend/routes/authRoutes.js`
- [Identity and profile](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/controllers/authController.js): `U-Pay Backend/controllers/authController.js`
- [Access middleware](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/middleware/authMiddleware.js): `U-Pay Backend/middleware/authMiddleware.js`

### Payments and accounts

- [Account routes](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/routes/accountRoutes.js): `U-Pay Backend/routes/accountRoutes.js`
- [Account management](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/controllers/accountController.js): `U-Pay Backend/controllers/accountController.js`
- [Transaction routes](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/routes/transactionRoutes.js): `U-Pay Backend/routes/transactionRoutes.js`
- [Payment operations](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/controllers/transactionController.js): `U-Pay Backend/controllers/transactionController.js`
- [User accounts](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/models/User.js): `U-Pay Backend/models/User.js`
- [Transaction records](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/models/Transaction.js): `U-Pay Backend/models/Transaction.js`

### Product services

- [Merchant routes](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/routes/merchantRoutes.js): `U-Pay Backend/routes/merchantRoutes.js`
- [Merchant payments](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/controllers/merchantController.js): `U-Pay Backend/controllers/merchantController.js`
- [Merchant profiles](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/models/Merchant.js): `U-Pay Backend/models/Merchant.js`
- [Specialized API routes](https://github.com/hadighany25/u-pay-bank/tree/main/U-Pay%20Backend/routes): `U-Pay Backend/routes`
- [Specialized services](https://github.com/hadighany25/u-pay-bank/tree/main/U-Pay%20Backend/controllers): `U-Pay Backend/controllers`
- [Payroll processing](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/services/payrollProcessor.js): `U-Pay Backend/services/payrollProcessor.js`
- [Payroll scheduler](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/cron/payrollCron.js): `U-Pay Backend/cron/payrollCron.js`

### Administration

- [System settings](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/services/systemService.js): `U-Pay Backend/services/systemService.js`
- [Admin routes](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/routes/adminRoutes.js): `U-Pay Backend/routes/adminRoutes.js`
- [Administration](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/controllers/adminController.js): `U-Pay Backend/controllers/adminController.js`
- [Admin browser UI](https://github.com/hadighany25/u-pay-bank/tree/main/public/admin/js): `public/admin/js`
- [System settings store](https://github.com/hadighany25/u-pay-bank/blob/main/U-Pay%20Backend/models/System.js): `U-Pay Backend/models/System.js`

### Other components

- **API client**
- [Customer browser UI](https://github.com/hadighany25/u-pay-bank/tree/main/public/js): `public/js`

## Connections

- API client → HTTP and sockets: sends requests
- Customer browser UI → HTTP and sockets: calls API
- Admin browser UI → HTTP and sockets: calls API
- HTTP and sockets → Authentication routes: mounts routes (evidence: `U-Pay Backend/server.js`)
- HTTP and sockets → Transaction routes: mounts routes (evidence: `U-Pay Backend/server.js`)
- HTTP and sockets → Account routes: mounts routes (evidence: `U-Pay Backend/server.js`)
- HTTP and sockets → Merchant routes: mounts routes (evidence: `U-Pay Backend/server.js`)
- HTTP and sockets → Admin routes: mounts routes (evidence: `U-Pay Backend/server.js`)
- HTTP and sockets → Specialized API routes: mounts routes (evidence: `U-Pay Backend/server.js`)
- Authentication routes → Identity and profile: dispatches to (evidence: `U-Pay Backend/routes/authRoutes.js`)
- Authentication routes → Access middleware: protects routes (evidence: `U-Pay Backend/routes/authRoutes.js`)
- Account routes → Account management: dispatches to (evidence: `U-Pay Backend/routes/accountRoutes.js`)
- Account routes → Access middleware: protects routes (evidence: `U-Pay Backend/routes/accountRoutes.js`)
- Transaction routes → Payment operations: dispatches to (evidence: `U-Pay Backend/routes/transactionRoutes.js`)
- Transaction routes → Access middleware: protects routes (evidence: `U-Pay Backend/routes/transactionRoutes.js`)
- Merchant routes → Merchant payments: dispatches to (evidence: `U-Pay Backend/routes/merchantRoutes.js`)
- Merchant routes → Access middleware: protects routes (evidence: `U-Pay Backend/routes/merchantRoutes.js`)
- Admin routes → Administration: dispatches to (evidence: `U-Pay Backend/routes/adminRoutes.js`)
- Admin routes → Access middleware: checks roles (evidence: `U-Pay Backend/routes/adminRoutes.js`)
- Identity and profile → User accounts: reads and writes (evidence: `U-Pay Backend/controllers/authController.js`)
- Payment operations → User accounts: updates balances (evidence: `U-Pay Backend/controllers/transactionController.js`)
- Payment operations → Transaction records: records payments (evidence: `U-Pay Backend/controllers/transactionController.js`)
- Payment operations → Merchant profiles: resolves merchants (evidence: `U-Pay Backend/controllers/transactionController.js`)
- Merchant payments → Merchant profiles: manages profiles (evidence: `U-Pay Backend/controllers/merchantController.js`)
- Merchant payments → Transaction records: records charges (evidence: `U-Pay Backend/controllers/merchantController.js`)
- Merchant payments → User accounts: reads account owners (evidence: `U-Pay Backend/controllers/merchantController.js`)
- Access middleware → System settings: checks system status (evidence: `U-Pay Backend/middleware/authMiddleware.js`)
- System settings → System settings store: reads settings (evidence: `U-Pay Backend/services/systemService.js`)
- Administration → System settings: uses settings (evidence: `U-Pay Backend/controllers/adminController.js`)
- Administration → User accounts: manages users (evidence: `U-Pay Backend/controllers/adminController.js`)
- Administration → Transaction records: queries transactions (evidence: `U-Pay Backend/controllers/adminController.js`)
- Admin routes → Merchant payments: dispatches merchant actions (evidence: `U-Pay Backend/routes/adminRoutes.js`)
- Specialized API routes → Specialized services: dispatches to (evidence: `U-Pay Backend/routes/adminRoutes.js`)
- Payroll scheduler → Payroll processing: runs payroll (evidence: `U-Pay Backend/cron/payrollCron.js`)
- HTTP and sockets → Payroll scheduler: loads scheduler (evidence: `U-Pay Backend/server.js`)
