Solar-Idea System Requirements Document

Introduction

The "Solar-Idea" project aims to develop an AI-driven Social Video Automation Agent SaaS web application named "ViralVideo Agent." This application will enable users to generate and publish complete social video packages automatically, enhancing their social media presence with minimal effort.

System Overview

The ViralVideo Agent is designed to streamline the creation and publication of social media videos by automating the generation of scripts, voiceovers, scene plans, AI-generated visuals, and more. Users can connect their social media accounts, input a topic, and receive a publish-ready video package tailored to their specified audience and platform preferences.

Functional Requirements

• As a User, I should be able to log in to the application.
• As a User, I should be able to connect my YouTube channel using Google OAuth.
• As a User, I should be able to connect my Instagram Professional account and Facebook Page using Meta OAuth.
• As a User, I should be able to enter a topic, language, audience, video type, duration, and tone for video generation.
• As a User, I should be able to receive a viral hook, full video script, scene-by-scene visual plan, voiceover text, subtitle text, thumbnail concept, YouTube title options, description, tags, keywords, hashtags, Instagram caption, Facebook caption, and pinned comment generated by AI.
• As a User, I should be able to preview the generated video.
• As a User, I should be able to edit the script, title, description, tags, caption, and thumbnail.
• As a User, I should be able to approve and publish the video to YouTube, Instagram, and Facebook.
• As a User, I should be able to view upload status, errors, links, and history.

User Personas

• User: Individuals or businesses looking to automate their social media video content creation and publishing process.

Core User Flows

1. User logs in -> Connects social media accounts -> Enters video parameters -> AI generates video package -> User previews and edits -> User approves and publishes -> System uploads to platforms -> User views upload status and history.

Visuals Colors and Theme

• primary: #1E3A8A (Deep Blue)
• primary_light: #3B82F6 (Light Blue)
• secondary: #F97316 (Vibrant Orange)
• accent: #EC4899 (Bright Pink)
• highlight: #F59E0B (Amber)
• bg: #111827 (Dark Gray)
• surface: rgba(17, 24, 39, 0.8)
• text: #F9FAFB (White)
• text_muted: #9CA3AF (Muted Gray)
• border: rgba(156, 163, 175, 0.2)

Signature Design Concept

The homepage will feature an interactive 3D floating island where each section of the site is represented as a building. Users can navigate between these buildings by "flying" over the island. Each building will represent a different feature of the application, such as video generation, account settings, and upload history. The island will be rendered using @react-three/fiber and @react-three/drei, providing a unique and engaging user experience. Hovering over a building will reveal a brief description of the feature, and clicking will transport the user to the respective section.

Interaction Model & Motion Direction

The landing page will use a "parallax" interaction model, creating a sense of depth as users scroll through the page. Decorative layers will move at different speeds, enhancing the storytelling aspect of the site. Internal pages will adopt a "static" model for clarity and ease of use, focusing on functionality over decoration.

Non-Functional Requirements

• Ensure secure user authentication and data encryption.
• Maintain high availability and scalability to handle peak loads.
• Implement responsive design for seamless use across devices.
• Ensure compliance with copyright laws and platform API usage policies.

Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB
• Video Rendering: FFmpeg
• AI Models: GPT 5.4, Claude Sonnet 5, Gemini 3.1 pro
• AI Tools: Litellm, Langchain
• Orchestration: Docker, Kubernetes

Assumptions and Constraints

• The application will only use official APIs for social media platforms.
• All generated content will include AI-generated content disclosures.
• The system will require manual approval before publishing videos in the MVP phase.

Glossary

• OAuth: Open standard for access delegation commonly used for token-based authentication.
• FFmpeg: A multimedia framework used to decode, encode, transcode, mux, demux, stream, filter, and play almost anything that humans and machines have created.
• MVP: Minimum Viable Product, the most pared-down version of a product that can still be released.

This document outlines the comprehensive requirements for the Solar-Idea project, ensuring a robust and scalable solution for automated social video content creation and publishing.