Control-plane/internal/org/handler.go

package org

import (
	"errors"
	"log"
	"net/http"
	"strconv"

	"github.com/gin-gonic/gin"
)

type Handler struct {
	service *Service
}

func NewHandler(service *Service) *Handler {
	return &Handler{service: service}
}

// @Summary      Создание организации
// @Description  Создание новой организации. slug используется в URL и должен быть уникальным.
// @Description  **Требуется:** заголовок `Authorization: Bearer <token>`.
// @Tags         organizations
// @Accept       json
// @Produce      json
// @Security     Bearer
// @Param        request  body  CreateOrgRequest  true  "Название и slug организации"
// @Success      201  {object}  OrgResponse  "Организация создана"
// @Failure      400  {object}  ErrorResponse  "Ошибка валидации полей"
// @Failure      409  {object}  ErrorResponse  "Slug уже занят"
// @Router       /api/v1/organizations [post]
func (h *Handler) Create(c *gin.Context) {
	var req CreateOrgRequest
	if err := c.ShouldBindJSON(&req); err != nil {
		c.JSON(http.StatusBadRequest, ErrorResponse{Error: err.Error()})
		return
	}

	org, err := h.service.Create(c.Request.Context(), req)
	if err != nil {
		if errors.Is(err, ErrSlugExists) {
			c.JSON(http.StatusConflict, ErrorResponse{Error: err.Error()})
			return
		}
		log.Printf("create org error: %v", err)
		c.JSON(http.StatusInternalServerError, ErrorResponse{Error: "internal server error"})
		return
	}

	c.JSON(http.StatusCreated, OrgResponse{Organization: *org})
}

// @Summary      Получить организацию
// @Description  Получение информации об организации по её ID.
// @Description  **Требуется:** заголовок `Authorization: Bearer <token>`.
// @Tags         organizations
// @Accept       json
// @Produce      json
// @Security     Bearer
// @Param        id   path      string  true  "UUID организации"
// @Success      200  {object}  OrgResponse  "Данные организации"
// @Failure      404  {object}  ErrorResponse  "Организация не найдена"
// @Router       /api/v1/organizations/{id} [get]
func (h *Handler) GetByID(c *gin.Context) {
	id := c.Param("id")

	org, err := h.service.GetByID(c.Request.Context(), id)
	if err != nil {
		if errors.Is(err, ErrNotFound) {
			c.JSON(http.StatusNotFound, ErrorResponse{Error: err.Error()})
			return
		}
		log.Printf("get org error: %v", err)
		c.JSON(http.StatusInternalServerError, ErrorResponse{Error: "internal server error"})
		return
	}

	c.JSON(http.StatusOK, OrgResponse{Organization: *org})
}

// @Summary      Список организаций
// @Description  Получение списка всех организаций с пагинацией.
// @Description  **Требуется:** заголовок `Authorization: Bearer <token>`.
// @Tags         organizations
// @Accept       json
// @Produce      json
// @Security     Bearer
// @Param        limit   query  int  false  "Количество записей на странице (по умолчанию 20)"
// @Param        offset  query  int  false  "Смещение от начала списка (по умолчанию 0)"
// @Success      200  {object}  OrgListResponse  "Список организаций"
// @Failure      500  {object}  ErrorResponse  "Внутренняя ошибка сервера"
// @Router       /api/v1/organizations [get]
func (h *Handler) List(c *gin.Context) {
	limit, _ := strconv.Atoi(c.DefaultQuery("limit", "20"))
	offset, _ := strconv.Atoi(c.DefaultQuery("offset", "0"))

	resp, err := h.service.List(c.Request.Context(), limit, offset)
	if err != nil {
		log.Printf("list orgs error: %v", err)
		c.JSON(http.StatusInternalServerError, ErrorResponse{Error: "internal server error"})
		return
	}

	c.JSON(http.StatusOK, resp)
}

// @Summary      Обновление организации
// @Description  Обновление названия организации. slug изменить нельзя.
// @Description  **Требуется:** заголовок `Authorization: Bearer <token>`.
// @Tags         organizations
// @Accept       json
// @Produce      json
// @Security     Bearer
// @Param        id       path    string            true  "UUID организации"
// @Param        request  body    UpdateOrgRequest  true  "Новое название организации"
// @Success      200      {object}  OrgResponse  "Обновлённая организация"
// @Failure      400      {object}  ErrorResponse  "Ошибка валидации полей"
// @Failure      404      {object}  ErrorResponse  "Организация не найдена"
// @Router       /api/v1/organizations/{id} [put]
func (h *Handler) Update(c *gin.Context) {
	id := c.Param("id")

	var req UpdateOrgRequest
	if err := c.ShouldBindJSON(&req); err != nil {
		c.JSON(http.StatusBadRequest, ErrorResponse{Error: err.Error()})
		return
	}

	org, err := h.service.Update(c.Request.Context(), id, req)
	if err != nil {
		if errors.Is(err, ErrNotFound) {
			c.JSON(http.StatusNotFound, ErrorResponse{Error: err.Error()})
			return
		}
		log.Printf("update org error: %v", err)
		c.JSON(http.StatusInternalServerError, ErrorResponse{Error: "internal server error"})
		return
	}

	c.JSON(http.StatusOK, OrgResponse{Organization: *org})
}

// @Summary      Удаление организации
// @Description  Безвозвратное удаление организации по её ID.
// @Description  **Требуется:** заголовок `Authorization: Bearer <token>`.
// @Tags         organizations
// @Accept       json
// @Produce      json
// @Security     Bearer
// @Param        id   path      string  true  "UUID организации"
// @Success      200  {object}  map[string]string  "{"message": "organization deleted"}"
// @Failure      404  {object}  ErrorResponse  "Организация не найдена"
// @Router       /api/v1/organizations/{id} [delete]
func (h *Handler) Delete(c *gin.Context) {
	id := c.Param("id")

	if err := h.service.Delete(c.Request.Context(), id); err != nil {
		if errors.Is(err, ErrNotFound) {
			c.JSON(http.StatusNotFound, ErrorResponse{Error: err.Error()})
			return
		}
		log.Printf("delete org error: %v", err)
		c.JSON(http.StatusInternalServerError, ErrorResponse{Error: "internal server error"})
		return
	}

	c.JSON(http.StatusOK, gin.H{"message": "organization deleted"})
}