System Requirements Document for askkushal

1. Introduction

AskKushal Study AI is a production-ready, ultra-modern, cinematic 3D global education website for learners, exam candidates, educators, and platform operators. It replaces all prior AskRohit and digital-marketing-agency content with education, learning, AI study tools, courses, academic productivity, exam practice, activities, analytics, and gamification.

The product brand is AskKushal Study AI.

• Tagline: “Learn Without Limits.”
• Supporting line: “Your AI-powered global study universe.”
• Hero learning statement: “Learn, practice, revise and master almost anything with AI-powered study tools.”

The system shall provide a futuristic global study experience that combines subject discovery, course exploration, interactive study tools, daily learning activities, AI Tutor integration readiness, exams, dashboard analytics, achievements, streaks, leaderboard presentation, pricing, and contact delivery.

2. System Overview

AskKushal Study AI shall be delivered as a responsive first-party web experience built with HTML5, CSS3, Vanilla JavaScript ES6+, Three.js, GSAP, GSAP ScrollTrigger, Lenis, and Font Awesome CDN. It shall be usable from index.html or a simple local server, subject to PHP server requirements for contact email delivery.

The platform shall provide the following current public destinations:

1. Home
2. Subjects
3. Courses
4. Study Tools
5. Activities
6. AI Tutor
7. Exams
8. Dashboard
9. Pricing
10. About
11. Contact
12. Privacy
13. Terms

The experience shall be dark, premium, futuristic, cinematic, interactive, and education-focused. It shall not contain old AskRohit, marketing-agency, lorem ipsum, fake backend, fake AI, fake payment, broken-link, dead-button, stock-photo, downloaded SVG, or downloaded illustration content.

Platform coverage claims shall be presented as conceptual platform coverage, not as live database counts unless real connected data exists:

• 5000+ Subjects
• 4500+ Courses
• 1000+ Languages
• 40+ Countries

2a. Product Interpretation and Delivery Boundary

AskKushal Study AI is a client-side educational product experience with selected server integration points.

• The site shall provide real frontend interactions for study tools, activities, timers, calculators, filters, scoring, progress, restart actions, and result states.
• The AI Tutor interface shall provide an authentic integration-ready chat surface but shall not generate fabricated AI answers.
• API keys, private tokens, passwords, database credentials, and AI provider secrets shall never be placed in frontend code.
• Payment buttons shall be integration-ready only and shall not simulate payment completion.
• Contact form delivery shall use server/contact.php and PHP mail() to send to kushal3011official@gmail.com.
• The contact form shall explain and gracefully handle the fact that PHP mail delivery cannot work from file:// and requires a PHP-capable server.
• Dashboard, leaderboard, achievements, testimonials, and fixed learner metrics shall be explicitly labelled Sample Data or Demo Data until real user data is connected.
• WebGL-dependent scenes shall provide a CSS fallback when WebGL is unavailable.
• The site shall be public and no application-owned sign-in, registration, profile management, or permission model is required by the current scope. “Sign In” is a visible navigation control reserved for future identity integration and shall not falsely claim authentication functionality.

2b. Page Content and Component Coverage

Home

• Information and state
  • Cinematic AskKushal/STUDY AI loader.
  • Home navigation, glass navbar, mobile menu, hero experience, language selector, global education globe, How It Works sequence, testimonials, technology section, footer.
  • Public, anonymous access.
• Primary actions
  • Navigate to Subjects, Courses, Study Tools, Activities, AI Tutor, Exams, Pricing, About, Contact, Privacy, and Terms.
  • Activate Start Learning, Explore Subjects, Ask AI, Get Started, Sign In, language selection, prompt suggestions, globe country points, and footer links.
• Hero universe
  • Display “ASKKUSHAL STUDY AI”.
  • Display “LEARN WITHOUT LIMITS.”
  • Display the required supporting learning statement.
  • Display coverage claims: 5000+ Subjects, 4500+ Courses, 1000+ Languages, and 40+ Countries.
  • Include Start Learning, Explore Subjects, and Ask AI controls.
  • Include a prompt bar reading “What do you want to learn today?”
  • Include prompt examples: Explain photosynthesis; Create nursing MCQs; Teach calculus; Summarize this chapter; Explain in Gujarati; Create flashcards; Make a study plan.
