Aggar is a vehicle rental platform connecting vehicle owners with customers. Owners can list, edit, and delete their vehicles while managing bookings. Customers search for vehicles by rating, type, brand, or distance, then book securely. The app includes mapping services, notifications, payment processing, and an admin dashboard for platform management, reporting, and user moderation.

1. Overview
2. Architecture
3. Authentication System
   • Login Page
   • Registration Pages
     • Screen 1: Personal Information
     • Screen 2: Credential Information
     • Screen 3: Location & User Type Selection
   • Verification Screen
4. Main Dashboard Pages
   • Customer Main Page
   • Renter Main Page
   • Admin Main Page
5. Communication System
   • Personal Chat Page
6. Notifications System
7. Profile Managment
8. Profile and Settings Page
9. Vehicle Management
10. Vehicle Details and Booking
    • Renter Vehicle Details Page
    • Customer Vehicle Details Page

Aggar is a comprehensive vehicle rental marketplace that connects vehicle owners with customers through a seamless online platform. The application provides a complete ecosystem for vehicle sharing with advanced features for all user types.

• Vehicle Listing Management: Easily list vehicles on the platform with detailed information and photos
• Listing Control: Full editing and deletion capabilities for managing vehicle listings
• Reservation Management: Receive and manage booking requests from customers
• Earnings Tracking: Monitor rental income and transaction history

• Advanced Search: Find vehicles by category, type, brand, or proximity location
• Location-Based Discovery: Integrated mapping services for finding nearby vehicles
• Secure Reservations: Safe and reliable booking system with instant confirmation
• Real-Time Communication: Direct messaging with vehicle owners including file and photo sharing

• Integrated Mapping: Location-based search and navigation services
• Smart Notifications: Instant updates for bookings, messages, and platform activities
• Secure Payments: Protected payment processing for all transactions
• Instant Messaging: Built-in communication system between users with multimedia support

• Platform Control: Comprehensive management of all platform operations
• Analytics & Reporting: Detailed reports on usage, revenue, and platform metrics
• Content Management: Add new vehicle types, brands, and categories to the system
• User Monitoring: Track user activity and platform engagement
• Moderation Tools: Enforce platform rules and take disciplinary actions when necessary
• Safety Assurance: Maintain a secure and reliable rental experience for all users

The Aggar application follows a modular Flutter architecture with clean separation of concerns and organized feature-based structure.

lib/
├── core/                           # Core application components
│   ├── api/                        # API services and HTTP clients
│   ├── cache/                      # Local data caching mechanisms
│   ├── cubit/                      # State management (Cubit pattern)
│   │   ├── edit_user_info/         # User profile editing state
│   │   │   ├── edit_user_info_cubit.dart
│   │   │   └── edit_user_info_state.dart
│   ├── errors/                     # Error handling and custom exceptions
│   ├── extensions/                 # Dart extensions for enhanced functionality
│   ├── helper/                     # Utility helper functions
│   ├── language/                   # Internationalization and localization
│   ├── notification/               # Push notification services
│   ├── refresh_token/              # Authentication token management
│   ├── report/                     # Reporting system core logic
│   ├── reportld/                   # Report ID management
│   ├── services/                   # Core application services
│   ├── theme/                      # Application theming and styling
│   ├── themes/                     # Multiple theme configurations
│   ├── translations/               # Translation files and localization
│   ├── user_cubit/                 # User authentication state management
│   ├── user_review_cubit/          # User review system state
│   ├── utils/                      # Utility functions and constants
│   └── widgets/                    # Reusable UI components
└── features/                       # Feature-based modular architecture
    ├── authorization/              # Authentication and authorization
    │   ├── data/                   # Data layer (models, repositories)
    │   └── presentation/           # UI layer (screens, widgets)
    └── booking/                    # Booking management feature
        ├── data/                   # Booking data models and services
        └── presentation/           # Booking UI components

The application implements Clean Architecture principles with clear separation between:

