Лаб. 4 6412 Русяев Алексей

.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  push:
+    branches: [ "*" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Setup .NET
+      uses: actions/setup-dotnet@v4
+      with:
+        dotnet-version: '8.0.x'
+
+    - name: Restore dependencies
+      run: dotnet restore
+
+    - name: Build
+      run: dotnet build --no-restore --configuration Release
+
+    - name: Run unit tests
+      run: dotnet test --no-build --configuration Release --verbosity normal

CarRental.Api/CarRental.Api.csproj

@@ -0,0 +1,22 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <GenerateDocumentationFile>True</GenerateDocumentationFile>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Aspire.MongoDB.Driver" Version="13.1.0" />
+    <PackageReference Include="Swashbuckle.AspNetCore" Version="10.0.1" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\CarRental.Application\CarRental.Application.csproj" />
+    <ProjectReference Include="..\CarRental.Domain\CarRental.Domain.csproj" />
+    <ProjectReference Include="..\CarRental.Infrastructure\CarRental.Infrastructure.csproj" />
+    <ProjectReference Include="..\CarRental.ServiceDefaults\CarRental.ServiceDefaults.csproj" />
+  </ItemGroup>
+
+</Project>

CarRental.Api/Controllers/AnalyticsController.cs

@@ -0,0 +1,126 @@
+using CarRental.Application.Contracts.Client;
+using CarRental.Application.Contracts.Analytics;
+using CarRental.Application.Contracts.Interfaces;
+using Microsoft.AspNetCore.Mvc;
+
+namespace CarRental.Api.Controllers;
+
+/// <summary>
+/// Provides specialized API endpoints for data analytics and business reporting
+/// </summary>
+[ApiController]
+[Route("api/[controller]")]
+public class AnalyticsController(IAnalyticsService analyticsService, ILogger<AnalyticsController> logger) : ControllerBase
+{
+    /// <summary>
+    /// Retrieves a list of clients who have rented cars associated with a specific model name
+    /// </summary>
+    /// <param name="modelName">The name of the car model to filter by</param>
+    [HttpGet("clients-by-model")]
+    [ProducesResponseType(200)]
+    [ProducesResponseType(500)]
+    public async Task<ActionResult<List<ClientDto>>> GetClientsByModel([FromQuery] string modelName)
+    {
+        logger.LogInformation("{method} method of {controller} is called with {string} parameter", nameof(GetClientsByModel), GetType().Name, modelName);
+        try
+        {
+            var result = await analyticsService.ReadClientsByModelName(modelName);
+            logger.LogInformation("{method} method of {controller} executed successfully", nameof(GetClientsByModel), GetType().Name);
+            return Ok(result);
+        }
+        catch (Exception ex) 
+        {
+            logger.LogError(ex, "An exception happened during {method} method of {controller}", nameof(GetClientsByModel), GetType().Name);
+            return StatusCode(500);
+        }
+    }
+
+    /// <summary>
+    /// Returns details of cars that are currently on lease at the specified date and time
+    /// </summary>
+    /// <param name="atTime">The point in time to check for active rentals</param>
+    [HttpGet("cars-in-rent")]
+    [ProducesResponseType(200)]
+    [ProducesResponseType(500)]
+    public async Task<ActionResult<List<CarInRentDto>>> GetCarsInRent([FromQuery] DateTime atTime)
+    {
+        logger.LogInformation("{method} method of {controller} is called with {parameterName} = {parameterValue}", nameof(GetCarsInRent), GetType().Name, nameof(atTime), atTime);
+        try
+        {
+            var result = await analyticsService.ReadCarsInRent(atTime);
+            logger.LogInformation("{method} method of {controller} executed successfully", nameof(GetCarsInRent), GetType().Name);
+            return Ok(result);
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "An exception happened during {method} method of {controller}", nameof(GetCarsInRent), GetType().Name);
+            return StatusCode(500);
+        }
+    }
+
+    /// <summary>
+    /// Returns the top 5 most popular cars based on total rental frequency
+    /// </summary>
+    [HttpGet("top-5-rented-cars")]
+    [ProducesResponseType(200)]
+    [ProducesResponseType(500)]
+    public async Task<ActionResult<List<CarWithRentalCountDto>>> GetTop5Cars()
+    {
+        logger.LogInformation("{method} method of {controller} is called", nameof(GetTop5Cars), GetType().Name);
+        try
+        {
+            var result = await analyticsService.ReadTop5MostRentedCars();
+            logger.LogInformation("{method} method of {controller} executed successfully", nameof(GetTop5Cars), GetType().Name);
+            return Ok(result);
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "An exception happened during {method} method of {controller}", nameof(GetTop5Cars), GetType().Name);
+            return StatusCode(500);
+        }
+    }
+
+    /// <summary>
+    /// Provides a comprehensive list of all cars and how many times each has been rented
+    /// </summary>
+    [HttpGet("all-cars-with-rental-count")]
+    [ProducesResponseType(200)]
+    [ProducesResponseType(500)]
+    public async Task<ActionResult<List<CarWithRentalCountDto>>> GetAllCarsWithCount()
+    {
+        logger.LogInformation("{method} method of {controller} is called", nameof(GetAllCarsWithCount), GetType().Name);
+        try
+        {
+            var result = await analyticsService.ReadAllCarsWithRentalCount();
+            logger.LogInformation("{method} method of {controller} executed successfully", nameof(GetAllCarsWithCount), GetType().Name);
+            return Ok(result);
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "An exception happened during {method} method of {controller}", nameof(GetAllCarsWithCount), GetType().Name);
+            return StatusCode(500);
+        }
+    }
+
+    /// <summary>
+    /// Returns the top 5 clients who have contributed the most to total revenue
+    /// </summary>
+    [HttpGet("top-5-clients-by-money")]
+    [ProducesResponseType(200)]
+    [ProducesResponseType(500)]
+    public async Task<ActionResult<List<ClientWithTotalAmountDto>>> GetTop5Clients()
+    {
+        logger.LogInformation("{method} method of {controller} is called", nameof(GetTop5Clients), GetType().Name);
+        try
+        {
+            var result = await analyticsService.ReadTop5ClientsByTotalAmount();
+            logger.LogInformation("{method} method of {controller} executed successfully", nameof(GetTop5Clients), GetType().Name);
+            return Ok(result);
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "An exception happened during {method} method of {controller}", nameof(GetTop5Clients), GetType().Name);
+            return StatusCode(500);
+        }
+    }
+}

