System Requirements Document (SRD)

Project Name: orbit-game

1. Introduction

The orbit-game is a betting platform designed for users in South Africa (ZA), where players can join, place bets on various events, and earn real money through bank transfers. The platform is managed by Kamogelo, who will act as the admin, overseeing all operations, including event management, user accounts, and payouts. Inspired by platforms like Betway, orbit-game aims to provide a seamless, engaging, and trustworthy experience for its users.

This document outlines the system requirements for the development of orbit-game, including functional and non-functional requirements, user personas, visual themes, and technical specifications.

2. System Overview

The orbit-game platform will serve as an online betting system where users can:

• Register and create accounts.
• Deposit funds into their accounts.
• Place bets on various events (e.g., sports, games, or other outcomes).
• Withdraw winnings via bank transfer.

Kamogelo, as the admin, will have access to a comprehensive dashboard to manage events, monitor user activity, and handle payouts. The system will prioritize security, transparency, and ease of use to build trust and encourage user engagement.

Key features include:

• User registration and authentication.
• Event listing and live odds display.
• Secure deposit and withdrawal mechanisms.
• Admin dashboard for event and user management.

3. Functional Requirements

User Stories:

• As Admin, I should be able to create and manage betting events.
• As Admin, I should be able to view and manage user accounts.
• As Admin, I should be able to process payouts via bank transfer.
• As User, I should be able to register and log in to my account.
• As User, I should be able to deposit funds into my account.
• As User, I should be able to view available betting events and odds.
• As User, I should be able to place bets on events.
• As User, I should be able to withdraw winnings to my bank account.
• As User, I should be able to view my betting history and account balance.

4. User Personas

4.1 Admin (Kamogelo)

• Role: Oversees the platform, manages events, and processes payouts.
• Goals: Ensure the platform runs smoothly, maintain user trust, and manage financial transactions.
• Needs: A comprehensive dashboard for event creation, user management, and payout processing.

4.2 Registered User

• Role: A player who registers on the platform to place bets and earn money.
• Goals: Participate in betting events, win money, and withdraw winnings securely.
• Needs: A user-friendly interface for account management, betting, and transactions.

5. Visuals Colors and Theme

The visual identity of orbit-game will reflect trust, excitement, and professionalism. Below is the custom color palette for the platform:

• primary: #1A237E (Deep Indigo)
• primary_light: #534BAE (Soft Indigo)
• secondary: #FF6F00 (Vivid Amber)
• accent: #D500F9 (Electric Purple)
• highlight: #FFAB40 (Bright Orange)
• bg: #F5F5F5 (Light Gray)
• surface: rgba(26, 35, 126, 0.1) (Translucent Indigo)
• text: #212121 (Dark Gray)
• text_muted: #757575 (Muted Gray)
• border: rgba(33, 33, 33, 0.2) (Subtle Gray)

6. Signature Design Concept

Interactive Betting Universe

The homepage will feature an interactive galaxy map where each star represents a betting event. Users can:

• Hover over stars to see event details (e.g., teams, odds, and start times).
• Click on a star to open a detailed event page with betting options.
• Drag the galaxy to explore more events, creating a sense of discovery.

The galaxy will be rendered using @react-three/fiber and @react-three/drei for 3D interactivity. Subtle animations, such as stars pulsing or orbiting, will add a dynamic feel. The color scheme will shift slightly based on the time of day, creating a living, immersive experience.

7. Interaction Model & Motion Direction

Landing Page Interaction Model: Parallax

The landing page will use a parallax interaction model, with layered depth effects as users scroll. Key elements include:

• A dynamic galaxy background that moves at different speeds.
• Scroll-triggered animations for event highlights and CTAs.
• Hover effects on interactive elements, such as buttons and event cards.

Internal Pages: Animated

Internal pages, such as the dashboard and betting interface, will feature moderate animations for transitions and hover states, ensuring a polished user experience without compromising functionality.

8. Non-Functional Requirements

• Performance: The platform must handle up to 10,000 concurrent users.
• Security: All transactions must be encrypted using SSL/TLS.
• Scalability: The system should be scalable to accommodate future growth.
• Localization: Default to South African Rand (ZAR) and English language.
• Availability: 99.9% uptime SLA.

9. Tech Stack

Frontend

• React for Web

Backend

• Python
• FastAPI

Database

• MySQL (with Alembic for migrations)

AI Tools

• GPT 5.4 for user-friendly responses

Orchestration

• Docker
• Kubernetes

10. Assumptions and Constraints

• The platform will initially target users in South Africa.
• Bank transfers will be the only payout method.
• Betting events will be manually created and managed by the admin.
• The platform will comply with South African gambling regulations.

11. Glossary

• Admin: The person managing the platform (Kamogelo).
• User: A registered player on the platform.
• Betting Event: An event on which users can place bets.
• Odds: The probability of an event outcome, determining potential winnings.
• Payout: The process of transferring winnings to a user's bank account.