# abhijitmohanty782/accessone-bank- architecture

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

- Interactive diagram: https://gitdiagram.com/abhijitmohanty782/accessone-bank-
- Repository: https://github.com/abhijitmohanty782/accessone-bank-

## Overview

AccessOne combines a React banking portal, a Flask banking API, and a FastAPI AI assistant. Users enter through the browser, authenticate, and use banking workflows such as account management and transfers; the copilot separately answers banking questions or maps navigation requests to destinations. The README also describes multilingual voice interaction, contextual conversations, and navigation. Source excerpts show route registration, chat-chain calls, and authentication requests; links between the frontend copilot and assistant API are documented at product level but not shown in sampled frontend calls.

Main entry points: [`frontend/src/App.jsx`](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/frontend/src/App.jsx) (Banking App), [`backend/app.py`](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/backend/app.py) (Banking API), [`Assistants/app/rag_engine/chatbot/retriever.py`](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/rag_engine/chatbot/retriever.py) (Product Retrieval), [`Assistants/app/main.py`](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/main.py) (Assistant API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Banking Web App"]
  node_app["Banking App<br/>[App.jsx]"]
  node_auth["Session and Auth<br/>[AuthContext.jsx]"]
  node_navigation["App Navigation<br/>[Header.jsx]"]
  node_copilot_ui["Copilot Controls"]
  node_account_ui["Accounts and Dashboard"]
  node_transactions_ui["Transaction History"]
  node_transfer_ui["Money Transfers<br/>[TransferSystem.jsx]"]
  node_banking_pages["Banking Products"]
end

subgraph group_bank["Banking Services"]
  node_flask_api["Banking API<br/>[app.py]"]
  node_bank_model["Banking Operations<br/>[models.py]"]
  node_bank_store[("MongoDB")]
end

subgraph group_assistant["AI Copilot"]
  node_fastapi["Assistant API<br/>[main.py]"]
  node_chat_routes["Chat Endpoint<br/>[chatbot_routes.py]"]
  node_nav_routes["Navigation Endpoint<br/>[helper_routes.py]"]
  node_chat_chain["Answer Chain<br/>[chain.py]"]
  node_nav_chain["Intent Chain<br/>[chain.py]"]
  node_nav_links["Route Lookup<br/>[config.py]"]
end

subgraph group_knowledge["AI Knowledge"]
  node_chat_retriever["Product Retrieval<br/>[retriever.py]"]
  node_chat_loader["Product Documents<br/>[loader.py]"]
  node_nav_loader["Navigation Documents<br/>[loader.py]"]
  node_chroma[("Chroma Vector Store<br/>[retriever.py]")]
end

node_customer(("Bank Customer"))
node_gemini{{"Gemini API"}}

node_customer -->|"uses"| node_app
node_app -->|"provides auth"| node_auth
node_app -->|"renders"| node_navigation
node_app -->|"routes to"| node_account_ui
node_app -->|"routes to"| node_transactions_ui
node_app -->|"routes to"| node_transfer_ui
node_app -->|"routes to"| node_banking_pages
node_app -->|"renders"| node_copilot_ui
node_auth -->|"requests auth"| node_flask_api
node_account_ui -.->|"loads account data"| node_flask_api
node_transactions_ui -.->|"loads transactions"| node_flask_api
node_transfer_ui -.->|"submits transfers"| node_flask_api
node_flask_api -->|"calls operations"| node_bank_model
node_bank_model -->|"reads and writes"| node_bank_store
node_fastapi -->|"registers routes"| node_chat_routes
node_fastapi -->|"registers routes"| node_nav_routes
node_chat_routes -->|"calls answer chain"| node_chat_chain
node_nav_routes -->|"calls intent chain"| node_nav_chain
node_nav_routes -.->|"looks up destinations"| node_nav_links
node_chat_chain -->|"retrieves context"| node_chat_retriever
node_chat_retriever -->|"builds index from"| node_chat_loader
node_chat_retriever -->|"searches"| node_chroma
node_chat_chain -.->|"generates answers"| node_gemini
node_chat_retriever -.->|"embeds and queries"| node_gemini
node_nav_chain -.->|"uses navigation knowledge"| node_nav_loader
node_copilot_ui -.->|"sends copilot requests"| node_fastapi
node_fastapi -.->|"returns guidance"| node_customer

click node_app "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/frontend/src/App.jsx"
click node_auth "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/frontend/src/contexts/AuthContext.jsx"
click node_navigation "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/frontend/src/components/Header.jsx"
click node_copilot_ui "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/frontend/src/components/FloatingButtons.jsx"
click node_account_ui "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/frontend/src/components/AccountOverview.jsx"
click node_transactions_ui "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/frontend/src/components/AdvancedTransactionHistory.jsx"
click node_transfer_ui "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/frontend/src/components/TransferSystem.jsx"
click node_banking_pages "https://github.com/abhijitmohanty782/accessone-bank-/tree/main/frontend/src/pages"
click node_flask_api "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/backend/app.py"
click node_bank_model "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/backend/models.py"
click node_fastapi "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/main.py"
click node_chat_routes "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/api/chatbot_routes.py"
click node_nav_routes "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/api/helper_routes.py"
click node_chat_chain "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/rag_engine/chatbot/chain.py"
click node_nav_chain "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/rag_engine/helper/chain.py"
click node_nav_links "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/core/config.py"
click node_chat_retriever "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/rag_engine/chatbot/retriever.py"
click node_chat_loader "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/rag_engine/chatbot/loader.py"
click node_nav_loader "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/rag_engine/helper/loader.py"
click node_chroma "https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/rag_engine/chatbot/retriever.py"

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_navigation,node_copilot_ui,node_account_ui,node_transactions_ui,node_transfer_ui,node_banking_pages toneBlue
class node_flask_api,node_bank_model,node_bank_store toneAmber
class node_fastapi,node_chat_routes,node_nav_routes,node_chat_chain,node_nav_chain,node_nav_links,node_gemini toneMint
class node_chat_retriever,node_chat_loader,node_nav_loader,node_chroma toneRose
class node_customer toneIndigo
```

## Components

### Banking Web App

- [Banking App](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Session and Auth](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/frontend/src/contexts/AuthContext.jsx): `frontend/src/contexts/AuthContext.jsx`
- [App Navigation](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/frontend/src/components/Header.jsx): `frontend/src/components/Header.jsx`
- [Copilot Controls](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/frontend/src/components/FloatingButtons.jsx): `frontend/src/components/FloatingButtons.jsx`
- [Accounts and Dashboard](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/frontend/src/components/AccountOverview.jsx): `frontend/src/components/AccountOverview.jsx`
- [Transaction History](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/frontend/src/components/AdvancedTransactionHistory.jsx): `frontend/src/components/AdvancedTransactionHistory.jsx`
- [Money Transfers](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/frontend/src/components/TransferSystem.jsx): `frontend/src/components/TransferSystem.jsx`
- [Banking Products](https://github.com/abhijitmohanty782/accessone-bank-/tree/main/frontend/src/pages): `frontend/src/pages`

### Banking Services

- [Banking API](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/backend/app.py): `backend/app.py`
- [Banking Operations](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/backend/models.py): `backend/models.py`
- **MongoDB**

### AI Copilot

- [Assistant API](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/main.py): `Assistants/app/main.py`
- [Chat Endpoint](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/api/chatbot_routes.py): `Assistants/app/api/chatbot_routes.py`
- [Navigation Endpoint](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/api/helper_routes.py): `Assistants/app/api/helper_routes.py`
- [Answer Chain](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/rag_engine/chatbot/chain.py): `Assistants/app/rag_engine/chatbot/chain.py`
- [Intent Chain](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/rag_engine/helper/chain.py): `Assistants/app/rag_engine/helper/chain.py`
- [Route Lookup](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/core/config.py): `Assistants/app/core/config.py`

### AI Knowledge

- [Product Retrieval](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/rag_engine/chatbot/retriever.py): `Assistants/app/rag_engine/chatbot/retriever.py`
- [Product Documents](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/rag_engine/chatbot/loader.py): `Assistants/app/rag_engine/chatbot/loader.py`
- [Navigation Documents](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/rag_engine/helper/loader.py): `Assistants/app/rag_engine/helper/loader.py`
- [Chroma Vector Store](https://github.com/abhijitmohanty782/accessone-bank-/blob/main/Assistants/app/rag_engine/chatbot/retriever.py): `Assistants/app/rag_engine/chatbot/retriever.py`

### Other components

- **Bank Customer**
- **Gemini API**

## Connections

- Bank Customer → Banking App: uses
- Banking App → Session and Auth: provides auth (evidence: `frontend/src/App.jsx`)
- Banking App → App Navigation: renders (evidence: `frontend/src/App.jsx`)
- Banking App → Accounts and Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Banking App → Transaction History: routes to (evidence: `frontend/src/App.jsx`)
- Banking App → Money Transfers: routes to (evidence: `frontend/src/App.jsx`)
- Banking App → Banking Products: routes to (evidence: `frontend/src/App.jsx`)
- Banking App → Copilot Controls: renders (evidence: `frontend/src/App.jsx`)
- Session and Auth → Banking API: requests auth (evidence: `frontend/src/contexts/AuthContext.jsx`)
- Accounts and Dashboard → Banking API: loads account data
- Transaction History → Banking API: loads transactions
- Money Transfers → Banking API: submits transfers
- Banking API → Banking Operations: calls operations (evidence: `backend/app.py`)
- Banking Operations → MongoDB: reads and writes (evidence: `backend/models.py`)
- Assistant API → Chat Endpoint: registers routes (evidence: `Assistants/app/main.py`)
- Assistant API → Navigation Endpoint: registers routes (evidence: `Assistants/app/main.py`)
- Chat Endpoint → Answer Chain: calls answer chain (evidence: `Assistants/app/api/chatbot_routes.py`)
- Navigation Endpoint → Intent Chain: calls intent chain (evidence: `Assistants/app/api/helper_routes.py`)
- Navigation Endpoint → Route Lookup: looks up destinations
- Answer Chain → Product Retrieval: retrieves context (evidence: `Assistants/app/rag_engine/chatbot/chain.py`)
- Product Retrieval → Product Documents: builds index from (evidence: `Assistants/app/rag_engine/chatbot/retriever.py`)
- Product Retrieval → Chroma Vector Store: searches (evidence: `Assistants/app/rag_engine/chatbot/retriever.py`)
- Answer Chain → Gemini API: generates answers
- Product Retrieval → Gemini API: embeds and queries
- Intent Chain → Navigation Documents: uses navigation knowledge (evidence: `Assistants/app/rag_engine/helper/chain.py`)
- Copilot Controls → Assistant API: sends copilot requests
- Assistant API → Bank Customer: returns guidance
