# genix2096/ai-meeting-intelligence architecture

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

- Interactive diagram: https://gitdiagram.com/genix2096/ai-meeting-intelligence
- Repository: https://github.com/genix2096/ai-meeting-intelligence

## Overview

The platform accepts a meeting transcript by file upload or pasted text, then extracts and preprocesses it, analyzes it with an LLM, and presents a structured report with status tracking and PDF export. The graph distinguishes frontend orchestration, API/job handling, analysis stages, and report presentation. Unsampled modules and their connections are included only where the README or SOURCE INDEX supports them; optional provider details are not inferred.

Main entry points: [`backend/controllers/analyzeController.js`](https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/controllers/analyzeController.js) (Job controller), [`frontend/src/pages/Home.jsx`](https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/pages/Home.jsx) (Home workflow), [`backend/services/transcriptProcessor.js`](https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/services/transcriptProcessor.js) (Preprocessing assembly), [`frontend/src/components/ReportPreview.jsx`](https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/components/ReportPreview.jsx) (Report preview)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web interface"]
  node_home["Home workflow<br/>[Home.jsx]"]
  node_transcript_input["Transcript input"]
  node_file_uploader["File uploader<br/>[FileUploader.jsx]"]
  node_analysis_hook["Analysis lifecycle<br/>[useAnalysis.js]"]
  node_api_client["API client<br/>[api.js]"]
  node_status_view["Processing status"]
end

subgraph group_backend["API and jobs"]
  node_express_routes["Analysis routes<br/>[analyze.js]"]
  node_job_controller["Job controller"]
  node_job_map[("In-memory jobs")]
end

subgraph group_analysis["Transcript analysis"]
  node_file_extraction["File text extraction<br/>[fileProcessor.js]"]
  node_transcript_processing["Preprocessing assembly"]
  node_tokenizer["Tokenizer<br/>[tokenizer.js]"]
  node_regex_extractor["Regex extraction<br/>[regexExtractor.js]"]
  node_grammar_parser["Action grammar<br/>[grammarParser.js]"]
  node_meeting_fsm["Meeting FSM<br/>[meetingFSM.js]"]
  node_llm_service["LLM analysis<br/>[groqService.js]"]
  node_response_validator["Response validation<br/>[validator.js]"]
end

subgraph group_report["Reports"]
  node_report_preview["Report preview<br/>[ReportPreview.jsx]"]
  node_report_sections["Report sections"]
  node_followup_email["Follow-up email<br/>[FollowUpEmail.jsx]"]
  node_download_button["PDF download control<br/>[DownloadButton.jsx]"]
  node_report_generator["PDF generation<br/>[reportGenerator.js]"]
end

node_user(("Meeting user"))
node_llm_provider{{"Groq API"}}
node_pdfkit{{"PDFKit"}}

node_user -->|"provides transcript"| node_transcript_input
node_transcript_input -->|"offers upload"| node_file_uploader
node_home -->|"renders"| node_transcript_input
node_home -->|"uses lifecycle"| node_analysis_hook
node_analysis_hook -->|"starts and polls"| node_api_client
node_home -->|"renders progress"| node_status_view
node_home -->|"renders result"| node_report_preview
node_report_preview -->|"renders sections"| node_report_sections
node_report_preview -->|"renders email"| node_followup_email
node_report_preview -->|"renders download"| node_download_button
node_download_button -->|"requests PDF"| node_api_client
node_api_client -->|"calls REST endpoints"| node_express_routes
node_express_routes -->|"routes requests"| node_job_controller
node_job_controller -->|"stores job state"| node_job_map
node_job_controller -->|"extracts uploaded text"| node_file_extraction
node_job_controller -->|"preprocesses transcript"| node_transcript_processing
node_transcript_processing -->|"uses"| node_tokenizer
node_transcript_processing -->|"uses"| node_regex_extractor
node_transcript_processing -->|"uses"| node_grammar_parser
node_job_controller -->|"updates lifecycle"| node_meeting_fsm
node_job_controller -->|"sends transcript context"| node_llm_service
node_llm_service -->|"requests analysis"| node_llm_provider
node_llm_service -->|"validates response"| node_response_validator
node_job_controller -->|"generates download"| node_report_generator
node_report_generator -->|"builds PDF"| node_pdfkit