• Data Layer: API services, local storage, and data models
• Business Logic Layer: Cubit state management and business rules
• Presentation Layer: UI components, screens, and widgets

• Cubit Pattern: Used for predictable state management across the application
• Feature-Specific Cubits: Each major feature has its own state management
• Global State: Core user authentication and app-wide settings managed centrally

• Feature-Based Structure: Each major feature is self-contained with its own data and presentation layers
• Core Utilities: Shared components, services, and utilities available across all features
• Scalable Architecture: Easy to add new features without affecting existing functionality

Core Services

• API Integration: Centralized HTTP client and API service management
• Caching System: Local data storage for offline capabilities and performance
• Authentication: Secure user authentication with token refresh mechanisms
• Notifications: Real-time push notification handling and management

Feature Modules

• Authorization Module: Complete authentication flow with registration, login, and verification
• Booking Module: Comprehensive booking system with reservation management
• User Management: Profile management, settings, and user preferences
• Vehicle Management: Vehicle listing, editing, and management capabilities

Shared Components

• Reusable Widgets: Common UI components used throughout the application
• Theming System: Consistent visual design and theme management
• Internationalization: Multi-language support with translation management
• Error Handling: Centralized error management and user feedback systems

This architecture ensures maintainability, scalability, and clear separation of concerns while providing a robust foundation for the vehicle rental platform.

The application begins with an intelligent onboarding system that determines the user's path based on their installation status and account history:

• First-Time Installation: New users are directed to the login page to begin the authentication process
• Existing Account Holders: Users with valid credentials can log in directly and proceed to their respective main screens
• Account Type Routing:
  • Renters are directed to the Renter Main Screen upon successful login
  • Customers are directed to the Customer Main Screen upon successful login
• New User Registration: Users without accounts are guided through the comprehensive registration process

The login page serves as the primary entry point for existing users, providing secure access to their accounts with credential validation and account activation status verification.

The registration process consists of three sequential screens, each with built-in validation to ensure data integrity and completeness before proceeding to the next step.

This initial registration screen captures essential personal information:

• Username: Unique identifier for the user account
• Full Name: User's complete legal name
• Date of Birth: Age verification and account personalization
• Validation Requirements: All fields must be completed and validated before proceeding to the next screen

The credential setup screen establishes account security:

• Email Address: Primary contact and login identifier
• Password: Secure password meeting platform requirements
• Password Confirmation: Verification field to ensure password accuracy
• Validation Process: Email format validation and password matching confirmation required before advancing

The final registration screen completes the account setup:

• Location Services: GPS-based location detection or manual address entry
• Address Information: Complete address details for service area determination
• User Type Selection: Choose between Customer or Renter account types
• Terms and Conditions: Mandatory acceptance of platform terms and policies
• Final Validation: All fields must be completed and terms accepted before proceeding to verification

The verification system ensures account security and email validity:

• Email Code Delivery: Verification code sent to the registered email address
• Code Input: Six-digit verification code entry interface
• Resend Functionality: Option to resend verification code if not received
• Account Activation: Upon successful verification, users return to the login page to access their activated account
• Login Redirect: Verified users can now log in and access their appropriate main screen based on their selected user type

The Customer Main Page serves as the primary hub for vehicle discovery and booking, providing customers with comprehensive search and browsing capabilities.

The main screen displays the user's current address at the top, providing location context for vehicle searches and recommendations.

Type List Section

• Vehicle Categories: Browse vehicles by category (cars, motorcycles, trucks, etc.)
• Navigation: Click on any vehicle type to view the complete list of vehicles in that category
• Category-Specific Filtering: Access vehicles filtered by specific type requirements

Brand List Section

• Automotive Brands: Browse vehicles by manufacturer (Toyota, Honda, BMW, etc.)
• Brand Navigation: Click on any brand to view all available vehicles from that manufacturer
• Brand-Specific Listings: Access complete inventory organized by brand

All Vehicles Section This section is divided into three subsections for enhanced vehicle discovery:

