EpicOs System Requirements Document

1. Introduction

EpicOs will support multiple data connections accessible through a single login. EpicOs is a comprehensive reporting and analytics system designed to integrate multiple advertising platforms into a unified dashboard. It leverages AI capabilities to provide users with insightful reports and analytics, facilitating efficient decision-making processes. This document outlines the system requirements for EpicOs, focusing on its integration with various advertising platforms and user management functionalities.

2. System Overview

EpicOs aims to streamline the process of generating and managing reports from multiple advertising platforms. The system will integrate with Meta Ads, Google Ads, TikTok Ads, Snapchat Ads, and CRM/Lead systems. It will feature an interactive dashboard powered by a ChatGPT agent, allowing users to generate and view reports seamlessly. The system will support a subscription-based model for admin and member management, enabling users to connect their email IDs and social media login access.

2a. Source Content Inventory

• Meta Ads: Integration for lead generation and reporting.
• Google Ads: Integration for lead generation and reporting.
• TikTok Ads: Integration for lead generation and reporting.
• Snapchat Ads: Integration for lead generation and reporting.
• CRM/Lead System: Integration for comprehensive lead management.
• MCP (Multi-Channel Platform): Utilized for integration and data management.
• ChatGPT Agent: Provides interactive dashboard capabilities.
• Data Connections: Supports 15 data connections across various brands and platforms.

3. Functional Requirements as Story Points

• As a User, I should be able to connect my email ID and social media login access to EpicOs for personalized access.
• As an Admin, I should be able to manage user subscriptions and access levels within EpicOs.
• As a User, I should be able to generate lead generation reports from Meta Ads.
• As a User, I should be able to generate lead generation reports from Google Ads.
• As a User, I should be able to access multiple data connections with a single login.
• As a User, I should be able to generate lead generation reports from TikTok Ads.
• As a User, I should be able to generate lead generation reports from Snapchat Ads.
• As a User, I should be able to view all reports in a single, integrated dashboard.
• As a User, I should be able to access detailed analytics through the ChatGPT-powered interactive dashboard.
• As an Admin, I should be able to hyperlink the dashboard with specific tools for direct access.

4. User Personas

• Admin: Manages user subscriptions, access levels, and system configurations.
• User: Connects personal accounts, generates reports, and accesses analytics.

5. Core User Flows

• User logs into EpicOs -> Connects email and social media accounts -> Accesses dashboard -> Generates reports -> Views analytics.
• Admin manages subscriptions -> Configures user access -> Links dashboard tools -> Monitors system usage.

6. Visuals Colors and Theme

• primary: #1E3A8A (Deep Blue)
• primary_light: #3B82F6 (Light Blue)
• secondary: #F97316 (Vibrant Orange)
• accent: #10B981 (Emerald Green)
• highlight: #F59E0B (Amber)
• bg: #F3F4F6 (Light Gray)
• surface: rgba(255, 255, 255, 0.8) (White)
• text: #111827 (Dark Gray)
• text_muted: #6B7280 (Muted Gray)
• border: rgba(209, 213, 219, 0.2) (Light Gray)

7. Signature Design Concept

EpicOs will feature an interactive galaxy map on the homepage, where each star represents a different advertising platform or tool. Users can click on a star to open a detailed report card, drag to rotate the galaxy, and hover to highlight connections between platforms. This concept will be built using @react-three/fiber and @react-three/drei for a 3D interactive experience.

Landing Hero Motion Brief

The landing page will feature a continuously moving 2D composition using motion/react. The animation will depict data streams flowing into a central AI brain, transforming into actionable insights displayed as dynamic graphs and charts. This loop will last 10 seconds, with interactive elements allowing users to pause and explore specific data points.

8. Interaction Model & Motion Direction

• Intended Interaction Model: Animated
• The landing page will feature moderate scroll-triggered reveals and hover transitions, enhancing user engagement with spring physics on interactive elements.

9. Non-Functional Requirements

• The system must ensure secure access control for user data and integrations.
• The dashboard should maintain high performance and responsiveness across devices.

10. Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB
• AI Models: GPT 5.4 for user-friendly responses
• AI Tools: Litellm for LLM Routing
• Orchestration: Docker, Kubernetes

11. Assumptions and Constraints

• Users will have existing accounts with the integrated advertising platforms.
• The system will rely on MCPs for data integration and management.

12. Glossary

• MCP: Multi-Channel Platform
• CRM: Customer Relationship Management
• AI: Artificial Intelligence
• API: Application Programming Interface

This document outlines the comprehensive requirements for the EpicOs project, ensuring a robust and user-friendly reporting and analytics system.