• Language and global education
  • Display “LEARN IN YOUR LANGUAGE”.
  • Provide a selector with English, Hindi, Gujarati, Spanish, French, German, Arabic, Japanese, Chinese, Portuguese, Italian, and Korean.
  • Present 1000+ languages as a conceptual platform-coverage claim without claiming full implementation for every language.
  • Provide a geometry-only Three.js globe with glowing points representing 40+ countries and click-to-open learning-information panels.
• How It Works
  • Present the flow: 1 Choose, 2 Ask, 3 Learn, 4 Practice, 5 Master.
• Testimonials and technology
  • Show floating glass testimonial cards using initials, procedural avatars, and Font Awesome icons only.
  • Mark all unverified testimonials as Sample/Demo.
  • Display “POWERED BY MODERN TECHNOLOGY” with icons for AI, HTML5, CSS3, JavaScript, Three.js, Cloud, APIs, Security, Analytics, and Database.
• States and recovery
  • Show cinematic WebGL loader when available.
  • Show CSS-only rotating ring, counter, and loader fallback if WebGL is unavailable.
  • Reduce animated effects on mobile, low-power devices, and reduced-motion environments.
  • Maintain working navigation if Three.js, animation, or scroll enhancement is unavailable.

Subjects

• Information and state
  • Interactive 3D subject universe and searchable subject/course/topic data.
  • Public access.
• Primary actions
  • Hover or focus subject nodes to reveal information.
  • Click or activate subject nodes to reveal a glass subject-detail panel.
  • Search subjects, courses, and topics.
  • Apply filters.
• Subject coverage
  • Include Nursing, Medicine, Biology, Chemistry, Physics, Mathematics, Engineering, Computer Science, Psychology, Business, Economics, Accounting, Law, History, Geography, Literature, Languages, Arts, Science, and more.
• Search and filtering
  • Display “WHAT DO YOU WANT TO MASTER?”
  • Support frontend filtering over available frontend data by Subject, Course, Country, Language, Education Level, Difficulty, and Duration.
  • Academic levels shall include Primary, Secondary, Higher Secondary, Diploma, Undergraduate, Postgraduate, Professional, and Competitive Exams.
• States and recovery
  • Show matching frontend data after query/filter changes.
  • Show an accessible no-results state when no available frontend records match.
  • Permit filters to be cleared or adjusted to continue discovery.

Courses

• Information and state
  • Futuristic course explorer representing 4500+ course coverage conceptually.
  • Public access.
• Primary actions
  • Browse categories, inspect course cards, filter available frontend data, and activate Start controls.
• Course categories
  • Nursing, Medical, Engineering, Science, Technology, Business, Commerce, Arts, Languages, Professional Skills, and Competitive Exams.
• Course card content
  • Title, subject, level, duration, lessons, difficulty, language, progress, and Start button.
  • No image-based course artwork.
• States and recovery
  • Start controls shall lead to the related available study or practice continuation without pretending that enrollment or backend course tracking is complete.
  • Course progress shown without real account data shall be clearly labelled Sample/Demo.
  • Show an empty state for unmatched course filters.

Study Tools

• Information and state
  • A tool workspace containing interactive client-side study utilities.
  • Public access.
• Primary actions
  • Select a tool and use its applicable modal, input/output surface, calculator, timer, tab, filter, editor, planner, or result view.
• Required tools
  • AI Tutor entry point.
  • AI Question Solver.
  • Notes / Smart Notes.
  • Smart Summarizer.
  • Flashcards.
  • Quiz Generator.
  • MCQ Generator.
  • Exam Generator.
  • Study Planner.
  • Pomodoro Timer.
  • Formula Sheet.
  • Dictionary.
  • Translation / Translator.
  • Grammar Checker.
  • Citation Helper.
  • PDF Study Tool.
  • Mind Map.
  • Revision Planner.
  • Progress Tracker.
  • Question Bank.
  • Calculator.
  • Unit Converter.
  • Scientific Calculator.
  • Stopwatch.
  • Timer.
  • To-Do List.
  • Habit Tracker.
  • Daily Goals.
