EdTech/AI · Full-Stack AI Web Application
Smart Study Companion
An AI-first educational platform integrating RAG architecture, LLM orchestration, and full-stack development to modernize student study workflows.
System Flow & Architecture
Real System Boundaries
1. Frontend is a browser-based SPA responsible for UI rendering, route handling, local state, and authenticated API calls.
2. Backend is a Node.js/Express API that owns business logic, request validation, authentication, AI orchestration, and response formatting.
3. MongoDB stores persistent domain data (users, courses, GPA inputs, session history, and generated study artifacts metadata).
4. AI providers are external dependencies invoked by backend services, not directly by the frontend.
Backend Internal Architecture
End-To-End Data Flows
Authenticated Read Flow
AI Learning Flow
Security And Trust Model
1. Authentication uses JWT with client-side token storage.
2. Frontend sends token through request headers (x-auth-token) via API layer.
3. Protected routes enforce identity in backend middleware before controller execution.
4. AI and external API keys are server-side only and loaded from environment variables.
Why This Architecture Works
1. Clear separation of concerns: UI, API/business logic, and persistence are independently evolvable.
2. Service layer centralizes complex logic (GPA math, AI prompting, parsing) for reuse and testing.
3. External AI providers are abstracted behind backend endpoints, allowing provider changes without frontend rewrites.
4. Feature growth is manageable because frontend and backend are both organized by domain modules.
Key Features
- Retrieval-Augmented Generation (RAG) workflows
- AI syllabus parser to automate setup
- Adaptive quiz generation
- Master schedule planning engine
- Comprehensive GPA tracking
- Hybrid AI orchestration (Groq + Gemini)