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 `. // @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 `. // @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 `. // @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 `. // @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 `. // @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"}) }