How jegan029/fingen-training-hub works
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: main.py FastAPI application · api.ts API client · db.py SQLite database · kb_service.py Knowledge base
Components 34
Learner experience
- App navigation
frontend/src/App.tsx - Home and resume
frontend/src/routes/HomePage.tsx - Roadmaps and lessons
frontend/src/routes/RoadmapViewer.tsx - Assessments
frontend/src/routes/AssessmentPage.tsx - Scenario quizzes
frontend/src/routes/ScenarioAssessment.tsx - AI tutor
frontend/src/routes/ChatAssistant.tsx - Runbook library
frontend/src/routes/RunbookLibrary.tsx - Certificate
frontend/src/routes/Certificate.tsx - API client
frontend/src/api.ts - Session context
frontend/src/context/AuthContext.tsx
Trainer experience
- Learner administration
frontend/src/routes/AdminView.tsx - Cohort analytics
frontend/src/routes/AnalyticsDashboard.tsx
API and domain
- FastAPI application
backend/app/main.py - Authentication routes
backend/app/routers/auth.py - Roadmap routes
backend/app/routers/roadmap.py - Progress routes
backend/app/routers/progress.py - Assessment routes
backend/app/routers/assessment.py - Chat routes
backend/app/routers/chat.py - Runbook routes
backend/app/routers/runbooks.py - Search routes
backend/app/routers/search.py - Certificate routes
backend/app/routers/certificate.py - Admin routes
backend/app/routers/admin.py - Analytics routes
backend/app/routers/analytics.py - Knowledge base
backend/app/services/kb_service.py - Assessment scoring
backend/app/services/assessment_service.py - LLM orchestration
backend/app/services/llm_service.py - LLM providers
backend/app/services/llm_providers.py - Progress logic
backend/app/services/progress_service.py - Search logic
backend/app/services/search_service.py - Certificate eligibility
backend/app/services/certificate_service.py
Data and security
- Session security
backend/app/security.py - SQLite database
backend/app/db.py
Other components
- Learner
- Trainer
Connections 48
- Learner → App navigation: uses
README.md - Trainer → App navigation: uses
README.md - App navigation → Home and resume: routes to
frontend/src/App.tsx - Home and resume → API client: fetches progress
frontend/src/routes/HomePage.tsx - Home and resume → Roadmaps and lessons: starts training
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
frontend/src/routes/RunbookLibrary.tsx - Certificate → API client: checks eligibility
- Learner administration → API client: fetches learners
frontend/src/routes/AdminView.tsx - Cohort analytics → API client: requests analytics
- App navigation → Session context: provides session
frontend/src/App.tsx - Session context → API client: checks session
frontend/src/context/AuthContext.tsx - API client → FastAPI application: calls API
README.md - FastAPI application → Authentication routes: mounts
backend/app/main.py - FastAPI application → Roadmap routes: mounts
backend/app/main.py - FastAPI application → Progress routes: mounts
backend/app/main.py - FastAPI application → Assessment routes: mounts
backend/app/main.py - FastAPI application → Chat routes: mounts
backend/app/main.py - FastAPI application → Runbook routes: mounts
backend/app/main.py - FastAPI application → Search routes: mounts
backend/app/main.py - FastAPI application → Certificate routes: mounts
backend/app/main.py - FastAPI application → Admin routes: mounts
backend/app/main.py - FastAPI application → Analytics routes: mounts
backend/app/main.py - FastAPI application → Session security: guards requests
backend/app/main.py - FastAPI application → SQLite database: initializes
backend/app/main.py - Authentication routes → SQLite database: reads accounts
backend/app/routers/auth.py - Authentication routes → Session security: sets session
backend/app/routers/auth.py - Roadmap routes → Knowledge base: loads path content
- Progress routes → Progress logic: delegates progress
backend/app/routers/progress.py - Progress routes → Knowledge base: loads topics
backend/app/routers/progress.py - Assessment routes → Assessment scoring: scores answers
backend/app/routers/assessment.py - Assessment routes → Knowledge base: loads lesson content
backend/app/routers/assessment.py - Chat routes → Knowledge base: retrieves context
backend/app/routers/chat.py - Chat routes → LLM orchestration: requests answer
backend/app/routers/chat.py - Runbook routes → Knowledge base: loads runbooks
- Search routes → Search logic: delegates search
backend/app/routers/search.py - Certificate routes → Certificate eligibility: checks eligibility
backend/app/routers/certificate.py - Admin routes → SQLite database: reads learners
backend/app/routers/admin.py - Analytics routes → SQLite database: queries metrics
backend/app/routers/analytics.py - Assessment scoring → LLM orchestration: evaluates answer
backend/app/services/assessment_service.py - LLM orchestration → LLM providers: completes prompts
backend/app/services/llm_service.py - Knowledge base → SQLite database: queries content
backend/app/services/kb_service.py - Progress logic → SQLite database: updates progress
backend/app/services/progress_service.py - Search logic → SQLite database: searches records
backend/app/services/search_service.py - Certificate eligibility → SQLite database: checks completion
backend/app/services/certificate_service.py