System Requirements Document (SRD) for ruby-influencer

1. Introduction

The ruby-influencer project, branded as The Creators Hub, is a web application designed to connect influencers with brands for collaborations. The platform focuses on simplicity and usability, offering a clean and modern interface for influencers to showcase their profiles and interact with admins in real-time. This document outlines the system requirements for building the MVP (Minimum Viable Product) of The Creators Hub, tailored for the Indian market (IN), with locale-specific considerations such as OTP-based authentication, mobile-first design, and real-time messaging.

2. System Overview

The Creators Hub is a platform aimed at influencers who wish to collaborate with brands. The system will allow influencers to register, validate their social media profiles, and interact with admins through a real-time chat feature. Admins will have access to a dashboard to manage influencer data and respond to messages. The platform will prioritize a clean, mobile-friendly UI/UX and ensure secure, real-time communication.

Key features include:

• OTP-based authentication for influencers.
• Social media profile validation with follower count checks.
• Real-time chat between influencers and admins.
• Separate dashboards for influencers and admins.
• A focus on minimalism and ease of use.

3. Functional Requirements

Authentication

• As an Influencer, I should be able to sign up/login using:
  • Name
  • Email (with OTP verification)
  • Phone Number (with OTP verification)

Profile Validation

• As an Influencer, I should be prompted to provide:
  • Instagram Profile URL (Mandatory)
    • Validate that the URL is a real Instagram profile.
    • Ensure the account has at least 1000 followers (via API or mock validation).
  • Facebook Profile URL (Optional)
  • YouTube Channel URL (Optional)
    • Validate these URLs as legitimate profiles.

Additional Questions

• As an Influencer, I should be asked:
  • "What do you bring here?" with options:
    • "Paid collaboration"
    • "Barter (Free Products)"
    • "Brand Enquiry"
    • "All Of These"
  • "What type of products/content do you mainly create?" (Optional)

Influencer Dashboard

• As an Influencer, I should see a simple profile dashboard displaying:
  • Name
  • Email
  • Phone
  • Instagram ID
  • Other social links
  • Description
  • Status: "Logged in successfully"
  • A chat button to message the admin (with persistent chat history).

Admin Panel

• As an Admin, I should have a dashboard to:
  • View all influencer data, including:
    • Name
    • Email
    • Phone
    • Instagram URL
    • Facebook/YouTube (if provided)
    • Answers to additional questions.
  • Access a chat section to reply to influencers (with persistent chat history).
• As an Admin, I should ensure influencers cannot see other influencers' data.

Real-Time Messaging

• As a User, I should experience real-time messaging functionality similar to WhatsApp, with:
  • Instant delivery of messages.
  • Persistent chat history.
  • Notifications for new messages.

UI/UX

• As a User, I should experience a clean, modern, and mobile-friendly interface with a simple onboarding flow.

4. User Personas

Influencer

• Description: Social media content creators looking for brand collaborations.
• Goals: Showcase their profiles, connect with brands, and communicate with admins.
• Pain Points: Complicated onboarding, lack of real-time communication, and unverified platforms.

Admin

• Description: Platform managers responsible for overseeing influencer data and communication.
• Goals: Manage influencer profiles, validate data, and respond to queries efficiently.
• Pain Points: Overwhelming data management and lack of organized communication tools.

5. Visuals Colors and Theme

Color Palette

The Creators Hub will use a vibrant yet professional color scheme to appeal to influencers and maintain a modern aesthetic.

• Background: #FAF3E0 (soft cream)
• Surface: #FFFFFF (pure white)
• Text: #2C2C2C (charcoal gray for readability)
• Accent: #FF5733 (vivid orange-red for buttons and highlights)
• Muted Tones: #C4C4C4 (light gray for secondary elements)

6. Signature Design Concept

The "Interactive Social Media Mosaic" Homepage

The homepage will feature an interactive mosaic of social media posts. Each tile in the mosaic represents a snippet of an influencer's Instagram, Facebook, or YouTube content. When users hover over a tile, it will expand slightly, revealing the influencer's name and a brief description of their niche. Clicking on a tile will simulate a "zoom-in" effect, transitioning to the influencer's profile page.

Key Features:

• Dynamic Animations: Smooth hover effects and transitions for an engaging experience.
• Real-Time Updates: The mosaic updates dynamically to showcase the latest influencer profiles.
• Color Shift: The background subtly shifts between pastel gradients (e.g., orange-red to soft cream) to create a lively yet professional atmosphere.
• Micro-Interactions: Buttons and icons will have subtle animations, such as a ripple effect on clicks.

This design will make the homepage visually striking and immediately communicate the platform's purpose.

7. Non-Functional Requirements

• Performance: The system should handle up to 10,000 concurrent users without significant latency.
• Scalability: The architecture should support future expansion, including additional features and user types.
• Security: Ensure secure authentication and data storage, including encrypted communication for the chat feature.
• Localization: Support Indian locale defaults, including OTP-based authentication and INR currency symbols if needed.
• Accessibility: Adhere to WCAG 2.1 standards for accessibility.

8. Tech Stack

Frontend

• React for Web

Backend

• Python
• FastAPI

Database

• MongoDB for NoSQL storage
• Alembic for migrations

Real-Time Messaging

• Firebase Realtime Database for chat functionality

AI Tools

• GPT 5.4 for user-friendly responses in chat

Orchestration

• Docker for local development
• Kubernetes for server-side orchestration

9. Assumptions and Constraints

Assumptions

• Influencers will primarily access the platform via mobile devices.
• Instagram's API will be available for follower count validation.
• Real-time chat will use Firebase for simplicity and scalability.

Constraints

• The MVP must be delivered within 3 months.
• Budget constraints limit the use of premium third-party services.

10. Glossary

• Influencer: A social media content creator with a significant following.
• Admin: A platform manager responsible for overseeing operations.
• OTP: One-Time Password, used for authentication.
• MVP: Minimum Viable Product, the simplest version of the product with core features.
• WCAG: Web Content Accessibility Guidelines, standards for web accessibility.

This updated SRD reflects your vision for The Creators Hub. Let me know if you'd like further refinements!