System Requirements Document (SRD)

Project Name: raven-candi

1. Introduction

The raven-candi project is a real-time random video and text chat web application designed to connect users anonymously with random strangers. Inspired by platforms like Omegle, this project aims to foster spontaneous and engaging interactions between users worldwide. The platform will prioritize simplicity, anonymity, and real-time communication while incorporating modern design aesthetics and robust backend functionality.

This document outlines the system requirements for raven-candi, ensuring clarity and alignment with the project's goals.

2. System Overview

The raven-candi platform will enable users to connect with random strangers in real time through video and text chat. The system will support anonymous interactions, ensuring no personally identifiable information (PII) is shared unless explicitly allowed by the user.

Key features include:

• Real-time video and text chat functionality.
• Randomized pairing of users.
• Anonymity by default, with optional interest-based matching.
• Moderation tools to ensure a safe and respectful environment.
• A sleek and intuitive user interface optimized for both desktop and mobile devices.

The platform will cater to a global audience, with localization options for users in India (IN) and beyond.

3. Functional Requirements

Core Functionalities:

• As a User, I should be able to connect with a random stranger for video chat.
• As a User, I should be able to connect with a random stranger for text chat.
• As a User, I should be able to toggle between video and text chat modes during a session.
• As a User, I should be able to end a chat session and immediately start a new one with another random stranger.
• As a User, I should be able to report inappropriate behavior during a chat session.
• As a User, I should be able to filter random matches based on shared interests.
• As an Admin, I should be able to monitor flagged sessions for moderation purposes.
• As an Admin, I should be able to ban users who violate community guidelines.

Additional Features:

• As a User, I should be able to select my preferred language for the chat interface.
• As a User, I should be able to adjust video quality based on my internet connection.
• As a User, I should be able to view a brief tutorial on how to use the platform.

4. User Personas

1. Anonymous User

• Description: A user who visits the platform without creating an account.
• Goals: Engage in random video or text chats anonymously.
• Needs: Simple and quick access to chat features, anonymity, and safety.

2. Registered User

• Description: A user who creates an account to unlock additional features.
• Goals: Access interest-based matching and save preferences.
• Needs: A secure account system and enhanced personalization options.

3. Admin

• Description: A moderator responsible for maintaining a safe and respectful environment.
• Goals: Monitor flagged sessions, enforce community guidelines, and manage user bans.
• Needs: Robust moderation tools and real-time monitoring capabilities.

5. Visuals Colors and Theme

Color Palette for raven-candi:

• Background: #1A1A2E (Deep Midnight Blue)
• Surface: #16213E (Dark Navy)
• Text: #E94560 (Vivid Coral Red)
• Accent: #0F3460 (Rich Sapphire Blue)
• Muted Tones: #53354A (Muted Plum)

This palette reflects a modern and slightly playful aesthetic, balancing dark tones for sophistication with vibrant accents for energy and engagement.

6. Signature Design Concept

The "Dynamic Galaxy" Landing Page

The homepage of raven-candi will feature an interactive galaxy map. Users will see a dark, starry background with constellations subtly glowing and shifting. Each star represents a potential connection, and as users hover over them, the stars will pulse gently, symbolizing the possibility of meeting someone new.

Key elements:

• Interactive Animation: Stars will twinkle and move slightly, creating a sense of depth and dynamism.
• Micro-interactions: Clicking on a star will initiate a connection, with a smooth transition to the chat interface.
• Color Shifts: The galaxy's hues will subtly change based on the time of day, offering a unique experience for users logging in at different times.
• Sound Design: A soft ambient soundtrack will play in the background, enhancing the immersive experience.

This design will make the platform instantly memorable and set the tone for exciting, spontaneous interactions.

7. Non-Functional Requirements

• The system must support at least 10,000 concurrent users.
• The platform should ensure end-to-end encryption for all communications.
• The system must comply with data protection regulations, including GDPR and local Indian data privacy laws.
• The platform should maintain an uptime of 99.9%.
• The system should be responsive and optimized for both desktop and mobile devices.
• The platform must support localization for multiple languages, starting with English and Hindi.

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
• Claude 4.6 Opas for moderation and content analysis

AI Tools:

• Langchain for conversational AI workflows
• Litellm for LLM routing

Orchestration:

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

9. Assumptions and Constraints

Assumptions:

• Users will have access to a stable internet connection for video and text chat.
• The majority of users will access the platform via desktop or mobile web browsers.
• Users will adhere to community guidelines, with moderation tools in place for violations.

Constraints:

• The platform must operate within the legal frameworks of India and other target countries.
• Real-time video and text chat functionality must be optimized for low-latency performance.
• The system must be scalable to accommodate a growing user base.

10. Glossary

• Anonymous User: A user who accesses the platform without creating an account.
• Registered User: A user who has created an account on the platform.
• Admin: A moderator responsible for maintaining the platform's safety and integrity.
• End-to-End Encryption: A method of secure communication that prevents third parties from accessing data while it's transferred.
• Localization: Adapting the platform to support multiple languages and regional preferences.
• Micro-interactions: Small, subtle animations or design elements that enhance user experience.