# ilavarasanappu/elasu_chat architecture

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

## Overview

GhostReply accepts automated or platform messages, selects personal or professional handling, checks for escalation, builds a persona- or knowledge-grounded prompt, and generates a reply through an LLM provider. Its runtime also manages connected messaging accounts, Signal integration, voice-related API operations, and persistent settings and conversation data. The sampled sources establish the core routing and service calls; other advertised capabilities are represented only where the README documents them.

Main entry points: [`src/routes/api.js`](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/routes/api.js) (REST and webhook routes), [`src/services/decisionEngine.js`](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/decisionEngine.js) (Decision engine), [`src/db/database.js`](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/db/database.js) (SQLite data store), [`src/services/telegramService.js`](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/telegramService.js) (Telegram integration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API and runtime"]
  node_server["HTTP and WebSocket server<br/>[server.js]"]
  node_api["REST and webhook routes<br/>[api.js]"]
  node_dashboard["Dashboard<br/>[app.js]"]
end

subgraph group_reply["Response pipeline"]
  node_engine["Decision engine<br/>[decisionEngine.js]"]
  node_rag["Knowledge and escalation<br/>[ragService.js]"]
  node_persona["Persona profiler"]
  node_llm["LLM provider dispatcher<br/>[llmService.js]"]
  node_voice["Voice service<br/>[voiceService.js]"]
end

subgraph group_channels["Messaging channels"]
  node_whatsapp["WhatsApp integration<br/>[whatsappService.js]"]
  node_telegram["Telegram integration<br/>[telegramService.js]"]
  node_signal["Signal integration<br/>[signalService.js]"]
end

subgraph group_accounts["Accounts and safety"]
  node_account["Account management<br/>[accountService.js]"]
  node_credentials["Credential management"]
  node_signalutils["Signal utilities<br/>[signalUtils.js]"]
end

subgraph group_state["Persistence"]
  node_db[("SQLite data store<br/>[database.js]")]
  node_escalations["Escalation records<br/>[database.js]"]
end

node_automation(("Automation caller"))
node_provider{{"External AI providers"}}
node_messaging{{"Messaging platforms"}}

node_automation -->|"triggers webhook"| node_api
node_server -->|"mounts routes"| node_api
node_server -->|"initializes"| node_db
node_server -->|"registers clients"| node_engine
node_server -->|"starts accounts"| node_account
node_api -->|"dispatches messages"| node_engine
node_api -->|"queries knowledge"| node_rag
node_api -->|"manages profiles"| node_persona
node_api -->|"tests providers"| node_llm
node_api -->|"manages accounts"| node_account
node_api -->|"manages sessions"| node_whatsapp
node_api -->|"manages bots"| node_telegram
node_api -->|"manages connection"| node_signal
node_api -->|"routes voice actions"| node_voice
node_engine -->|"checks and retrieves"| node_rag
node_engine -->|"builds personal context"| node_persona
node_engine -->|"generates reply"| node_llm
node_engine -->|"reads and writes"| node_db
node_engine -.->|"records escalation"| node_escalations
node_llm -->|"calls model APIs"| node_provider
node_whatsapp -->|"submits inbound messages"| node_engine
node_telegram -.->|"submits inbound messages"| node_engine
node_signal -->|"submits inbound messages"| node_engine
node_engine -->|"sends replies"| node_telegram
node_whatsapp -->|"receives and sends"| node_messaging
node_telegram -->|"receives and sends"| node_messaging
node_signal -.->|"connects Signal"| node_messaging
node_account -->|"uses credentials"| node_credentials
node_account -->|"starts bot accounts"| node_telegram
node_account -->|"reads and writes accounts"| node_db
node_whatsapp -->|"loads session directory"| node_credentials
node_telegram -->|"loads credentials"| node_credentials
node_signal -->|"stores connection settings"| node_db
node_signal -.->|"uses utilities"| node_signalutils
node_rag -->|"reads knowledge data"| node_db
node_persona -->|"stores profiles"| node_db
node_llm -->|"reads settings"| node_db
node_dashboard -->|"loads dashboard"| node_server

click node_server "https://github.com/ilavarasanappu/elasu_chat/blob/main/src/server.js"
click node_api "https://github.com/ilavarasanappu/elasu_chat/blob/main/src/routes/api.js"
click node_dashboard "https://github.com/ilavarasanappu/elasu_chat/blob/main/public/app.js"
click node_engine "https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/decisionEngine.js"
click node_rag "https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/ragService.js"
click node_persona "https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/personalityService.js"
click node_llm "https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/llmService.js"
click node_voice "https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/voiceService.js"
click node_whatsapp "https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/whatsappService.js"
click node_telegram "https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/telegramService.js"
click node_signal "https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/signalService.js"
click node_account "https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/accountService.js"
click node_credentials "https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/credentialService.js"
click node_signalutils "https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/signalUtils.js"
click node_db "https://github.com/ilavarasanappu/elasu_chat/blob/main/src/db/database.js"
click node_escalations "https://github.com/ilavarasanappu/elasu_chat/blob/main/src/db/database.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_api,node_dashboard toneBlue
class node_engine,node_rag,node_persona,node_llm,node_voice toneAmber
class node_whatsapp,node_telegram,node_signal toneMint
class node_account,node_credentials,node_signalutils toneRose
class node_db,node_escalations,node_automation,node_provider,node_messaging toneIndigo
```

## Components

### API and runtime

- [HTTP and WebSocket server](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/server.js): `src/server.js`
- [REST and webhook routes](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/routes/api.js): `src/routes/api.js`
- [Dashboard](https://github.com/ilavarasanappu/elasu_chat/blob/main/public/app.js): `public/app.js`

### Response pipeline

- [Decision engine](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/decisionEngine.js): `src/services/decisionEngine.js`
- [Knowledge and escalation](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/ragService.js): `src/services/ragService.js`
- [Persona profiler](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/personalityService.js): `src/services/personalityService.js`
- [LLM provider dispatcher](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/llmService.js): `src/services/llmService.js`
- [Voice service](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/voiceService.js): `src/services/voiceService.js`

### Messaging channels

- [WhatsApp integration](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/whatsappService.js): `src/services/whatsappService.js`
- [Telegram integration](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/telegramService.js): `src/services/telegramService.js`
- [Signal integration](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/signalService.js): `src/services/signalService.js`

### Accounts and safety

- [Account management](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/accountService.js): `src/services/accountService.js`
- [Credential management](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/credentialService.js): `src/services/credentialService.js`
- [Signal utilities](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/services/signalUtils.js): `src/services/signalUtils.js`

### Persistence

- [SQLite data store](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/db/database.js): `src/db/database.js`
- [Escalation records](https://github.com/ilavarasanappu/elasu_chat/blob/main/src/db/database.js): `src/db/database.js`

### Other components

- **Automation caller**
- **External AI providers**
- **Messaging platforms**

## Connections

- Automation caller → REST and webhook routes: triggers webhook (evidence: `README.md`)
- HTTP and WebSocket server → REST and webhook routes: mounts routes (evidence: `src/server.js`)
- HTTP and WebSocket server → SQLite data store: initializes (evidence: `src/server.js`)
- HTTP and WebSocket server → Decision engine: registers clients (evidence: `src/server.js`)
- HTTP and WebSocket server → Account management: starts accounts (evidence: `src/server.js`)
- REST and webhook routes → Decision engine: dispatches messages (evidence: `src/routes/api.js`)
- REST and webhook routes → Knowledge and escalation: queries knowledge (evidence: `src/routes/api.js`)
- REST and webhook routes → Persona profiler: manages profiles (evidence: `src/routes/api.js`)
- REST and webhook routes → LLM provider dispatcher: tests providers (evidence: `src/routes/api.js`)
- REST and webhook routes → Account management: manages accounts (evidence: `src/routes/api.js`)
- REST and webhook routes → WhatsApp integration: manages sessions (evidence: `src/routes/api.js`)
- REST and webhook routes → Telegram integration: manages bots (evidence: `src/routes/api.js`)
- REST and webhook routes → Signal integration: manages connection (evidence: `src/routes/api.js`)
- REST and webhook routes → Voice service: routes voice actions (evidence: `src/routes/api.js`)
- Decision engine → Knowledge and escalation: checks and retrieves (evidence: `src/services/decisionEngine.js`)
- Decision engine → Persona profiler: builds personal context (evidence: `src/services/decisionEngine.js`)
- Decision engine → LLM provider dispatcher: generates reply (evidence: `src/services/decisionEngine.js`)
- Decision engine → SQLite data store: reads and writes (evidence: `src/services/decisionEngine.js`)
- Decision engine → Escalation records: records escalation (evidence: `src/services/decisionEngine.js`)
- LLM provider dispatcher → External AI providers: calls model APIs (evidence: `README.md`)
- WhatsApp integration → Decision engine: submits inbound messages (evidence: `src/services/whatsappService.js`)
- Telegram integration → Decision engine: submits inbound messages (evidence: `src/services/decisionEngine.js`)
- Signal integration → Decision engine: submits inbound messages (evidence: `src/services/signalService.js`)
- Decision engine → Telegram integration: sends replies (evidence: `src/services/decisionEngine.js`)
- WhatsApp integration → Messaging platforms: receives and sends (evidence: `README.md`)
- Telegram integration → Messaging platforms: receives and sends (evidence: `README.md`)
- Signal integration → Messaging platforms: connects Signal
- Account management → Credential management: uses credentials (evidence: `src/services/accountService.js`)
- Account management → Telegram integration: starts bot accounts (evidence: `src/services/accountService.js`)
- Account management → SQLite data store: reads and writes accounts (evidence: `src/services/accountService.js`)
- WhatsApp integration → Credential management: loads session directory (evidence: `src/services/whatsappService.js`)
- Telegram integration → Credential management: loads credentials (evidence: `src/services/telegramService.js`)
- Signal integration → SQLite data store: stores connection settings (evidence: `src/services/signalService.js`)
- Signal integration → Signal utilities: uses utilities (evidence: `src/services/signalService.js`)
- Knowledge and escalation → SQLite data store: reads knowledge data (evidence: `src/services/ragService.js`)
- Persona profiler → SQLite data store: stores profiles (evidence: `src/services/personalityService.js`)
- LLM provider dispatcher → SQLite data store: reads settings (evidence: `src/services/llmService.js`)
- Dashboard → HTTP and WebSocket server: loads dashboard (evidence: `README.md`)
