How yashwinbuilds/kcet-college-predictor works
KCET College Predictor is a counseling and college-discovery platform for Karnataka exam aspirants. Its main workflow combines live college data with a rank, category, and preference-based predictor to produce safe, moderate, and dream college options; users can save choices and explore them further. Other substantial product areas include a mock allotment simulator, commute mapping, trends, chat, and community features. The README documents version-checked user data sync and a live master view for administrators. Some feature paths are evident from the tree and README, but their internal wiring was not sampled, so those connections are omitted.
Main entry points: predictor/page.tsx Smart Predictor · useWishlist.ts Wishlist · commute/page.tsx Commute Planner · CollegeContext.tsx College Data Context
Components 25
College Discovery
- Home Explorer
src/app/page.tsx - Smart Predictor
src/app/predictor/page.tsx - Prediction Engine
src/lib/predictor.ts - Cutoff Explorer
src/app/cutoffs/page.tsx - Rank Predictor
src/app/rank-predictor/page.tsx - College Compare
src/app/compare/page.tsx - Commute Planner
src/app/commute/page.tsx - Map View
src/components/Map.tsx - Transit Data
src/lib/data/metro_connectivity.ts - Trends Explorer
src/app/trends/page.tsx
Data and Sync
- College Data Context
src/lib/contexts/CollegeContext.tsx - Cloud Firestore
- Firebase Client
src/lib/firebase.ts
Counseling and Community
- Mock Simulator
src/app/simulator/page.tsx - Wishlist
src/lib/hooks/useWishlist.ts - Social Matches
src/lib/hooks/useSocialMatches.ts - Messages
src/app/messages/page.tsx - Chat Service
src/lib/services/chat.ts - AI Chat API
src/app/api/chat/route.ts - Application Tracker
src/app/tracker/page.tsx - Community
src/app/community/page.tsx
Access and Administration
- Admin Console
src/app/admin/page.tsx - Authentication Context
src/lib/contexts/AuthContext.tsx - Sign-in Modal
src/components/AuthModal.tsx
Other components
- KCET Aspirant
Connections 24
- KCET Aspirant → Home Explorer: opens
README.md - KCET Aspirant → Smart Predictor: submits preferences
README.md - Smart Predictor → Prediction Engine: calculates predictions
src/app/predictor/page.tsx - Smart Predictor → College Data Context: reads live colleges
src/app/predictor/page.tsx - Smart Predictor → Wishlist: uses saved choices
src/app/predictor/page.tsx - Smart Predictor → Sign-in Modal: opens sign-in
src/app/predictor/page.tsx - Sign-in Modal → Authentication Context: invokes sign-in
src/components/AuthModal.tsx - College Data Context → Firebase Client: uses client
src/lib/contexts/CollegeContext.tsx - Firebase Client → Cloud Firestore: initializes database
src/lib/firebase.ts - Admin Console → Cloud Firestore: reads and writes master data
src/app/admin/page.tsx - Admin Console → College Data Context: uses data context
src/app/admin/page.tsx - KCET Aspirant → Mock Simulator: runs mock counseling
README.md - Mock Simulator → Cloud Firestore: saves simulation state
src/app/simulator/page.tsx - KCET Aspirant → Commute Planner: plans travel
src/app/commute/page.tsx - Commute Planner → Map View: renders map
src/app/commute/page.tsx - Commute Planner → Transit Data: reads transit data
src/app/commute/page.tsx - Cutoff Explorer → Prediction Engine: uses predictions
src/app/cutoffs/page.tsx - Wishlist → Authentication Context: reads user state
src/lib/hooks/useWishlist.ts - Wishlist → Cloud Firestore: syncs saved choices
src/lib/hooks/useWishlist.ts - Social Matches → Wishlist: uses wishlist
src/lib/hooks/useSocialMatches.ts - Social Matches → Cloud Firestore: queries profiles
src/lib/hooks/useSocialMatches.ts - Messages → Chat Service: uses chat service
src/app/messages/page.tsx - Chat Service → Cloud Firestore: uses client database
src/lib/services/chat.ts - AI Chat API → KCET Aspirant: serves chat requests