# cseengineerasif/upay_ai-hackathon architecture

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

- Interactive diagram: https://gitdiagram.com/cseengineerasif/upay_ai-hackathon
- Repository: https://github.com/cseengineerasif/upay_ai-hackathon

## Overview

Recursion Pay is a Bangladesh-focused MFS super-app. Users register or sign in, navigate core wallet and payment services, and receive transaction risk checks and safety guidance; the app also offers distinct voice, family, community savings, escrow, and finance tools. The README documents broader search/maps, audio, and utility capabilities. Source excerpts and the index establish the main app/store, risk flow, and several integrations; unsampled feature links are left unasserted.

Main entry points: [`src/App.tsx`](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/App.tsx) (App and navigation), [`src/store/useAppStore.ts`](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/store/useAppStore.ts) (App state), [`server.ts`](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/server.ts) (Risk API), [`src/components/childwallet/ChildWalletScreen.tsx`](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/childwallet/ChildWalletScreen.tsx) (Child wallet)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_app["App and navigation<br/>[App.tsx]"]
  node_auth["Registration"]
  node_home["Home and services<br/>[HomeScreen.tsx]"]
  node_store["App state<br/>[useAppStore.ts]"]
end

subgraph group_payments["Payments and safety"]
  node_payment["Payment flow"]
  node_risk["Risk scoring<br/>[riskEngine.ts]"]
  node_explain["Risk explanation<br/>[llmExplain.ts]"]
  node_scam["Scam checking<br/>[scamChecker.ts]"]
  node_voice["Dialect voice pay"]
  node_assistant["Audio and finance assistant"]
  node_search["Grounded search"]
end

subgraph group_finance["Financial tools"]
  node_account["Account records<br/>[accountManager.ts]"]
  node_child["Child wallet"]
  node_childmgr["Child wallet rules"]
  node_somiti["Savings groups"]
  node_somitimgr["Somiti ledger<br/>[somitiManager.ts]"]
  node_trust["TrustPay escrow<br/>[TrustPayScreen.tsx]"]
  node_trustmgr["TrustPay orders<br/>[trustPayManager.ts]"]
  node_mandate["Payment mandates"]
  node_payslip["Payslip audit"]
  node_liquidity["Liquidity forecasts"]
  node_bundle["Bundle optimizer"]
end

subgraph group_services["AI and backend"]
  node_riskapi["Risk API<br/>[server.ts]"]
  node_firebase[("Firebase auth and data<br/>[firebase.ts]")]
  node_ai["Google GenAI"]
end