• Component responsibilities
  • Every listed tool shall expose a meaningful frontend interaction; no tool control may be dead.
  • AI-dependent tools shall provide input, configuration, and integration-ready response areas but shall not create fake AI output.
  • Timers, stopwatch, Pomodoro, calculators, converters, to-do lists, goals, filters, tabs, note editing, flashcard interaction, planning views, and non-AI practice interactions shall function in the frontend.
• States and recovery
  • Show validation guidance for missing or invalid required input.
  • Show empty states before user input.
  • Preserve the ability to reset, clear, restart, change tabs, or select a different tool.
  • Clearly state that genuine AI output requires server-side AI API configuration.

Activities

• Information and state
  • Dedicated Daily Learning Activities area.
  • Public access.
• Primary actions
  • Launch, answer, score, time, progress through, restart, and complete activities.
• Required activities
  • Daily Quiz.
  • Daily Challenge.
  • Brain Trainer.
  • Rapid MCQ.
  • Flashcard Battle.
  • Memory Test.
  • Match the Answer.
  • True/False Challenge.
  • Fill in the Blank.
  • Speed Math.
  • Vocabulary Practice.
  • Concept of the Day.
  • Question of the Day.
  • Study Streak.
  • Focus Session.
  • Random Practice.
• Component responsibilities
  • Each activity shall use real frontend logic.
  • Each activity shall provide scoring, timing where applicable, progress indication, restart functionality, and a result screen.
• States and recovery
  • Display active, paused where applicable, complete, result, and restart states.
  • Provide an answer-feedback state where applicable.
  • Permit a learner to retry or choose another activity after results.

AI Tutor

• Information and state
  • Premium AI Tutor chat interface.
  • Public access.
• Primary actions
  • Enter a prompt, choose subject, choose language, choose mode, send, and use example prompts.
• Required controls
  • Message area.
  • Text input.
  • Send control.
  • Subject selector.
  • Language selector.
  • Modes: Beginner, Student, Advanced, Expert.
  • Example prompts.
• Component responsibilities
  • Provide clean, documented integration points for a real server-side AI API.
  • Never expose frontend API keys.
  • Never present fabricated AI messages as real responses.
• States and recovery
  • Before API configuration, explain that live AI responses are unavailable until a secure server-side integration is configured.
  • Validate empty messages.
  • Show safe service-unavailable or request-failed messaging without exposing stack traces, secrets, or internal errors.
  • Allow the learner to edit, resend, or change subject, language, and mode.

Exams

• Information and state
  • Exam Center for school, university, nursing, medical, engineering, and competitive-exam preparation.
  • Public access.
• Primary actions
  • Choose exam context, launch practice, answer questions, use timed sessions, review results, and inspect performance analysis.
• Required exam interfaces
  • Mock Test.
  • MCQ Test.
  • Timed Exam.
  • Practice Set.
  • Revision Plan.
  • Exam Result.
  • Performance Analysis.
• States and recovery
  • Provide question, response, timer where applicable, completion, result, restart, and review states.
  • Permit learners to restart or select another test after results.
  • Clearly label fixed analytics as Sample/Demo where no real learner account data exists.

Dashboard

• Information and state
  • Student dashboard using CSS/JavaScript charts, bars, progress rings, and graphs.
  • Public access.
  • All fixed values shall be labelled Sample Data or Demo Data until connected to real user data.
• Primary actions
  • Inspect learning metrics, progress, strengths, weaknesses, revision state, activities, streaks, badges, goals, and leaderboard presentation.
  • Activate Continue Learning and Today’s Goal.
• Required dashboard metrics
  • Study Hours.
  • Courses Completed.
  • Questions Solved.
  • Quiz Score.
  • Current Streak.
  • Learning Progress / Progress.
  • Strong Areas / Strong Topics.
  • Weak Areas / Weak Topics.
  • Revision Status.
  • Activity Calendar.
• Gamification coverage
  • Daily streak.
  • XP/points.
  • Daily goal.
  • Progress ring.
  • Leaderboard for points, streaks, quizzes, and activities.
  • Achievement badge cards for Daily Streak, Quiz Master, Fast Learner, Course Finisher, Night Study, 7-Day Streak, 30-Day Streak, and subject milestones.
