fix: linter and docs

2026-04-04 19:43:43 +03:00
parent fe7e41e4af
commit 0f8b148279
23 changed files with 480 additions and 105 deletions
@@ -2,23 +2,23 @@ package repository

 // Tokens represents a user record with info and permissions.
 type Tokens struct {
-	ID                int64  `json:"id"`
-	Name              string `json:"name"`
-	LastName          string `json:"last_name"`
-	Login             string `json:"login"`
-	Token             string `json:"token"`
-	PermissionView    bool   `json:"permission_view"`
-	PermissionManage  bool   `json:"permission_manage_agent"`
-	PermissionAdmin   bool   `json:"permission_admin"`
-	IsActive          bool   `json:"is_active"`
+	ID               int64  `json:"id"`
+	Name             string `json:"name"`
+	LastName         string `json:"last_name"`
+	Login            string `json:"login"`
+	Token            string `json:"token"`
+	PermissionView   bool   `json:"permission_view"`
+	PermissionManage bool   `json:"permission_manage_agent"`
+	PermissionAdmin  bool   `json:"permission_admin"`
+	IsActive         bool   `json:"is_active"`
 }

 // TokenCreate is the request body for creating a new user.
 type TokenCreate struct {
-	Name             string `json:"name" binding:"required"`
-	LastName         string `json:"last_name" binding:"required"`
-	Login            string `json:"login" binding:"required"`
-	Password         string `json:"password" binding:"required"`
+	Name             string `json:"name"                    binding:"required"`
+	LastName         string `json:"last_name"               binding:"required"`
+	Login            string `json:"login"                   binding:"required"`
+	Password         string `json:"password"                binding:"required"`
 	PermissionView   bool   `json:"permission_view"`
 	PermissionManage bool   `json:"permission_manage_agent"`
 	PermissionAdmin  bool   `json:"permission_admin"`
@@ -27,10 +27,10 @@ type TokenCreate struct {

 // UserRegister is the request body for public user registration (all permissions false).
 type UserRegister struct {
-	Name     string `json:"name" binding:"required"`
+	Name     string `json:"name"      binding:"required"`
 	LastName string `json:"last_name" binding:"required"`
-	Login    string `json:"login" binding:"required"`
-	Password string `json:"password" binding:"required"`
+	Login    string `json:"login"     binding:"required"`
+	Password string `json:"password"  binding:"required"`
 }

 // TokenUpdate is the request body for updating an existing user.
@@ -59,7 +59,7 @@ type BatchActionRequest struct {

 // LoginRequest is the request body for login.
 type LoginRequest struct {
-	Login    string `json:"login" binding:"required"`
+	Login    string `json:"login"    binding:"required"`
 	Password string `json:"password" binding:"required"`
 }

@@ -117,14 +117,14 @@ const (
 // AgentDeployConfig represents the configuration for deploying an agent to a server
 // @Description Configuration for deploying HellreigN agent to a single server
 type AgentDeployConfig struct {
-	User       string     `json:"user" binding:"required" example:"admin" description:"SSH username"`
-	IP         string     `json:"ip" binding:"required" example:"192.168.1.100" description:"Server IP address"`
-	Port       int        `json:"port" example:"22" description:"SSH port (default: 22)"`
-	AuthMethod AuthMethod `json:"authMethod" binding:"required" example:"key" description:"SSH auth method: key or password"`
-	SSHKey     string     `json:"sshKey,omitempty" example:"-----BEGIN OPENSSH PRIVATE KEY-----" description:"SSH private key (required if authMethod=key)"`
-	Password   string     `json:"password,omitempty" example:"secret" description:"SSH password (required if authMethod=password)"`
-	DeployType DeployType `json:"deployType" binding:"required" example:"docker" description:"Deployment type: docker or binary"`
-	AgentLabel string     `json:"agentLabel" binding:"required" example:"production-server-1" description:"Unique label for the agent"`
+	User       string     `json:"user"               binding:"required" example:"admin"                               description:"SSH username"`
+	IP         string     `json:"ip"                 binding:"required" example:"192.168.1.100"                       description:"Server IP address"`
+	Port       int        `json:"port"                                  example:"22"                                  description:"SSH port (default: 22)"`
+	AuthMethod AuthMethod `json:"authMethod"         binding:"required" example:"key"                                 description:"SSH auth method: key or password"`
+	SSHKey     string     `json:"sshKey,omitempty"                      example:"-----BEGIN OPENSSH PRIVATE KEY-----" description:"SSH private key (required if authMethod=key)"`
+	Password   string     `json:"password,omitempty"                    example:"secret"                              description:"SSH password (required if authMethod=password)"`
+	DeployType DeployType `json:"deployType"         binding:"required" example:"docker"                              description:"Deployment type: docker or binary"`
+	AgentLabel string     `json:"agentLabel"         binding:"required" example:"production-server-1"                 description:"Unique label for the agent"`
 }

 // DeployAgentsRequest represents the request body for deploying agents to multiple servers
@@ -137,15 +137,15 @@ type DeployAgentsRequest struct {
 // @Description Response containing deployment results and registration tokens
 type DeployResponse struct {
 	Message string         `json:"message" example:"Deployment completed"`
-	Results []DeployResult `json:"results" description:"Deployment results for each server"`
+	Results []DeployResult `json:"results"                                description:"Deployment results for each server"`
 }

 // DeployResult represents the result of deploying to a single server
 // @Description Result of deploying to a single server
 type DeployResult struct {
-	IP         string `json:"ip" example:"192.168.1.100" description:"Server IP address"`
-	AgentLabel string `json:"agent_label" example:"production-server-1" description:"Agent label"`
-	Token      string `json:"token" example:"abc123..." description:"Registration token for agent registration"`
-	Success    bool   `json:"success" example:"true" description:"Whether deployment succeeded"`
-	Error      string `json:"error,omitempty" example:"" description:"Error message if deployment failed"`
+	IP         string `json:"ip"              example:"192.168.1.100"       description:"Server IP address"`
+	AgentLabel string `json:"agent_label"     example:"production-server-1" description:"Agent label"`
+	Token      string `json:"token"           example:"abc123..."           description:"Registration token for agent registration"`
+	Success    bool   `json:"success"         example:"true"                description:"Whether deployment succeeded"`
+	Error      string `json:"error,omitempty" example:""                    description:"Error message if deployment failed"`
 }