How srideep-kundu/skill_passport_project works
Skill Passport is a multi-role platform for building evidence-backed skill profiles and connecting candidates with opportunities. The central workflow is evidence submission, asynchronous skill extraction and verification, then reproducible, explainable matching that supports discovery and applications. Recruiter assessment and analytics, learning and career guidance, and institution and academician tools are additional product branches. The excerpts confirm API registration, extraction-worker dispatch, and application workflow calls; other subsystem links are limited to documented behavior and the repository’s module structure.
Main entry points: main.py FastAPI Entry · db.py PostgreSQL + pgvector · extraction_service.py Skill Extraction · App.tsx Role Dashboards
Components 24
User Experience
- Role Dashboards
frontend/src/App.tsx - API Client
frontend/src/api/service.ts - FastAPI Entry
backend/app/main.py - Authentication
backend/app/api/auth.py
Evidence and Passport
- Evidence Intake
backend/app/api/evidence.py - Skill Extraction
backend/app/services/extraction_service.py - Extraction Worker
backend/app/workers/extraction_worker.py - Redis Queue
- Skill Passport
backend/app/api/passport.py - Evidence Verification
backend/app/services/verification_service.py - PostgreSQL + pgvector
backend/app/core/db.py
Matching and Opportunities
- Explainable Matching
backend/app/services/matching_service.py - Match APIs
backend/app/api/matches.py - Job Discovery
backend/app/services/discovery_service.py - Applications
backend/app/api/applications.py
Role Portals
- Project Assessment
backend/app/services/project_assessment_service.py - Career and Learning
backend/app/services/career_guidance_service.py - Institution Analytics
backend/app/services/institution_analytics_service.py
Other components
- Candidate
- Recruiter
- Institution / Faculty
- Job Providers
- GitHub
- Extraction Models
Connections 27
- Candidate → Role Dashboards: uses
- Recruiter → Role Dashboards: uses
- Institution / Faculty → Role Dashboards: uses
- Role Dashboards → API Client: requests
- API Client → FastAPI Entry: calls
- FastAPI Entry → Authentication: registers
- FastAPI Entry → Evidence Intake: registers
- FastAPI Entry → Skill Passport: registers
- FastAPI Entry → Match APIs: registers
- FastAPI Entry → Applications: registers
- FastAPI Entry → PostgreSQL + pgvector: initializes
- Evidence Intake → Skill Extraction: schedules
- Skill Extraction → Redis Queue: enqueues
- Extraction Worker → Redis Queue: dequeues
- Extraction Worker → Skill Extraction: processes jobs
- Skill Extraction → Extraction Models: requests extraction
- Skill Extraction → PostgreSQL + pgvector: persists skills
- Evidence Verification → PostgreSQL + pgvector: updates evidence
- Skill Passport → PostgreSQL + pgvector: reads passport
- Match APIs → Explainable Matching: requests scores
- Explainable Matching → PostgreSQL + pgvector: reads inputs
- Job Discovery → Job Providers: fetches listings
- Applications → PostgreSQL + pgvector: reads and writes
- Recruiter → Project Assessment: requests assessment
- Project Assessment → GitHub: scans repository
- Candidate → Career and Learning: uses guidance
- Institution / Faculty → Institution Analytics: uses analytics