• States and recovery
  • Clearly distinguish demo/sample metrics from connected account data.
  • Show accessible chart labels in addition to visual rings and graphs.
  • Continue Learning and Today’s Goal shall lead to a valid available learning or activity continuation.

Pricing

• Information and state
  • Six-tier public pricing comparison.
  • Public access.
• Primary actions
  • Switch Monthly/Annual billing presentation.
  • Switch INR ₹ / USD $ presentation.
  • Review plan details and activate integration-ready plan controls.
• Required tiers
  • FREE.
  • STUDENT.
  • PLUS.
  • PRO.
  • PREMIUM.
  • ULTIMATE.
• Pricing rules
  • Exactly six tiers shall be shown: one FREE tier and five paid tiers.
  • FREE shall display ₹0 and $0.
  • Paid INR and USD prices shall be maintained separately in one centralized JavaScript configuration object.
  • Currency, price, billing period, and savings shall update dynamically.
  • The system shall not represent values as live currency conversions.
  • The system shall not claim unlimited features unless those features are implemented.
  • Plan buttons shall be ready for future payment integration but shall not impersonate or simulate payment completion.
• States and recovery
  • Preserve the selected currency and billing period while viewing plan details.
  • If payment integration is unavailable, show a clear integration-ready message rather than a fake success state.

About

• Information and state
  • Public explanation of AskKushal Study AI.
• Primary actions
  • Read about the global AI-powered study ecosystem and navigate to related product areas.
• Required content
  • Explain the platform’s role in learning, practice, revision, exams, academic productivity, activities, analytics, and global study discovery.
  • Include the “POWERED BY MODERN TECHNOLOGY” presentation with required technology icons when not surfaced from Home.
• States and recovery
  • Maintain working navigation to referenced first-party destinations.

Contact

• Information and state
  • Public glassmorphism contact form.
• Primary actions
  • Enter and submit Name, Email, Country, Subject, Education Level, and Message.
• Form and delivery responsibilities
  • Validate required fields and email format before submission.
  • Submit through AJAX without page reload to server/contact.php.
  • Send mail via PHP mail() to kushal3011official@gmail.com.
  • Show “Sending...” while the request is in progress.
  • Show “Mail successfully sent!” only on confirmed success.
  • Show a clear error on delivery or server failure.
  • Explain that PHP mail delivery requires a PHP-capable server and cannot send mail directly from file://.
• States and recovery
  • Display field-level validation errors.
  • Preserve submitted values after validation or delivery failure where practical.
  • Fail gracefully if PHP is unavailable, without exposing sensitive server details or stack traces.
  • Permit correction and resubmission.

Privacy

• Information and state
  • Public privacy-policy destination.
• Primary actions
  • Read privacy information and return to available product navigation.
• States and recovery
  • Present readable content with consistent footer and navigation access.

Terms

• Information and state
  • Public terms-of-use destination.
• Primary actions
  • Read terms information and return to available product navigation.
• States and recovery
  • Present readable content with consistent footer and navigation access.

3. Functional Requirements

FR-01 — Brand and Education Rebuild

As a Student Learner, I should experience AskKushal Study AI as a global education platform so that all content supports learning, practice, revision, exams, and academic productivity.

• Provenance: explicit.
• The system shall use the AskKushal Study AI brand, “Learn Without Limits.” tagline, and “Your AI-powered global study universe.” supporting line.
• The system shall remove AskRohit, Digital Marketing Agency, marketing-agency copy, lorem ipsum, and unrelated legacy content.
• Acceptance: No retained visible product content shall represent the product as a marketing agency.

FR-02 — Cinematic Loader and WebGL Fallback

As a visitor, I should see a branded loading transition so that entry into the learning universe feels continuous and cinematic.

• Provenance: explicit.
• The loader shall show AskKushal branding, STUDY AI, percentage progress, rotating 3D knowledge sphere, particles, and glowing rings.
• The loader shall transition by zooming or dollying smoothly into the Hero.
• If WebGL is unavailable, the system shall show a CSS fallback loader.
• Failure/recovery: WebGL failure shall not block navigation or public content.
• Acceptance: A visitor can reach Home with either the Three.js experience or a functioning CSS fallback.

