tidal-i System Requirements Document

Introduction

The purpose of this document is to outline the system requirements for the "tidal-i" project, an AI-powered learning platform for students. The platform, developed by Knowledgestream AI Pvt. Ltd., aims to teach coding with AI technology, focusing on learning to code rather than copying.

System Overview

The tidal-i project is designed to provide an interactive and engaging learning experience for students interested in coding. The platform leverages AI to offer personalized learning paths, tutorials, and coding challenges. The primary goal is to enhance students' coding skills through innovative teaching methods.

Functional Requirements as Story Points

• As a User, I should be able to see a splash screen with the company name "Knowledgestream AI Pvt. Ltd." upon visiting the landing page.
• As a User, I should be able to sign in to the platform using my credentials.
• As a User, I should be able to sign up for a new account on the platform.
• As a User, I should be able to view the company's goal to teach coding with AI technology.
• As a User, I should be able to explore the features of the platform.
• As a User, I should be able to read testimonials from other users.
• As a User, I should be able to access a FAQ section for common queries.
• As a User, I should be able to view a demo showing how the AI works.

User Personas

• Student: A primary user who wants to learn coding using AI technology.
• Guest: A potential user exploring the platform before signing up.
• Admin: A user responsible for managing content and user accounts on the platform.

Core User Flows

• Student visits the landing page -> views splash screen -> signs up -> explores features -> starts learning.
• Guest visits the landing page -> views splash screen -> reads testimonials and FAQs -> signs up.
• Admin logs in -> manages user accounts -> updates platform content.

Visuals Colors and Theme

• primary: #1A73E8 (Deep Blue)
• primary_light: #E8F0FE (Light Blue)
• secondary: #FF6F61 (Coral)
• accent: #FFD700 (Gold)
• highlight: #FFA500 (Orange)
• bg: #FFFFFF (White)
• surface: rgba(240, 240, 240, 0.8)
• text: #333333 (Dark Gray)
• text_muted: #777777 (Light Gray)
• border: rgba(200, 200, 200, 0.5)

Signature Design Concept

The landing page will feature an interactive splash screen that dynamically displays the company name "Knowledgestream AI Pvt. Ltd." in a bold, animated typography. As users hover over the name, the letters will subtly shift and change color, creating an engaging visual effect. The background will feature a flowing stream of binary code, symbolizing the flow of knowledge and technology. This effect will be achieved using motion/react for smooth animations and transitions.

Landing Hero Motion Brief

The landing hero will depict a student interacting with a virtual AI tutor. The scene will show the student inputting a coding problem, the AI processing the input, and then displaying a solution. This loop will run continuously, illustrating the platform's core functionality. The animation will be created using CSS and motion/react, ensuring a seamless experience across devices.

Interaction Model & Motion Direction

The intended interaction model for the landing page is "animated," featuring moderate scroll-triggered reveals and hover transitions. The splash screen will have a continuous 2D motion loop, enhancing the storytelling aspect of the platform.

Non-Functional Requirements

• The platform should be responsive and accessible on various devices and screen sizes.
• The system should ensure data privacy and secure user authentication.

Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB
• AI Models: GPT 5.4 for user-friendly responses

Assumptions and Constraints

• The platform will primarily target students in India, considering local educational standards and requirements.
• The system will need to handle a high volume of concurrent users efficiently.

Glossary

• AI: Artificial Intelligence
• FAQ: Frequently Asked Questions
• UI: User Interface
• UX: User Experience