# gladsonr23/nexora- architecture

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

- Interactive diagram: https://gitdiagram.com/gladsonr23/nexora-
- Repository: https://github.com/gladsonr23/nexora-

## Overview

Nexora is a student-study dashboard whose strongest implemented workflows are YouTube-to-study-notes and exam-paper-to-pattern analysis, alongside a browser-local Vault. The graph preserves documented dashboard capabilities and the server-side processing stages. Some frontend wiring and route details are not shown in the excerpts, so those links rely on README statements; the Vault’s internal implementation is represented only at the documented capability level.

Main entry points: [`server/index.js`](https://github.com/gladsonr23/nexora-/blob/main/server/index.js) (Local API Server), [`dist/app.js`](https://github.com/gladsonr23/nexora-/blob/main/dist/app.js) (Dashboard UI), [`server/ai.js`](https://github.com/gladsonr23/nexora-/blob/main/server/ai.js) (Notes Generation), [`dist/pattern.js`](https://github.com/gladsonr23/nexora-/blob/main/dist/pattern.js) (Analysis Views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Dashboard"]
  node_dashboard_ui["Dashboard UI<br/>[app.js]"]
  node_dashboard_modules["Module Navigation<br/>[app.js]"]
  node_focus_theme["Focus and Theme<br/>[app.js]"]
end

subgraph group_summarizer["Study Summarizer"]
  node_summarizer_ui["Summarizer UI<br/>[app.js]"]
  node_youtube_captions["Caption Retrieval<br/>[youtube.js]"]
  node_notes_generation["Notes Generation<br/>[ai.js]"]
  node_notes_validation["Notes Validation<br/>[notes.js]"]
  node_pdf_output["PDF Output<br/>[pdf.js]"]
end

subgraph group_patterns["Pattern Detector"]
  node_pattern_ui["Analysis Views<br/>[pattern.js]"]
  node_paper_ingest["Paper Ingestion<br/>[index.js]"]
  node_pdf_text["PDF Text Extraction<br/>[pattern.js]"]
  node_ocr["Scanned Paper OCR<br/>[pattern-ocr.js]"]
  node_ocr_reconcile["Question Reconciliation"]
  node_question_analysis["Question Grouping<br/>[pattern.js]"]
  node_topic_analysis["Topic Analysis<br/>[pattern-topics.js]"]
end

subgraph group_vault["Browser Vault"]
  node_vault_store[("Browser File Vault<br/>[vault-files.js]")]
end

subgraph group_server["Server Services"]
  node_server_api["Local API Server<br/>[index.js]"]
  node_study_chat["Study Assistant<br/>[study-chat.js]"]
  node_nickname["Nickname Moderation"]
end

node_student(("Student"))
node_gemini{{"Gemini"}}
node_groq{{"Groq"}}
node_nvidia_ocr{{"NVIDIA OCR"}}
node_youtube{{"YouTube"}}

node_student -->|"uses"| node_dashboard_ui
node_dashboard_ui -->|"shows"| node_dashboard_modules
node_dashboard_ui -->|"offers"| node_focus_theme
node_student -->|"submits video"| node_summarizer_ui
node_summarizer_ui -->|"requests notes"| node_server_api
node_server_api -->|"retrieves captions"| node_youtube_captions
node_youtube_captions -->|"fetches captions"| node_youtube
node_server_api -->|"generates notes"| node_notes_generation
node_notes_generation -->|"validates notes"| node_notes_validation
node_notes_generation -->|"requests generation"| node_gemini
node_notes_generation -.->|"fallback generation"| node_groq
node_summarizer_ui -->|"creates PDF"| node_pdf_output
node_student -->|"uploads papers"| node_pattern_ui
node_pattern_ui -->|"requests analysis"| node_server_api
node_server_api -->|"handles papers"| node_paper_ingest
node_paper_ingest -->|"extracts text"| node_pdf_text
node_paper_ingest -->|"extracts scans"| node_ocr
node_ocr -.->|"requests OCR"| node_nvidia_ocr
node_paper_ingest -->|"parses questions"| node_question_analysis
node_paper_ingest -->|"cross-checks scans"| node_ocr_reconcile
node_ocr_reconcile -->|"extracts questions"| node_gemini
node_ocr_reconcile -->|"extracts questions"| node_groq
node_pattern_ui -->|"requests topic labels"| node_topic_analysis
node_server_api -->|"analyzes topics"| node_topic_analysis
node_topic_analysis -->|"labels topics"| node_gemini
node_topic_analysis -->|"labels topics"| node_groq
node_student -->|"saves study files"| node_vault_store
node_summarizer_ui -->|"saves notes"| node_vault_store
node_pattern_ui -->|"loads and saves papers"| node_vault_store
node_dashboard_ui -.->|"offers assistant"| node_study_chat
node_server_api -->|"dispatches chat"| node_study_chat
node_study_chat -->|"answers questions"| node_gemini
node_study_chat -->|"fallback answers"| node_groq
node_server_api -->|"checks nickname"| node_nickname
node_nickname -->|"moderates text"| node_gemini
node_nickname -->|"moderates text"| node_groq

click node_dashboard_ui "https://github.com/gladsonr23/nexora-/blob/main/dist/app.js"
click node_dashboard_modules "https://github.com/gladsonr23/nexora-/blob/main/dist/app.js"
click node_focus_theme "https://github.com/gladsonr23/nexora-/blob/main/dist/app.js"
click node_summarizer_ui "https://github.com/gladsonr23/nexora-/blob/main/dist/app.js"
click node_youtube_captions "https://github.com/gladsonr23/nexora-/blob/main/server/youtube.js"
click node_notes_generation "https://github.com/gladsonr23/nexora-/blob/main/server/ai.js"
click node_notes_validation "https://github.com/gladsonr23/nexora-/blob/main/server/notes.js"
click node_pdf_output "https://github.com/gladsonr23/nexora-/blob/main/dist/pdf.js"
click node_pattern_ui "https://github.com/gladsonr23/nexora-/blob/main/dist/pattern.js"
click node_paper_ingest "https://github.com/gladsonr23/nexora-/blob/main/server/index.js"
click node_pdf_text "https://github.com/gladsonr23/nexora-/blob/main/server/pattern.js"
click node_ocr "https://github.com/gladsonr23/nexora-/blob/main/server/pattern-ocr.js"
click node_ocr_reconcile "https://github.com/gladsonr23/nexora-/blob/main/server/pattern-ai-extract.js"
click node_question_analysis "https://github.com/gladsonr23/nexora-/blob/main/server/pattern.js"
click node_topic_analysis "https://github.com/gladsonr23/nexora-/blob/main/server/pattern-topics.js"
click node_vault_store "https://github.com/gladsonr23/nexora-/blob/main/dist/vault-files.js"
click node_server_api "https://github.com/gladsonr23/nexora-/blob/main/server/index.js"
click node_study_chat "https://github.com/gladsonr23/nexora-/blob/main/server/study-chat.js"
click node_nickname "https://github.com/gladsonr23/nexora-/blob/main/server/nickname-moderation.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_dashboard_ui,node_dashboard_modules,node_focus_theme toneBlue
class node_summarizer_ui,node_youtube_captions,node_notes_generation,node_notes_validation,node_pdf_output toneAmber
class node_pattern_ui,node_paper_ingest,node_pdf_text,node_ocr,node_ocr_reconcile,node_question_analysis,node_topic_analysis toneMint
class node_vault_store toneRose
class node_server_api,node_study_chat,node_nickname,node_student,node_gemini,node_groq,node_nvidia_ocr,node_youtube toneIndigo
```

## Components

### Dashboard

- [Dashboard UI](https://github.com/gladsonr23/nexora-/blob/main/dist/app.js): `dist/app.js`
- [Module Navigation](https://github.com/gladsonr23/nexora-/blob/main/dist/app.js): `dist/app.js`
- [Focus and Theme](https://github.com/gladsonr23/nexora-/blob/main/dist/app.js): `dist/app.js`

### Study Summarizer

- [Summarizer UI](https://github.com/gladsonr23/nexora-/blob/main/dist/app.js): `dist/app.js`
- [Caption Retrieval](https://github.com/gladsonr23/nexora-/blob/main/server/youtube.js): `server/youtube.js`
- [Notes Generation](https://github.com/gladsonr23/nexora-/blob/main/server/ai.js): `server/ai.js`
- [Notes Validation](https://github.com/gladsonr23/nexora-/blob/main/server/notes.js): `server/notes.js`
- [PDF Output](https://github.com/gladsonr23/nexora-/blob/main/dist/pdf.js): `dist/pdf.js`

### Pattern Detector

- [Analysis Views](https://github.com/gladsonr23/nexora-/blob/main/dist/pattern.js): `dist/pattern.js`
- [Paper Ingestion](https://github.com/gladsonr23/nexora-/blob/main/server/index.js): `server/index.js`
- [PDF Text Extraction](https://github.com/gladsonr23/nexora-/blob/main/server/pattern.js): `server/pattern.js`
- [Scanned Paper OCR](https://github.com/gladsonr23/nexora-/blob/main/server/pattern-ocr.js): `server/pattern-ocr.js`
- [Question Reconciliation](https://github.com/gladsonr23/nexora-/blob/main/server/pattern-ai-extract.js): `server/pattern-ai-extract.js`
- [Question Grouping](https://github.com/gladsonr23/nexora-/blob/main/server/pattern.js): `server/pattern.js`
- [Topic Analysis](https://github.com/gladsonr23/nexora-/blob/main/server/pattern-topics.js): `server/pattern-topics.js`

### Browser Vault

- [Browser File Vault](https://github.com/gladsonr23/nexora-/blob/main/dist/vault-files.js): `dist/vault-files.js`

### Server Services

- [Local API Server](https://github.com/gladsonr23/nexora-/blob/main/server/index.js): `server/index.js`
- [Study Assistant](https://github.com/gladsonr23/nexora-/blob/main/server/study-chat.js): `server/study-chat.js`
- [Nickname Moderation](https://github.com/gladsonr23/nexora-/blob/main/server/nickname-moderation.js): `server/nickname-moderation.js`

### Other components

- **Student**
- **Gemini**
- **Groq**
- **NVIDIA OCR**
- **YouTube**

## Connections

- Student → Dashboard UI: uses (evidence: `README.md`)
- Dashboard UI → Module Navigation: shows (evidence: `README.md`)
- Dashboard UI → Focus and Theme: offers (evidence: `README.md`)
- Student → Summarizer UI: submits video (evidence: `README.md`)
- Summarizer UI → Local API Server: requests notes (evidence: `README.md`)
- Local API Server → Caption Retrieval: retrieves captions (evidence: `server/index.js`)
- Caption Retrieval → YouTube: fetches captions (evidence: `server/youtube.js`)
- Local API Server → Notes Generation: generates notes (evidence: `server/index.js`)
- Notes Generation → Notes Validation: validates notes (evidence: `server/ai.js`)
- Notes Generation → Gemini: requests generation (evidence: `server/ai.js`)
- Notes Generation → Groq: fallback generation (evidence: `README.md`)
- Summarizer UI → PDF Output: creates PDF (evidence: `README.md`)
- Student → Analysis Views: uploads papers (evidence: `README.md`)
- Analysis Views → Local API Server: requests analysis (evidence: `README.md`)
- Local API Server → Paper Ingestion: handles papers (evidence: `server/index.js`)
- Paper Ingestion → PDF Text Extraction: extracts text (evidence: `server/index.js`)
- Paper Ingestion → Scanned Paper OCR: extracts scans (evidence: `server/index.js`)
- Scanned Paper OCR → NVIDIA OCR: requests OCR (evidence: `README.md`)
- Paper Ingestion → Question Grouping: parses questions (evidence: `server/index.js`)
- Paper Ingestion → Question Reconciliation: cross-checks scans (evidence: `server/index.js`)
- Question Reconciliation → Gemini: extracts questions (evidence: `server/pattern-ai-extract.js`)
- Question Reconciliation → Groq: extracts questions (evidence: `server/pattern-ai-extract.js`)
- Analysis Views → Topic Analysis: requests topic labels (evidence: `README.md`)
- Local API Server → Topic Analysis: analyzes topics (evidence: `server/index.js`)
- Topic Analysis → Gemini: labels topics (evidence: `server/pattern-topics.js`)
- Topic Analysis → Groq: labels topics (evidence: `server/pattern-topics.js`)
- Student → Browser File Vault: saves study files (evidence: `README.md`)
- Summarizer UI → Browser File Vault: saves notes (evidence: `README.md`)
- Analysis Views → Browser File Vault: loads and saves papers (evidence: `README.md`)
- Dashboard UI → Study Assistant: offers assistant (evidence: `README.md`)
- Local API Server → Study Assistant: dispatches chat (evidence: `server/index.js`)
- Study Assistant → Gemini: answers questions (evidence: `server/study-chat.js`)
- Study Assistant → Groq: fallback answers (evidence: `server/study-chat.js`)
- Local API Server → Nickname Moderation: checks nickname (evidence: `server/index.js`)
- Nickname Moderation → Gemini: moderates text (evidence: `server/nickname-moderation.js`)
- Nickname Moderation → Groq: moderates text (evidence: `server/nickname-moderation.js`)