FR-03 — Navigation and Mobile Menu

As a visitor, I should navigate to Home, Subjects, Courses, Study Tools, Activities, AI Tutor, Exams, Pricing, About, and Contact so that I can reach each public product area.

• Provenance: explicit.
• The navbar shall include Sign In and Get Started controls.
• The navbar shall become a glass navbar on scroll.
• The system shall provide an animated responsive mobile menu.
• Failure/recovery: Navigation shall remain keyboard-accessible and usable if animations are disabled.
• Acceptance: Every navigation and footer destination resolves to its matching first-party page without broken links.

FR-04 — Hero Learning Universe

As a visitor, I should enter an interactive educational hero universe so that I can understand the platform’s learning scope and start a relevant journey.

• Provenance: explicit.
• The Hero shall use particles, knowledge nodes, digital grid, orbiting geometry, mathematical symbols, molecular/network structures, and holographic panels.
• The Hero shall show required wordmark, tagline, supporting statement, coverage claims, buttons, prompt bar, and prompt examples.
• Start Learning, Explore Subjects, and Ask AI shall lead to valid related destinations.
• Acceptance: Coverage values are displayed as platform coverage claims, not live database counts.

FR-05 — Subject Discovery and Search

As a Student Learner or Educator / Content Curator, I should browse and search the subject universe so that I can identify subjects, courses, and topics relevant to my learning or material preparation.

• Provenance: explicit.
• The system shall provide hover/focus and click/activation details for named subject domains.
• The system shall provide functional frontend searching and filtering by Subject, Course, Country, Language, Education Level, Difficulty, and Duration.
• Failure/recovery: No-match results shall explain that the available frontend data has no match and allow filters to be adjusted.
• Acceptance: Selected filters visibly change results from available frontend data.

FR-06 — Course Exploration

As a Student Learner or Educator / Content Curator, I should inspect course cards by category so that I can choose an available learning continuation.

• Provenance: explicit.
• Course cards shall show title, subject, level, duration, lessons, difficulty, language, progress, and Start.
• Categories shall include all named course categories.
• Failure/recovery: Unmatched category/filter combinations shall show an empty state.
• Acceptance: Start does not fake enrollment, backend progress persistence, or payment.

FR-07 — Interactive Study Tools

As a Student Learner or Educator / Content Curator, I should use the required study tools so that I can work with notes, planning, practice, time management, reference, calculations, and academic productivity.

• Provenance: explicit.
• Every named Study Tools capability shall have a real frontend interaction such as modal, input/output, calculator, timer, tabs, editing, filtering, planning, or results.
• No listed tool shall be a dead button.
• Failure/recovery: Tools shall provide reset, clear, validation, empty, or retry behavior as applicable.
• Acceptance: Non-AI tools respond to user interaction in the frontend; AI-dependent tools do not fabricate results.

FR-08 — AI Tutor Integration-Ready Chat

As a Student Learner, I should configure and submit an AI Tutor prompt so that I can prepare a real AI learning request by subject, language, and expertise mode.

• Provenance: explicit.
• The AI Tutor shall include messages, input, send, subject selector, language selector, modes Beginner/Student/Advanced/Expert, and example prompts.
• The system shall provide a clean server-side AI API integration point.
• Failure/recovery: Without configured AI service, the system shall clearly state that live AI responses are unavailable; it shall not fake a response.
• Acceptance: No API key or secret is exposed in browser-delivered code.

FR-09 — Language Learning Presentation

As a Student Learner, I should choose from example languages so that I can explore the platform’s multilingual learning concept.

• Provenance: explicit.
• The language selector shall include English, Hindi, Gujarati, Spanish, French, German, Arabic, Japanese, Chinese, Portuguese, Italian, and Korean.
• The system shall present 1000+ Languages conceptually and shall not claim complete implementation of every language unless implemented.
• Acceptance: Language selection updates the relevant frontend presentation without falsely promising full language support.

FR-10 — Global Education Globe

As a visitor, I should explore a geometry-only global education globe so that I can inspect learning information associated with country points.

