# suldev2024/automated-meeting-minutes architecture

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

- Interactive diagram: https://gitdiagram.com/suldev2024/automated-meeting-minutes
- Repository: https://github.com/suldev2024/automated-meeting-minutes

## Overview

Automated Meeting Minutes is a web application that turns uploaded Russian, Kazakh, or mixed-language meeting recordings into transcripts, speaker-separated minutes, summaries, validated action items, and downloadable PDF/DOCX files. The main workflow runs through the frontend and FastAPI analysis endpoint; transcription and diarization are separate audio-processing calls, while summary and action extraction use diarized output. The README documents detailed action-resolution stages not fully visible in the excerpts; those are represented as documented stages, not claims of separately implemented modules. Evaluation tooling is excluded from the runtime map.

Main entry points: [`backend/main.py`](https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/main.py) (Analysis API), [`backend/diarization.py`](https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/diarization.py) (Speaker Diarization), [`frontend/src/App.jsx`](https://github.com/suldev2024/automated-meeting-minutes/blob/main/frontend/src/App.jsx) (Upload & Results UI), [`backend/summarizer.py`](https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/summarizer.py) (Executive Summary)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Web Interface"]
  node_webapp["Upload &amp; Results UI<br/>[App.jsx]"]
  node_demo["Saved Demo<br/>[demoMeeting.json]"]
end

subgraph group_ingestion["Audio Processing"]
  node_api["Analysis API<br/>[main.py]"]
  node_transcription["Speech Transcription<br/>[transcriber.py]"]
  node_diarization["Speaker Diarization<br/>[diarization.py]"]
end

subgraph group_analysis["Meeting Analysis"]
  node_summary["Executive Summary<br/>[summarizer.py]"]
  node_candidates["Action Detection"]
  node_resolution["Task Resolution"]
  node_grounding["Evidence &amp; Deadlines"]
  node_cleanup["Action Validation"]
end

subgraph group_delivery["Minutes Delivery"]
  node_results["Analysis Results<br/>[main.py]"]
  node_exporter["Document Generation<br/>[exporter.py]"]
  node_documents["PDF &amp; DOCX<br/>[exporter.py]"]
end

node_user(("Meeting User"))
node_audio["Recording"]
node_groq{{"Groq API"}}
node_openai{{"OpenAI API"}}

node_user -->|"uploads recording"| node_webapp
node_webapp -->|"loads demo"| node_demo
node_webapp -->|"posts analysis"| node_api
node_api -->|"transcribes audio"| node_transcription
node_api -->|"diarizes audio"| node_diarization
node_audio -->|"audio input"| node_transcription
node_audio -->|"audio input"| node_diarization
node_transcription -->|"calls transcription"| node_groq
node_diarization -->|"calls diarization"| node_openai
node_api -->|"requests summary"| node_summary
node_api -->|"extracts actions"| node_candidates
node_diarization -->|"provides transcript"| node_summary
node_diarization -->|"provides segments"| node_candidates
node_candidates -->|"resolves candidates"| node_resolution
node_resolution -->|"grounds actions"| node_grounding
node_grounding -->|"cleans actions"| node_cleanup
node_cleanup -->|"returns validated actions"| node_results
node_summary -->|"returns summary"| node_results
node_api -->|"generates exports"| node_exporter
node_results -->|"supplies meeting data"| node_exporter
node_exporter -->|"writes documents"| node_documents
node_results -->|"returns analysis"| node_webapp
node_documents -->|"download links"| node_webapp
node_groq -->|"LLM reasoning"| node_candidates
node_groq -->|"LLM summary"| node_summary

click node_webapp "https://github.com/suldev2024/automated-meeting-minutes/blob/main/frontend/src/App.jsx"
click node_demo "https://github.com/suldev2024/automated-meeting-minutes/blob/main/frontend/src/data/demoMeeting.json"
click node_api "https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/main.py"
click node_transcription "https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/transcriber.py"
click node_diarization "https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/diarization.py"
click node_summary "https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/summarizer.py"
click node_candidates "https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/action_extractor.py"
click node_resolution "https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/action_extractor.py"
click node_grounding "https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/action_extractor.py"
click node_cleanup "https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/action_extractor.py"
click node_results "https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/main.py"
click node_exporter "https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/exporter.py"
click node_documents "https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/exporter.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_demo,node_user toneBlue
class node_api,node_transcription,node_diarization toneAmber
class node_summary,node_candidates,node_resolution,node_grounding,node_cleanup,node_groq,node_openai toneMint
class node_results,node_exporter,node_documents toneRose
class node_audio toneIndigo
```

## Components

### Web Interface

- [Upload & Results UI](https://github.com/suldev2024/automated-meeting-minutes/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Saved Demo](https://github.com/suldev2024/automated-meeting-minutes/blob/main/frontend/src/data/demoMeeting.json): `frontend/src/data/demoMeeting.json`

### Audio Processing

- [Analysis API](https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/main.py): `backend/main.py`
- [Speech Transcription](https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/transcriber.py): `backend/transcriber.py`
- [Speaker Diarization](https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/diarization.py): `backend/diarization.py`

### Meeting Analysis

- [Executive Summary](https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/summarizer.py): `backend/summarizer.py`
- [Action Detection](https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/action_extractor.py): `backend/action_extractor.py`
- [Task Resolution](https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/action_extractor.py): `backend/action_extractor.py`
- [Evidence & Deadlines](https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/action_extractor.py): `backend/action_extractor.py`
- [Action Validation](https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/action_extractor.py): `backend/action_extractor.py`

### Minutes Delivery

- [Analysis Results](https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/main.py): `backend/main.py`
- [Document Generation](https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/exporter.py): `backend/exporter.py`
- [PDF & DOCX](https://github.com/suldev2024/automated-meeting-minutes/blob/main/backend/exporter.py): `backend/exporter.py`

### Other components

- **Meeting User**
- **Recording**
- **Groq API**
- **OpenAI API**

## Connections

- Meeting User → Upload & Results UI: uploads recording (evidence: `README.md`)
- Upload & Results UI → Saved Demo: loads demo (evidence: `frontend/src/App.jsx`)
- Upload & Results UI → Analysis API: posts analysis (evidence: `frontend/src/App.jsx`)
- Analysis API → Speech Transcription: transcribes audio (evidence: `backend/main.py`)
- Analysis API → Speaker Diarization: diarizes audio (evidence: `backend/main.py`)
- Recording → Speech Transcription: audio input (evidence: `backend/transcriber.py`)
- Recording → Speaker Diarization: audio input (evidence: `backend/diarization.py`)
- Speech Transcription → Groq API: calls transcription (evidence: `backend/transcriber.py`)
- Speaker Diarization → OpenAI API: calls diarization (evidence: `backend/diarization.py`)
- Analysis API → Executive Summary: requests summary (evidence: `backend/main.py`)
- Analysis API → Action Detection: extracts actions (evidence: `backend/main.py`)
- Speaker Diarization → Executive Summary: provides transcript (evidence: `backend/main.py`)
- Speaker Diarization → Action Detection: provides segments (evidence: `backend/main.py`)
- Action Detection → Task Resolution: resolves candidates (evidence: `README.md`)
- Task Resolution → Evidence & Deadlines: grounds actions (evidence: `README.md`)
- Evidence & Deadlines → Action Validation: cleans actions (evidence: `README.md`)
- Action Validation → Analysis Results: returns validated actions (evidence: `backend/main.py`)
- Executive Summary → Analysis Results: returns summary (evidence: `backend/main.py`)
- Analysis API → Document Generation: generates exports (evidence: `README.md`)
- Analysis Results → Document Generation: supplies meeting data (evidence: `backend/exporter.py`)
- Document Generation → PDF & DOCX: writes documents (evidence: `backend/exporter.py`)
- Analysis Results → Upload & Results UI: returns analysis (evidence: `frontend/src/App.jsx`)
- PDF & DOCX → Upload & Results UI: download links (evidence: `frontend/src/App.jsx`)
- Groq API → Action Detection: LLM reasoning (evidence: `README.md`)
- Groq API → Executive Summary: LLM summary (evidence: `backend/summarizer.py`)
