abhi-148/up-student-ai-copilot

1. This is a single-page React application built with Vite. The runtime entry points are src/main.jsx and src/App.jsx, with global styling coming from src/index.css, src/App.css, Tailwind config, and the custom src/styles/glass.css theme layer.

2. The app is organized primarily as a route-driven product experience. The src/pages directory holds the top-level screens, while src/components contains reusable UI and domain widgets that are composed into those screens. For an architecture diagram, treat pages as the boundary between navigation-level views and components as the presentation/service widgets underneath them.

3. The product domain is education and career guidance, not a generic dashboard. The page set shows distinct workflows for students, parents, admins, schools, coaching institutes, and district-level intelligence. That makes the application more like a multi-tenant decision-support portal than a simple consumer app.

4. The student journey appears to start at onboarding and welcome/login flows, then move into planning and decision screens such as Dashboard, StudentOnboarding, CareerMap, CareerMapAfter9th, AIDailyTimetable, StudyProgress, and StudentPlanner. These screens likely feed recommendation and progress-tracking components for daily and long-term guidance.

5. The parent-facing area is separate and summarized through ParentView and ParentWeeklySummary, with supporting notification and planning widgets. This suggests a secondary read-only/oversight experience layered over the student guidance data, rather than a fully independent parent workflow.

6. The admin and institution side is also explicitly modeled. Pages like AdminDashboard, AdminLogin, InstituteSelect, CoachingAnalytics, CoachingComparison, SchoolLeaderboard, and DistrictTrustScore indicate management and comparison flows for schools/coaching institutes, with KPI-style metrics and trust/ROI analysis.

7. A major subsystem is the “AI / decision engine” feature set in src/components. Components such as CareerDecisionEngine, BestInstituteMatch, InstituteComparisonAI, DistrictCareerScore, DistrictHeatmap, AIInsight, AIRecommendation, AISimulation, SmartExamStrategy, and LocalAlternativeAI indicate a recommendation/scoring layer surfaced as UI modules. The repo does not show a dedicated backend ML service, so these appear to be front-end orchestration and visualization layers around heuristic or API-driven intelligence.

8. There is a clear data boundary between static/reference content and dynamic UI. src/data/schools.js and src/data/coachings.jsx hold domain datasets that likely power comparison, scoring, and listing screens. This makes the app partially data-driven even without a visible database layer in the repository.

9. External communication is abstracted behind src/services/api.js. That file is the main architectural seam for backend or third-party calls, and it is the likely integration point for authentication, AI responses, or fetched analytics. No other server code is present, so the frontend is the visible system and the API layer is the outbound boundary.

10. Internationalization is built into the UI architecture. src/context/LanguageContext.jsx and src/utils/i18n.js, plus the LanguageToggle component, show that language selection is a shared cross-cutting concern affecting many screens. In a diagram, this should be shown as a context/provider layer feeding text and labels across the app.

11. Navigation and shell components form the app scaffold: Navbar, TopNav, Sidebar, NotificationPanel, FocusMode, and StatCard provide persistent layout and common interaction patterns. These components are reused across pages to keep the experience consistent while the main content changes by workflow.

12. Overall, the architecture is a frontend-only, modular React portal with three main layers: route pages, reusable domain widgets, and shared context/service utilities. The key data flow is: static/reference data and API responses feed the decision/recommendation components, which then render persona-specific views for students, parents, institutions, and district administrators.