Restaurants API

This is a .NET 9.0 web API for managing restaurants, following the principles of Clean Architecture.

Project Structure

• src/Restaurants.API: The main API project. This is the entry point of the application.
• src/Restaurants.Application: Contains the application logic. This layer is responsible for the application's behavior and policies.
• src/Restaurants.Domain: Contains enterprise logic and types. This is the core layer of the application.
• src/Restaurants.Infrastructure: Contains infrastructure-related code such as database and file system interactions. This layer supports the higher layers.
• tests/Restaurants.API.Tests: Contains unit tests for the API.

Packages and Libraries

This project uses several NuGet packages and libraries to achieve its functionality:

• Serilog: This library is used for logging. It provides a flexible and easy-to-use logging API.

• MediatR: This library is used to implement the Command Query Responsibility Segregation (CQRS) pattern. In this solution, commands (which change the state of the system) and queries (which read the state) are separated for clarity and ease of development.

• Entity Framework: This is an open-source ORM framework for .NET. It enables developers to work with data using objects of domain-specific classes without focusing on the underlying database tables and columns where this data is stored.

• Microsoft Identity Package: This package is used for handling user identity in the web API. It provides features such as authentication, authorization, identity, and user access control.

• FluentValidation: This library is used for building strongly-typed validation rules for models and DTOs. It provides a fluent interface for defining validation logic, making the code more readable and maintainable.

• Hybrid Cache: This package provides a caching mechanism that combines in-memory cache and distributed cache. Frequently accessed data is served quickly from local memory, while a distributed cache ensures consistency across multiple instances.

• Redis Caching: This library is used for high-performance distributed caching using Redis. It helps reduce database load, store sessions, and provide fast access to frequently used data across multiple servers or services.

Please refer to the official documentation of each package for more details and usage examples.

Getting Started

Prerequisites

• .NET 9.0
• Visual Studio 2022 or later

Building

To build the project, open the Restaurants.sln file in Visual Studio and build the solution.

Running

To run the project, set Restaurants.API as the startup project in Visual Studio and start the application.

API Endpoints

1. GET /api/restaurants

   • Parameters: searchPhrase, pageSize, pageNumber, sortBy, sortDirection
   • Authorization Bearer token

2. GET /api/restaurants/{id}

   • Parameters: id
   • Authorization: Bearer token

3. GET /api/restaurants/{id}/dishes

   • Parameters: id
   • Authorization: Bearer token

4. DELETE /api/restaurants/{id}/dishes

   • Parameters: id

5. GET /api/restaurants/{id}/dishes/{dishId}

   • Parameters: id, dishId

6. DELETE /api/restaurants/{id}

   • Parameters: id
   • Authorization: Bearer token

7. POST /api/restaurants

   • Body: JSON object with properties Name, Description, Category, HasDelivery, ContactEmail, ContactNumber, City, Street
   • Authorization: Bearer token

Testing

The tests are located in the tests/* directory. You can run them using the test runner in Visual Studio.