• Most Rented Vehicles: Displays the most popular rental vehicles based on booking frequency
• Popular Vehicles: Shows trending vehicles based on customer ratings and engagement
• All Vehicles: Complete vehicle inventory with comprehensive listings

• Advanced Search Field: Navigate to the dedicated search screen for detailed filtering
• Search Parameters: Filter vehicles by multiple criteria:
  • Rating: Find vehicles based on customer ratings
  • Price Range: Set minimum and maximum rental rates
  • Vehicle Type: Filter by specific vehicle categories
  • Brand: Search within specific automotive brands
  • Year: Filter by manufacturing year range
  • Distance: Find vehicles by proximity (nearest to farthest)
• Location-Based Results: Search results prioritized by distance from user's current location

• Vehicle Cards: Click on any vehicle card to navigate to the detailed vehicle information page
• Quick Actions: Save vehicles to favorites, view basic details, and access booking options directly from the main screen

The Renter Main Page provides vehicle owners with comprehensive tools for managing their rental business and tracking bookings.

• Address Information: Current address of the renter account displayed prominently at the top of the screen

Calendar Section

• Booking Calendar: Visual calendar interface showing all upcoming and current bookings
• Availability Management: View which days have existing reservations
• Date Highlighting: Booked dates are clearly marked for easy scheduling reference
• Booking Overview: Quick view of rental schedule and availability gaps

New Booking List Section

• Recent Requests: Displays the newest booking requests in chronological order
• Booking Details: Essential information for each new booking including:
  • Customer information and contact details
  • Requested rental dates and duration
  • Selected vehicle and booking preferences
  • Booking status (pending, approved, declined)
• Quick Actions: Accept or decline booking requests directly from the main screen
• Real-Time Updates: Automatically refreshes with new booking requests as they arrive

• Request Handling: Streamlined process for responding to customer booking requests
• Calendar Integration: Booking decisions automatically update the calendar view
• Notification System: Instant alerts for new bookings and booking status changes

The Admin Main Page provides comprehensive platform oversight with user management, reporting, and administrative controls.

• Admin Address: Current address of the admin account displayed at the top of the interface

• User Search Field: Advanced search capabilities for finding platform users
• Search Parameters: Find users by:
  • Name: Search by full name or partial name matches
  • Username: Locate users by their unique identifiers

User Statistics Section

• User Analytics Chart: Visual representation of platform user distribution
• User Type Breakdown: Detailed statistics showing:
  • Admin Accounts: Total number of administrative users
  • Customer Accounts: Complete customer user count and activity metrics
  • Renter Accounts: Vehicle owner statistics and engagement data
• Growth Metrics: User registration trends and platform expansion data

Report Statistics Section Comprehensive reporting system covering all platform activities:

• Message Reports: Total count and statistics for communication-related reports
• Vehicle Reports: Vehicle listing violations, quality issues, and safety concerns
• Customer Review Reports: Customer feedback disputes and review authenticity issues
• Renter Review Reports: Vehicle owner rating disputes and feedback management
• App User Reports: General user behavior violations and platform misuse reports

Each report category displays:

• Total Report Count: Number of reports in each category
• Statistical Analysis: Trends, resolution rates, and category-specific metrics
• Status Breakdown: Open, in progress, and resolved report counts

All Reports List Section

• Report Management Interface: Comprehensive list of all platform reports
• Report Cards: Individual report summaries with essential details including:
  • Report type and category
  • Reporting user and reported user information
  • Report submission date and priority level
  • Current status and assigned administrator

When clicking on any report card, administrators access detailed report information and can take the following actions:

Administrative Actions:

• Ban User: Temporarily or permanently suspend user accounts
• Warn User: Issue formal warnings for policy violations
• Delete User: Remove user accounts for severe violations
• Account Restrictions: Limit user capabilities or access levels

Report Status Management:

• Status Updates: Change report status (open, in progress, resolved, dismissed)
• Action Documentation: Record all administrative actions taken for audit trails

Messages Overview Page

