From edff901b52c438976cfb16acd3e3baba46944b8e Mon Sep 17 00:00:00 2001
From: shept <sheptikhinv@gmail.com>
Date: Sun, 27 Apr 2025 16:06:17 +0500
Subject: [PATCH] add all docs

---
 .../SurveyBackend.API/Mappers/AuthMapper.cs       |  8 ++++++++
 .../SurveyBackend.API/Mappers/QuestionMapper.cs   | 15 +++++++++++++++
 .../SurveyBackend.API/Mappers/SurveyMapper.cs     | 14 ++++++++++++++
 .../Middlewares/ExceptionsMiddleware.cs           | 12 ++++++++++++
 4 files changed, 49 insertions(+)

diff --git a/SurveyBackend/SurveyBackend.API/Mappers/AuthMapper.cs b/SurveyBackend/SurveyBackend.API/Mappers/AuthMapper.cs
index 50b1980..47a01e6 100644
--- a/SurveyBackend/SurveyBackend.API/Mappers/AuthMapper.cs
+++ b/SurveyBackend/SurveyBackend.API/Mappers/AuthMapper.cs
@@ -3,8 +3,16 @@ using SurveyBackend.DTOs;
 
 namespace SurveyBackend.Mappers;
 
+/// <summary>
+/// Маппер всего связанного с авторизацией
+/// </summary>
 public static class AuthMapper
 {
+    /// <summary>
+    /// Перегнать схему регистрации в нового юзера
+    /// </summary>
+    /// <param name="dto"></param>
+    /// <returns></returns>
     public static User UserRegistrationToModel(UserRegistrationDto dto) => new User
     {
         Email = dto.Email,
diff --git a/SurveyBackend/SurveyBackend.API/Mappers/QuestionMapper.cs b/SurveyBackend/SurveyBackend.API/Mappers/QuestionMapper.cs
index b6fd399..dab60b9 100644
--- a/SurveyBackend/SurveyBackend.API/Mappers/QuestionMapper.cs
+++ b/SurveyBackend/SurveyBackend.API/Mappers/QuestionMapper.cs
@@ -5,8 +5,18 @@ using SurveyLib.Core.Models.QuestionVariants;
 
 namespace SurveyBackend.Mappers;
 
+/// <summary>
+/// Маппер всего про вопросы
+/// </summary>
 public static class QuestionMapper
 {
+    /// <summary>
+    /// Создание вопроса в модель
+    /// </summary>
+    /// <param name="dto"></param>
+    /// <param name="surveyId"></param>
+    /// <returns></returns>
+    /// <exception cref="BadRequestException"></exception>
     public static QuestionBase QuestionCreationToModel(CreateQuestionDto dto, int surveyId)
     {
         return dto.QuestionType.ToLower() switch
@@ -32,6 +42,11 @@ public static class QuestionMapper
         };
     }
 
+    /// <summary>
+    /// Модель в выходную схему
+    /// </summary>
+    /// <param name="question"></param>
+    /// <returns></returns>
     public static OutputQuestionDto ModelToQuestionDto(QuestionBase question)
     {
         var withAnswerVariants = question.GetType() != typeof(TextQuestion);
diff --git a/SurveyBackend/SurveyBackend.API/Mappers/SurveyMapper.cs b/SurveyBackend/SurveyBackend.API/Mappers/SurveyMapper.cs
index 46f85cb..bbcc51f 100644
--- a/SurveyBackend/SurveyBackend.API/Mappers/SurveyMapper.cs
+++ b/SurveyBackend/SurveyBackend.API/Mappers/SurveyMapper.cs
@@ -3,8 +3,17 @@ using SurveyLib.Core.Models;
 
 namespace SurveyBackend.Mappers;
 
+/// <summary>
+/// Маппер всего про опросы
+/// </summary>
 public static class SurveyMapper
 {
+    /// <summary>
+    /// Схема создания в модель
+    /// </summary>
+    /// <param name="dto"></param>
+    /// <param name="userId"></param>
+    /// <returns></returns>
     public static Survey CreateDtoToModel(CreateSurveyDto dto, int userId)
     {
         return new Survey
@@ -15,6 +24,11 @@ public static class SurveyMapper
         };
     }
 
+    /// <summary>
+    /// Модель в выходную схему
+    /// </summary>
+    /// <param name="survey"></param>
+    /// <returns></returns>
     public static OutputSurveyDto ModelToOutputDto(Survey survey)
     {
         return new OutputSurveyDto
diff --git a/SurveyBackend/SurveyBackend.API/Middlewares/ExceptionsMiddleware.cs b/SurveyBackend/SurveyBackend.API/Middlewares/ExceptionsMiddleware.cs
index 65c94f8..1898da8 100644
--- a/SurveyBackend/SurveyBackend.API/Middlewares/ExceptionsMiddleware.cs
+++ b/SurveyBackend/SurveyBackend.API/Middlewares/ExceptionsMiddleware.cs
@@ -2,17 +2,29 @@ using SurveyBackend.Services.Exceptions;
 
 namespace SurveyBackend.Middlewares;
 
+/// <summary>
+/// Имбовая миддлваря, ловит все эксепшны, кастомные прокидывает как HTTP-exception, остальные кидает 502 и кайфуем
+/// </summary>
 public class ExceptionsMiddleware
 {
     private readonly RequestDelegate _next;
     private readonly ILogger<ExceptionsMiddleware> _logger;
 
+    /// <summary>
+    /// Ну типа конструктор хз
+    /// </summary>
+    /// <param name="next"></param>
+    /// <param name="logger"></param>
     public ExceptionsMiddleware(RequestDelegate next, ILogger<ExceptionsMiddleware> logger)
     {
         _next = next;
         _logger = logger;
     }
 
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="context"></param>
     public async Task InvokeAsync(HttpContext context)
     {
         try