Fiery-System

Introduction

The Fiery-System is designed to provide an engaging and interactive experience, incorporating unique functionalities such as behavior detection near a camera. This document outlines the system requirements for the Fiery-System project.

System Overview

The Fiery-System aims to create an interactive environment where users can engage with dynamic behaviors detected near a camera. The system will leverage advanced motion detection and animation techniques to enhance user interaction.

Functional Requirements

• As a User, I should be able to detect twerking behavior near the camera to trigger specific animations.
• As an Admin, I should be able to configure the sensitivity of behavior detection.
• As a User, I should receive feedback when a behavior is detected near the camera.

User Personas

• User: Engages with the system to experience interactive animations.
• Admin: Manages system settings and configures behavior detection parameters.

Core User Flows

• User approaches camera -> System detects twerking behavior -> Animation is triggered.
• Admin logs in -> Configures detection sensitivity -> Saves settings.

Visuals Colors and Theme

• primary: #FF4500 (Fiery Orange)
• primary_light: #FF7F50 (Coral)
• secondary: #4682B4 (Steel Blue)
• accent: #32CD32 (Lime Green)
• highlight: #FFD700 (Gold)
• bg: #000000 (Black)
• surface: rgba(255, 69, 0, 0.8)
• text: #FFFFFF (White)
• text_muted: #B0C4DE (Light Steel Blue)
• border: rgba(255, 165, 0, 0.2)

Signature Design Concept

The homepage will feature an interactive 3D environment where users can explore a virtual dance floor. Using @react-three/fiber and gsap, the environment will react to detected behaviors, such as twerking, by triggering dynamic lighting and animations. Users can click and drag to navigate the space, with animations responding to their movements and interactions.

Interaction Model & Motion Direction

• Interaction Model: Parallax
• Motion Direction: The landing page will feature layered depth with scroll-triggered animations. Users will experience dynamic lighting effects and animations that respond to detected behaviors, creating an immersive experience.

Non-Functional Requirements

• The system must process behavior detection in real-time.
• The system should maintain a high level of accuracy in detecting specified behaviors.

Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MongoDB
• AI Models: Google Nano banana for image generation
• AI Tools: Litellm for LLM Routing
• Local Orchestration: Docker, docker-compose

Assumptions and Constraints

• The system assumes a stable internet connection for real-time processing.
• The camera used must support high-resolution video capture for accurate behavior detection.

Glossary

• Behavior Detection: The process of identifying specific actions or movements near the camera.
• Parallax: A scrolling technique where background images move slower than foreground images, creating an illusion of depth.