System Requirements Document (SRD)

Project Name: azure-iracing

1. Introduction

The azure-iracing project aims to develop an advanced toolset for the iRacing platform, focusing on enhancing user experience and performance through innovative AI-driven solutions. This document outlines the system requirements for the project, ensuring clarity and alignment with the project's goals.

Given the competitive nature of iRacing and its strict adherence to fair play, this document assumes the development of tools that comply with ethical guidelines and platform rules. The project will cater to users in the UK (GB), considering local preferences such as timezone (GMT/BST) and regional standards.

2. System Overview

The azure-iracing project is designed to provide iRacing users with advanced tools to improve their racing performance. The system will leverage AI and telemetry data to deliver actionable insights, real-time feedback, and automated functionalities. The core features include telemetry analysis, grip optimization, and a newly requested AI-driven racing bot that interfaces with the iRacing platform to autonomously control vehicle inputs.

The system will be built using a robust tech stack, ensuring scalability, reliability, and performance. It will include a web-based interface for ease of access and a mobile app for on-the-go functionality.

3. Functional Requirements

The functional requirements for azure-iracing are as follows:

• As a User, I should be able to analyze telemetry data to understand tire wear, temperature, and track conditions.
• As a User, I should be able to receive real-time feedback on racing lines, braking points, and gear changes.
• As a User, I should be able to optimize grip through AI-suggested setup adjustments.
• As a User, I should be able to access a dashboard that visualizes my performance metrics.
• As a User, I should be able to use an AI-driven racing bot that interfaces with the iRacing platform to autonomously control vehicle inputs.

4. User Personas

The following user personas have been identified for the azure-iracing project:

1. Casual Racer

   • Goals: Improve racing skills, understand telemetry data, and enhance grip.
   • Needs: Easy-to-use interface, real-time feedback, and actionable insights.

2. Competitive Racer

   • Goals: Gain a competitive edge, optimize vehicle setup, and analyze performance metrics.
   • Needs: Advanced telemetry analysis, AI-driven recommendations, and detailed performance dashboards.

3. Tech Enthusiast

   • Goals: Explore AI-driven functionalities and experiment with automated racing tools.
   • Needs: Access to the AI-driven racing bot and customization options for automation.

5. Creative Reference Stories (AI Inspiration)

Based on the project's focus on precision, performance, and AI-driven automation, the Stormy Ocean Authority design story has been selected as the creative reference. This story's cinematic and powerful aesthetic aligns with the high-performance and resilient nature of the azure-iracing project.

6. Visuals Colors and Theme

The visual design for azure-iracing will reflect a cinematic and high-performance aesthetic inspired by the Stormy Ocean Authority story. Below is the unique color palette for the project:

• Background: #0A1B3D (deep navy)
• Surface: #1E2A45 (muted blue-gray)
• Text: #F5E9D2 (warm ivory)
• Accent: #FF8C42 (soft tangerine)
• Muted Tones: #4A5A73 (subtle gray-blue)

The typography will include:

• Headings: Dramatic serif, weight 700 (e.g., Playfair Display).
• Body Text: Clean light sans-serif, weight 300 (e.g., Open Sans).

The layout will feature generous negative space, a cinematic fullscreen hero section, and slow, intentional motion effects like fade-up and parallax.

7. Signature Design Concept

The homepage of azure-iracing will feature a dynamic racing cockpit simulation. Users will be greeted with an immersive 3D cockpit view that reacts to mouse movements or touch gestures, creating a sense of being inside a high-performance racing car.

Key elements:

• Interactive Dashboard: The cockpit's dashboard will display live telemetry data, such as speed, tire temperature, and grip levels, in real-time.
• AI Bot Activation: A glowing "Activate AI" button will pulsate subtly, inviting users to engage the AI-driven racing bot.
• Cinematic Animations: The background will feature a stormy racetrack scene with dynamic lighting and subtle rain effects, reinforcing the project's high-performance theme.
• Micro-Interactions: Buttons and controls will respond with smooth glows and slight movements, enhancing the tactile experience.

This design concept will make the homepage unforgettable, drawing users into the world of high-performance racing.

8. Non-Functional Requirements

• Performance: The system must process telemetry data and provide real-time feedback with a latency of less than 100ms.
• Scalability: The system should support up to 10,000 concurrent users without performance degradation.
• Compliance: The system must adhere to iRacing's terms of service and ethical guidelines.
• Security: All user data must be encrypted in transit and at rest.
• Availability: The system should maintain 99.9% uptime.

9. Tech Stack

The following technologies will be used for the azure-iracing project:

• Frontend: React for Web, React Native for mobile app.
• Backend: Python, FastAPI.
• Database: MySQL with Alembic for migrations.
• AI Models:
  • GPT 5.2 for user-friendly responses.
  • Claude 4.5 Opas for academic or coding work.
  • Gemini 3 Pro for friendly responses.
• AI Tools: Litellm for LLM routing, Langchain.
• Orchestration: Docker, docker-compose, Kubernetes.

10. Assumptions and Constraints

• The AI-driven racing bot will comply with iRacing's terms of service and will not be used for competitive advantage in official races.
• The system will primarily target users in the UK, considering GMT/BST timezone and regional preferences.
• The project will require user consent for data collection and processing.

11. Glossary

• Telemetry: Data collected from the vehicle during a race, including speed, tire temperature, and grip levels.
• AI-Driven Racing Bot: An automated system that controls vehicle inputs based on AI algorithms.
• Grip Optimization: Adjustments made to improve the vehicle's traction on the track.
• LLM: Large Language Model, used for natural language processing tasks.

This document outlines the updated requirements for the azure-iracing project, incorporating the new functionality for an AI-driven racing bot while maintaining a focus on ethical and compliant development.