SmartStudy AI

SmartStudy AI is a learning platform blueprint for students, focused on:

• automatic study planning
• progress tracking
• smart review with flashcards/quizzes
• focus support with Pomodoro and gamification

Core Value

• Helps learners avoid last-minute cramming.
• Shows weak subjects clearly through dashboard analytics.
• Manages multiple subjects in one consistent workflow.
• Builds daily motivation with XP, levels, badges, and leaderboards.

Main Features

1. Smart Dashboard

• Subject progress charts.
• Weekly and monthly task completion rates.
• Upcoming deadline alerts.

2. AI Study Planner

• Enter course or exam deadlines.
• Automatically splits tasks by remaining time.
• Rebalances the plan if users miss sessions.

3. Flashcard and Quiz Generator

• Upload study materials (PDF).
• Generate flashcards and multiple-choice questions.
• Track accuracy by topic.

4. Pomodoro Focus Mode

• Focus/break timer.
• Daily focused session tracking.
• Weekly study time summary.

5. Gamification

• XP, levels, and badges.
• Class or study-group leaderboard.

Proposed Architecture

Frontend (Angular 19)

• Standalone components.
• Angular Signals for local/reactive UI state.
• Lazy-loaded routes by feature.
• Angular Material or Tailwind CSS.
• Guards and interceptors for security and API flow.
• Optional SSR for SEO.

Backend (suggested)

• NestJS (Node.js).
• MongoDB or PostgreSQL.
• Firebase Authentication.
• OpenAI API for intelligent quiz/flashcard generation.
• WebSocket for real-time progress sync.

Current Repository Structure

• smartstudy-ai/

• Active Angular CLI workspace (single maintained app codebase).

• App shell, routes, feature components, and services.

• docs/architecture.md

• Business flow, data schema, and implementation roadmap.

• Archived/

• Legacy source code kept for reference.

Run the App (Single Source of Truth)

Use only one codebase for maintenance: smartstudy-ai/.

First-time setup (one time)

npm install -g @angular/cli
ng new smartstudy-ai --routing --style=scss
cd smartstudy-ai
npm install
ng serve

Next runs

cd smartstudy-ai
ng serve

Keep smartstudy-ai/ as the only active app code.

Monetization Model

• Freemium: limited subjects and limited AI quiz generations.
• Individual Premium: unlimited AI usage and advanced analytics.
• School plan: class dashboard, teacher management, and term reports.