Moon-Idea System Requirements Document

1. Introduction

This document outlines the system requirements for the "Moon-Idea" project. The purpose of this document is to provide a comprehensive overview of the system's capabilities, user interactions, and design elements to ensure successful implementation and deployment.

2. System Overview

The Moon-Idea project is designed to facilitate the management of rental cars, including tracking driver information, vehicle usage, and fuel consumption. The system will provide users with detailed data tables and analytics to optimize operations and improve efficiency.

3. Functional Requirements

• As a User, I should be able to view a data table for rental cars that includes driver name, departure time, arrival time, starting km, ending km, fuel in liters, fuel rate, total km, total time, km per liter, total fuel cost, cost per km, total rides, and top-up.

4. User Personas

• Admin: Responsible for managing the overall system, including user access and data integrity.
• Driver: Uses the system to log trip details and fuel usage.
• Fleet Manager: Monitors vehicle usage, fuel consumption, and operational efficiency.

5. Core User Flows

• Driver logs trip: Driver enters departure time, arrival time, starting km, ending km, and fuel details -> System calculates total km, total time, km per liter, total fuel cost, and cost per km -> Data is updated in the system.
• Fleet Manager reviews data: Fleet Manager accesses data table -> Reviews trip details and fuel consumption -> Identifies areas for operational improvement.

6. Visuals Colors and Theme

• primary: #1A73E8 (deep blue)
• primary_light: #E8F0FE (light blue)
• secondary: #FF6F61 (coral)
• accent: #FFD700 (gold)
• highlight: #FFA500 (orange)
• bg: #FFFFFF (white)
• surface: rgba(240, 240, 240, 0.8)
• text: #333333 (dark gray)
• text_muted: #777777 (light gray)
• border: rgba(200, 200, 200, 0.5)

7. Signature Design Concept

The Moon-Idea homepage will feature an interactive 3D dashboard using @react-three/fiber and @react-three/drei. Users will navigate through a virtual car rental lot where each car represents a data point. Hovering over a car will display detailed trip information, and clicking will expand the data into a full-screen analytics view. The dashboard will dynamically update in real-time, providing a visually engaging and informative experience.

8. Interaction Model & Motion Direction

The landing page will employ a "parallax" interaction model, creating a layered depth effect as users scroll through the site. Decorative elements such as animated cars and fuel gauges will move at different speeds, enhancing the storytelling aspect of the site. Internal pages will maintain a "static" interaction model for clarity and ease of use.

9. Non-Functional Requirements

• The system must support real-time data updates.
• The user interface should be responsive and accessible across devices.
• Data security and privacy must be ensured, complying with relevant regulations.

10. Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB, using Alembic for migrations

11. Assumptions and Constraints

• The system will be primarily used in Pakistan, considering local timezone and currency.
• The system must integrate with existing fleet management tools if applicable.

12. Glossary

• KM: Kilometers
• Fuel Rate: Cost per liter of fuel
• Top-up: Additional fuel added during a trip

This document serves as a comprehensive guide for the development and implementation of the Moon-Idea project, ensuring all stakeholders have a clear understanding of the system's requirements and design.