How priyanshitamta/vivaran-vqe works
Vivaran-VQE is a three-system learning platform whose learner workflow is assess skills, recommend courses, learn, verify with quizzes, then re-assess from quiz results. System 3 is the role-based web application and state owner; it delegates competency analysis to System 1 and quiz generation to System 2. The graph preserves the trainer/admin workspaces and progress features documented in the README. Some subsystem wiring is documented rather than shown in sampled source, so only documented calls are linked; peripheral routes are omitted.
Main entry points: System-3 Complete_Website/app.py Web routes · System-2 MCQ_Generator/app.py Quiz application · routes.py Recommendation API · registration_service.py Profile registration
Components 27
System 3 Web Platform
- Browser UI
System-3 Complete_Website/static/js/intake.js - Web routes
System-3 Complete_Website/app.py - Platform state
System-3 Complete_Website/db.py - Course catalogue
System-3 Complete_Website/courses.py - Roadmap builder
System-3 Complete_Website/recommender.py - Progress tracking
System-3 Complete_Website/progress.py - S1 HTTP client
System-3 Complete_Website/s1_client.py - S2 quiz bridge
System-3 Complete_Website/s2_bridge.py
System 1 Recommendations
- Engine assembly
System-1 Recommandation_Engine/app/main.py - Recommendation API
System-1 Recommandation_Engine/app/api/routes.py - Dataset loader
System-1 Recommandation_Engine/app/data/loader.py - Data repositories
System-1 Recommandation_Engine/app/data/repositories.py - Gap analysis
System-1 Recommandation_Engine/app/services/gap_service.py - Course ranking
System-1 Recommandation_Engine/app/services/recommendation_service.py - Profile registration
System-1 Recommandation_Engine/app/services/registration_service.py - Profile datasets
System-1 Recommandation_Engine/app/data/loader.py
System 2 Quiz Engine
- Quiz application
System-2 MCQ_Generator/app.py - Video processing
System-2 MCQ_Generator/utils/video_processor.py - Audio transcription
System-2 MCQ_Generator/utils/audio_transcriber.py - MCQ generation
System-2 MCQ_Generator/utils/mcq_generator.py - Question selection
System-2 MCQ_Generator/utils/question_manager.py - Quiz results
System-2 MCQ_Generator/utils/results_manager.py
External Services
- YouTube
- Groq API
Other components
- Learner
- Trainer
- Admin
Connections 30
- Learner → Browser UI: uses
- Trainer → Browser UI: uses
- Admin → Browser UI: uses
- Browser UI → Web routes: HTTP requests
- Web routes → Platform state: reads/writes
- Web routes → Course catalogue: loads courses
- Web routes → Roadmap builder: builds roadmap
- Web routes → Progress tracking: updates progress
- Web routes → S1 HTTP client: requests analysis
- S1 HTTP client → Recommendation API: REST/JSON
- Engine assembly → Dataset loader: loads datasets
- Dataset loader → Profile datasets: reads
- Engine assembly → Data repositories: builds
- Engine assembly → Recommendation API: mounts routes
- Recommendation API → Gap analysis: computes gaps
- Recommendation API → Course ranking: ranks courses
- Recommendation API → Profile registration: registers profile
- Profile registration → Gap analysis: computes gaps
- Profile registration → Course ranking: gets recommendations
- Profile registration → Profile datasets: persists profile
- Web routes → S2 quiz bridge: starts quiz job
- S2 quiz bridge → Quiz application: in-process call
- Quiz application → Video processing: processes video
- Video processing → YouTube: downloads video
- Quiz application → Audio transcription: transcribes audio
- Quiz application → MCQ generation: generates questions
- MCQ generation → Groq API: calls LLM
- Quiz application → Question selection: selects questions
- Quiz application → Quiz results: saves attempts
- Web routes → Platform state: caches quiz sets