# jegan029/fingen-training-hub architecture

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

- Interactive diagram: https://gitdiagram.com/jegan029/fingen-training-hub
- Repository: https://github.com/jegan029/fingen-training-hub

## Overview

FinGen Training Hub takes learners from a training-path roadmap through lesson content, progress tracking, assessments and scenario quizzes, with an AI tutor and runbooks as supporting resources. Progress feeds certificate eligibility; trainers review cohort analytics and learner progress. The React app calls a FastAPI API, whose routers delegate domain work to services and SQLite. The README documents capabilities beyond sampled implementations; arrows for those use the README, while source-level connections cite indexed or excerpted files.

Main entry points: [`backend/app/main.py`](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/main.py) (FastAPI application), [`frontend/src/api.ts`](https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/api.ts) (API client), [`backend/app/db.py`](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/db.py) (SQLite database), [`backend/app/services/kb_service.py`](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/services/kb_service.py) (Knowledge base)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learner_ui["Learner experience"]
  node_app["App navigation<br/>[App.tsx]"]
  node_home["Home and resume<br/>[HomePage.tsx]"]
  node_roadmap_ui["Roadmaps and lessons<br/>[RoadmapViewer.tsx]"]
  node_assessment_ui["Assessments<br/>[AssessmentPage.tsx]"]
  node_scenario_ui["Scenario quizzes"]
  node_tutor_ui["AI tutor<br/>[ChatAssistant.tsx]"]
  node_runbook_ui["Runbook library<br/>[RunbookLibrary.tsx]"]
  node_certificate_ui["Certificate<br/>[Certificate.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
  node_auth_ui["Session context<br/>[AuthContext.tsx]"]
end

subgraph group_trainer_ui["Trainer experience"]
  node_trainer_admin["Learner administration<br/>[AdminView.tsx]"]
  node_trainer_analytics["Cohort analytics"]
end

subgraph group_api["API and domain"]
  node_api_app["FastAPI application<br/>[main.py]"]
  node_auth_routes["Authentication routes<br/>[auth.py]"]
  node_roadmap_routes["Roadmap routes<br/>[roadmap.py]"]
  node_progress_routes["Progress routes<br/>[progress.py]"]
  node_assessment_routes["Assessment routes<br/>[assessment.py]"]
  node_chat_routes["Chat routes<br/>[chat.py]"]
  node_runbook_routes["Runbook routes<br/>[runbooks.py]"]
  node_search_routes["Search routes<br/>[search.py]"]
  node_certificate_routes["Certificate routes<br/>[certificate.py]"]
  node_admin_routes["Admin routes<br/>[admin.py]"]
  node_analytics_routes["Analytics routes<br/>[analytics.py]"]
  node_kb["Knowledge base<br/>[kb_service.py]"]
  node_assessment_service["Assessment scoring"]
  node_llm_service["LLM orchestration<br/>[llm_service.py]"]
  node_llm_provider["LLM providers<br/>[llm_providers.py]"]
  node_progress_service["Progress logic"]
  node_search_service["Search logic<br/>[search_service.py]"]
  node_certificate_service["Certificate eligibility"]
end

subgraph group_platform["Data and security"]
  node_security["Session security<br/>[security.py]"]
  node_database[("SQLite database<br/>[db.py]")]
end

node_learner(("Learner"))
node_trainer(("Trainer"))

node_learner -->|"uses"| node_app
node_trainer -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_home -->|"fetches progress"| node_api_client
node_home -->|"starts training"| node_roadmap_ui
node_roadmap_ui -.->|"loads learning"| node_api_client
node_assessment_ui -.->|"submits answers"| node_api_client
node_scenario_ui -.->|"submits choices"| node_api_client
node_tutor_ui -.->|"sends questions"| node_api_client
node_runbook_ui -->|"fetches runbooks"| node_api_client
node_certificate_ui -.->|"checks eligibility"| node_api_client
node_trainer_admin -->|"fetches learners"| node_api_client
node_trainer_analytics -.->|"requests analytics"| node_api_client
node_app -->|"provides session"| node_auth_ui
node_auth_ui -->|"checks session"| node_api_client
node_api_client -->|"calls API"| node_api_app
node_api_app -->|"mounts"| node_auth_routes
node_api_app -->|"mounts"| node_roadmap_routes
node_api_app -->|"mounts"| node_progress_routes
node_api_app -->|"mounts"| node_assessment_routes
node_api_app -->|"mounts"| node_chat_routes
node_api_app -->|"mounts"| node_runbook_routes
node_api_app -->|"mounts"| node_search_routes
node_api_app -->|"mounts"| node_certificate_routes
node_api_app -->|"mounts"| node_admin_routes
node_api_app -->|"mounts"| node_analytics_routes
node_api_app -->|"guards requests"| node_security
node_api_app -->|"initializes"| node_database
node_auth_routes -->|"reads accounts"| node_database
node_auth_routes -->|"sets session"| node_security
node_roadmap_routes -.->|"loads path content"| node_kb
node_progress_routes -->|"delegates progress"| node_progress_service
node_progress_routes -->|"loads topics"| node_kb
node_assessment_routes -->|"scores answers"| node_assessment_service
node_assessment_routes -->|"loads lesson content"| node_kb
node_chat_routes -->|"retrieves context"| node_kb
node_chat_routes -->|"requests answer"| node_llm_service
node_runbook_routes -.->|"loads runbooks"| node_kb
node_search_routes -->|"delegates search"| node_search_service
node_certificate_routes -->|"checks eligibility"| node_certificate_service
node_admin_routes -->|"reads learners"| node_database
node_analytics_routes -->|"queries metrics"| node_database
node_assessment_service -->|"evaluates answer"| node_llm_service
node_llm_service -->|"completes prompts"| node_llm_provider
node_kb -->|"queries content"| node_database
node_progress_service -->|"updates progress"| node_database
node_search_service -->|"searches records"| node_database
node_certificate_service -->|"checks completion"| node_database

click node_app "https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/App.tsx"
click node_home "https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/routes/HomePage.tsx"
click node_roadmap_ui "https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/routes/RoadmapViewer.tsx"
click node_assessment_ui "https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/routes/AssessmentPage.tsx"
click node_scenario_ui "https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/routes/ScenarioAssessment.tsx"
click node_tutor_ui "https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/routes/ChatAssistant.tsx"
click node_runbook_ui "https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/routes/RunbookLibrary.tsx"
click node_certificate_ui "https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/routes/Certificate.tsx"
click node_api_client "https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/api.ts"
click node_auth_ui "https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/context/AuthContext.tsx"
click node_trainer_admin "https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/routes/AdminView.tsx"
click node_trainer_analytics "https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/routes/AnalyticsDashboard.tsx"
click node_api_app "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/main.py"
click node_auth_routes "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/auth.py"
click node_roadmap_routes "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/roadmap.py"
click node_progress_routes "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/progress.py"
click node_assessment_routes "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/assessment.py"
click node_chat_routes "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/chat.py"
click node_runbook_routes "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/runbooks.py"
click node_search_routes "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/search.py"
click node_certificate_routes "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/certificate.py"
click node_admin_routes "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/admin.py"
click node_analytics_routes "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/analytics.py"
click node_kb "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/services/kb_service.py"
click node_assessment_service "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/services/assessment_service.py"
click node_llm_service "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/services/llm_service.py"
click node_llm_provider "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/services/llm_providers.py"
click node_progress_service "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/services/progress_service.py"
click node_search_service "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/services/search_service.py"
click node_certificate_service "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/services/certificate_service.py"
click node_security "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/security.py"
click node_database "https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/db.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_app,node_home,node_roadmap_ui,node_assessment_ui,node_scenario_ui,node_tutor_ui,node_runbook_ui,node_certificate_ui,node_api_client,node_auth_ui toneBlue
class node_trainer_admin,node_trainer_analytics toneAmber
class node_api_app,node_auth_routes,node_roadmap_routes,node_progress_routes,node_assessment_routes,node_chat_routes,node_runbook_routes,node_search_routes,node_certificate_routes,node_admin_routes,node_analytics_routes,node_kb,node_assessment_service,node_llm_service,node_llm_provider,node_progress_service,node_search_service,node_certificate_service toneMint
class node_security,node_database toneRose
class node_learner,node_trainer toneIndigo
```

## Components

### Learner experience

- [App navigation](https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Home and resume](https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/routes/HomePage.tsx): `frontend/src/routes/HomePage.tsx`
- [Roadmaps and lessons](https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/routes/RoadmapViewer.tsx): `frontend/src/routes/RoadmapViewer.tsx`
- [Assessments](https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/routes/AssessmentPage.tsx): `frontend/src/routes/AssessmentPage.tsx`
- [Scenario quizzes](https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/routes/ScenarioAssessment.tsx): `frontend/src/routes/ScenarioAssessment.tsx`
- [AI tutor](https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/routes/ChatAssistant.tsx): `frontend/src/routes/ChatAssistant.tsx`
- [Runbook library](https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/routes/RunbookLibrary.tsx): `frontend/src/routes/RunbookLibrary.tsx`
- [Certificate](https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/routes/Certificate.tsx): `frontend/src/routes/Certificate.tsx`
- [API client](https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/api.ts): `frontend/src/api.ts`
- [Session context](https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`

### Trainer experience

- [Learner administration](https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/routes/AdminView.tsx): `frontend/src/routes/AdminView.tsx`
- [Cohort analytics](https://github.com/jegan029/fingen-training-hub/blob/main/frontend/src/routes/AnalyticsDashboard.tsx): `frontend/src/routes/AnalyticsDashboard.tsx`

### API and domain

- [FastAPI application](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/main.py): `backend/app/main.py`
- [Authentication routes](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/auth.py): `backend/app/routers/auth.py`
- [Roadmap routes](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/roadmap.py): `backend/app/routers/roadmap.py`
- [Progress routes](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/progress.py): `backend/app/routers/progress.py`
- [Assessment routes](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/assessment.py): `backend/app/routers/assessment.py`
- [Chat routes](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/chat.py): `backend/app/routers/chat.py`
- [Runbook routes](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/runbooks.py): `backend/app/routers/runbooks.py`
- [Search routes](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/search.py): `backend/app/routers/search.py`
- [Certificate routes](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/certificate.py): `backend/app/routers/certificate.py`
- [Admin routes](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/admin.py): `backend/app/routers/admin.py`
- [Analytics routes](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/routers/analytics.py): `backend/app/routers/analytics.py`
- [Knowledge base](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/services/kb_service.py): `backend/app/services/kb_service.py`
- [Assessment scoring](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/services/assessment_service.py): `backend/app/services/assessment_service.py`
- [LLM orchestration](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/services/llm_service.py): `backend/app/services/llm_service.py`
- [LLM providers](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/services/llm_providers.py): `backend/app/services/llm_providers.py`
- [Progress logic](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/services/progress_service.py): `backend/app/services/progress_service.py`
- [Search logic](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/services/search_service.py): `backend/app/services/search_service.py`
- [Certificate eligibility](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/services/certificate_service.py): `backend/app/services/certificate_service.py`

### Data and security

- [Session security](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/security.py): `backend/app/security.py`
- [SQLite database](https://github.com/jegan029/fingen-training-hub/blob/main/backend/app/db.py): `backend/app/db.py`

### Other components

- **Learner**
- **Trainer**

## Connections

- Learner → App navigation: uses (evidence: `README.md`)
- Trainer → App navigation: uses (evidence: `README.md`)
- App navigation → Home and resume: routes to (evidence: `frontend/src/App.tsx`)
- Home and resume → API client: fetches progress (evidence: `frontend/src/routes/HomePage.tsx`)
- Home and resume → Roadmaps and lessons: starts training (evidence: `frontend/src/App.tsx`)
- Roadmaps and lessons → API client: loads learning
- Assessments → API client: submits answers
- Scenario quizzes → API client: submits choices
- AI tutor → API client: sends questions
- Runbook library → API client: fetches runbooks (evidence: `frontend/src/routes/RunbookLibrary.tsx`)
- Certificate → API client: checks eligibility
- Learner administration → API client: fetches learners (evidence: `frontend/src/routes/AdminView.tsx`)
- Cohort analytics → API client: requests analytics
- App navigation → Session context: provides session (evidence: `frontend/src/App.tsx`)
- Session context → API client: checks session (evidence: `frontend/src/context/AuthContext.tsx`)
- API client → FastAPI application: calls API (evidence: `README.md`)
- FastAPI application → Authentication routes: mounts (evidence: `backend/app/main.py`)
- FastAPI application → Roadmap routes: mounts (evidence: `backend/app/main.py`)
- FastAPI application → Progress routes: mounts (evidence: `backend/app/main.py`)
- FastAPI application → Assessment routes: mounts (evidence: `backend/app/main.py`)
- FastAPI application → Chat routes: mounts (evidence: `backend/app/main.py`)
- FastAPI application → Runbook routes: mounts (evidence: `backend/app/main.py`)
- FastAPI application → Search routes: mounts (evidence: `backend/app/main.py`)
- FastAPI application → Certificate routes: mounts (evidence: `backend/app/main.py`)
- FastAPI application → Admin routes: mounts (evidence: `backend/app/main.py`)
- FastAPI application → Analytics routes: mounts (evidence: `backend/app/main.py`)
- FastAPI application → Session security: guards requests (evidence: `backend/app/main.py`)
- FastAPI application → SQLite database: initializes (evidence: `backend/app/main.py`)
- Authentication routes → SQLite database: reads accounts (evidence: `backend/app/routers/auth.py`)
- Authentication routes → Session security: sets session (evidence: `backend/app/routers/auth.py`)
- Roadmap routes → Knowledge base: loads path content
- Progress routes → Progress logic: delegates progress (evidence: `backend/app/routers/progress.py`)
- Progress routes → Knowledge base: loads topics (evidence: `backend/app/routers/progress.py`)
- Assessment routes → Assessment scoring: scores answers (evidence: `backend/app/routers/assessment.py`)
- Assessment routes → Knowledge base: loads lesson content (evidence: `backend/app/routers/assessment.py`)
- Chat routes → Knowledge base: retrieves context (evidence: `backend/app/routers/chat.py`)
- Chat routes → LLM orchestration: requests answer (evidence: `backend/app/routers/chat.py`)
- Runbook routes → Knowledge base: loads runbooks
- Search routes → Search logic: delegates search (evidence: `backend/app/routers/search.py`)
- Certificate routes → Certificate eligibility: checks eligibility (evidence: `backend/app/routers/certificate.py`)
- Admin routes → SQLite database: reads learners (evidence: `backend/app/routers/admin.py`)
- Analytics routes → SQLite database: queries metrics (evidence: `backend/app/routers/analytics.py`)
- Assessment scoring → LLM orchestration: evaluates answer (evidence: `backend/app/services/assessment_service.py`)
- LLM orchestration → LLM providers: completes prompts (evidence: `backend/app/services/llm_service.py`)
- Knowledge base → SQLite database: queries content (evidence: `backend/app/services/kb_service.py`)
- Progress logic → SQLite database: updates progress (evidence: `backend/app/services/progress_service.py`)
- Search logic → SQLite database: searches records (evidence: `backend/app/services/search_service.py`)
- Certificate eligibility → SQLite database: checks completion (evidence: `backend/app/services/certificate_service.py`)
