System Requirements Document (SRD)

Project Name: wise-simulator

1. Introduction

The wise-simulator is a high-quality Egyptian car simulation project envisioned by Hamza Salem. This simulator aims to provide an authentic driving experience by incorporating real-life Egyptian landmarks, cars commonly seen on Egyptian roads, and realistic AI traffic with Egyptian license plates. The project will also feature live weather synced to real-world conditions in Egypt and fully interactive, detailed car interiors.

This document outlines the system requirements for the wise-simulator, ensuring the project delivers an immersive and culturally authentic experience for users in Qatar and beyond.

2. System Overview

The wise-simulator is a car simulation platform designed to replicate the driving experience in Egypt. It will feature:

• Authentic Egyptian Landmarks: Detailed 3D modeling of iconic locations such as the Pyramids of Giza, the Nile River, and the streets of Cairo.
• Realistic AI Traffic: AI-driven vehicles that mimic real-life Egyptian traffic patterns, complete with authentic license plates and commonly seen car models.
• Customizable Vehicles: Players can choose from a vast library of cars, including all global models and Egyptian-specific vehicles like Fiat 128s, Peugeot 504s, and microbuses. Customization options will include exterior and interior modifications, performance upgrades, and personalized license plates.
• Live Weather System: Real-time weather updates based on actual conditions in Egypt, including sandstorms, rain, and sunny skies.
• Interactive Car Interiors: Fully functional dashboards with interactive elements such as steering, speedometers, and climate controls.
• Selective Re-run Capability: A feature allowing users and admins to regenerate the System Requirements Document (SRD) selectively to reflect updated requirements.

The simulator will be developed with a focus on high-quality graphics, realistic physics, and an engaging user experience.

3. Functional Requirements

As a User:

• I should be able to drive through detailed 3D models of Egyptian landmarks.
• I should be able to select and customize cars, including exterior, interior, and performance upgrades.
• I should be able to drive cars with fully interactive interiors, including functional dashboards.
• I should be able to experience live weather synced to real-world conditions in Egypt.
• I should be able to toggle weather settings manually (e.g., sandstorms, rain).
• I should be able to drive cars with authentic Egyptian license plates.
• I should be able to regenerate the System Requirements Document (SRD) selectively when updates are needed.

As an Admin:

• I should be able to update the database of cars and landmarks.
• I should be able to manage live weather syncing and manual overrides.
• I should be able to monitor and adjust AI traffic behavior.
• I should be able to trigger selective re-runs of the SRD to reflect updated requirements.

4. User Personas

1. Casual Driver

• Description: A user who wants to explore Egyptian landmarks and enjoy a relaxing driving experience.
• Goals: Drive through iconic locations, experience live weather, and customize cars.

2. Car Enthusiast

• Description: A user passionate about cars who enjoys detailed customization and realistic interiors.
• Goals: Modify cars extensively, interact with dashboards, and test performance upgrades.

3. Simulation Enthusiast

• Description: A user who values realism and immersion in driving simulations.
• Goals: Experience authentic AI traffic, realistic weather, and detailed Egyptian environments.

4. Administrator

• Description: A system manager responsible for maintaining and updating the simulator.
• Goals: Ensure smooth operation, update content, manage user feedback, and trigger SRD updates as needed.

5. Visuals Colors and Theme

Color Palette:

The wise-simulator will use a unique color palette inspired by Egypt’s natural and urban landscapes:

• Background: Desert Sand (#F4E3C1)
• Surface: Nile Blue (#0077B6)
• Text: Obsidian Black (#1C1C1C)
• Accent: Pyramid Gold (#D4AF37)
• Muted Tones: Oasis Green (#A3C4BC)

This palette reflects the warmth of Egypt’s deserts, the vibrancy of the Nile, and the timeless allure of its landmarks.

6. Signature Design Concept

The wise-simulator homepage will feature an interactive 3D map of Egypt.

Concept Details:

• 3D Map: A fully interactive map of Egypt with glowing markers for major cities and landmarks. Users can zoom in and out, rotate the map, and click on landmarks to view detailed previews.
• Dynamic Weather Effects: The map will display real-time weather conditions, such as sandstorms sweeping across the desert or rain over Alexandria.
• Animated Cars: Tiny 3D cars will drive along the map’s roads, showcasing the diversity of vehicles in the simulator.
• Landmark Highlights: Hovering over a landmark will trigger a short animation, such as the Pyramids lighting up or the Nile shimmering.
• Seamless Transitions: Clicking on a landmark will smoothly transition the user into the driving simulation for that location.

This bold design will captivate users from the moment they land on the homepage, setting the tone for an immersive experience.

7. Non-Functional Requirements

• Performance: The simulator must run at a minimum of 60 FPS on modern gaming PCs and consoles.
• Scalability: The system should support future expansions, such as additional landmarks or car models.
• Localization: The simulator will include Arabic and English language options.
• Accessibility: The UI will be designed to accommodate users with visual or motor impairments.
• Selective Re-run Capability: The system must allow users and admins to trigger selective re-runs of the SRD to reflect updated requirements.

8. Tech Stack

Frontend:

• React for Web
• React Native for mobile app

Backend:

• Python
• FastAPI

Database:

• MySQL for relational data (e.g., user profiles, car configurations)
• MongoDB for unstructured data (e.g., weather logs)

AI Models:

• GPT 5.4 for user-friendly responses
• Claude 4.6 Opas for coding and academic tasks
• Google Nano Banana for image generation

AI Tools:

• Litellm for LLM Routing
• Langchain

Orchestration:

• Docker and docker-compose for local development
• Kubernetes for server-side orchestration

9. Assumptions and Constraints

Assumptions:

• Users will have access to modern devices capable of running high-quality simulations.
• Real-time weather data will be available via a reliable API.

Constraints:

• The simulator must adhere to local regulations regarding content and cultural representation.
• Development will prioritize Egyptian landmarks and vehicles before expanding globally.

10. Glossary

• AI Traffic: Computer-controlled vehicles that simulate real-world traffic behavior.
• Customization: The ability for users to modify cars, including appearance and performance.
• Landmarks: Iconic locations in Egypt, such as the Pyramids of Giza and the Nile River.
• Live Weather: Real-time weather conditions synced to actual data from Egypt.
• Interactive Interiors: Car dashboards and controls that users can interact with during the simulation.
• Selective Re-run Capability: A feature allowing users or admins to regenerate the SRD selectively to reflect updated requirements.