Central hub for all user conversations and communications The Messages Overview Page provides a comprehensive list of all previous conversations.

Individual conversation interface with multimedia support Real-Time Messaging

• Messages are sent and received instantly, enabling seamless communication
• Supports text, file, and image sharing for enhanced interaction
• Search functionality allows users to find specific message content

User Profile Access

• Clicking a recipient's name opens their profile
• Displays additional information such as user rating and location

Reporting Feature

• Users can report inappropriate behavior or content directly from the chat interface
• Reports are flagged for review to ensure a safe communication environment

Communication Features

• Real-Time Delivery: Messages are delivered instantly for efficient communication
• Multimedia Support: Share files and images seamlessly within the chat
• Search Functionality: Easily locate specific messages or content
• User Reporting: Report users to maintain a safe and respectful platform
• Profile Integration: Access detailed user information directly from the chat interface

The Aggar platform features a comprehensive real-time notification system that keeps all users informed of important activities and transactions. The system provides instant updates with read/unread status tracking to ensure users never miss critical information.

When a customer selects a vehicle and chooses their preferred booking dates and times, the system automatically sends a real-time notification to the vehicle owner. This notification includes:

• Customer booking request details
• Selected rental dates and duration
• Pickup and return time preferences
• Customer profile information

Vehicle owners receive booking requests and can respond with two actions:

Acceptance Process:

• When a renter accepts a booking request, the customer receives an instant notification confirming the approval
• The notification includes booking confirmation details and next steps for payment processing
• The system updates the booking status to "Approved - Pending Payment"

Decline Process:

• If a renter declines the booking request, the customer receives immediate notification of the rejection
• The notification may include alternative suggestions or reasons for decline
• The system automatically releases the booking hold and updates availability

Once a booking is approved and the customer proceeds with payment:

• Payment processing notifications are sent in real-time to confirm transaction status
• Successful payment triggers confirmation notifications to both customer and renter
• Final booking confirmation includes rental details, pickup instructions, and contact information

• Read Status Tracking: All notifications are marked as read/unread for better user experience
• Real-Time Delivery: Instant notification delivery ensures immediate communication
• Comprehensive Coverage: Notifications cover all stages of the booking and rental process
• Status Updates: Continuous updates throughout the entire rental journey from request to completion

The Aggar platform provides three distinct user interfaces for profile management: Customer, Renter, and Admin, each tailored to their specific roles.

Customer Interface

Customers can view and manage their saved vehicles, reviews, and bookings. Their profile displays their image, name, username, and an options button that navigates to profile settings. An edit button allows customers to update their profile information.

Renter Interface

Renters have access to their reviews, bookings, and a list of vehicles they own. Similar to the customer interface, their profile includes an image, name, username, and an options button for navigating to profile settings, along with an edit button for profile updates.

Admin Interface

The admin interface is streamlined, focusing solely on basic settings. It does not include bookings, reviews, or vehicle management, ensuring a simple and focused experience for administrative tasks.

The Profile and Settings page offers comprehensive account management through multiple organized sections:

• Personal Info: Complete profile information that users can view and edit as needed
• Account Details: Manage personal data, contact information, and profile preferences

The financial section varies based on user type:

• Payment Setup: Activate or create Stripe account integration for secure payment processing
• Account Status: If a Stripe account already exists, a confirmation notification is displayed
• Payout Details: Access detailed payout information including incoming earnings and transaction details
• Rental History: Complete history of all rental transactions with advanced filtering options

• Payment Methods: Manage payment options and billing information
• Rental History: Comprehensive booking history with filtering capabilities and detailed transaction views

• Platform Balance: Monitoring the application stripe account

• Rental History Access: Click on rental history to view all past transactions
• Advanced Filtering: Sort and filter rental history by various criteria
• Detailed Views: Navigate to specific rental details for comprehensive transaction information

• Settings & Preferences: Customize app experience through:
  • Language Selection: Choose preferred language for the interface
  • Theme Options: Switch between different visual themes and display modes

