# sujanprasad/vbcua architecture

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

- Interactive diagram: https://gitdiagram.com/sujanprasad/vbcua
- Repository: https://github.com/sujanprasad/vbcua

## Overview

VBCUA is a local speech-assessment dashboard. A candidate selects a reference concept, uploads an audio response, and runs analysis: the app transcribes speech, compares its meaning with the reference, extracts pacing and volume features, calculates a score and feedback, and saves the assessment. The app then presents diagnostics and offers a PDF report; users can also manage concepts and review or delete assessment history. The sampled frontend and analysis modules support this map; the README documents the end-to-end workflow and capabilities. Some internal call details are not shown, so those links cite the README.

Main entry points: [`5.Project_Development_Phase/frontend/app.py`](https://github.com/sujanprasad/vbcua/blob/main/5.Project_Development_Phase/frontend/app.py) (Streamlit dashboard), [`5.Project_Development_Phase/backend/modules/transcription.py`](https://github.com/sujanprasad/vbcua/blob/main/5.Project_Development_Phase/backend/modules/transcription.py) (Speech transcription), [`5.Project_Development_Phase/backend/modules/semantic_analysis.py`](https://github.com/sujanprasad/vbcua/blob/main/5.Project_Development_Phase/backend/modules/semantic_analysis.py) (Semantic analysis), [`5.Project_Development_Phase/backend/modules/audio_features.py`](https://github.com/sujanprasad/vbcua/blob/main/5.Project_Development_Phase/backend/modules/audio_features.py) (Audio features)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Assessment interface"]
  node_dashboard["Streamlit dashboard<br/>[app.py]"]
end

subgraph group_analysis["Analysis pipeline"]
  node_speech["Speech transcription<br/>[transcription.py]"]
  node_meaning["Semantic analysis"]
  node_audio["Audio features<br/>[audio_features.py]"]
  node_scoring["Scoring and feedback<br/>[evaluation.py]"]
end

subgraph group_persistence["Assessment data"]
  node_store[("Relational records<br/>[database.py]")]
end

subgraph group_reporting["Reporting"]
  node_pdf["PDF report generation"]
end

node_candidate(("Candidate"))

node_candidate -->|"uploads response"| node_dashboard
node_dashboard -->|"requests transcription"| node_speech
node_dashboard -->|"requests comparison"| node_meaning
node_dashboard -->|"requests extraction"| node_audio
node_dashboard -->|"requests scoring"| node_scoring
node_dashboard -->|"reads and writes"| node_store
node_dashboard -->|"generates report"| node_pdf
node_dashboard -->|"shows results"| node_candidate

click node_dashboard "https://github.com/sujanprasad/vbcua/blob/main/5.Project_Development_Phase/frontend/app.py"
click node_speech "https://github.com/sujanprasad/vbcua/blob/main/5.Project_Development_Phase/backend/modules/transcription.py"
click node_meaning "https://github.com/sujanprasad/vbcua/blob/main/5.Project_Development_Phase/backend/modules/semantic_analysis.py"
click node_audio "https://github.com/sujanprasad/vbcua/blob/main/5.Project_Development_Phase/backend/modules/audio_features.py"
click node_scoring "https://github.com/sujanprasad/vbcua/blob/main/5.Project_Development_Phase/backend/modules/evaluation.py"
click node_store "https://github.com/sujanprasad/vbcua/blob/main/5.Project_Development_Phase/backend/database.py"
click node_pdf "https://github.com/sujanprasad/vbcua/blob/main/5.Project_Development_Phase/backend/modules/report_generator.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_dashboard toneBlue
class node_speech,node_meaning,node_audio,node_scoring toneAmber
class node_store toneMint
class node_pdf toneRose
class node_candidate toneIndigo
```

## Components

### Assessment interface

- [Streamlit dashboard](https://github.com/sujanprasad/vbcua/blob/main/5.Project_Development_Phase/frontend/app.py): `5.Project_Development_Phase/frontend/app.py`

### Analysis pipeline

- [Speech transcription](https://github.com/sujanprasad/vbcua/blob/main/5.Project_Development_Phase/backend/modules/transcription.py): `5.Project_Development_Phase/backend/modules/transcription.py`
- [Semantic analysis](https://github.com/sujanprasad/vbcua/blob/main/5.Project_Development_Phase/backend/modules/semantic_analysis.py): `5.Project_Development_Phase/backend/modules/semantic_analysis.py`
- [Audio features](https://github.com/sujanprasad/vbcua/blob/main/5.Project_Development_Phase/backend/modules/audio_features.py): `5.Project_Development_Phase/backend/modules/audio_features.py`
- [Scoring and feedback](https://github.com/sujanprasad/vbcua/blob/main/5.Project_Development_Phase/backend/modules/evaluation.py): `5.Project_Development_Phase/backend/modules/evaluation.py`

### Assessment data

- [Relational records](https://github.com/sujanprasad/vbcua/blob/main/5.Project_Development_Phase/backend/database.py): `5.Project_Development_Phase/backend/database.py`

### Reporting

- [PDF report generation](https://github.com/sujanprasad/vbcua/blob/main/5.Project_Development_Phase/backend/modules/report_generator.py): `5.Project_Development_Phase/backend/modules/report_generator.py`

### Other components

- **Candidate**

## Connections

- Candidate → Streamlit dashboard: uploads response (evidence: `README.md`)
- Streamlit dashboard → Speech transcription: requests transcription (evidence: `README.md`)
- Streamlit dashboard → Semantic analysis: requests comparison (evidence: `README.md`)
- Streamlit dashboard → Audio features: requests extraction (evidence: `README.md`)
- Streamlit dashboard → Scoring and feedback: requests scoring (evidence: `README.md`)
- Streamlit dashboard → Relational records: reads and writes (evidence: `5.Project_Development_Phase/frontend/app.py`)
- Streamlit dashboard → PDF report generation: generates report (evidence: `README.md`)
- Streamlit dashboard → Candidate: shows results (evidence: `README.md`)
