diff --git a/src/main/java/app/controllers/StatsController.java b/src/main/java/app/controllers/StatsController.java
index cb1e939..e9063ed 100644
--- a/src/main/java/app/controllers/StatsController.java
+++ b/src/main/java/app/controllers/StatsController.java
@@ -17,6 +17,9 @@ import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 
+/**
+ * вся черная магия тут, вывод обобщенной информации как поживают сервера
+ */
 @RestController
 @RequestMapping("api/stats")
 public class StatsController {
diff --git a/src/main/java/app/controllers/admin/BanController.java b/src/main/java/app/controllers/admin/BanController.java
index d389cd8..2bd39d9 100644
--- a/src/main/java/app/controllers/admin/BanController.java
+++ b/src/main/java/app/controllers/admin/BanController.java
@@ -16,6 +16,9 @@ import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 
+/**
+ * удивительно, контроллер который используется для ботов и прочий хуйни чтоб банить игроков
+ */
 @RestController
 @RequestMapping("api/admin/ban")
 public class BanController {
diff --git a/src/main/java/app/controllers/admin/DBController.java b/src/main/java/app/controllers/admin/DBController.java
index f024445..49f62d1 100644
--- a/src/main/java/app/controllers/admin/DBController.java
+++ b/src/main/java/app/controllers/admin/DBController.java
@@ -14,6 +14,9 @@ import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 
+/**
+ * контроллер для ебанутых методов только для админов
+ */
 @RestController
 @RequestMapping(value = "api/admin/db")
 public class DBController {
diff --git a/src/main/java/app/controllers/admin/KickController.java b/src/main/java/app/controllers/admin/KickController.java
index 328d4bc..a5e34ad 100644
--- a/src/main/java/app/controllers/admin/KickController.java
+++ b/src/main/java/app/controllers/admin/KickController.java
@@ -15,6 +15,9 @@ import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 
+/**
+ * контролллер кикать игроков
+ */
 @RestController
 @RequestMapping("api/admin/kick")
 public class KickController {
diff --git a/src/main/java/app/controllers/admin/MuteContoller.java b/src/main/java/app/controllers/admin/MuteContoller.java
index e9ffa81..cfc2891 100644
--- a/src/main/java/app/controllers/admin/MuteContoller.java
+++ b/src/main/java/app/controllers/admin/MuteContoller.java
@@ -15,6 +15,9 @@ import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 
+/**
+ * контроллер чтоб закрыть еблет маленькому уебку
+ */
 @RestController
 @RequestMapping("api/admin/mute")
 public class MuteContoller {
diff --git a/src/main/java/app/controllers/admin/RconController.java b/src/main/java/app/controllers/admin/RconController.java
index e17299e..edbb7eb 100644
--- a/src/main/java/app/controllers/admin/RconController.java
+++ b/src/main/java/app/controllers/admin/RconController.java
@@ -16,6 +16,9 @@ import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.List;
 
+/**
+ * контролллер где чисто прибалдеть уебав сервер об стену
+ */
 @RestController
 @RequestMapping("api/admin/rcon")
 public class RconController {
diff --git a/src/main/java/app/controllers/admin/VIPController.java b/src/main/java/app/controllers/admin/VIPController.java
index c84b214..6d1a437 100644
--- a/src/main/java/app/controllers/admin/VIPController.java
+++ b/src/main/java/app/controllers/admin/VIPController.java
@@ -14,6 +14,9 @@ import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.*;
 
+/**
+ * котролллер где святое яйцо админ может выдать випку или ее забрать
+ */
 @RestController
 @RequestMapping("api/admin/vip")
 public class VIPController {
diff --git a/src/main/java/app/controllers/auth/AuthDiscordController.java b/src/main/java/app/controllers/auth/AuthDiscordController.java
index a4aa17e..a2db2b0 100644
--- a/src/main/java/app/controllers/auth/AuthDiscordController.java
+++ b/src/main/java/app/controllers/auth/AuthDiscordController.java
@@ -26,6 +26,9 @@ import java.util.Arrays;
 import java.util.HashMap;
 import java.util.Map;
 
+/**
+ * контролллер авторизации пользователя через дискорд
+ */
 @RestController
 @RequestMapping("/api/auth/discord")
 public class AuthDiscordController {
diff --git a/src/main/java/app/controllers/auth/AuthSteamController.java b/src/main/java/app/controllers/auth/AuthSteamController.java
index 1ebcdde..4167182 100644
--- a/src/main/java/app/controllers/auth/AuthSteamController.java
+++ b/src/main/java/app/controllers/auth/AuthSteamController.java
@@ -23,6 +23,9 @@ import java.util.List;
 import java.util.Map;
 import java.util.Objects;
 
+/**
+ * контролллер авторизации пользователя через стим
+ */
 @RestController
 @RequestMapping("/api/auth")
 public class AuthSteamController {
diff --git a/src/main/java/app/controllers/bot/DiscordBanController.java b/src/main/java/app/controllers/bot/DiscordBanController.java
index bc11a1f..d1150dc 100644
--- a/src/main/java/app/controllers/bot/DiscordBanController.java
+++ b/src/main/java/app/controllers/bot/DiscordBanController.java
@@ -11,6 +11,9 @@ import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
+/**
+ * контролллер для бота, нужный для синхронизации ролей в дискорде
+ */
 @RestController
 @RequestMapping("api/bot/discord")
 public class DiscordBanController {
diff --git a/src/main/java/app/controllers/bot/DiscordVIPController.java b/src/main/java/app/controllers/bot/DiscordVIPController.java
index be32100..9bf6735 100644
--- a/src/main/java/app/controllers/bot/DiscordVIPController.java
+++ b/src/main/java/app/controllers/bot/DiscordVIPController.java
@@ -11,6 +11,9 @@ import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
+/**
+ * контролллер для бота, кторый нужен для синхронизации ролей на сервере в дискорде
+ */
 @RestController
 @RequestMapping("api/bot/discord")
 public class DiscordVIPController {
diff --git a/src/main/java/app/controllers/debug/WebSocketPage.java b/src/main/java/app/controllers/debug/WebSocketPage.java
index 150792b..32e8df3 100644
--- a/src/main/java/app/controllers/debug/WebSocketPage.java
+++ b/src/main/java/app/controllers/debug/WebSocketPage.java
@@ -5,6 +5,9 @@ import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
+/**
+ * контролллер для дебага вебсокета на локалхосте
+ */
 @RestController
 @RequestMapping("/debug/ws")
 public class WebSocketPage {
diff --git a/src/main/java/app/controllers/discord/DiscordController.java b/src/main/java/app/controllers/discord/DiscordController.java
index ff0ce75..32e9e9b 100644
--- a/src/main/java/app/controllers/discord/DiscordController.java
+++ b/src/main/java/app/controllers/discord/DiscordController.java
@@ -14,6 +14,9 @@ import org.springframework.web.bind.annotation.*;
 import java.util.HashMap;
 import java.util.List;
 
+/**
+ * контролллер для бота дискорда с разным говном
+ */
 @RestController
 @RequestMapping("api/discord")
 public class DiscordController {
diff --git a/src/main/java/app/controllers/other/CryptoController.java b/src/main/java/app/controllers/other/CryptoController.java
index 3b030b5..d01afee 100644
--- a/src/main/java/app/controllers/other/CryptoController.java
+++ b/src/main/java/app/controllers/other/CryptoController.java
@@ -12,6 +12,9 @@ import org.springframework.web.bind.annotation.*;
 import java.util.HashMap;
 import java.util.Map;
 
+/**
+ * контролллер для дешефровки публичных данных
+ */
 @RestController
 @RequestMapping("/api/crypto")
 public class CryptoController {
diff --git a/src/main/java/app/controllers/other/DockerController.java b/src/main/java/app/controllers/other/DockerController.java
index 5245ce1..8aa22df 100644
--- a/src/main/java/app/controllers/other/DockerController.java
+++ b/src/main/java/app/controllers/other/DockerController.java
@@ -16,6 +16,9 @@ import java.time.Instant;
 import java.util.List;
 import java.util.stream.Collectors;
 
+/**
+ * контролллер для обновлении информации о состоянии серверов в контейнерах, работает с связке ext/python-docker-client/dockerclient.py
+ */
 @RestController
 @RequestMapping("/api/docker")
 public class DockerController {
diff --git a/src/main/java/app/controllers/other/ExternalVIPController.java b/src/main/java/app/controllers/other/ExternalVIPController.java
index 999ed1a..b1760e4 100644
--- a/src/main/java/app/controllers/other/ExternalVIPController.java
+++ b/src/main/java/app/controllers/other/ExternalVIPController.java
@@ -17,6 +17,9 @@ import org.springframework.web.bind.annotation.*;
 import java.util.*;
 import java.util.stream.Collectors;
 
+/**
+ * контролллер для платежных систем для выдачи прав за ЩЕДРЫЕ ПОДАРКИ
+ */
 @RestController
 @RequestMapping("api/external/vip")
 public class ExternalVIPController {
diff --git a/src/main/java/app/controllers/other/PromoCodeController.java b/src/main/java/app/controllers/other/PromoCodeController.java
index f6b17a1..dbf12b6 100644
--- a/src/main/java/app/controllers/other/PromoCodeController.java
+++ b/src/main/java/app/controllers/other/PromoCodeController.java
@@ -23,6 +23,9 @@ import java.util.List;
 import java.util.Map;
 import java.util.stream.Collectors;
 
+/**
+ * контролллер для промокодов на бесплатный вип скин вип нож вип паутинка
+ */
 @RestController
 @RequestMapping("api/promocode")
 public class PromoCodeController {
diff --git a/src/main/java/app/controllers/other/PulseController.java b/src/main/java/app/controllers/other/PulseController.java
index aec2197..b86f53e 100644
--- a/src/main/java/app/controllers/other/PulseController.java
+++ b/src/main/java/app/controllers/other/PulseController.java
@@ -9,6 +9,9 @@ import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
+/**
+ * контролллер для проверки жива ли эта хуйня и че там по бд
+ */
 @RestController
 @RequestMapping("/api/pulse")
 public class PulseController {
@@ -28,6 +31,10 @@ public class PulseController {
         return new ResponseEntity(dbService.getDBServerTime(), HttpStatus.OK);
     }
 
+    /**
+     * ЕСЛИ 0 ЗНАЧИТ ЗАЕБИСЬ
+     * @return
+     */
     @GetMapping("/db/diff")
     public ResponseEntity<Long> getDiff() {
         return new ResponseEntity<>(onlineUpdater.getDifferentReplica(), HttpStatus.OK);
diff --git a/src/main/java/app/controllers/server/ServerUpdaterController.java b/src/main/java/app/controllers/server/ServerUpdaterController.java
index 299c674..49cf581 100644
--- a/src/main/java/app/controllers/server/ServerUpdaterController.java
+++ b/src/main/java/app/controllers/server/ServerUpdaterController.java
@@ -18,6 +18,9 @@ import org.springframework.web.bind.annotation.*;
 
 import java.util.Map;
 
+/**
+ * контролллер для обновления информации с серверов, работаюзий в связке с ext/sourcepawn-client/Facti13BackendIntegration.sp
+ */
 @RestController
 @RequestMapping("api/server")
 public class ServerUpdaterController {
@@ -55,6 +58,13 @@ public class ServerUpdaterController {
         return new ResponseEntity(HttpStatus.OK);
     }
 
+    /**
+     * метод для работы репортов, работает в связке с ext/sourcepawn-client/Facti13Reports.sp
+     * @param request
+     * @param body
+     * @param srv
+     * @return
+     */
     @PostMapping(value = "/{srv}/report")
     @CheckWebAccess(auth_method = AuthMethod.SECRET_KEY)
     public ResponseEntity sendReport(HttpServletRequest request,
diff --git a/src/main/java/app/controllers/user/DetailController.java b/src/main/java/app/controllers/user/DetailController.java
index 1d1766e..1dde0b6 100644
--- a/src/main/java/app/controllers/user/DetailController.java
+++ b/src/main/java/app/controllers/user/DetailController.java
@@ -16,6 +16,9 @@ import org.springframework.web.bind.annotation.*;
 
 import java.util.HashMap;
 
+/**
+ * контроллер для конечного(конченного) пользователя для просмотра профиля
+ */
 @RestController
 @RequestMapping("api/profile")
 public class DetailController {
diff --git a/src/main/java/app/controllers/user/KillFeedController.java b/src/main/java/app/controllers/user/KillFeedController.java
index cf11899..49958a2 100644
--- a/src/main/java/app/controllers/user/KillFeedController.java
+++ b/src/main/java/app/controllers/user/KillFeedController.java
@@ -13,6 +13,9 @@ import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.*;
 
+/**
+ * контроллер для получение списка убийств\ассистов\смертей
+ */
 @RestController
 @RequestMapping("api/profile/killfeed")
 public class KillFeedController {
diff --git a/src/main/java/app/controllers/user/MessagesController.java b/src/main/java/app/controllers/user/MessagesController.java
index 04b8388..0529c45 100644
--- a/src/main/java/app/controllers/user/MessagesController.java
+++ b/src/main/java/app/controllers/user/MessagesController.java
@@ -14,6 +14,9 @@ import org.springframework.http.MediaType;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.*;
 
+/**
+ * котроллер для пользователя, чтоб смотреть сообщения
+ */
 @RestController
 @RequestMapping("/api/profile/messages")
 public class MessagesController {
diff --git a/src/main/java/app/controllers/user/Payload.java b/src/main/java/app/controllers/user/Payload.java
index 5a50d80..66e47df 100644
--- a/src/main/java/app/controllers/user/Payload.java
+++ b/src/main/java/app/controllers/user/Payload.java
@@ -2,6 +2,9 @@ package app.controllers.user;
 
 import lombok.Data;
 
+/**
+ * сущность для фильтрации сообщений
+ */
 @Data
 public class Payload {
     public String message;
diff --git a/src/main/java/app/controllers/user/ProfileController.java b/src/main/java/app/controllers/user/ProfileController.java
index 43440dc..90f9796 100644
--- a/src/main/java/app/controllers/user/ProfileController.java
+++ b/src/main/java/app/controllers/user/ProfileController.java
@@ -22,6 +22,9 @@ import org.springframework.web.bind.annotation.*;
 import java.util.Arrays;
 import java.util.List;
 
+/**
+ * мейн контролллер для пользователя где ВСЯ ИНФОРМАЦИЯ ИМЕННО О НЕМ
+ */
 @RestController
 @RequestMapping("api/profile/current")
 public class ProfileController {
diff --git a/src/main/java/app/controllers/user/PublicController.java b/src/main/java/app/controllers/user/PublicController.java
index dc8905f..73c4644 100644
--- a/src/main/java/app/controllers/user/PublicController.java
+++ b/src/main/java/app/controllers/user/PublicController.java
@@ -16,6 +16,9 @@ import org.springframework.web.bind.annotation.RestController;
 
 import java.util.HashMap;
 
+/**
+ * контролллер для просмотра всякой хуйни, например банлиста (нахуя он отдельный, незнаю, захотел)
+ */
 @RestController
 @RequestMapping("api/web")
 public class PublicController {