How ravishori/i-neet-exam-web works
TALOS is a FastAPI modular-monolith learning platform, with NEET as its first exam product. Its principal user flow is authentication, browsing the academic hierarchy and published content, taking timed practice or mock assessments, then reviewing performance through mastery and rule-based recommendations; AI tutoring and study planning are additional learning paths. Operators manage content through the CMS, including review and publication, and can ingest study materials into knowledge and content workflows. The README documents these capabilities, while sampled code gives implementation detail mainly for ingestion and CMS review; other wiring is shown only where supported by the documented module architecture.
Main entry points: main.py FastAPI application · content_workflow_service.py Content workflow · ingestion_router.py Ingestion API · assessment_router.py Assessment API
Components 24
Identity and access
- Auth API
apps/backend/app/modules/identity/api/auth_router.py - Authentication
apps/backend/app/modules/identity/services/auth_service.py
Academic content
- Academic browse
apps/backend/app/modules/academic/api/academic_router.py - Academic hierarchy
apps/backend/app/modules/academic/repositories/academic_repository.py - CMS API
apps/backend/app/modules/cms/api/cms_router.py - Content workflow
apps/backend/app/modules/cms/services/content_workflow_service.py - Content records
apps/backend/app/modules/cms/repositories/cms_repository.py - Ingestion API
apps/backend/app/modules/ingestion/api/ingestion_router.py - Source ingestion
apps/backend/app/modules/ingestion/services/source_ingestion_orchestration_service.py - Ingestion pipeline
apps/backend/app/modules/ingestion/services/ingestion_pipeline_service.py
Learning experience
- Assessment API
apps/backend/app/modules/assessment/api/assessment_router.py - Assessment engine
apps/backend/app/modules/assessment/services/assessment_service.py - Learning interactions
apps/backend/app/modules/learning/api/mastery_router.py - Mastery and recommendations
apps/backend/app/modules/learning/services/mastery_service.py - Student analytics
apps/backend/app/modules/analytics/services/analytics_service.py
AI services
- AI API
apps/backend/app/modules/ai/api/ai_router.py - Tutor and planner
apps/backend/app/modules/ai/services/tutor_service.py - AI provider gateway
apps/backend/app/modules/ai/gateway/ai_gateway.py
Operations and commerce
- Commerce API
apps/backend/app/modules/commerce/api/commerce_router.py - Order and payment
apps/backend/app/modules/commerce/services/commerce_service.py
Other components
- NEET aspirant
- Content operator
- FastAPI application
apps/backend/app/main.py - Razorpay
Connections 29
- NEET aspirant → FastAPI application: uses
- Content operator → FastAPI application: uses
- FastAPI application → Auth API: dispatches
- FastAPI application → Academic browse: dispatches
- FastAPI application → CMS API: dispatches
- FastAPI application → Ingestion API: dispatches
- FastAPI application → Assessment API: dispatches
- FastAPI application → Learning interactions: dispatches
- FastAPI application → AI API: dispatches
- FastAPI application → Commerce API: dispatches
- Auth API → Authentication: authenticates
- Academic browse → Academic hierarchy: browses hierarchy
- CMS API → Content workflow: manages content
- Content workflow → Content records: persists versions
- Content operator → Ingestion API: starts ingestion
- Ingestion API → Source ingestion: orchestrates
- Source ingestion → Ingestion pipeline: starts jobs
- Ingestion pipeline → Content workflow: creates drafts
- NEET aspirant → Assessment API: starts practice
- Assessment API → Assessment engine: scores attempts
- NEET aspirant → Learning interactions: records activity
- Learning interactions → Mastery and recommendations: updates mastery
- NEET aspirant → Student analytics: views scorecard
- NEET aspirant → AI API: requests coaching
- AI API → Tutor and planner: invokes agent
- Tutor and planner → AI provider gateway: routes generation
- NEET aspirant → Commerce API: creates order
- Commerce API → Order and payment: handles payment
- Order and payment → Razorpay: verifies payment