# radhikakawadkar/vocx-ai architecture

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

- Interactive diagram: https://gitdiagram.com/radhikakawadkar/vocx-ai
- Repository: https://github.com/radhikakawadkar/vocx-ai

## Overview

VOCX AI is a multilingual voice-of-customer intelligence platform. Analysts authenticate, submit feedback manually or in CSV/JSON batches, and receive analyzed records for exploration, dashboards, language and translation views, and automated risk escalation. The graph separates the UI/API boundary, ingestion and NLP processing, persistence, and insight/automation capabilities. Sampled source confirms key ingestion, NLP, authentication, routing, and frontend interactions; several other feature links are documented in the README but their implementation was not sampled.

Main entry points: [`backend/app/services/nlp_engine.py`](https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/nlp_engine.py) (Multilingual NLP), [`backend/app/services/ingestion_service.py`](https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/ingestion_service.py) (Ingestion Service), [`backend/app/api/v1/feedback.py`](https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/api/v1/feedback.py) (Feedback API), [`frontend/src/App.tsx`](https://github.com/radhikakawadkar/vocx-ai/blob/main/frontend/src/App.tsx) (Web Application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Analyst Experience"]
  node_webapp["Web Application<br/>[App.tsx]"]
  node_authstate["Auth State<br/>[AuthContext.tsx]"]
  node_ingestionui["Ingestion Manager"]
  node_feedbackclient["Feedback Client<br/>[feedback.ts]"]
end

subgraph group_api["API and Access"]
  node_api["REST API<br/>[router.py]"]
  node_authapi["Authentication API<br/>[auth.py]"]
  node_feedbackapi["Feedback API<br/>[feedback.py]"]
  node_authservice["Auth Service<br/>[auth_service.py]"]
end

subgraph group_processing["Feedback Processing"]
  node_feedbackservice["Feedback Service"]
  node_ingestion["Ingestion Service"]
  node_nlp["Multilingual NLP<br/>[nlp_engine.py]"]
  node_language["Language Analysis"]
  node_translation["Translation Service"]
  node_sentiment["Sentiment Analysis"]
  node_category["Category Analysis"]
end

subgraph group_insights["Insights and Actions"]
  node_analytics["Analytics"]
  node_automation["Automation Rules"]
  node_externalactions["Alert Integrations"]
end

subgraph group_persistence["Persistence"]
  node_database[("Feedback Database<br/>[feedback.py]")]
  node_userstore[("User Records<br/>[user.py]")]
end

node_analyst(("Analyst"))

node_analyst -->|"uses"| node_webapp
node_webapp -->|"provides auth"| node_authstate
node_webapp -->|"routes to"| node_ingestionui
node_ingestionui -->|"requests stats"| node_feedbackclient
node_feedbackclient -->|"calls endpoints"| node_feedbackapi
node_api -->|"routes to"| node_authapi
node_api -->|"routes to"| node_feedbackapi
node_authapi -->|"invokes"| node_authservice
node_authservice -->|"queries and saves"| node_userstore
node_feedbackapi -->|"imports feedback"| node_ingestion
node_feedbackapi -->|"uses"| node_feedbackservice
node_ingestion -->|"analyzes text"| node_nlp
node_ingestion -->|"stores records"| node_database
node_ingestion -->|"evaluates rules"| node_automation
node_feedbackservice -.->|"reads feedback"| node_database
node_nlp -.->|"detects language"| node_language
node_nlp -.->|"translates text"| node_translation
node_nlp -.->|"scores sentiment"| node_sentiment
node_nlp -.->|"classifies aspects"| node_category
node_analytics -.->|"aggregates records"| node_database
node_automation -.->|"triggers alerts"| node_externalactions
node_analyst -.->|"views insights"| node_analytics
node_analyst -.->|"configures rules"| node_automation
node_analyst -.->|"tests feedback"| node_nlp

click node_webapp "https://github.com/radhikakawadkar/vocx-ai/blob/main/frontend/src/App.tsx"
click node_authstate "https://github.com/radhikakawadkar/vocx-ai/blob/main/frontend/src/context/AuthContext.tsx"
click node_ingestionui "https://github.com/radhikakawadkar/vocx-ai/blob/main/frontend/src/pages/IngestionManagerPage.tsx"
click node_feedbackclient "https://github.com/radhikakawadkar/vocx-ai/blob/main/frontend/src/services/feedback.ts"
click node_api "https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/api/v1/router.py"
click node_authapi "https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/api/v1/auth.py"
click node_feedbackapi "https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/api/v1/feedback.py"
click node_feedbackservice "https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/feedback_service.py"
click node_ingestion "https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/ingestion_service.py"
click node_nlp "https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/nlp_engine.py"
click node_language "https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/language_service.py"
click node_translation "https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/translation_service.py"
click node_sentiment "https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/sentiment_service.py"
click node_category "https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/category_service.py"
click node_analytics "https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/analytics_service.py"
click node_automation "https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/automation_service.py"
click node_database "https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/models/feedback.py"
click node_authservice "https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/auth_service.py"
click node_userstore "https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/models/user.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_webapp,node_authstate,node_ingestionui,node_feedbackclient toneBlue
class node_api,node_authapi,node_feedbackapi,node_authservice toneAmber
class node_feedbackservice,node_ingestion,node_nlp,node_language,node_translation,node_sentiment,node_category toneMint
class node_analytics,node_automation,node_externalactions toneRose
class node_database,node_userstore,node_analyst toneIndigo
```

## Components

### Analyst Experience

- [Web Application](https://github.com/radhikakawadkar/vocx-ai/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Auth State](https://github.com/radhikakawadkar/vocx-ai/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Ingestion Manager](https://github.com/radhikakawadkar/vocx-ai/blob/main/frontend/src/pages/IngestionManagerPage.tsx): `frontend/src/pages/IngestionManagerPage.tsx`
- [Feedback Client](https://github.com/radhikakawadkar/vocx-ai/blob/main/frontend/src/services/feedback.ts): `frontend/src/services/feedback.ts`

### API and Access

- [REST API](https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/api/v1/router.py): `backend/app/api/v1/router.py`
- [Authentication API](https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/api/v1/auth.py): `backend/app/api/v1/auth.py`
- [Feedback API](https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/api/v1/feedback.py): `backend/app/api/v1/feedback.py`
- [Auth Service](https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/auth_service.py): `backend/app/services/auth_service.py`

### Feedback Processing

- [Feedback Service](https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/feedback_service.py): `backend/app/services/feedback_service.py`
- [Ingestion Service](https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/ingestion_service.py): `backend/app/services/ingestion_service.py`
- [Multilingual NLP](https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/nlp_engine.py): `backend/app/services/nlp_engine.py`
- [Language Analysis](https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/language_service.py): `backend/app/services/language_service.py`
- [Translation Service](https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/translation_service.py): `backend/app/services/translation_service.py`
- [Sentiment Analysis](https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/sentiment_service.py): `backend/app/services/sentiment_service.py`
- [Category Analysis](https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/category_service.py): `backend/app/services/category_service.py`

### Insights and Actions

- [Analytics](https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/analytics_service.py): `backend/app/services/analytics_service.py`
- [Automation Rules](https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/services/automation_service.py): `backend/app/services/automation_service.py`
- **Alert Integrations**

### Persistence

- [Feedback Database](https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/models/feedback.py): `backend/app/models/feedback.py`
- [User Records](https://github.com/radhikakawadkar/vocx-ai/blob/main/backend/app/models/user.py): `backend/app/models/user.py`

### Other components

- **Analyst**

## Connections

- Analyst → Web Application: uses (evidence: `README.md`)
- Web Application → Auth State: provides auth (evidence: `frontend/src/App.tsx`)
- Web Application → Ingestion Manager: routes to (evidence: `frontend/src/App.tsx`)
- Ingestion Manager → Feedback Client: requests stats (evidence: `frontend/src/pages/IngestionManagerPage.tsx`)
- Feedback Client → Feedback API: calls endpoints (evidence: `frontend/src/services/feedback.ts`)
- REST API → Authentication API: routes to (evidence: `backend/app/api/v1/router.py`)
- REST API → Feedback API: routes to (evidence: `backend/app/api/v1/router.py`)
- Authentication API → Auth Service: invokes (evidence: `backend/app/api/v1/auth.py`)
- Auth Service → User Records: queries and saves (evidence: `backend/app/services/auth_service.py`)
- Feedback API → Ingestion Service: imports feedback (evidence: `backend/app/api/v1/feedback.py`)
- Feedback API → Feedback Service: uses (evidence: `backend/app/api/v1/feedback.py`)
- Ingestion Service → Multilingual NLP: analyzes text (evidence: `backend/app/services/ingestion_service.py`)
- Ingestion Service → Feedback Database: stores records (evidence: `backend/app/services/ingestion_service.py`)
- Ingestion Service → Automation Rules: evaluates rules (evidence: `backend/app/services/ingestion_service.py`)
- Feedback Service → Feedback Database: reads feedback
- Multilingual NLP → Language Analysis: detects language
- Multilingual NLP → Translation Service: translates text
- Multilingual NLP → Sentiment Analysis: scores sentiment
- Multilingual NLP → Category Analysis: classifies aspects
- Analytics → Feedback Database: aggregates records
- Automation Rules → Alert Integrations: triggers alerts
- Analyst → Analytics: views insights (evidence: `README.md`)
- Analyst → Automation Rules: configures rules (evidence: `README.md`)
- Analyst → Multilingual NLP: tests feedback (evidence: `README.md`)
