documentation / controllers

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 {

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 {

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 {

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 {

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 {

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 {

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 {

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 {

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 {

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 {

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 {

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 {

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 {

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 {

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 {

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 {

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 {

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);

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,

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 {

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 {

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 {

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;

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 {

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 {