CarRental.Api/Controllers/CarControllers.cs

@@ -0,0 +1,135 @@
+using CarRental.Application.Contracts.Car;
+using CarRental.Application.Contracts.Interfaces;
+using Microsoft.AspNetCore.Mvc;
+
+namespace CarRental.Api.Controllers;
+
+/// <summary>
+/// API controller for managing the car fleet (CRUD operations)
+/// </summary>
+[ApiController]
+[Route("api/[controller]")]
+public class CarController(IApplicationService<CarDto, CarCreateUpdateDto, Guid> carService, ILogger<CarController> logger) : ControllerBase
+{
+    /// <summary>
+    /// Retrieves a list of all cars available in the system
+    /// </summary>
+    [HttpGet]
+    [ProducesResponseType(200)]
+    [ProducesResponseType(500)]
+    public async Task<ActionResult<List<CarDto>>> GetAll()
+    {
+        logger.LogInformation("{method} method of {controller} is called", nameof(GetAll), GetType().Name);
+        try
+        {
+            var cars = await carService.ReadAll();
+            logger.LogInformation("{method} method of {controller} executed successfully", nameof(GetAll), GetType().Name);
+            return Ok(cars);
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "An exception happened during {method} method of {controller}", nameof(GetAll), GetType().Name);
+            return StatusCode(500);
+        }
+    }
+
+    /// <summary>
+    /// Retrieves details of a specific car by its identifier
+    /// </summary>
+    /// <param name="id">The unique identifier of the car</param>
+    [HttpGet("{id}")]
+    [ProducesResponseType(200)]
+    [ProducesResponseType(404)]
+    [ProducesResponseType(500)]
+    public async Task<ActionResult<CarDto>> Get(Guid id)
+    {
+        logger.LogInformation("{method} method of {controller} is called with {id} parameter", nameof(Get), GetType().Name, id);
+        try
+        {
+            var car = await carService.Read(id);
+            logger.LogInformation("{method} method of {controller} executed successfully", nameof(Get), GetType().Name);
+            return Ok(car);
+        }
+        catch (KeyNotFoundException ex)
+        {
+            logger.LogWarning(ex, "An exception happened during {method} method of {controller}", nameof(Get), GetType().Name);
+            return NotFound();
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "An exception happened during {method} method of {controller}", nameof(Get), GetType().Name);
+            return StatusCode(500);
+        }
+    }
+
+    /// <summary>
+    /// Registers a new car in the fleet
+    /// </summary>
+    /// <param name="dto">The data for the new car record</param>
+    [HttpPost]
+    [ProducesResponseType(201)]
+    [ProducesResponseType(500)]
+    public async Task<ActionResult<CarDto>> Create([FromBody] CarCreateUpdateDto dto)
+    {
+        logger.LogInformation("{method} method of {controller} is called with {dto} parameter", nameof(Create), GetType().Name, dto);
+        try
+        {
+            var createdCar = await carService.Create(dto);
+            logger.LogInformation("{method} method of {controller} executed successfully", nameof(Create), GetType().Name);
+            return CreatedAtAction(nameof(this.Create), createdCar);
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "An exception happened during {method} method of {controller}", nameof(Create), GetType().Name);
+            return StatusCode(500);
+        }
+    }
+
+    /// <summary>
+    /// Updates an existing car's information
+    /// </summary>
+    /// <param name="id">The unique identifier of the car to update</param>
+    /// <param name="dto">The updated data</param>
+    [HttpPut("{id}")]
+    [ProducesResponseType(200)]
+    [ProducesResponseType(500)]
+    public async Task<ActionResult<CarDto>> Update(Guid id, [FromBody] CarCreateUpdateDto dto)
+    {
+        logger.LogInformation("{method} method of {controller} is called with {key},{dto} parameters", nameof(Update), GetType().Name, id, dto);
+        try
+        {
+            var updatedCar = await carService.Update(dto, id);
+            logger.LogInformation("{method} method of {controller} executed successfully", nameof(Update), GetType().Name);
+            return Ok(updatedCar);
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "An exception happened during {method} method of {controller}", nameof(Update), GetType().Name);
+            return StatusCode(500);
+        }
+    }
+
+    /// <summary>
+    /// Removes a car from the system
+    /// </summary>
+    /// <param name="id">The unique identifier of the car to delete</param>
+    [HttpDelete("{id}")]
+    [ProducesResponseType(200)]
+    [ProducesResponseType(204)]
+    [ProducesResponseType(500)]
+    public async Task<ActionResult> Delete(Guid id)
+    {
+        logger.LogInformation("{method} method of {controller} is called with {id} parameter", nameof(Delete), GetType().Name, id);
+        try
+        {
+            var result = await carService.Delete(id);
+            logger.LogInformation("{method} method of {controller} executed successfully", nameof(Delete), GetType().Name);
+            return result ? Ok() : NoContent();
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "An exception happened during {method} method of {controller}", nameof(Delete), GetType().Name);
+            return StatusCode(500);
+        }
+    }
+}