How dhanushaadhikesh12-spec/career_forge_ai works
CareerForge AI is a placement-readiness platform for students and trainers. Students register, learn and practice aptitude topics, take adaptive or proctored tests, and submit code; trainers manage cohorts, review analytics, and ask a grounded AI assistant about authorized student data. The backend combines REST routes, adaptive aptitude, coding evaluation, ML analytics, and AI services over PostgreSQL. README documents capabilities whose route-level wiring was not sampled; those links are shown as documented or left unverified rather than inferred from module names.
Main entry points: database.py PostgreSQL data · App.tsx Role-based app · feature_engineering.py Readiness features · adaptive_engine.py Adaptive aptitude engine
Components 28
Student and trainer experience
- Role-based app
frontend/src/App.tsx - Sign-in UI
frontend/src/contexts/AuthContext.tsx - Student learning UI
frontend/src/pages/student/TestSessionPage.tsx - Trainer workspace
frontend/src/pages/trainer/TrainerAIAssistantPage.tsx - REST client
frontend/src/services/api.ts
API and learning workflows
- FastAPI application
backend/app/main.py - Authentication routes
backend/app/api/routes/auth.py - Student learning routes
backend/app/api/routes/student.py - Coding assessment routes
backend/app/api/routes/coding.py - Proctoring routes
backend/app/api/routes/proctoring.py - Trainer routes
backend/app/api/routes/trainer.py - Adaptive aptitude engine
backend/app/services/adaptive_engine.py - Code evaluation client
backend/app/services/judge0.py - Question and curriculum bank
backend/app/data/curriculum.py
Analytics and AI
- Readiness features
backend/app/ml/feature_engineering.py - Readiness prediction
backend/app/ml/readiness_model.py - Cohort and integrity ML
backend/app/ml - Trainer AI assistant
backend/app/services/ai/assistant.py - Grounded data tools
backend/app/services/ai/tools.py - Ollama provider
backend/app/services/ai/provider.py
Platform data
- PostgreSQL data
backend/app/db/database.py - Learning and account models
backend/app/models/content.py - Coding submission models
backend/app/models/coding.py - User and cohort models
backend/app/models/user.py
Other components
- Students
- Trainers
- Judge0 sandbox
- Ollama Gemma
Connections 36
- Students → Role-based app: use
- Trainers → Role-based app: use
- Role-based app → Sign-in UI: provides routes
frontend/src/App.tsx - Role-based app → Student learning UI: routes students
frontend/src/App.tsx - Role-based app → Trainer workspace: routes trainers
frontend/src/App.tsx - Sign-in UI → REST client: requests
- Student learning UI → REST client: requests
- Trainer workspace → REST client: requests
- REST client → FastAPI application: REST requests
- FastAPI application → PostgreSQL data: initializes
backend/app/main.py - FastAPI application → Authentication routes: registers routes
- Authentication routes → PostgreSQL data: reads and writes
backend/app/api/routes/auth.py - Student learning routes → Adaptive aptitude engine: uses
- Adaptive aptitude engine → Learning and account models: reads progress and questions
backend/app/services/adaptive_engine.py - Adaptive aptitude engine → User and cohort models: updates progress
backend/app/services/adaptive_engine.py - Adaptive aptitude engine → Question and curriculum bank: selects from
- Coding assessment routes → Code evaluation client: evaluates submissions
- Code evaluation client → Judge0 sandbox: submits code
- Coding assessment routes → Coding submission models: stores submissions
- Proctoring routes → PostgreSQL data: records events
backend/app/api/routes/proctoring.py - Trainer routes → Readiness features: requests analytics
- Readiness features → User and cohort models: extracts profile data
backend/app/ml/feature_engineering.py - Readiness features → Learning and account models: extracts topic progress
backend/app/ml/feature_engineering.py - Readiness features → Coding submission models: extracts coding data
backend/app/ml/feature_engineering.py - Readiness prediction → Readiness features: uses features
backend/app/ml/readiness_model.py - Trainer routes → Cohort and integrity ML: serves analytics
- Trainer routes → Readiness prediction: serves readiness
- Trainer AI assistant → Grounded data tools: grounds answers
- Trainer AI assistant → Ollama provider: generates responses
- Ollama provider → Ollama Gemma: calls local model
- Grounded data tools → User and cohort models: queries cohort data
backend/app/services/ai/tools.py - Grounded data tools → Readiness prediction: queries predictions
backend/app/services/ai/tools.py - Trainer workspace → Trainer AI assistant: chat requests
- PostgreSQL data → Learning and account models: maps tables
backend/app/db/database.py - PostgreSQL data → Coding submission models: maps tables
backend/app/db/database.py - PostgreSQL data → User and cohort models: maps tables
backend/app/db/database.py