System Requirements Document (SRD) for Misty-Cab

1. Introduction

The Misty-Cab project is a comprehensive cab booking application designed to provide a seamless experience for both riders and drivers. Developed using Flutter, the app ensures a consistent and high-quality user interface across platforms. This document outlines the system requirements for Misty-Cab, focusing on features like fare estimation, live tracking, and driver ratings to enhance user trust and engagement.

This SRD is tailored for Harsh Kumar, based in India (IN), and considers locale-specific defaults such as INR currency, IST timezone, and regional preferences for usability.

2. System Overview

Misty-Cab is a dual-role application catering to two primary user groups: riders and drivers. The system will enable riders to book rides, estimate fares, track their rides in real-time, and rate their drivers. Drivers will manage ride requests, navigate to pickup/drop-off locations, and view their earnings.

The app will leverage Flutter for cross-platform compatibility, ensuring a smooth experience on both Android and iOS. Backend services will be powered by Python and FastAPI, with MySQL as the primary database for structured data storage. Real-time features like live tracking will be supported by WebSocket or similar technologies.

3. Functional Requirements

Rider Features

• As a Rider, I should be able to register and log in to the app.
• As a Rider, I should be able to book a ride by entering my pickup and drop-off locations.
• As a Rider, I should be able to view fare estimates before confirming a ride.
• As a Rider, I should be able to track my ride in real-time on a map.
• As a Rider, I should be able to rate and review my driver after the ride.
• As a Rider, I should be able to view my ride history and receipts.

Driver Features

• As a Driver, I should be able to register and log in to the app.
• As a Driver, I should be able to accept or decline ride requests.
• As a Driver, I should be able to view navigation to the rider's pickup and drop-off locations.
• As a Driver, I should be able to view my earnings and ride history.
• As a Driver, I should be able to update my availability status (online/offline).

Admin Features

• As an Admin, I should be able to manage user accounts (riders and drivers).
• As an Admin, I should be able to monitor ride activity and system performance.
• As an Admin, I should be able to resolve disputes between riders and drivers.
• As an Admin, I should be able to generate reports on app usage and earnings.

4. User Personas

Rider

• Description: Individuals looking for convenient and affordable transportation.
• Goals: Book rides, track progress, and ensure a safe journey.
• Pain Points: Unreliable fare estimates, lack of real-time tracking, and poor driver behavior.

Driver

• Description: Individuals seeking to earn income by providing transportation services.
• Goals: Maximize earnings, efficiently navigate routes, and maintain high ratings.
• Pain Points: Unclear ride requests, low earnings, and disputes with riders.

Admin

• Description: System administrators managing the platform's operations.
• Goals: Ensure smooth functioning of the app, resolve issues, and analyze performance metrics.
• Pain Points: Overwhelming data, user disputes, and system downtime.

5. Visuals Colors and Theme

Unique Color Palette

• Background: #F5F9FF (Soft Misty Blue)
• Surface: #FFFFFF (Pure White)
• Text: #2C3E50 (Deep Charcoal)
• Accent: #3498DB (Vibrant Sky Blue)
• Muted Tones: #BDC3C7 (Light Gray)

This palette reflects a clean, professional, and approachable aesthetic, aligning with the Misty-Cab brand identity.

6. Signature Design Concept

Interactive Ride Map with Dynamic Animations

The home page of Misty-Cab will feature an interactive ride map as its centerpiece. Upon opening the app, users will see a 3D animated map of their current city, with key landmarks subtly highlighted. Riders can drag and drop pins to set their pickup and drop-off locations, with smooth transitions and animations guiding the interaction.

Key features of the design:

• Dynamic Map Animations: The map will zoom in and out as users interact with it, creating a sense of depth and immersion.
• Live Ride Icons: Small animated car icons will move along the map, representing active rides in the area.
• Micro-Interactions: Buttons and icons will have subtle hover and click effects, such as a ripple animation when selecting a location.
• Color Shifts: The map's color scheme will adapt to the time of day (e.g., brighter tones during the day and darker, muted tones at night).

This design ensures that the first impression of Misty-Cab is both visually stunning and functionally intuitive.

7. Non-Functional Requirements

• Performance: The app should load within 2 seconds on a 4G network.
• Scalability: The system must support up to 10,000 concurrent users in the initial phase.
• Security: All user data must be encrypted in transit and at rest.
• Availability: The app should maintain 99.9% uptime.
• Localization: The app must support INR currency and IST timezone by default.

8. Tech Stack

Frontend

• Flutter (for cross-platform mobile app development)

Backend

• Python
• FastAPI

Database

• MySQL (primary database)
• Alembic (for database migrations)

Real-Time Features

• WebSocket (for live tracking and updates)

AI Models

• GPT 5.4 (for user-friendly responses)
• Claude 4.6 Opas (for coding-related queries)

AI Tools

• Langchain
• Litellm (for LLM routing)

Orchestration

• Docker (local)
• Kubernetes (server-side)

9. Assumptions and Constraints

Assumptions

• Users will have access to smartphones with GPS functionality.
• The app will primarily target users in India, with plans for future expansion.
• Drivers will have basic knowledge of using smartphones and navigation apps.

Constraints

• The app must comply with Indian data protection laws.
• Initial development will focus on mobile platforms only (no web version).
• Real-time tracking accuracy depends on the quality of GPS signals.

10. Glossary

• Rider: A user who books rides through the Misty-Cab app.
• Driver: A user who provides transportation services via the Misty-Cab app.
• Admin: A system administrator managing the platform's operations.
• Fare Estimate: An approximate cost of the ride calculated based on distance and time.
• Live Tracking: Real-time visualization of the ride's progress on a map.
• IST: Indian Standard Time.
• INR: Indian Rupee.