System Requirements Document (SRD)

Project Name: sapphire-students

1. Introduction

The sapphire-students project is an innovative application designed to address the challenges faced by students in managing their study schedules effectively. Developed for students in India, this app leverages AI to create personalized study plans, track syllabus completion, send revision reminders, and integrate focus-enhancing tools like the Pomodoro timer.

This document outlines the system requirements for building the MVP (Minimum Viable Product) version of the sapphire-students application. The goal is to deliver a practical, user-friendly solution that directly improves academic performance while maintaining affordability through a subscription model priced between ₹149–₹299/month.

2. System Overview

The sapphire-students application is a smart study planner that empowers students to:

• Understand what to study, when to revise, and how to stay consistent.
• Use AI-driven tools to create daily study plans tailored to their syllabus.
• Track syllabus completion and receive timely revision reminders based on spaced repetition techniques.
• Enhance focus and productivity using an integrated Pomodoro timer with focus tracking.

The system will consist of:

• A mobile application (React Native) for students to interact with the features.
• A backend (Python with FastAPI) to handle AI logic, user data, and notifications.
• A database (MySQL or MariaDB) for storing syllabus details, progress, and reminders.

3. Functional Requirements

Core Features:

• As a Student, I should be able to input my syllabus details to generate a personalized study plan.
• As a Student, I should be able to mark topics as "Done" or "Pending" to track syllabus completion.
• As a Student, I should receive revision reminders based on spaced repetition techniques.
• As a Student, I should be able to use a Pomodoro timer integrated with focus tracking.
• As a Student, I should be able to subscribe to the app for ₹149–₹299/month.

Additional Features:

• As a Student, I should be able to register with my academic board (e.g., CBSE, ICSE) for tailored study plans.
• As a Student, I should be able to view analytics of my study progress (e.g., hours studied, topics completed).
• As a Student, I should be able to customize the app theme for a personalized experience.

4. User Personas

1. Student

• Description: Primary user of the app, typically aged 13–21, preparing for school or university exams.
• Goals: Improve academic performance, stay consistent with studies, and manage time effectively.
• Pain Points: Difficulty in planning studies, staying motivated, and revising effectively.

2. Admin

• Description: Backend user responsible for managing subscriptions, monitoring app performance, and ensuring smooth operations.
• Goals: Ensure app reliability, manage user data securely, and handle customer support.

5. Visuals Colors and Theme

Color Palette

The sapphire-students app will feature a vibrant yet calming color scheme to resonate with students and promote focus:

• Background: #F5F9FF (Soft Sky Blue)
• Surface: #FFFFFF (Pure White)
• Text: #2E3A59 (Deep Navy Blue)
• Accent: #FF6F61 (Warm Coral Red)
• Muted Tones: #D1D9E6 (Light Steel Blue)

6. Signature Design Concept

Concept: Interactive Study Galaxy

The homepage of sapphire-students will feature an Interactive Study Galaxy. Students will be greeted with a dynamic, animated galaxy where each star represents a subject or topic.

• Visuals:

  • Stars will glow and pulse gently, creating a calming effect.
  • Completed topics will shine brightly, while pending ones will appear dimmer.
  • Clicking on a star will zoom into a detailed view of the topic, showing progress, revision schedules, and Pomodoro stats.

• Animations:

  • Smooth transitions when zooming into stars.
  • A subtle parallax effect as users scroll through the galaxy.

• Micro-interactions:

  • Hovering over a star will display a tooltip with the topic name and completion percentage.
  • A playful "shooting star" animation will appear when a topic is marked as completed.

This design will make the app unforgettable and engaging, encouraging students to interact with their study plans regularly.

7. Non-Functional Requirements

• Performance: The app should load within 2 seconds on standard mobile devices.
• Scalability: The backend should support up to 100,000 users concurrently.
• Security: User data must be encrypted and comply with GDPR and Indian data protection laws.
• Availability: The app should maintain 99.9% uptime.
• Localization: Support for English and Hindi languages.

8. Tech Stack

Frontend

• React Native for mobile application development.

Backend

• Python with FastAPI for API development.

Database

• MySQL or MariaDB for relational data (syllabus, progress tracking).
• MongoDB for storing unstructured data (e.g., user preferences).

AI Models

• GPT 5.4 for user-friendly responses.
• Claude 4.6 Opas for academic or coding assistance.
• Google Nano Banana for generating visual content.

AI Tools

• Litellm for LLM routing.
• Langchain for AI workflow orchestration.

Orchestration

• Docker and docker-compose for local development.
• Kubernetes for server-side orchestration.

9. Assumptions and Constraints

Assumptions

• Students will have access to smartphones and internet connectivity.
• The app will initially target Indian students preparing for CBSE and ICSE board exams.
• Subscription pricing will remain affordable (₹149–₹299/month).

Constraints

• Limited budget for MVP development.
• The app must comply with Indian data protection laws.
• AI models must be optimized to run efficiently on mobile devices.

10. Glossary

• MVP: Minimum Viable Product, the simplest version of the app with core features.
• Pomodoro Timer: A time management tool that breaks work into intervals, typically 25 minutes, separated by short breaks.
• Spaced Repetition: A learning technique that involves reviewing material at increasing intervals to enhance memory retention.
• GDPR: General Data Protection Regulation, a legal framework for data protection and privacy.