How dhanush-10-1/pathforge-hackcodeio works
PathForge guides a candidate from role selection and resume parsing through diagnostic skill verification to an explainable, personalized learning pathway. The frontend calls the backend, which coordinates persistence and the ML service; the documented external quiz portal can return graded results to the backend. The README documents the major ML capabilities, but router and model excerpts are incomplete, so some internal wiring is not shown.
Main entry points: app/main.py Backend API · app/main.py ML API · quiz.py Quiz sessions · ml_client.py ML HTTP client
Components 25
Candidate experience
- Landing
frontend/app/page.tsx - Role and resume
frontend/app/onboarding/page.tsx - Quiz interface
frontend/app/quiz/page.tsx - Pathway view
frontend/app/pathway/page.tsx - API client
frontend/lib/api.ts
Backend orchestration
- Backend API
backend/app/main.py - Authentication
backend/app/routers/auth.py - Resume processing
backend/app/routers/resume.py - Quiz sessions
backend/app/routers/quiz.py - Pathway orchestration
backend/app/routers/pathway.py - ML HTTP client
backend/app/services/ml_client.py
ML capabilities
- ML API
ml/app/main.py - Skill extraction
ml/app/routers/skills.py - Skill extractor
ml/app/models/skill_extractor.py - Role mapping
ml/app/routers/roles.py - Role mapper
ml/app/models/role_mapper.py - Quiz generation and grading
ml/app/routers/quiz.py - Quiz generator
ml/app/models/quiz_generator.py - Pathway generation
ml/app/routers/pathway.py - Adaptive engine
ml/app/models/adaptive_engine.py
Persistent state
- Database sessions
backend/app/db/database.py - User and learning records
backend/app/db/models.py - PostgreSQL
Other components
- Candidate
- External quiz portal
Connections 31
- Candidate → Landing: visits
- Landing → Role and resume: starts onboarding
- Candidate → Role and resume: selects role, submits resume
- Role and resume → API client: requests
- API client → Backend API: HTTP requests
- Backend API → Authentication: dispatches auth
- Backend API → Resume processing: dispatches resume
- Backend API → Quiz sessions: dispatches quiz
- Backend API → Pathway orchestration: dispatches pathway
- Resume processing → ML HTTP client: requests extraction
- ML HTTP client → ML API: calls ML endpoints
- ML API → Skill extraction: dispatches skills
- ML API → Role mapping: dispatches roles
- ML API → Quiz generation and grading: dispatches quiz
- ML API → Pathway generation: dispatches pathway
- Skill extraction → Skill extractor: extracts skills
- Role mapping → Role mapper: maps role
- Quiz sessions → ML HTTP client: requests quiz and grading
- Quiz generation and grading → Quiz generator: generates and grades
- Quiz sessions → External quiz portal: provides session
- External quiz portal → Quiz sessions: posts results
- Candidate → Quiz interface: takes quiz
- Quiz interface → API client: loads session
- Quiz interface → Backend API: starts or submits quiz
- Candidate → Pathway view: views pathway
- Pathway view → Backend API: requests pathway
- Pathway orchestration → ML HTTP client: requests pathway generation
- Pathway generation → Adaptive engine: generates adaptive path
- Authentication → Database sessions: reads and writes users
- Database sessions → User and learning records: uses records
- Database sessions → PostgreSQL: reads and writes