System Requirements Document (SRD) for Project cosmic-neet

1. Introduction

The cosmic-neet project is designed to empower students in India, like Meghna Ranga, to achieve significant improvements in their NEET exam preparation within a short timeframe. This document outlines the system requirements for creating a personalized, interactive, and visually engaging platform that provides strategic guidance, time management tools, and motivational support for students aiming to excel in NEET.

This SRD incorporates Meghna's specific request for guidance on how to make the most of her time after a challenging day, emphasizing the need for a system that adapts to real-time user emotions and situations.

2. System Overview

The cosmic-neet platform will serve as a digital companion for NEET aspirants, offering:

• Personalized study plans and time management strategies.
• Real-time motivational support and adaptive guidance.
• Interactive tools for mock tests, analysis, and quick revisions.
• A visually engaging and calming interface to reduce stress and enhance focus.

The system will cater to students in India, considering local academic standards, time zones (IST), and cultural nuances. It will integrate AI-driven features to provide dynamic responses and tailored recommendations based on user input.

3. Functional Requirements as Story Points

• As a User, I should be able to receive personalized study plans based on my current time and emotional state.
• As a User, I should be able to access quick revision tools for high-weightage topics in Biology, Physics, and Chemistry.
• As a User, I should be able to take full-length mock tests with time-bound constraints.
• As a User, I should be able to analyze my mock test performance and identify weak areas.
• As a User, I should be able to receive motivational tips and strategies to stay focused after a bad day.
• As a User, I should be able to track my daily progress and achievements to maintain consistency.
• As a User, I should be able to access a calming and visually appealing interface to reduce stress.

4. User Personas

4.1 Student

• Description: A NEET aspirant like Meghna, who is highly motivated but occasionally struggles with time management, stress, and maintaining consistency.
• Needs:
  • Personalized study plans and real-time guidance.
  • Tools for quick revisions and mock test analysis.
  • Emotional support and motivational tips.
• Goals:
  • Achieve a significant score improvement in NEET within a short timeframe.
  • Stay consistent and focused despite challenges.

5. Visuals Colors and Theme

The cosmic-neet platform will feature a unique color palette designed to evoke calmness, focus, and motivation. The colors are inspired by the cosmos, symbolizing limitless potential and exploration.

Color Palette

• Background: #0B132B (Deep Space Blue)
• Surface: #1C2541 (Midnight Navy)
• Text: #F0F3F5 (Soft Moonlight White)
• Accent: #FF6F61 (Cosmic Coral)
• Muted Tones: #3A506B (Nebula Gray)

This palette creates a serene yet inspiring atmosphere, helping users stay calm and motivated during their study sessions.

6. Signature Design Concept

Interactive Cosmic Journey Homepage

The homepage of cosmic-neet will feature an immersive, interactive cosmic journey. Upon landing on the page, users will see a 3D galaxy map with glowing stars, each representing a key feature or section of the platform (e.g., Study Plans, Mock Tests, Quick Revisions, Motivational Tips).

• Animations:
  • Stars will twinkle subtly, and constellations will form as users hover over different sections.
  • Clicking on a star will zoom in, revealing a detailed view of the selected feature.
• Transitions:
  • Smooth, fluid transitions between sections, with a "warp speed" effect to simulate traveling through space.
• Micro-Interactions:
  • When users complete a task (e.g., finishing a mock test), a new star will light up, symbolizing their progress and achievements.
• Color Shifts:
  • The background will subtly shift hues (e.g., from Deep Space Blue to Nebula Gray) based on the time of day, creating a dynamic and immersive experience.

This design will make the platform visually captivating and reinforce the theme of exploration and growth.

7. Non-Functional Requirements

• Performance: The system should load within 3 seconds on a standard 4G connection.
• Scalability: The platform must support up to 1 million concurrent users during peak NEET preparation periods.
• Availability: The system should have 99.9% uptime to ensure uninterrupted access.
• Security: User data, including progress and performance metrics, must be securely stored and encrypted.
• Localization: The platform should support Indian academic standards and be available in English and Hindi.

8. Tech Stack

Frontend

• React for Web
• React Native for Mobile App

Backend

• Python
• FastAPI

Database

• MySQL (with Alembic for migrations)

AI Models

• GPT 5.4 for user-friendly responses
• Claude 4.6 Opas for academic or coding work
• Google Nano Banana for image generation

AI Tools

• Litellm for LLM Routing
• Langchain

Orchestration

• Docker
• Kubernetes

9. Assumptions and Constraints

Assumptions

• Users will have access to a stable internet connection.
• The primary user base will be Indian students preparing for NEET.
• Users will primarily access the platform via mobile devices.

Constraints

• The system must comply with Indian data protection laws.
• The platform must be optimized for low-end devices to ensure accessibility.

10. Glossary

• NEET: National Eligibility cum Entrance Test, an entrance exam for medical colleges in India.
• Mock Test: A practice test designed to simulate the actual NEET exam.
• NCERT: National Council of Educational Research and Training, whose textbooks are the standard for NEET preparation.
• AI: Artificial Intelligence, used in the platform for personalized guidance and support.
• IST: Indian Standard Time, the time zone for the platform's scheduling features.