node_user(("Customer"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_auth
node_app -->|"renders"| node_home
node_app -->|"reads state"| node_store
node_home -->|"reads state"| node_store
node_auth -->|"registers via"| node_store
node_store -->|"loads records"| node_account
node_store -->|"authenticates via"| node_firebase
node_app -->|"opens flow"| node_payment
node_payment -.->|"requests assessment"| node_riskapi
node_riskapi -->|"scores transaction"| node_risk
node_riskapi -->|"requests explanation"| node_explain
node_explain -->|"generates text"| node_ai
node_riskapi -->|"uses checker"| node_scam
node_app -->|"renders feature"| node_voice
node_app -.->|"opens feature"| node_assistant
node_app -.->|"renders feature"| node_search
node_search -->|"reads state"| node_store
node_app -->|"renders feature"| node_child
node_child -->|"uses state"| node_store
node_child -->|"delegates to"| node_childmgr
node_app -->|"opens feature"| node_somiti
node_somiti -->|"uses state"| node_store
node_somiti -->|"delegates to"| node_somitimgr
node_app -.->|"opens feature"| node_trust
node_trust -->|"uses state"| node_store
node_trust -->|"delegates to"| node_trustmgr
node_mandate -.->|"parses instruction"| node_ai
node_app -.->|"offers feature"| node_payslip
node_app -.->|"offers feature"| node_liquidity
node_app -.->|"offers feature"| node_bundle
node_riskapi -.->|"uses models"| node_ai

click node_app "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/App.tsx"
click node_auth "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/auth/RegistrationFlow.tsx"
click node_home "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/home/HomeScreen.tsx"
click node_store "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/store/useAppStore.ts"
click node_payment "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/mfs/PaymentFlowModal.tsx"
click node_risk "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/functions/riskEngine.ts"
click node_explain "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/functions/llmExplain.ts"
click node_scam "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/functions/scamChecker.ts"
click node_riskapi "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/server.ts"
click node_account "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/utils/accountManager.ts"
click node_firebase "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/services/firebase.ts"
click node_voice "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/voice/DialectVoiceScreen.tsx"
click node_assistant "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/safety/VoiceConversationModal.tsx"
click node_search "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/safety/SearchGroundingModal.tsx"
click node_child "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/childwallet/ChildWalletScreen.tsx"
click node_childmgr "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/utils/childWalletManager.ts"
click node_somiti "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/somiti/SomitiDetailModal.tsx"
click node_somitimgr "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/utils/somitiManager.ts"
click node_trust "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/trustpay/TrustPayScreen.tsx"
click node_trustmgr "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/utils/trustPayManager.ts"
click node_mandate "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/utils/mandateWalletEngine.ts"
click node_payslip "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/payslip/PayslipWageScreen.tsx"
click node_liquidity "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/liquidity/LiquidityNetworkScreen.tsx"
click node_bundle "https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/bundle/BundleOptimizerScreen.tsx"

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_app,node_auth,node_home,node_store toneBlue
class node_payment,node_risk,node_explain,node_scam,node_voice,node_assistant,node_search toneAmber
class node_account,node_child,node_childmgr,node_somiti,node_somitimgr,node_trust,node_trustmgr,node_mandate,node_payslip,node_liquidity,node_bundle toneMint
class node_riskapi,node_firebase,node_ai toneRose
class node_user toneIndigo
```

## Components

### App experience

- [App and navigation](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/App.tsx): `src/App.tsx`
- [Registration](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/auth/RegistrationFlow.tsx): `src/components/auth/RegistrationFlow.tsx`
- [Home and services](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/home/HomeScreen.tsx): `src/components/home/HomeScreen.tsx`
- [App state](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/store/useAppStore.ts): `src/store/useAppStore.ts`

### Payments and safety

- [Payment flow](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/mfs/PaymentFlowModal.tsx): `src/components/mfs/PaymentFlowModal.tsx`
- [Risk scoring](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/functions/riskEngine.ts): `functions/riskEngine.ts`
- [Risk explanation](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/functions/llmExplain.ts): `functions/llmExplain.ts`
- [Scam checking](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/functions/scamChecker.ts): `functions/scamChecker.ts`
- [Dialect voice pay](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/voice/DialectVoiceScreen.tsx): `src/components/voice/DialectVoiceScreen.tsx`
- [Audio and finance assistant](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/safety/VoiceConversationModal.tsx): `src/components/safety/VoiceConversationModal.tsx`
- [Grounded search](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/safety/SearchGroundingModal.tsx): `src/components/safety/SearchGroundingModal.tsx`

### Financial tools

- [Account records](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/utils/accountManager.ts): `src/utils/accountManager.ts`
- [Child wallet](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/childwallet/ChildWalletScreen.tsx): `src/components/childwallet/ChildWalletScreen.tsx`
- [Child wallet rules](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/utils/childWalletManager.ts): `src/utils/childWalletManager.ts`
- [Savings groups](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/somiti/SomitiDetailModal.tsx): `src/components/somiti/SomitiDetailModal.tsx`
- [Somiti ledger](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/utils/somitiManager.ts): `src/utils/somitiManager.ts`
- [TrustPay escrow](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/trustpay/TrustPayScreen.tsx): `src/components/trustpay/TrustPayScreen.tsx`
- [TrustPay orders](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/utils/trustPayManager.ts): `src/utils/trustPayManager.ts`
- [Payment mandates](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/utils/mandateWalletEngine.ts): `src/utils/mandateWalletEngine.ts`
- [Payslip audit](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/payslip/PayslipWageScreen.tsx): `src/components/payslip/PayslipWageScreen.tsx`
- [Liquidity forecasts](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/liquidity/LiquidityNetworkScreen.tsx): `src/components/liquidity/LiquidityNetworkScreen.tsx`
- [Bundle optimizer](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/components/bundle/BundleOptimizerScreen.tsx): `src/components/bundle/BundleOptimizerScreen.tsx`

### AI and backend

- [Risk API](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/server.ts): `server.ts`
- [Firebase auth and data](https://github.com/cseengineerasif/upay_ai-hackathon/blob/main/src/services/firebase.ts): `src/services/firebase.ts`
- **Google GenAI**

### Other components

- **Customer**

## Connections

- Customer → App and navigation: uses (evidence: `src/App.tsx`)
- App and navigation → Registration: renders (evidence: `src/App.tsx`)
- App and navigation → Home and services: renders (evidence: `src/App.tsx`)
- App and navigation → App state: reads state (evidence: `src/App.tsx`)
- Home and services → App state: reads state (evidence: `src/components/home/HomeScreen.tsx`)
- Registration → App state: registers via (evidence: `src/components/auth/RegistrationFlow.tsx`)
- App state → Account records: loads records (evidence: `src/store/useAppStore.ts`)
- App state → Firebase auth and data: authenticates via (evidence: `src/store/useAppStore.ts`)
- App and navigation → Payment flow: opens flow (evidence: `src/App.tsx`)
- Payment flow → Risk API: requests assessment
- Risk API → Risk scoring: scores transaction (evidence: `server.ts`)
- Risk API → Risk explanation: requests explanation (evidence: `server.ts`)
- Risk explanation → Google GenAI: generates text (evidence: `functions/llmExplain.ts`)
- Risk API → Scam checking: uses checker (evidence: `server.ts`)
- App and navigation → Dialect voice pay: renders feature (evidence: `src/App.tsx`)
- App and navigation → Audio and finance assistant: opens feature (evidence: `src/App.tsx`)
- App and navigation → Grounded search: renders feature (evidence: `src/App.tsx`)
- Grounded search → App state: reads state (evidence: `src/components/safety/SearchGroundingModal.tsx`)
- App and navigation → Child wallet: renders feature (evidence: `src/App.tsx`)
- Child wallet → App state: uses state (evidence: `src/components/childwallet/ChildWalletScreen.tsx`)
- Child wallet → Child wallet rules: delegates to (evidence: `src/components/childwallet/ChildWalletScreen.tsx`)
- App and navigation → Savings groups: opens feature (evidence: `src/App.tsx`)
- Savings groups → App state: uses state (evidence: `src/components/somiti/SomitiDetailModal.tsx`)
- Savings groups → Somiti ledger: delegates to (evidence: `src/components/somiti/SomitiDetailModal.tsx`)
- App and navigation → TrustPay escrow: opens feature (evidence: `src/App.tsx`)
- TrustPay escrow → App state: uses state (evidence: `src/components/trustpay/TrustPayScreen.tsx`)
- TrustPay escrow → TrustPay orders: delegates to (evidence: `src/components/trustpay/TrustPayScreen.tsx`)
- Payment mandates → Google GenAI: parses instruction
- App and navigation → Payslip audit: offers feature
- App and navigation → Liquidity forecasts: offers feature
- App and navigation → Bundle optimizer: offers feature
- Risk API → Google GenAI: uses models
