System Requirements Document (SRD)

Project Name: keen-hack

1. Introduction

The keen-hack project is a web-based platform designed to provide users with the ability to play and download videos from Terabox links. The system is built with simplicity and user engagement in mind, leveraging an ad-based monetization model. This document outlines the system requirements for the project, ensuring clarity and alignment with the vision shared by Arbaz Alam from India.

The platform will feature a clean and attractive design, with a blue-themed interface, and will focus on delivering a seamless user experience.

2. System Overview

The keen-hack platform will allow users to paste their Terabox video links, play the videos, and download them. The system will operate on a reward-based model where users must watch ads to access video playback and download functionality.

Key highlights of the system:

• Ad-based monetization model.
• Users can play and download videos after watching ads.
• A point-based system where each video play deducts one point from a total of five points.
• Optional login functionality with no additional benefits for logged-in users.
• Attractive blue-themed UI for a modern and engaging look.

3. Functional Requirements

As User:

• I should be able to paste my Terabox link and play the video.
• I should be able to download the video after watching an ad.
• I should see a tracker showing my remaining points (e.g., "2/5 plays left").
• I should have a limit of 5 video plays per day, with 1 point deducted per video play.
• I should be required to watch an ad before accessing video playback or download functionality.

As Admin:

• I should be able to manage ad placements and monitor user activity.
• I should be able to reset user points daily.

4. User Personas

1. Guest User:

• Can paste Terabox links to play and download videos.
• Limited to 5 video plays per day.
• Must watch ads to access functionality.

2. Logged-In User:

• Same functionality as Guest User.
• No additional benefits for logging in.

3. Admin:

• Manages ad placements and user activity.
• Oversees point reset functionality.

5. Visuals Colors and Theme

The keen-hack platform will feature a unique blue-themed design. Below is the custom color palette:

• Background: #0A2540 (Deep Navy Blue)
• Surface: #1E3A5F (Steel Blue)
• Text: #FFFFFF (White)
• Accent: #4A90E2 (Bright Sky Blue)
• Muted Tones: #7A9EB1 (Muted Blue-Grey)

This palette ensures a professional yet engaging look, aligning with the project's identity.

6. Signature Design Concept

Concept: Interactive "Blue Universe" Homepage

The homepage of keen-hack will immerse users in a dynamic "Blue Universe" experience. Upon landing, users will see a mesmerizing animated galaxy of floating blue orbs, each representing a feature or section of the platform.

Key Features:

• Interactive Orbs: Hovering over an orb will reveal its purpose (e.g., "Paste Link", "Play Video", "Download Video"). Clicking an orb will smoothly transition the user to the respective section.
• Ad Integration: Ads will appear as glowing constellations in the background, subtly blending into the theme.
• Micro-Interactions: Orbs will pulse gently to indicate interactivity, and clicking will trigger a ripple effect across the galaxy.
• Dynamic Background: The galaxy will subtly shift and rotate, creating a sense of depth and motion.

This design will make the platform instantly fascinating and memorable, ensuring users are engaged from the moment they arrive.

7. Non-Functional Requirements

• The system must support high-speed video playback and download functionality.
• The platform should be optimized for mobile and desktop devices.
• Ads must load seamlessly without disrupting the user experience.
• The system should reset user points daily at 4 PM UTC.
• The UI must be lightweight and fast-loading.

8. Tech Stack

Frontend:

• React for Web

Backend:

• Python
• FastAPI

Database:

• MySQL (preferred) or MariaDB for relational data
• Alembic for migrations

AI Tools:

• GPT 5.4 for user-friendly responses
• Litellm for LLM Routing

Local Orchestration:

• Docker
• docker-compose

Server-Side Orchestration:

• Kubernetes

9. Assumptions and Constraints

Assumptions:

• Users will have access to Terabox links for video playback and download.
• Ads will be provided by third-party advertisers.
• The system will reset points daily at a fixed time (4 PM UTC).

Constraints:

• The platform must comply with copyright and data protection laws.
• Ad integration must not compromise video playback quality.
• The system must handle high traffic efficiently.

10. Glossary

• Terabox: A cloud storage platform where users can store and share files, including videos.
• Ad-Based Monetization: A revenue model where users watch ads to access platform features.
• Point System: A mechanism to limit user activity based on a fixed number of points.
• Frontend: The user-facing part of the application.
• Backend: The server-side logic and database management.
• Docker: A tool for containerizing applications.
• Kubernetes: A system for automating deployment, scaling, and management of containerized applications.

End of Document