Files
fm_be/internal/transport/http/handlers/federal_state_handler.go
2026-07-16 22:16:45 +07:00

527 lines
17 KiB
Go

package handlers
import (
"bytes"
"errors"
"strconv"
"strings"
"time"
"github.com/gofiber/fiber/v2"
"gorm.io/gorm"
"wucher/internal/domain/federal_state"
"wucher/internal/shared/pkg/apperrors"
"wucher/internal/shared/pkg/apperrorsx"
"wucher/internal/shared/pkg/uuidv7"
"wucher/internal/transport/http/dto"
"wucher/internal/transport/http/jsonapi"
"wucher/internal/transport/http/response"
"wucher/internal/transport/http/validators"
)
type FederalStateHandler struct {
svc federal_state.Service
validate *validators.Validator
}
func NewFederalStateHandler(svc federal_state.Service) *FederalStateHandler {
return &FederalStateHandler{
svc: svc,
validate: validators.New(),
}
}
// CreateFederalState godoc
// @Summary Create federal state
// @Description Create a federal state row.
// @Tags Hospital - Federal State
// @Accept json
// @Produce json
// @Param request body dto.FederalStateCreateRequest true "JSON:API federal state create request"
// @Success 201 {object} dto.FederalStateResponse
// @Failure 422 {object} dto.ErrorResponse
// @Failure 400 {object} dto.ErrorResponse
// @Router /api/v1/federal-state/create [post]
func (h *FederalStateHandler) Create(c *fiber.Ctx) error {
var req dto.FederalStateCreateRequest
if err := c.BodyParser(&req); err != nil {
return writeFederalStateErrors(c, fiber.StatusBadRequest, []jsonapi.ErrorObject{{
Status: "400",
Title: "Invalid JSON",
Detail: safeInternalDetail(),
}})
}
if errs := h.validate.ValidateStruct(req); errs != nil {
return writeFederalStateErrors(c, fiber.StatusUnprocessableEntity, errs)
}
name := strings.TrimSpace(req.Data.Attributes.Name)
if name == "" {
return writeFederalStateErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{{
Status: "422",
Title: "Validation error",
Detail: "name is required",
Source: &jsonapi.ErrorSource{Pointer: "/data/attributes/name"},
}})
}
landID, err := uuidv7.ParseString(strings.TrimSpace(req.Data.Attributes.LandID))
if err != nil {
return writeFederalStateErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{{
Status: "422",
Title: "Validation error",
Detail: "land_id is invalid UUID",
Source: &jsonapi.ErrorSource{Pointer: "/data/attributes/land_id"},
}})
}
row := &federal_state.FederalState{
Name: name,
Note: strings.TrimSpace(stringOrDefault(req.Data.Attributes.Note, "")),
LandID: landID,
SortKey: cloneIntPointer(req.Data.Attributes.SortKey),
IsActive: boolOrDefault(req.Data.Attributes.IsActive, true),
CreatedBy: actorUserID(c),
UpdatedBy: actorUserID(c),
}
if err := h.svc.Create(c.UserContext(), row); err != nil {
return writeFederalStateErrors(c, fiber.StatusBadRequest, []jsonapi.ErrorObject{{
Status: "400",
Title: "Create failed",
Detail: safeInternalDetail(),
}})
}
created, err := h.svc.GetByID(c.UserContext(), row.ID)
if err == nil && created != nil {
return response.Write(c, fiber.StatusCreated, federalStateResource(created))
}
return response.Write(c, fiber.StatusCreated, federalStateResource(row))
}
// UpdateFederalState godoc
// @Summary Update federal state (partial)
// @Description Patch federal state by ID.
// @Tags Hospital - Federal State
// @Accept json
// @Produce json
// @Param id path string true "Federal State ID (UUIDv7)"
// @Param request body dto.FederalStateUpdateRequest true "JSON:API federal state update request"
// @Success 200 {object} dto.FederalStateResponse
// @Failure 422 {object} dto.ErrorResponse
// @Failure 404 {object} dto.ErrorResponse
// @Router /api/v1/federal-state/update/{id} [patch]
func (h *FederalStateHandler) Update(c *fiber.Ctx) error {
idStr := c.Params("id")
id, err := uuidv7.ParseString(idStr)
if err != nil {
return writeFederalStateErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{{
Status: "422",
Title: "Validation error",
Detail: "id is invalid UUID",
Source: &jsonapi.ErrorSource{Pointer: "/path/id"},
}})
}
var req dto.FederalStateUpdateRequest
if err := c.BodyParser(&req); err != nil {
return writeFederalStateErrors(c, fiber.StatusBadRequest, []jsonapi.ErrorObject{{
Status: "400",
Title: "Invalid JSON",
Detail: safeInternalDetail(),
}})
}
if errs := h.validate.ValidateStruct(req); errs != nil {
return writeFederalStateErrors(c, fiber.StatusUnprocessableEntity, errs)
}
if strings.TrimSpace(req.Data.ID) == "" {
return writeFederalStateErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{{
Status: "422",
Title: "Validation error",
Detail: "id is required",
Source: &jsonapi.ErrorSource{Pointer: "/data/id"},
}})
}
if req.Data.ID != idStr {
return writeFederalStateErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{{
Status: "422",
Title: "Validation error",
Detail: "id does not match path id",
Source: &jsonapi.ErrorSource{Pointer: "/data/id"},
}})
}
attrs := req.Data.Attributes
if attrs.Name == nil && attrs.Note == nil && attrs.LandID == nil && !attrs.SortKey.Set && attrs.IsActive == nil {
return writeFederalStateErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{{
Status: "422",
Title: "Validation error",
Detail: "at least one attribute must be provided",
Source: &jsonapi.ErrorSource{Pointer: "/data/attributes"},
}})
}
existing, err := h.svc.GetByID(c.UserContext(), id)
if err != nil || existing == nil {
return writeFederalStateErrors(c, fiber.StatusNotFound, []jsonapi.ErrorObject{{
Status: "404",
Title: "Not found",
Detail: "federal state not found",
}})
}
if attrs.Name != nil {
v := strings.TrimSpace(*attrs.Name)
if v == "" {
return writeFederalStateErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{{
Status: "422",
Title: "Validation error",
Detail: "name cannot be empty",
Source: &jsonapi.ErrorSource{Pointer: "/data/attributes/name"},
}})
}
existing.Name = v
}
if attrs.Note != nil {
existing.Note = strings.TrimSpace(*attrs.Note)
}
if attrs.LandID != nil {
parsed, parseErr := uuidv7.ParseString(strings.TrimSpace(*attrs.LandID))
if parseErr != nil {
return writeFederalStateErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{{
Status: "422",
Title: "Validation error",
Detail: "land_id is invalid UUID",
Source: &jsonapi.ErrorSource{Pointer: "/data/attributes/land_id"},
}})
}
existing.LandID = parsed
// Prevent stale preloaded belongs-to association from overriding new foreign key on Save.
if existing.Land != nil && !bytes.Equal(existing.Land.ID, parsed) {
existing.Land = nil
}
}
if attrs.SortKey.Set {
if attrs.SortKey.Valid {
sortKey := attrs.SortKey.Value
existing.SortKey = &sortKey
} else {
existing.SortKey = nil
}
}
if attrs.IsActive != nil {
existing.IsActive = *attrs.IsActive
}
existing.UpdatedBy = actorUserID(c)
if err := h.svc.Update(c.UserContext(), existing); err != nil {
return writeFederalStateErrors(c, fiber.StatusBadRequest, []jsonapi.ErrorObject{{
Status: "400",
Title: "Update failed",
Detail: safeInternalDetail(),
}})
}
updated, err := h.svc.GetByID(c.UserContext(), existing.ID)
if err == nil && updated != nil {
return response.Write(c, fiber.StatusOK, federalStateResource(updated))
}
return response.Write(c, fiber.StatusOK, federalStateResource(existing))
}
// DeleteFederalState godoc
// @Summary Delete federal state
// @Tags Hospital - Federal State
// @Produce json
// @Param id path string true "Federal State ID (UUIDv7)"
// @Success 200 {object} dto.FederalStateDeleteResponse
// @Failure 404 {object} dto.ErrorResponse
// @Router /api/v1/federal-state/delete/{id} [delete]
func (h *FederalStateHandler) Delete(c *fiber.Ctx) error {
idStr := c.Params("id")
id, err := uuidv7.ParseString(idStr)
if err != nil {
return writeFederalStateErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{{
Status: "422",
Title: "Validation error",
Detail: "id is invalid UUID",
Source: &jsonapi.ErrorSource{Pointer: "/path/id"},
}})
}
if err := h.svc.Delete(c.UserContext(), id, actorUserID(c)); err != nil {
if errors.Is(err, gorm.ErrRecordNotFound) {
return writeFederalStateErrors(c, fiber.StatusNotFound, []jsonapi.ErrorObject{{
Status: "404",
Title: "Not found",
Detail: "federal state not found",
}})
}
if conflict, ok := apperrors.AsDeleteConflict(err); ok {
return writeFederalStateErrors(c, fiber.StatusConflict, []jsonapi.ErrorObject{{
Status: "409",
Title: "Conflict",
Detail: conflict.Error(),
}})
}
return writeFederalStateErrors(c, fiber.StatusBadRequest, []jsonapi.ErrorObject{{
Status: "400",
Title: "Delete failed",
Detail: safeInternalDetail(),
}})
}
return response.Write(c, fiber.StatusOK, jsonapi.Resource{
Type: "federal_state_delete",
Attributes: map[string]any{
"deleted": true,
},
})
}
// ListFederalState godoc
// @Summary List federal state
// @Description JSON:API list with pagination, filtering and sorting. Sort values: name, -name, sortkey, -sortkey, is_active, -is_active, created_at, -created_at, updated_at, -updated_at.
// @Tags Hospital - Federal State
// @Produce json
// @Param filter[search] query string false "Search by name"
// @Param land_id query string false "Filter federal state by land UUID"
// @Param land_name query string false "Filter federal state by land name"
// @Param page[number] query int false "Page number (default 1)"
// @Param page[size] query int false "Page size (default 20, max 100)"
// @Param sort query string false "Sort order"
// @Success 200 {object} dto.FederalStateListResponse
// @Router /api/v1/federal-state/get-all [get]
func (h *FederalStateHandler) List(c *fiber.Ctx) error {
filter := c.Query("filter[search]")
if filter == "" {
filter = c.Query("filter[name]")
}
landName := c.Query("land_name")
if landName == "" {
landName = c.Query("filter[land_name]")
}
landIDQuery := c.Query("land_id")
landID, landIDErr := parseOptionalUUID(&landIDQuery, "/query/land_id")
if landIDErr != nil {
landIDErr.Detail = "land_id is invalid UUID"
return writeFederalStateErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{*landIDErr})
}
pageNumber := parseIntDefault(c.Query("page[number]"), 1)
pageSize := parseIntDefault(c.Query("page[size]"), 20)
if pageSize > 100 {
pageSize = 100
}
if pageNumber < 1 {
pageNumber = 1
}
offset := (pageNumber - 1) * pageSize
_ = offset
sort := c.Query("sort")
rows, total, err := h.svc.List(c.UserContext(), filter, sort, 0, 0, landID, landName)
if err != nil {
return writeFederalStateErrors(c, fiber.StatusBadRequest, []jsonapi.ErrorObject{{
Status: "400",
Title: "List failed",
Detail: safeInternalDetail(),
}})
}
data := make([]dto.FederalStateResource, 0, len(rows))
for i := range rows {
data = append(data, federalStateResource(&rows[i]))
}
meta := map[string]any{
"page_number": pageNumber,
"page_size": pageSize,
"total": total,
}
return response.WriteWithMeta(c, fiber.StatusOK, data, meta)
}
// ListFederalStateDatatable godoc
// @Summary List federal state (datatable)
// @Description Datatable response with simple pagination params.
// @Tags Hospital - Federal State
// @Produce json
// @Param page query int false "Page number (default 1)"
// @Param size query int false "Page size (default 20, max 100)"
// @Param limit query int false "Page size override (same as size)"
// @Param draw query int false "Draw counter (optional)"
// @Param search query string false "Search term"
// @Param filter[search] query string false "Search by name"
// @Param land_id query string false "Filter federal state by land UUID"
// @Param land_name query string false "Filter federal state by land name"
// @Success 200 {object} dto.FederalStateDataTableResponse
// @Router /api/v1/federal-state/get-all/dt [get]
func (h *FederalStateHandler) ListDatatable(c *fiber.Ctx) error {
pageNumber := parseIntDefault(c.Query("page"), 1)
if pageNumber < 1 {
pageNumber = 1
}
length := parseIntDefault(c.Query("limit"), 0)
if length <= 0 {
length = parseIntDefault(c.Query("size"), 20)
}
if length > 100 {
length = 100
}
if length < 1 {
length = 20
}
start := (pageNumber - 1) * length
draw := parseIntDefault(c.Query("draw"), pageNumber)
search := c.Query("search")
if search == "" {
search = c.Query("filter[search]")
}
if search == "" {
search = c.Query("filter[name]")
}
landName := c.Query("land_name")
if landName == "" {
landName = c.Query("filter[land_name]")
}
landIDQuery := c.Query("land_id")
landID, landIDErr := parseOptionalUUID(&landIDQuery, "/query/land_id")
if landIDErr != nil {
landIDErr.Detail = "land_id is invalid UUID"
return writeFederalStateErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{*landIDErr})
}
rows, total, err := h.svc.List(c.UserContext(), search, "", length, start, landID, landName)
if err != nil {
return writeFederalStateErrors(c, fiber.StatusBadRequest, []jsonapi.ErrorObject{{
Status: "400",
Title: "List failed",
Detail: safeInternalDetail(),
}})
}
data := make([]dto.FederalStateResource, 0, len(rows))
for i := range rows {
data = append(data, federalStateResource(&rows[i]))
}
meta := map[string]any{
"draw": draw,
"records_total": total,
"records_filtered": total,
}
return response.WriteWithMeta(c, fiber.StatusOK, data, meta)
}
func federalStateResource(row *federal_state.FederalState) dto.FederalStateResource {
return dto.FederalStateResource{
Type: "federal_state",
ID: idString(row.ID),
Attributes: dto.FederalStateAttributes{
Name: row.Name,
Note: row.Note,
LandID: idString(row.LandID),
LandName: landNameFromFederalState(row),
LandISOCode: landISOCodeFromFederalState(row),
SortKey: cloneIntPointer(row.SortKey),
IsActive: row.IsActive,
CreatedAt: row.CreatedAt.UTC().Format(time.RFC3339),
CreatedBy: uuidStringOrEmpty(row.CreatedBy),
UpdatedAt: row.UpdatedAt.UTC().Format(time.RFC3339),
UpdatedBy: uuidStringOrEmpty(row.UpdatedBy),
DeletedAt: timeStringOrEmpty(row.DeletedAt),
DeletedBy: uuidStringOrEmpty(row.DeletedBy),
},
}
}
func landNameFromFederalState(row *federal_state.FederalState) string {
if row == nil || row.Land == nil {
return ""
}
return row.Land.Name
}
func landISOCodeFromFederalState(row *federal_state.FederalState) string {
if row == nil || row.Land == nil {
return ""
}
return row.Land.LandISOCode
}
func writeFederalStateErrors(c *fiber.Ctx, status int, errs []jsonapi.ErrorObject) error {
statusStr := strconv.Itoa(status)
enriched := make([]jsonapi.ErrorObject, 0, len(errs))
for i := range errs {
e := errs[i]
e.Status = statusStr
def := inferFederalStateDef(status, e.Title, e.Detail)
if strings.TrimSpace(e.Code) == "" {
e.Code = def.Code
}
if strings.TrimSpace(e.ErrorCode) == "" {
e.ErrorCode = def.ErrorCode
}
e.Detail = def.Message
enriched = append(enriched, e)
}
return response.WriteErrors(c, status, enriched)
}
func inferFederalStateErrorCode(status int, title, detail string) (string, string) {
def := inferFederalStateDef(status, title, detail)
return def.Code, def.ErrorCode
}
func inferFederalStateDef(status int, title, detail string) apperrorsx.Def {
lowerTitle := strings.ToLower(strings.TrimSpace(title))
lowerDetail := strings.ToLower(strings.TrimSpace(detail))
switch status {
case fiber.StatusNotFound:
return apperrorsx.ErrFederalStateNotFound
case fiber.StatusConflict:
return apperrorsx.ErrFederalStateRelationDelete
case fiber.StatusUnprocessableEntity:
switch {
case strings.Contains(lowerDetail, "land_id is invalid uuid"):
return apperrorsx.ErrFederalStateLandIDInvalid
case strings.Contains(lowerDetail, "id is invalid uuid"), strings.Contains(lowerDetail, "invalid uuid"):
return apperrorsx.ErrFederalStateInvalidID
case strings.Contains(lowerDetail, "id is required"):
return apperrorsx.ErrFederalStateIDRequired
case strings.Contains(lowerDetail, "id does not match path id"):
return apperrorsx.ErrFederalStateIDMismatch
case strings.Contains(lowerDetail, "at least one attribute must be provided"):
return apperrorsx.ErrFederalStateAttributesRequired
case strings.Contains(lowerDetail, "name is required"), strings.Contains(lowerDetail, "name cannot be empty"):
return apperrorsx.ErrFederalStateNameRequired
default:
return apperrorsx.ErrFederalStateInvalidPayload
}
case fiber.StatusBadRequest:
switch {
case strings.Contains(lowerTitle, "invalid json"):
return apperrorsx.ErrFederalStateInvalidJSON
case strings.Contains(lowerTitle, "create failed"):
return apperrorsx.ErrFederalStateCreateFailed
case strings.Contains(lowerTitle, "update failed"):
return apperrorsx.ErrFederalStateUpdateFailed
case strings.Contains(lowerTitle, "delete failed"):
return apperrorsx.ErrFederalStateDeleteFailed
case strings.Contains(lowerTitle, "list failed"):
return apperrorsx.ErrFederalStateListFailed
default:
return apperrorsx.ErrFederalStateInvalidPayload
}
default:
return apperrorsx.ErrInternal
}
}