• Support Section: Direct access to help and assistance:
  • Personal Support: Connect directly with support staff or developers for personalized assistance
  • Help Center: Access comprehensive support resources and documentation
  • Direct Communication: Establish direct contact with the support team for issue resolution

• Logout Option: Secure logout functionality to safely exit your account session

When you click the add button on the renter main screen, you navigate to the vehicle creation interface. This comprehensive process allows renters to list their vehicles on the platform with detailed information and specifications.

• Data Entry: Enter comprehensive vehicle details including make, model, year, and specifications
• Validation System: Built-in validators prevent empty fields or incorrect information, ensuring data quality
• Image Upload: Add multiple photos showcasing the vehicle from different angles
• Location Setting: Define the vehicle's pickup location with address details

• Post-Creation Setup: After vehicle creation, navigate to the discount configuration screen
• Optional Pricing: Choose whether to apply discounts to your vehicle listing
• Multiple Discounts: Create and manage various discount options and promotional pricing
• Flexible Pricing: Adjust rates based on seasonal demand or booking duration

• Edit Capabilities: Full editing access to modify any vehicle information after creation
• Real-Time Updates: Changes are immediately reflected in the platform listings
• Information Management: Update specifications, pricing, availability, and descriptions as needed
• Listing Control: Maintain current and accurate vehicle informtion throughout the listing lifecycle

Administrative interface for managing vehicle categories, types, and brands

• Add New Types: Create new vehicle type categories through the admin dashboard
• Edit Existing Types: Modify vehicle type information and specifications as needed
• Remove Types: Delete unused or obsolete vehicle types from the system
• Add New Brands: Register new automotive brands in the platform database
• Edit Brand Information: Update existing brand details and associated data
• Remove Brands: Delete brands that are no longer relevant to the platform

When you click on a vehicle card, it displays the vehicle details page for renters. This interface is similar to the customer's view but presents all information in a unified single-screen layout without section divisions.

• Vehicle Images: Primary vehicle photos displayed prominently
• Location Services: Complete location details with "View on Map" functionality for precise positioning
• Vehicle Properties: Comprehensive specifications and feature listings
• Image Gallery: Full collection of vehicle photos and visual documentation
• Rating System: Overall rating display with customer review comments and total review count
• Overview Section: Detailed vehicle description with customer feedback and statistics

• Pricing Details: Displays the daily rental rate and any active discounts
• Discount Control: Shows current discount percentages and promotional pricing
• Rate Adjustment: Ability to modify pricing and discount structures

• Menu Options: Access vehicle management tools through the app bar menu button
• Delete Function: Remove vehicle listings with confirmation prompts to ensure intentional deletion
• Edit Capabilities: Navigate to the edit screen for comprehensive vehicle information updates
• Information Updates: Modify all vehicle details, specifications, and listing information through the dedicated edit interface

When you click on a vehicle card, it displays the vehicle details page with three main sections: About, Properties, and Reviews.

• Renter Information: Displays the rental partner's profile details with their activity status
• Messaging: Provides the ability to message the vehicle owner directly
• Location Services: Shows the vehicle's current location with full address and coordinates
• Map Integration: Displays the exact location on Google Maps with detailed address information

• Vehicle Capabilities: Comprehensive overview of the vehicle's features and specifications
• Image Gallery: Complete collection of vehicle photos and images
• Status Indicators:
  • Current physical condition of the vehicle
  • Availability status (active/inactive)
  • Stock availability (in stock/out of stock)

• Rating System: Displays the overall rating for the vehicle
• User Comments: Shows customer reviews and feedback
• Review Counter: Displays the total number of reviews received

• Vehicle Images: Primary vehicle photos displayed at the top
• Basic Information: Vehicle name, transmission type, and manufacturing year
• Action Buttons:
  • Book Button: Located at the bottom of the screen for making reservations
  • Report Vehicle: Option to report issues or violations
  • Save Vehicle: Ability to save the vehicle to favorites or watchlist