askarmus / SmartHotel

This repository provides comprehensive guidance on developing your upcoming microservices architecture project using .NET Core 8.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

.NET CORE 8.0 Microservices Boilerplate

Overview

Explore the SmartHotel Booking System, a comprehensive showcase illustrating the power of microservices architecture. This project, crafted with simplicity and efficiency in mind, demonstrates the orchestration of a hotel booking workflow through a series of modular microservices.

If you find this project useful, please give it a star. Thanks! ⭐

Pattern, C#12 and .NET Core 8 features.

Built on .NET 8.0 Follows Clean Architecture Principles Docker-Compose File Examples
Global Error Handling Uses Entity Framework Core as DB Abstraction Global using
Fluent Validation and a Validation Pipeline Behaviour on top of MediatR JWT Authentication CQRS implementation with MediatR library
API Versioning Uses Entity Framework Core as DB Abstraction Minimal API for all endpoints.
Rabbitmq on top of MassTranit for Event Driven Architecture between our microservices. Health Check for reporting the health of app infrastructure components. Ocelot as a microservices gateway.

Architecture

techStack

♥️ Technical stacks

  • ❇️ .NET Core 8 - .NET Framework and .NET Core, including ASP.NET and ASP.NET Core
  • ❇️ MediatR - Simple, unambitious mediator implementation in .NET
  • ❇️ FluentValidation - Popular .NET validation library for building strongly-typed validation rules
  • ❇️ serilog - Simple .NET logging with fully-structured events
  • ❇️ Ocelot - Ocelot is an open-source API Gateway, designed for microservices architecture.
  • ❇️ AutoMapper - AutoMapper is a simple library that helps us to transform one object type into another.
  • ❇️ EF Core - Modern object-database mapper for .NET. It supports LINQ queries, change tracking, updates, and schema migrations
  • ❇️ Polly - Polly is a .NET resilience and transient-fault-handling library that allows developers to express policies such as Retry, Circuit Breaker, Timeout, Bulkhead Isolation, and Fallback in a fluent and thread-safe manner
  • ❇️ RabbitMQ - RabbitMQ is an open-source message-broker
  • ❇️ MassTransit - MassTransit provides a developer-focused, modern platform for creating distributed applications without complexity.
  • ❇️ Mog - The most popular and friendly mocking library for .NET.
  • ❇️ NUite - NUnit is a unit-testing framework for all .Net languages.

techStack

Features

Booking Service: Manages the booking lifecycle, orchestrates workflows using MassTransit and RabbitMQ, and implements the Saga pattern for state transitions. Collaborates with Payment and Availability Services.

Payment Service: Processes payments asynchronously, communicates with external gateways, and updates the Booking Service with payment statuses, ensuring seamless integration within the booking ecosystem.

Availability Service: Manages real-time room availability updates based on bookings from the Booking Service, fostering an accurate representation of room status and communicating updates to support timely decision-making.

Authentication Service: Ensures system security by managing user authentication, validating credentials, and providing authentication tokens for secure operations, safeguarding against unauthorized access.

#f03c15 Todo Items

  • API version ✔️
  • Saga Orchestration using MassTransit
  • Infrastructure project to deploy Azure AKS
  • Reduce a Significant part of code by using Primary Constructors.
  • Add unit testing proejct for all services.

Authors

If you have any questions or need further assistance, please contact the project author at LinkedIn

Contributing

Feel free to contribute to this project! Share your ideas, bug fixes, or improvements by opening an issue or submitting a pull request. Your input is valuable and helps enhance the project.

License

This project is licensed under the MIT License.

About

This repository provides comprehensive guidance on developing your upcoming microservices architecture project using .NET Core 8.

License:MIT License


Languages

Language:C# 97.1%Language:Dockerfile 2.8%Language:TSQL 0.2%