click node_home "https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/pages/Home.jsx"
click node_transcript_input "https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/components/TranscriptInput.jsx"
click node_file_uploader "https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/components/FileUploader.jsx"
click node_analysis_hook "https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/hooks/useAnalysis.js"
click node_api_client "https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/services/api.js"
click node_status_view "https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/components/ProcessingStatus.jsx"
click node_report_preview "https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/components/ReportPreview.jsx"
click node_report_sections "https://github.com/genix2096/ai-meeting-intelligence/tree/main/frontend/src/components"
click node_followup_email "https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/components/FollowUpEmail.jsx"
click node_download_button "https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/components/DownloadButton.jsx"
click node_express_routes "https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/routes/analyze.js"
click node_job_controller "https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/controllers/analyzeController.js"
click node_job_map "https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/controllers/analyzeController.js"
click node_file_extraction "https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/services/fileProcessor.js"
click node_transcript_processing "https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/services/transcriptProcessor.js"
click node_tokenizer "https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/toc/tokenizer.js"
click node_regex_extractor "https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/toc/regexExtractor.js"
click node_grammar_parser "https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/toc/grammarParser.js"
click node_meeting_fsm "https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/toc/meetingFSM.js"
click node_llm_service "https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/services/groqService.js"
click node_response_validator "https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/utils/validator.js"
click node_report_generator "https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/services/reportGenerator.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_home,node_transcript_input,node_file_uploader,node_analysis_hook,node_api_client,node_status_view,node_user toneBlue
class node_express_routes,node_job_controller,node_job_map toneAmber
class node_file_extraction,node_transcript_processing,node_tokenizer,node_regex_extractor,node_grammar_parser,node_meeting_fsm,node_llm_service,node_response_validator,node_llm_provider toneMint
class node_report_preview,node_report_sections,node_followup_email,node_download_button,node_report_generator toneRose
class node_pdfkit toneIndigo
```

## Components

### Web interface

- [Home workflow](https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [Transcript input](https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/components/TranscriptInput.jsx): `frontend/src/components/TranscriptInput.jsx`
- [File uploader](https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/components/FileUploader.jsx): `frontend/src/components/FileUploader.jsx`
- [Analysis lifecycle](https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/hooks/useAnalysis.js): `frontend/src/hooks/useAnalysis.js`
- [API client](https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Processing status](https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/components/ProcessingStatus.jsx): `frontend/src/components/ProcessingStatus.jsx`

### API and jobs

- [Analysis routes](https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/routes/analyze.js): `backend/routes/analyze.js`
- [Job controller](https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/controllers/analyzeController.js): `backend/controllers/analyzeController.js`
- [In-memory jobs](https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/controllers/analyzeController.js): `backend/controllers/analyzeController.js`

### Transcript analysis

- [File text extraction](https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/services/fileProcessor.js): `backend/services/fileProcessor.js`
- [Preprocessing assembly](https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/services/transcriptProcessor.js): `backend/services/transcriptProcessor.js`
- [Tokenizer](https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/toc/tokenizer.js): `backend/toc/tokenizer.js`
- [Regex extraction](https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/toc/regexExtractor.js): `backend/toc/regexExtractor.js`
- [Action grammar](https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/toc/grammarParser.js): `backend/toc/grammarParser.js`
- [Meeting FSM](https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/toc/meetingFSM.js): `backend/toc/meetingFSM.js`
- [LLM analysis](https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/services/groqService.js): `backend/services/groqService.js`
- [Response validation](https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/utils/validator.js): `backend/utils/validator.js`

### Reports

- [Report preview](https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/components/ReportPreview.jsx): `frontend/src/components/ReportPreview.jsx`
- [Report sections](https://github.com/genix2096/ai-meeting-intelligence/tree/main/frontend/src/components): `frontend/src/components`
- [Follow-up email](https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/components/FollowUpEmail.jsx): `frontend/src/components/FollowUpEmail.jsx`
- [PDF download control](https://github.com/genix2096/ai-meeting-intelligence/blob/main/frontend/src/components/DownloadButton.jsx): `frontend/src/components/DownloadButton.jsx`
- [PDF generation](https://github.com/genix2096/ai-meeting-intelligence/blob/main/backend/services/reportGenerator.js): `backend/services/reportGenerator.js`

### Other components

- **Meeting user**
- **Groq API**
- **PDFKit**

## Connections

- Meeting user → Transcript input: provides transcript (evidence: `README.md`)
- Transcript input → File uploader: offers upload (evidence: `frontend/src/components/TranscriptInput.jsx`)
- Home workflow → Transcript input: renders (evidence: `frontend/src/pages/Home.jsx`)
- Home workflow → Analysis lifecycle: uses lifecycle (evidence: `frontend/src/pages/Home.jsx`)
- Analysis lifecycle → API client: starts and polls (evidence: `frontend/src/hooks/useAnalysis.js`)
- Home workflow → Processing status: renders progress (evidence: `frontend/src/pages/Home.jsx`)
- Home workflow → Report preview: renders result (evidence: `frontend/src/pages/Home.jsx`)
- Report preview → Report sections: renders sections (evidence: `frontend/src/components/ReportPreview.jsx`)
- Report preview → Follow-up email: renders email (evidence: `frontend/src/components/ReportPreview.jsx`)
- Report preview → PDF download control: renders download (evidence: `frontend/src/components/ReportPreview.jsx`)
- PDF download control → API client: requests PDF (evidence: `frontend/src/components/DownloadButton.jsx`)
- API client → Analysis routes: calls REST endpoints (evidence: `frontend/src/services/api.js`)
- Analysis routes → Job controller: routes requests (evidence: `backend/routes/analyze.js`)
- Job controller → In-memory jobs: stores job state (evidence: `backend/controllers/analyzeController.js`)
- Job controller → File text extraction: extracts uploaded text (evidence: `backend/controllers/analyzeController.js`)
- Job controller → Preprocessing assembly: preprocesses transcript (evidence: `backend/controllers/analyzeController.js`)
- Preprocessing assembly → Tokenizer: uses (evidence: `backend/services/transcriptProcessor.js`)
- Preprocessing assembly → Regex extraction: uses (evidence: `backend/services/transcriptProcessor.js`)
- Preprocessing assembly → Action grammar: uses (evidence: `backend/services/transcriptProcessor.js`)
- Job controller → Meeting FSM: updates lifecycle (evidence: `backend/controllers/analyzeController.js`)
- Job controller → LLM analysis: sends transcript context (evidence: `backend/controllers/analyzeController.js`)
- LLM analysis → Groq API: requests analysis (evidence: `backend/services/groqService.js`)
- LLM analysis → Response validation: validates response (evidence: `backend/services/groqService.js`)
- Job controller → PDF generation: generates download (evidence: `backend/controllers/analyzeController.js`)
- PDF generation → PDFKit: builds PDF (evidence: `README.md`)
