Skip to main content

Welcome to Masar Eagle

Masar Eagle is a production-ready transportation management system built with modern .NET technologies and microservices architecture. It provides a complete solution for managing trips, bookings, users, and payments in real-time transportation operations.

What is Masar Eagle?

Masar Eagle is a multi-tenant transportation platform that supports three primary user types:
  • Drivers - Create and manage trips, handle bookings, track earnings
  • Passengers - Search and book trips, manage payments, rate drivers
  • Companies - Manage fleets, drivers, and company-wide bookings
The system is built on .NET Aspire, providing cloud-native orchestration, observability, and service discovery out of the box.

Key Features

Microservices Architecture

Built with .NET Aspire for modern cloud-native applications with independent, scalable services

Real-time Trip Management

Create, search, and manage trips with real-time availability and booking confirmations

Integrated Payments

Wallet system with Moyasar payment gateway integration and bank transfer support

Multi-currency Support

Flexible commission policies with support for multiple currencies and exchange rates

Event-driven Messaging

RabbitMQ and Wolverine for reliable, asynchronous communication between services

Complete Observability

OpenTelemetry integration with Grafana, Prometheus, Loki, and Jaeger for monitoring

Architecture Overview

Masar Eagle consists of five core microservices:

Gateway API

YARP reverse proxy providing unified API access and routing

Identity Service

OpenID Connect authentication with OTP-based login

Users Service

Manages drivers, passengers, companies, vehicles, and zones

Trips Service

Trip creation, booking management, and payment processing

Notifications Service

Push notifications and device token management

Technology Stack

  • .NET 8 - Modern, high-performance framework
  • .NET Aspire - Cloud-native orchestration and service discovery
  • PostgreSQL - Reliable relational database
  • RabbitMQ - Message broker for event-driven architecture
  • OpenID Connect - Industry-standard authentication
  • YARP - Reverse proxy for API gateway
  • Wolverine - Messaging framework for .NET
  • OpenTelemetry - Observability and distributed tracing

Next Steps

Quickstart

Get Masar Eagle running locally in minutes

Architecture

Learn about the system architecture and design decisions

API Reference

Explore the complete API documentation

Deployment

Deploy Masar Eagle to production with .NET Aspire

Build docs developers (and LLMs) love