System Requirements Document (SRD)

Project Name: grand-tiktok

1. Introduction

Welcome to the System Requirements Document (SRD) for grand-tiktok, a full-stack SaaS web application designed to provide TikTok analytics and revenue estimation under the brand name Toklytics. This document outlines the functional and non-functional requirements, user personas, design concepts, and technical specifications necessary to build and deploy the platform successfully.

The goal of Toklytics is to empower TikTok creators by offering deep insights into engagement, growth, viral performance, and estimated earnings. The platform will cater to users globally, with specific revenue estimation tailored to regions like India (Austin's locale), the USA, Europe, and others.

2. System Overview

Toklytics is a SaaS application that allows users to search for any public TikTok username and retrieve analytics such as engagement rates, growth trends, viral scores, and estimated revenue. The platform will feature a tiered subscription model, offering free and premium plans to maximize user acquisition and monetization.

Key features include:

• A high-conversion landing page with blurred previews and urgency elements.
• A search engine for public TikTok profiles.
• Advanced analytics, including engagement rates, growth indicators, and revenue estimation.
• Premium features like growth tracking, competitor analysis, and AI-driven content strategies.
• A subscription system integrated with Stripe for seamless payments.

The application will be built using modern technologies, ensuring scalability, performance, and a premium user experience.

3. Functional Requirements

Landing Page

• As a Visitor, I should see a dark premium UI with a black background and purple/pink gradient accents.
• As a Visitor, I should see a headline: "Analyze TikTok. Predict Growth."
• As a Visitor, I should see a subheadline: "Discover engagement, growth, and estimated earnings instantly."
• As a Visitor, I should be able to input a TikTok username and click "Analyze Now."
• As a Visitor, I should see blurred preview cards for revenue, viral score, and growth.
• As a Visitor, I should see lock icons on premium features.
• As a Visitor, I should see testimonials and urgency text like "Limited-time offer."

Search & Profile Analysis

• As a User, I should be able to search for any public TikTok username without logging in.
• As a User, I should see profile details like profile picture, username, followers, total likes, and video count.
• As a User, I should see analytics for the last 10–20 videos, including views, likes, and comments.

Analytics Engine

• As a User, I should see engagement rates calculated as (likes + comments) / views.
• As a User, I should see growth indicators like "Growing Fast 🔥," "Stable," or "Declining."
• As a User, I should see a viral score based on views vs followers ratio.
• As a User, I should see a trending score and top-performing video.

Revenue Estimation (Premium Core)

• As a Premium User, I should see revenue estimates calculated using the formula: Revenue = (Total Views × CPM) / 1000.
• As a Premium User, I should see monthly revenue estimates, per-video earnings, and revenue breakdown charts.
• As a Free User, I should see blurred revenue data with a lock overlay and "Unlock Revenue Insights" text.

Advanced Premium Features

• As a Premium User, I should be able to track growth over time.
• As a Premium User, I should see revenue history tracking.
• As a Premium User, I should see viral content detection and AI-based suggestions for the best time to post.
• As a Premium User, I should see content strategy tips like "Post shorter videos" and "Use trending sounds."
• As a Premium User, I should see audience quality scores and fake follower detection.
• As a Premium User, I should compare two profiles using competitor analysis.

Subscription System

• As a User, I should see subscription plans with features clearly outlined.
• As a User, I should be able to upgrade/downgrade my subscription plan.
• As a User, I should see payment options integrated with Stripe.

User System & Dashboard

• As a User, I should be able to sign up and log in using my email.
• As a User, I should see a dashboard with saved profiles, search history, revenue tracking, and profile monitoring.

4. User Personas

Admin

• Manages platform settings, user accounts, and subscription plans.
• Monitors analytics and ensures compliance with TikTok's public data policies.

Free User

• Searches public TikTok profiles and views basic analytics.
• Limited access to features like revenue estimation and growth tracking.

Premium User

• Accesses advanced analytics, revenue insights, and AI-driven content strategies.
• Utilizes competitor analysis and growth tracking tools.

5. Visuals Colors and Theme

Color Palette

• Background: #121212 (Black)
• Surface: #1E1E2F (Deep Charcoal)
• Text: #FFFFFF (White)
• Accent: #FF00FF (Vivid Pink)
• Muted Tones: #6A6A8E (Muted Purple)

Mood Direction

The theme is premium, futuristic, and sleek, with glassmorphism elements and smooth animations.

6. Signature Design Concept

Concept: Interactive Galaxy Map Homepage

The homepage will feature an interactive galaxy map where each star represents a TikTok profile. Users can input a username, and the galaxy dynamically zooms into the star representing that profile.

Details:

• Animations: Stars twinkle subtly, and the galaxy rotates slowly.
• Transitions: When a username is entered, the galaxy zooms in with a smooth animation, revealing the profile's analytics.
• Micro-interactions: Hovering over stars displays tooltips like "Trending 🔥" or "Growing Fast 📈."
• Color Shifts: The galaxy's colors (purple/pink gradients) subtly shift based on user interaction.

This design will create an unforgettable first impression, making users feel like they’re exploring a universe of TikTok data.

7. Non-Functional Requirements

• Performance: The application should load analytics within 2 seconds.
• Scalability: Support up to 100,000 daily searches.
• Security: Ensure data privacy and secure payment processing.
• Compliance: Adhere to TikTok's public data usage policies.

8. Tech Stack

Frontend

• React for Web

Backend

• Python
• FastAPI

Database

• MySQL (with Alembic for migrations)

AI Models

• GPT 5.4 for user-friendly responses
• Google Nano Banana for image generation

AI Tools

• Langchain
• Litellm for LLM Routing

Orchestration

• Docker
• Kubernetes

9. Assumptions and Constraints

Assumptions

• TikTok public data is accessible via scraping or API.
• Users will upgrade to premium plans for advanced features.

Constraints

• Revenue estimation must remain approximate to avoid legal issues.
• The platform must not require TikTok login credentials.

10. Glossary

• CPM: Cost Per Mille, the cost advertisers pay per 1,000 views.
• Engagement Rate: A metric indicating user interaction with content.
• Viral Score: A measure of how likely content is to go viral.
• Glassmorphism: A design trend featuring frosted-glass-like UI elements.

This document provides a comprehensive blueprint for building grand-tiktok under the Toklytics brand. Let me know if you need further refinements, Austin!