• Provenance: explicit.
• The globe shall use Three.js geometry only, no map image.
• It shall show glowing country points representing 40+ countries and open information panels when points are activated.
• Failure/recovery: A non-WebGL fallback shall preserve the global education content.
• Acceptance: Country details are accessible by click and keyboard-compatible activation where applicable.

FR-11 — How It Works Journey

As a visitor, I should understand the Choose, Ask, Learn, Practice, Master flow so that I can understand the intended learning journey.

• Provenance: explicit.
• The system shall show five steps in this exact order: Choose, Ask, Learn, Practice, Master.
• The system shall use ScrollTrigger and camera motion where supported.
• Acceptance: Reduced-motion users receive a readable static or opacity-fade presentation.

FR-12 — Daily Learning Activities

As a Student Learner, I should complete daily learning activities so that I can practice through interactive scoring, timing, progress, and result experiences.

• Provenance: explicit.
• The system shall implement all required named activities.
• Activities shall include real frontend logic, scoring, timer where applicable, progress, restart, and result screens.
• Failure/recovery: Learners shall be able to retry, restart, or select another activity after a result.
• Acceptance: Activities do not depend on fake backend or AI output to show legitimate frontend results.

FR-13 — Exam Preparation

As an Exam Candidate, I should complete mock tests, MCQs, timed exams, and practice sets so that I can review results and performance for school, university, nursing, medical, engineering, or competitive exams.

• Provenance: explicit.
• The Exam Center shall provide Mock Test, MCQ Test, Timed Exam, Practice Set, Revision Plan, Exam Result, and Performance Analysis interfaces.
• Failure/recovery: Timed and completed practice shall lead to result/review/restart options.
• Acceptance: Fixed performance analytics are labelled Sample/Demo unless connected to real learner data.

FR-14 — Dashboard, Streaks, Achievements, and Leaderboard

As a Student Learner, I should review learning metrics and gamification indicators so that I can understand my sample or connected learning progress.

• Provenance: explicit and required_inference for the Dashboard page.
• The Dashboard shall show all required metrics, activity calendar, streak system, XP/points, daily goal, progress ring, achievement badges, leaderboard, Continue Learning, and Today’s Goal.
• Failure/recovery: All disconnected fixed values shall be visibly labelled Sample Data or Demo Data.
• Acceptance: The interface does not claim real personal tracking until connected user data exists.

FR-15 — Pricing Controls

As a visitor, I should compare exactly six plans in INR or USD and monthly or annual periods so that I can understand future purchase options without being misled by fabricated pricing behavior.

• Provenance: explicit.
• The plans shall be FREE, STUDENT, PLUS, PRO, PREMIUM, and ULTIMATE.
• FREE shall be ₹0/$0.
• A central JavaScript configuration object shall hold editable paid INR/USD prices.
• Currency, period, price, and savings shall update dynamically.
• Failure/recovery: Payment controls shall state that payment integration is pending when no provider is configured.
• Acceptance: No live exchange rate, fake payment, or unsupported unlimited-feature claim is displayed.

FR-16 — Contact Submission

As a visitor, I should submit a validated contact enquiry so that AskKushal can receive my message without a page reload.

• Provenance: explicit.
• The form shall collect Name, Email, Country, Subject, Education Level, and Message.
• It shall validate inputs and submit via AJAX to server/contact.php.
• It shall show “Sending...”, “Mail successfully sent!” on success, or a clear error on failure.
• PHP mail() shall send to kushal3011official@gmail.com.
• Failure/recovery: If run from file:// or without a PHP-capable server, the form shall fail gracefully and explain the server requirement.
• Acceptance: No sensitive error data or stack trace is exposed.

FR-17 — Accessibility, Responsiveness, Performance, and Security

As any visitor, I should use the site safely and accessibly across devices so that the experience remains understandable and performant.

• Provenance: explicit.
• The system shall use semantic HTML, keyboard navigation, focus states, ARIA labels where needed, readable contrast, and prefers-reduced-motion.
• The system shall be mobile-first and support phones, tablets, laptops, desktops, and large screens.
• The system shall reduce particle, 3D, and cursor effects on mobile and low-power devices and support touch interaction.
• The system shall use efficient requestAnimationFrame, optimized particles/draw calls, lazy loading of heavy