# suvashanbaniya/business_agent architecture

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

## Overview

Business_Agent is a customer-support application with web and email entry points. Customers ask product, order, or ticket questions; the web app classifies messages and routes them to product chat, support answers, or ticket operations, while admins manage tickets and customers can register and sign in. A separate inbox worker classifies incoming email, drafts eligible replies, and sends them; product data can also be synchronized from Excel. The graph preserves documented capabilities, but unsampled routes and integrations are shown only where the excerpts or README support them (the README is empty).

Main entry points: [`Business_Agent/app.py`](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/app.py) (Web app and routes), [`Business_Agent/database/customer.db`](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/database/customer.db) (Customer database), [`Business_Agent/ai/llm.py`](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/ai/llm.py) (Support RAG assistant), [`Business_Agent/auto_reply.py`](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/auto_reply.py) (Email reply worker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_flask["Web app and routes<br/>[app.py]"]
  node_web_ui["Customer and admin pages"]
end

subgraph group_ai["AI support"]
  node_intent["Intent detection<br/>[intent_detector.py]"]
  node_llm["Support RAG assistant<br/>[llm.py]"]
  node_product_chat["Product chat<br/>[customer_chat.py]"]
  node_memory["Conversation history"]
end

subgraph group_service["Support services"]
  node_tickets["Ticket operations<br/>[create_ticket.py]"]
  node_ticket_messages["Ticket messages"]
  node_customer_service["Customer context"]
  node_email_worker["Email reply worker<br/>[auto_reply.py]"]
  node_email_reader["Inbox reader<br/>[emailreader.py]"]
  node_email_sender["Email sender<br/>[emailservice.py]"]
  node_excel_sync["Excel product sync"]
  node_excel_watcher["Excel watcher<br/>[excel_watcher.py]"]
end

subgraph group_data["Business data"]
  node_customer_db[("Customer database<br/>[customer.db]")]
  node_auth_db[("Authentication database<br/>[auth.db]")]
end

node_customer(("Customer"))
node_admin(("Admin"))
node_ollama{{"Ollama model service"}}
node_inbox{{"Support inbox"}}
node_email_provider{{"Email provider"}}
node_workbook["Product workbook"]

node_customer -->|"submits requests"| node_flask
node_admin -->|"manages support"| node_flask
node_flask -->|"renders pages"| node_web_ui
node_flask -->|"classifies message"| node_intent
node_flask -->|"routes product chat"| node_product_chat
node_flask -->|"requests support answer"| node_llm
node_flask -->|"manages tickets"| node_tickets
node_flask -->|"handles ticket messages"| node_ticket_messages
node_flask -->|"reads and writes"| node_customer_db
node_flask -->|"uses authentication store"| node_auth_db
node_llm -->|"loads customer context"| node_customer_service
node_customer_service -->|"reads customer records"| node_customer_db
node_llm -->|"uses conversation history"| node_memory
node_product_chat -->|"uses conversation history"| node_memory
node_product_chat -->|"reads public products"| node_customer_db
node_intent -->|"requests classification"| node_ollama
node_llm -->|"requests generated answer"| node_ollama
node_product_chat -->|"requests product answer"| node_ollama
node_tickets -->|"reads and writes tickets"| node_customer_db
node_ticket_messages -->|"reads and writes messages"| node_customer_db
node_email_worker -->|"reads unread mail"| node_email_reader
node_email_worker -->|"classifies email"| node_intent
node_email_worker -->|"drafts eligible replies"| node_llm
node_email_worker -->|"sends generated reply"| node_email_sender
node_email_reader -->|"fetches unread messages"| node_inbox
node_email_sender -->|"sends via SMTP"| node_email_provider
node_excel_watcher -->|"invokes synchronization"| node_excel_sync
node_excel_sync -->|"reads product rows"| node_workbook
node_excel_sync -->|"upserts products"| node_customer_db

click node_flask "https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/app.py"
click node_web_ui "https://github.com/suvashanbaniya/business_agent/tree/master/Business_Agent/templates"
click node_intent "https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/ai/intent_detector.py"
click node_llm "https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/ai/llm.py"
click node_product_chat "https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/ai/customer_chat.py"
click node_memory "https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/ai/conversation_memory.py"
click node_tickets "https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/services/create_ticket.py"
click node_ticket_messages "https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/services/ticket_message_service.py"
click node_customer_service "https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/services/customer_service.py"
click node_email_worker "https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/auto_reply.py"
click node_email_reader "https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/services/emailreader.py"
click node_email_sender "https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/services/emailservice.py"
click node_excel_sync "https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/services/excel_product_sync.py"
click node_excel_watcher "https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/services/excel_watcher.py"
click node_customer_db "https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/database/customer.db"
click node_auth_db "https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/database/auth.db"

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_flask,node_web_ui toneBlue
class node_intent,node_llm,node_product_chat,node_memory toneAmber
class node_tickets,node_ticket_messages,node_customer_service,node_email_worker,node_email_reader,node_email_sender,node_excel_sync,node_excel_watcher toneMint
class node_customer_db,node_auth_db toneRose
class node_customer,node_admin,node_ollama,node_inbox,node_email_provider,node_workbook toneIndigo
```

## Components

### Web application

- [Web app and routes](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/app.py): `Business_Agent/app.py`
- [Customer and admin pages](https://github.com/suvashanbaniya/business_agent/tree/master/Business_Agent/templates): `Business_Agent/templates`

### AI support

- [Intent detection](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/ai/intent_detector.py): `Business_Agent/ai/intent_detector.py`
- [Support RAG assistant](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/ai/llm.py): `Business_Agent/ai/llm.py`
- [Product chat](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/ai/customer_chat.py): `Business_Agent/ai/customer_chat.py`
- [Conversation history](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/ai/conversation_memory.py): `Business_Agent/ai/conversation_memory.py`

### Support services

- [Ticket operations](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/services/create_ticket.py): `Business_Agent/services/create_ticket.py`
- [Ticket messages](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/services/ticket_message_service.py): `Business_Agent/services/ticket_message_service.py`
- [Customer context](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/services/customer_service.py): `Business_Agent/services/customer_service.py`
- [Email reply worker](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/auto_reply.py): `Business_Agent/auto_reply.py`
- [Inbox reader](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/services/emailreader.py): `Business_Agent/services/emailreader.py`
- [Email sender](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/services/emailservice.py): `Business_Agent/services/emailservice.py`
- [Excel product sync](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/services/excel_product_sync.py): `Business_Agent/services/excel_product_sync.py`
- [Excel watcher](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/services/excel_watcher.py): `Business_Agent/services/excel_watcher.py`

### Business data

- [Customer database](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/database/customer.db): `Business_Agent/database/customer.db`
- [Authentication database](https://github.com/suvashanbaniya/business_agent/blob/master/Business_Agent/database/auth.db): `Business_Agent/database/auth.db`

### Other components

- **Customer**
- **Admin**
- **Ollama model service**
- **Support inbox**
- **Email provider**
- **Product workbook**

## Connections

- Customer → Web app and routes: submits requests (evidence: `Business_Agent/app.py`)
- Admin → Web app and routes: manages support (evidence: `Business_Agent/app.py`)
- Web app and routes → Customer and admin pages: renders pages (evidence: `Business_Agent/app.py`)
- Web app and routes → Intent detection: classifies message (evidence: `Business_Agent/app.py`)
- Web app and routes → Product chat: routes product chat (evidence: `Business_Agent/app.py`)
- Web app and routes → Support RAG assistant: requests support answer (evidence: `Business_Agent/app.py`)
- Web app and routes → Ticket operations: manages tickets (evidence: `Business_Agent/app.py`)
- Web app and routes → Ticket messages: handles ticket messages (evidence: `Business_Agent/app.py`)
- Web app and routes → Customer database: reads and writes (evidence: `Business_Agent/app.py`)
- Web app and routes → Authentication database: uses authentication store (evidence: `Business_Agent/app.py`)
- Support RAG assistant → Customer context: loads customer context (evidence: `Business_Agent/ai/llm.py`)
- Customer context → Customer database: reads customer records (evidence: `Business_Agent/services/customer_service.py`)
- Support RAG assistant → Conversation history: uses conversation history (evidence: `Business_Agent/ai/llm.py`)
- Product chat → Conversation history: uses conversation history (evidence: `Business_Agent/ai/customer_chat.py`)
- Product chat → Customer database: reads public products (evidence: `Business_Agent/ai/customer_chat.py`)
- Intent detection → Ollama model service: requests classification (evidence: `Business_Agent/ai/intent_detector.py`)
- Support RAG assistant → Ollama model service: requests generated answer (evidence: `Business_Agent/ai/llm.py`)
- Product chat → Ollama model service: requests product answer (evidence: `Business_Agent/ai/customer_chat.py`)
- Ticket operations → Customer database: reads and writes tickets (evidence: `Business_Agent/services/create_ticket.py`)
- Ticket messages → Customer database: reads and writes messages (evidence: `Business_Agent/services/ticket_message_service.py`)
- Email reply worker → Inbox reader: reads unread mail (evidence: `Business_Agent/auto_reply.py`)
- Email reply worker → Intent detection: classifies email (evidence: `Business_Agent/auto_reply.py`)
- Email reply worker → Support RAG assistant: drafts eligible replies (evidence: `Business_Agent/auto_reply.py`)
- Email reply worker → Email sender: sends generated reply (evidence: `Business_Agent/auto_reply.py`)
- Inbox reader → Support inbox: fetches unread messages (evidence: `Business_Agent/services/emailreader.py`)
- Email sender → Email provider: sends via SMTP (evidence: `Business_Agent/services/emailservice.py`)
- Excel watcher → Excel product sync: invokes synchronization (evidence: `Business_Agent/services/excel_watcher.py`)
- Excel product sync → Product workbook: reads product rows (evidence: `Business_Agent/services/excel_product_sync.py`)
- Excel product sync → Customer database: upserts products (evidence: `Business_Agent/services/excel_product_sync.py`)
