How rithusona35-cpu/ncct-ecosystem works
NCCT is a closed-loop skills-to-employment ecosystem: learners progress from physical training and attendance through LMS learning, assessment, skill-gap diagnosis, remedial recommendations, and a verifiable skill passport; employers match and hire candidates, then provide placement feedback that informs curriculum updates. The graph includes the sampled API, data, and intelligence layers plus major README-documented capabilities. Several frontend pages and integrations were not sampled, so undocumented implementation links are omitted.
Main entry points: lms.py Courses and LMS · assessment.py Competency Assessment · main.py FastAPI Gateway · attendance.py Attendance
Components 27
Web Portals
- Trainee Portal
frontend/src/app/trainee/courses/page.tsx - Trainer Portal
frontend/src/app/trainer/programmes/page.tsx - Employer Portal
frontend/src/app/employer/matches/page.tsx - Admin Portal
frontend/src/app/admin/dashboard/page.tsx - Session and Access
frontend/src/context/AuthContext.tsx
API and Domain
- FastAPI Gateway
backend/app/main.py - Authentication
backend/app/routers/auth.py - Attendance
backend/app/routers/attendance.py - Courses and LMS
backend/app/routers/lms.py - Competency Assessment
backend/app/routers/assessment.py - Skill Passport
backend/app/services/skill_passport_service.py - Certificates
backend/app/services/certificate_service.py - Media Storage
backend/app/services/storage_service.py - Relational Database
backend/app/database.py - Domain Models
backend/app/models.py
Skills Intelligence
- Employer Matching
backend/app/services/employer_matching_service.py - Skill-Gap Engine
backend/app/services/skill_gap_engine.py - Remedial Recommendations
backend/app/routers/skill_gap.py - Placement Feedback
backend/app/services/feedback_analytics.py - Curriculum Intelligence
backend/app/services/admin_stats_service.py - Career Guidance RAG
ai-engine/query.py - Gemini Client
ai-engine/gemini_client.py
Training Edge
- ESP32 Training Node
firmware/esp32_kiosk/config.h
Other components
- Trainee
- Trainer
- Employer
- Administrator
Connections 32
- FastAPI Gateway → Authentication: routes to
backend/app/main.py - FastAPI Gateway → Attendance: routes to
backend/app/main.py - FastAPI Gateway → Courses and LMS: routes to
backend/app/main.py - FastAPI Gateway → Competency Assessment: routes to
backend/app/main.py - Authentication → Relational Database: queries users
backend/app/routers/auth.py - Attendance → Relational Database: records attendance
backend/app/routers/attendance.py - Courses and LMS → Relational Database: records progress
backend/app/routers/lms.py - Competency Assessment → Relational Database: stores results
backend/app/routers/assessment.py - Competency Assessment → Certificates: issues
backend/app/routers/assessment.py - Certificates → Media Storage: uploads PDFs
backend/app/services/certificate_service.py - Skill-Gap Engine → Remedial Recommendations: recommends learning
backend/app/routers/skill_gap.py - Employer Matching → Skill-Gap Engine: uses skill scores
backend/app/routers/employer.py - Admin Portal → Curriculum Intelligence: views intelligence
frontend/src/app/admin/dashboard/page.tsx - Curriculum Intelligence → Placement Feedback: aggregates feedback
backend/app/services/admin_stats_service.py - Session and Access → Authentication: verifies session
frontend/src/context/AuthContext.tsx - Trainee → ESP32 Training Node: scans badge
README.md - ESP32 Training Node → Attendance: syncs attendance
README.md - Trainee → Trainee Portal: uses portal
README.md - Trainer → Trainer Portal: uses portal
README.md - Employer → Employer Portal: uses portal
README.md - Administrator → Admin Portal: uses portal
README.md - Attendance → Courses and LMS: tracks learning
README.md - Courses and LMS → Competency Assessment: measures skills
README.md - Competency Assessment → Skill-Gap Engine: informs diagnosis
README.md - Skill-Gap Engine → Remedial Recommendations: guides remediation
README.md - Remedial Recommendations → Skill Passport: builds competencies
README.md - Skill Passport → Employer Matching: supports matching
README.md - Employer Matching → Employer: surfaces candidates
README.md - Employer → Placement Feedback: reports outcomes
README.md - Placement Feedback → Curriculum Intelligence: informs upgrades
README.md - Career Guidance RAG → Gemini Client: generates guidance
- Courses and LMS → Media Storage: serves media