How debasmita-rana/vidhyanidhi-scholarship-website works
Vidhyanidhi is a scholarship discovery and administration application. Students create profiles, browse and compare scholarships, receive eligibility and AI recommendations, apply, and track application status; administrators maintain scholarships, review applications, and view analytics. The React app routes users to these workflows, while the Express API handles requests, applies authentication and role checks, and persists domain records in MongoDB. AI recommendations combine rule-based matching with generated explanations. Frontend-to-API request wiring is not shown in the excerpts, so those links are marked unverified.
Main entry points: App.jsx Web routes · server.js Express server · aiController.js AI endpoints · recommendationService.js Rule-based matching
Components 29
Student experience
- Web routes
Frontend/src/App.jsx - Profile management
Frontend/src/components/Profile.jsx - Scholarship discovery
Frontend/src/components/Scholarships.jsx - Scholarship details
Frontend/src/components/ScholarshipDetails.jsx - My applications
Frontend/src/components/MyApplications.jsx - Recommendations
Frontend/src/components/AIRecommendation.jsx - Scholarship chat
Frontend/src/components/AIChat.jsx - Scholarship comparison
Frontend/src/components/AIComparison.jsx
Administration
- Scholarship management
Frontend/src/components/ManageScholarships.jsx - Application review
Frontend/src/components/AdminApplications.jsx - Application details
Frontend/src/components/ApplicationDetails.jsx - Admin analytics
Frontend/src/components/AdminAnalytics.jsx
API and domain logic
- Express server
backend/server.js - Profile API
backend/controllers/profileController.js - Scholarship API
backend/controllers/scholarshipController.js - Application workflow
backend/controllers/applicationController.js - Analytics API
backend/controllers/analyticsController.js - Authentication API
backend/controllers/authController.js
Domain data
- Student profiles
backend/models/StudentProfile.js - Scholarships
backend/models/Scholarship.js - Applications
backend/models/Application.js - User accounts
backend/models/User.js
AI services
- AI endpoints
backend/controllers/aiController.js - Rule-based matching
backend/services/recommendationService.js - Eligibility rules
backend/utils/eligibilityChecker.js - Match scoring
backend/utils/calculateMatchScore.js - AI generation
backend/services/groqService.js
Other components
- Student
- Administrator
Connections 35
- Student → Web routes: uses
Frontend/src/App.jsx - Administrator → Web routes: uses
Frontend/src/App.jsx - Web routes → Profile management: routes to
Frontend/src/App.jsx - Web routes → Scholarship discovery: routes to
Frontend/src/App.jsx - Web routes → Scholarship details: routes to
Frontend/src/App.jsx - Web routes → My applications: routes to
Frontend/src/App.jsx - Web routes → Recommendations: routes to
Frontend/src/App.jsx - Web routes → Scholarship chat: routes to
Frontend/src/App.jsx - Web routes → Scholarship comparison: routes to
Frontend/src/App.jsx - Web routes → Scholarship management: routes to
Frontend/src/App.jsx - Web routes → Application review: routes to
Frontend/src/App.jsx - Web routes → Application details: routes to
Frontend/src/App.jsx - Web routes → Admin analytics: routes to
Frontend/src/App.jsx - Express server → Profile API: mounts routes
backend/server.js - Express server → Scholarship API: mounts routes
backend/server.js - Express server → Application workflow: mounts routes
backend/server.js - Express server → AI endpoints: mounts routes
backend/server.js - Express server → Analytics API: mounts routes
backend/server.js - Profile API → Student profiles: reads and writes
backend/controllers/profileController.js - Application workflow → Applications: reads and writes
backend/controllers/applicationController.js - Application workflow → Scholarships: checks scholarship
backend/controllers/applicationController.js - Application workflow → Student profiles: loads profile
backend/controllers/applicationController.js - Scholarship API → Scholarships: reads and writes
backend/controllers/scholarshipController.js - Authentication API → User accounts: reads and writes
backend/controllers/authController.js - AI endpoints → Student profiles: loads profile
backend/controllers/aiController.js - AI endpoints → Applications: loads application
backend/controllers/aiController.js - AI endpoints → Scholarships: loads scholarships
backend/controllers/aiController.js - AI endpoints → Rule-based matching: requests matches
backend/controllers/aiController.js - AI endpoints → AI generation: requests generation
backend/controllers/aiController.js - Rule-based matching → Student profiles: reads profile
backend/services/recommendationService.js - Rule-based matching → Scholarships: reads scholarships
backend/services/recommendationService.js - Rule-based matching → Eligibility rules: checks eligibility
backend/services/recommendationService.js - Rule-based matching → Match scoring: scores matches
backend/services/recommendationService.js - Student → Express server: submits requests
- Administrator → Express server: submits requests