Skip to content

leomarcamargo/lcs-urbanify

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Urbanify – Vehicle Rental System

📖 Overview

Urbanify is an innovative nano vehicle rental solution, allowing drivers to rent vehicles and pay according to usage time (minutes, hours, or days) with full flexibility.

The system is built with .NET 9 and orchestrated with .NET Aspire, which manages all dependencies, configuration, and service discovery automatically. This eliminates the need for manual environment variable configuration or external service setup.


🏗 Architecture

The architecture is documented using the C4 Model.

  • Context Diagram: Shows how the Rental System interacts with its main actor (Driver).
  • Container Diagram: Details the main containers of the system, including Rides.API, Vehicles.API, Redis (distributed lock), and their supporting libraries. The project architecture is documented using the C4 Model, covering the Context and Container views.

📊 Architecture Diagrams

The project architecture is documented using the C4 Model, covering the Context and Container views.

Context Diagram

Context Diagram

Container Diagram

Container Diagram

⚙️ Technologies

  • .NET 9
  • .NET Aspire (distributed application model)
  • ASP.NET Core Web API
  • SQL Server (started and orchestrated automatically by Aspire)
  • Redis (used for distributed locking)

📋 Prerequisites

Make sure you have installed:

No manual database, Redis, or environment configuration is required. Aspire will handle dependencies automatically.


🚀 Running the Project

From the root folder, run the Aspire AppHost:

dotnet run --project LCS.Urbanify.AppHost

This will start all required services:

  • Rides.API
  • Vehicles.API
  • SQL Server container for persistence
  • Redis container for distributed locking

Service discovery, connection strings, and orchestration are fully managed by .NET Aspire.


📂 Project Structure

/docs
  /diagrams/images   # C4 model diagrams (context, container)

/src
  /LCS.Urbanify.AppHost         # Aspire orchestrator
  /LCS.Urbanify.Core.LIB        # Shared library
  /LCS.Urbanify.Rides.API       # API for managing rentals/trips
  /LCS.Urbanify.Vehicles.API    # API for managing vehicles
  /LCS.Urbanify.ServiceDefaults # Cross-cutting Aspire configuration

📜 License

This project is licensed under the MIT License.

About

Nano vehicle rental system built with .NET 9 and Aspire

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages