init push

This commit is contained in:
2026-07-16 22:16:45 +07:00
commit 8b068bdb10
1021 changed files with 332816 additions and 0 deletions

View File

@@ -0,0 +1,430 @@
package handlers
import (
"errors"
"strconv"
"strings"
"time"
"github.com/gofiber/fiber/v2"
"gorm.io/gorm"
"wucher/internal/domain/operation"
"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 HEMSOperationHandler struct {
svc operation.HEMSOperationService
validate *validators.Validator
}
func NewHEMSOperationHandler(svc operation.HEMSOperationService) *HEMSOperationHandler {
return &HEMSOperationHandler{svc: svc, validate: validators.New()}
}
// CreateHEMSOperation godoc
// @Summary Create HEMS operation
// @Tags Operation - HEMS Operation
// @Accept json
// @Produce json
// @Param request body dto.HEMSOperationCreateRequest true "JSON:API HEMS operation create request"
// @Success 201 {object} dto.HEMSOperationResponse
// @Failure 422 {object} dto.ErrorResponse
// @Failure 400 {object} dto.ErrorResponse
// @Router /api/v1/hems-operation/create [post]
func (h *HEMSOperationHandler) Create(c *fiber.Ctx) error {
var req dto.HEMSOperationCreateRequest
if err := c.BodyParser(&req); err != nil {
return writeHEMSOperationErrors(c, fiber.StatusBadRequest, []jsonapi.ErrorObject{{Status: "400", Title: "Invalid JSON", Detail: safeInternalDetail()}})
}
if errs := h.validate.ValidateStruct(req); errs != nil {
return writeHEMSOperationErrors(c, fiber.StatusUnprocessableEntity, errs)
}
dt, err := time.Parse(time.RFC3339, strings.TrimSpace(req.Data.Attributes.Date))
if err != nil {
return writeHEMSOperationErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{{
Status: "422", Title: "Validation error", Detail: "date must be in RFC3339 format", Source: &jsonapi.ErrorSource{Pointer: "/data/attributes/date"},
}})
}
row := &operation.HEMSOperation{Date: dt, CreatedBy: actorUserID(c), UpdatedBy: actorUserID(c)}
if req.Data.Attributes.OperationalDataID != nil {
parsed, errObj := parseOptionalUUID(req.Data.Attributes.OperationalDataID, "/data/attributes/operational_data_id")
if errObj != nil {
return writeHEMSOperationErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{*errObj})
}
row.OperationalDataID = parsed
}
if req.Data.Attributes.MissionID != nil {
parsed, errObj := parseOptionalUUID(req.Data.Attributes.MissionID, "/data/attributes/mission_id")
if errObj != nil {
return writeHEMSOperationErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{*errObj})
}
row.MissionID = parsed
}
if req.Data.Attributes.HEMSOperationCategoryID != nil {
parsed, errObj := parseOptionalUUID(req.Data.Attributes.HEMSOperationCategoryID, "/data/attributes/hems_operation_category_id")
if errObj != nil {
return writeHEMSOperationErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{*errObj})
}
row.HEMSOperationCategoryID = parsed
}
if err := h.svc.Create(c.UserContext(), row); err != nil {
if status, errs, ok := mapOperationRelationError(err, map[string]relationFieldError{
"(`operational_data_id`)": {Pointer: "/data/attributes/operational_data_id", Detail: "operational_data_id references data that does not exist"},
"(`hems_operation_category_id`)": {Pointer: "/data/attributes/hems_operation_category_id", Detail: "hems_operation_category_id references data that does not exist"},
"(`mission_id`)": {Pointer: "/data/attributes/mission_id", Detail: "mission_id references data that does not exist"},
"references `hems_operational_data`": {Pointer: "/data/attributes/operational_data_id", Detail: "operational_data_id references data that does not exist"},
"references `hems_operation_categories`": {Pointer: "/data/attributes/hems_operation_category_id", Detail: "hems_operation_category_id references data that does not exist"},
"references `missions`": {Pointer: "/data/attributes/mission_id", Detail: "mission_id references data that does not exist"},
}); ok {
return writeHEMSOperationErrors(c, status, errs)
}
return writeHEMSOperationErrors(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, hemsOperationResource(created))
}
return response.Write(c, fiber.StatusCreated, hemsOperationResource(row))
}
// GetHEMSOperation godoc
// @Summary Get HEMS operation by ID
// @Tags Operation - HEMS Operation
// @Produce json
// @Param uuid path string true "HEMS operation UUID (UUIDv7)"
// @Success 200 {object} dto.HEMSOperationResponse
// @Failure 422 {object} dto.ErrorResponse
// @Failure 404 {object} dto.ErrorResponse
// @Router /api/v1/hems-operation/get/{uuid} [get]
func (h *HEMSOperationHandler) Get(c *fiber.Ctx) error {
id, err := uuidv7.ParseString(c.Params("uuid"))
if err != nil {
return writeHEMSOperationErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{{Status: "422", Title: "Validation error", Detail: "uuid is invalid UUID", Source: &jsonapi.ErrorSource{Pointer: "/path/uuid"}}})
}
row, err := h.svc.GetByID(c.UserContext(), id)
if err != nil || row == nil {
return writeHEMSOperationErrors(c, fiber.StatusNotFound, []jsonapi.ErrorObject{{Status: "404", Title: "Not found", Detail: "hems operation not found"}})
}
return response.Write(c, fiber.StatusOK, hemsOperationResource(row))
}
// UpdateHEMSOperation godoc
// @Summary Update HEMS operation (partial)
// @Tags Operation - HEMS Operation
// @Accept json
// @Produce json
// @Param uuid path string true "HEMS operation UUID (UUIDv7)"
// @Param request body dto.HEMSOperationUpdateRequest true "JSON:API HEMS operation update request"
// @Success 200 {object} dto.HEMSOperationResponse
// @Failure 422 {object} dto.ErrorResponse
// @Failure 404 {object} dto.ErrorResponse
// @Router /api/v1/hems-operation/update/{uuid} [patch]
func (h *HEMSOperationHandler) Update(c *fiber.Ctx) error {
id, err := uuidv7.ParseString(c.Params("uuid"))
if err != nil {
return writeHEMSOperationErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{{Status: "422", Title: "Validation error", Detail: "uuid is invalid UUID", Source: &jsonapi.ErrorSource{Pointer: "/path/uuid"}}})
}
var req dto.HEMSOperationUpdateRequest
if err := c.BodyParser(&req); err != nil {
return writeHEMSOperationErrors(c, fiber.StatusBadRequest, []jsonapi.ErrorObject{{Status: "400", Title: "Invalid JSON", Detail: safeInternalDetail()}})
}
if errs := h.validate.ValidateStruct(req); errs != nil {
return writeHEMSOperationErrors(c, fiber.StatusUnprocessableEntity, errs)
}
attrs := req.Data.Attributes
if attrs.Date == nil && attrs.OperationalDataID == nil && attrs.MissionID == nil && attrs.HEMSOperationCategoryID == nil {
return writeHEMSOperationErrors(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 writeHEMSOperationErrors(c, fiber.StatusNotFound, []jsonapi.ErrorObject{{Status: "404", Title: "Not found", Detail: "hems operation not found"}})
}
if attrs.Date != nil {
dt, err := time.Parse(time.RFC3339, strings.TrimSpace(*attrs.Date))
if err != nil {
return writeHEMSOperationErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{{
Status: "422", Title: "Validation error", Detail: "date must be in RFC3339 format", Source: &jsonapi.ErrorSource{Pointer: "/data/attributes/date"},
}})
}
existing.Date = dt
}
if attrs.OperationalDataID != nil {
parsed, errObj := parseOptionalUUID(attrs.OperationalDataID, "/data/attributes/operational_data_id")
if errObj != nil {
return writeHEMSOperationErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{*errObj})
}
existing.OperationalDataID = parsed
}
if attrs.MissionID != nil {
parsed, errObj := parseOptionalUUID(attrs.MissionID, "/data/attributes/mission_id")
if errObj != nil {
return writeHEMSOperationErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{*errObj})
}
existing.MissionID = parsed
}
if attrs.HEMSOperationCategoryID != nil {
parsed, errObj := parseOptionalUUID(attrs.HEMSOperationCategoryID, "/data/attributes/hems_operation_category_id")
if errObj != nil {
return writeHEMSOperationErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{*errObj})
}
existing.HEMSOperationCategoryID = parsed
}
existing.UpdatedBy = actorUserID(c)
if err := h.svc.Update(c.UserContext(), existing); err != nil {
if status, errs, ok := mapOperationRelationError(err, map[string]relationFieldError{
"(`operational_data_id`)": {Pointer: "/data/attributes/operational_data_id", Detail: "operational_data_id references data that does not exist"},
"(`hems_operation_category_id`)": {Pointer: "/data/attributes/hems_operation_category_id", Detail: "hems_operation_category_id references data that does not exist"},
"(`mission_id`)": {Pointer: "/data/attributes/mission_id", Detail: "mission_id references data that does not exist"},
"references `hems_operational_data`": {Pointer: "/data/attributes/operational_data_id", Detail: "operational_data_id references data that does not exist"},
"references `hems_operation_categories`": {Pointer: "/data/attributes/hems_operation_category_id", Detail: "hems_operation_category_id references data that does not exist"},
"references `missions`": {Pointer: "/data/attributes/mission_id", Detail: "mission_id references data that does not exist"},
}); ok {
return writeHEMSOperationErrors(c, status, errs)
}
return writeHEMSOperationErrors(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, hemsOperationResource(updated))
}
return response.Write(c, fiber.StatusOK, hemsOperationResource(existing))
}
// DeleteHEMSOperation godoc
// @Summary Delete HEMS operation
// @Tags Operation - HEMS Operation
// @Produce json
// @Param uuid path string true "HEMS operation UUID (UUIDv7)"
// @Success 200 {object} dto.GenericDeleteResponse
// @Failure 422 {object} dto.ErrorResponse
// @Failure 404 {object} dto.ErrorResponse
// @Failure 400 {object} dto.ErrorResponse
// @Router /api/v1/hems-operation/delete/{uuid} [delete]
func (h *HEMSOperationHandler) Delete(c *fiber.Ctx) error {
id, err := uuidv7.ParseString(c.Params("uuid"))
if err != nil {
return writeHEMSOperationErrors(c, fiber.StatusUnprocessableEntity, []jsonapi.ErrorObject{{Status: "422", Title: "Validation error", Detail: "uuid is invalid UUID", Source: &jsonapi.ErrorSource{Pointer: "/path/uuid"}}})
}
if err := h.svc.Delete(c.UserContext(), id, actorUserID(c)); err != nil {
if errors.Is(err, gorm.ErrRecordNotFound) {
return writeHEMSOperationErrors(c, fiber.StatusNotFound, []jsonapi.ErrorObject{{Status: "404", Title: "Not found", Detail: "hems operation not found"}})
}
if status, errs, ok := mapOperationRelationError(err, nil); ok {
return writeHEMSOperationErrors(c, status, errs)
}
return writeHEMSOperationErrors(c, fiber.StatusBadRequest, []jsonapi.ErrorObject{{Status: "400", Title: "Delete failed", Detail: safeInternalDetail()}})
}
return response.Write(c, fiber.StatusOK, jsonapi.Resource{Type: "hems_operation_delete", Attributes: map[string]any{"deleted": true}})
}
// ListHEMSOperation godoc
// @Summary List HEMS operations
// @Tags Operation - HEMS Operation
// @Produce json
// @Param filter[search] query string false "Search by date"
// @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.HEMSOperationListResponse
// @Router /api/v1/hems-operation/get-all [get]
func (h *HEMSOperationHandler) List(c *fiber.Ctx) error {
filter := c.Query("filter[search]")
if filter == "" {
filter = c.Query("search")
}
pageNumber := parseIntDefault(c.Query("page[number]"), 0)
if pageNumber <= 0 {
pageNumber = parseIntDefault(c.Query("page"), 1)
}
pageSize := parseIntDefault(c.Query("page[size]"), 0)
if pageSize <= 0 {
pageSize = parseIntDefault(c.Query("limit"), 0)
}
if pageSize <= 0 {
pageSize = parseIntDefault(c.Query("size"), 20)
}
if pageSize > 100 {
pageSize = 100
}
if pageSize < 1 {
pageSize = 20
}
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)
if err != nil {
return writeHEMSOperationErrors(c, fiber.StatusBadRequest, []jsonapi.ErrorObject{{Status: "400", Title: "List failed", Detail: safeInternalDetail()}})
}
data := make([]dto.HEMSOperationResource, 0, len(rows))
for i := range rows {
data = append(data, hemsOperationResource(&rows[i]).Data)
}
meta := map[string]any{"page_number": pageNumber, "page_size": pageSize, "total": total}
return response.WriteWithMeta(c, fiber.StatusOK, data, meta)
}
// ListHEMSOperationDatatable godoc
// @Summary List HEMS operations (datatable)
// @Tags Operation - HEMS Operation
// @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"
// @Success 200 {object} dto.HEMSOperationDataTableResponse
// @Router /api/v1/hems-operation/get-all/dt [get]
func (h *HEMSOperationHandler) 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")
rows, total, err := h.svc.List(c.UserContext(), search, "", length, start)
if err != nil {
return writeHEMSOperationErrors(c, fiber.StatusBadRequest, []jsonapi.ErrorObject{{Status: "400", Title: "List failed", Detail: safeInternalDetail()}})
}
data := make([]dto.HEMSOperationResource, 0, len(rows))
for i := range rows {
data = append(data, hemsOperationResource(&rows[i]).Data)
}
meta := map[string]any{"draw": draw, "records_total": total, "records_filtered": total}
return response.WriteWithMeta(c, fiber.StatusOK, data, meta)
}
func hemsOperationResource(row *operation.HEMSOperation) dto.HEMSOperationResponse {
if row == nil {
return dto.HEMSOperationResponse{Data: dto.HEMSOperationResource{Type: "hems_operation"}}
}
operationalDataID := uuidStringOrEmpty(row.OperationalDataID)
missionID := uuidStringOrEmpty(row.MissionID)
categoryID := uuidStringOrEmpty(row.HEMSOperationCategoryID)
var operationalData *dto.HEMSOperationOperationalDataRef
if row.OperationalData != nil && len(row.OperationalData.ID) > 0 {
operationalData = &dto.HEMSOperationOperationalDataRef{ID: idString(row.OperationalData.ID)}
}
var mission *dto.HEMSOperationMissionRef
if row.Mission != nil && len(row.Mission.ID) > 0 {
mission = &dto.HEMSOperationMissionRef{
ID: idString(row.Mission.ID),
FlightID: uuidStringOrEmpty(row.Mission.FlightID),
Type: row.Mission.Type,
}
}
var category *dto.HEMSOperationCategoryRef
if row.HEMSOperationCategory != nil && len(row.HEMSOperationCategory.ID) > 0 {
category = &dto.HEMSOperationCategoryRef{ID: idString(row.HEMSOperationCategory.ID), Name: row.HEMSOperationCategory.Name, Type: row.HEMSOperationCategory.Type}
}
attrs := dto.HEMSOperationAttributes{
Date: row.Date.UTC().Format(time.RFC3339),
OperationalDataID: operationalDataID,
MissionID: missionID,
HEMSOperationCategoryID: categoryID,
OperationalData: operationalData,
Mission: mission,
HEMSOperationCategory: category,
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),
}
return dto.HEMSOperationResponse{Data: dto.HEMSOperationResource{Type: "hems_operation", ID: idString(row.ID), Attributes: attrs}}
}
func writeHEMSOperationErrors(c *fiber.Ctx, status int, errs []jsonapi.ErrorObject) error {
enriched := make([]jsonapi.ErrorObject, 0, len(errs))
statusStr := strconv.Itoa(status)
for i := range errs {
e := errs[i]
e.Status = statusStr
if strings.TrimSpace(e.Code) == "" || strings.TrimSpace(e.ErrorCode) == "" {
code, errorCode := inferHEMSOperationErrorCode(status, e.Title, e.Detail)
if strings.TrimSpace(e.Code) == "" {
e.Code = code
}
if strings.TrimSpace(e.ErrorCode) == "" {
e.ErrorCode = errorCode
}
}
enriched = append(enriched, e)
}
return response.WriteErrors(c, status, enriched)
}
func inferHEMSOperationErrorCode(status int, title, detail string) (string, string) {
lowerTitle := strings.ToLower(strings.TrimSpace(title))
lowerDetail := strings.ToLower(strings.TrimSpace(detail))
switch status {
case fiber.StatusNotFound:
return apperrorsx.CodeHEMSOperationNotFound, apperrorsx.ErrHEMSOperationNotFound.ErrorCode
case fiber.StatusUnprocessableEntity:
switch {
case strings.Contains(lowerDetail, "uuid is invalid"):
return apperrorsx.CodeHEMSOperationInvalidUUID, apperrorsx.ErrHEMSOperationInvalidUUID.ErrorCode
case strings.Contains(lowerDetail, "at least one attribute"):
return apperrorsx.CodeHEMSOperationAttributesRequired, apperrorsx.ErrHEMSOperationAttributesRequired.ErrorCode
case strings.Contains(lowerDetail, "date must be in rfc3339"):
return apperrorsx.CodeHEMSOperationDateInvalidRFC3339, apperrorsx.ErrHEMSOperationDateInvalidRFC3339.ErrorCode
case strings.Contains(lowerDetail, "references data that does not exist"), strings.Contains(lowerDetail, "invalid uuid"):
return apperrorsx.CodeHEMSOperationRelationReferenceInvalid, apperrorsx.ErrHEMSOperationRelationReferenceInvalid.ErrorCode
default:
return apperrorsx.CodeHEMSOperationInvalidPayload, apperrorsx.ErrHEMSOperationInvalidPayload.ErrorCode
}
case fiber.StatusBadRequest:
switch {
case strings.Contains(lowerTitle, "invalid json"):
return apperrorsx.CodeHEMSOperationInvalidJSON, apperrorsx.ErrHEMSOperationInvalidJSON.ErrorCode
case strings.Contains(lowerTitle, "create failed"):
return apperrorsx.CodeHEMSOperationCreateFailed, apperrorsx.ErrHEMSOperationCreateFailed.ErrorCode
case strings.Contains(lowerTitle, "update failed"):
return apperrorsx.CodeHEMSOperationUpdateFailed, apperrorsx.ErrHEMSOperationUpdateFailed.ErrorCode
case strings.Contains(lowerTitle, "delete failed"):
return apperrorsx.CodeHEMSOperationDeleteFailed, apperrorsx.ErrHEMSOperationDeleteFailed.ErrorCode
case strings.Contains(lowerTitle, "list failed"):
return apperrorsx.CodeHEMSOperationListFailed, apperrorsx.ErrHEMSOperationListFailed.ErrorCode
default:
return apperrorsx.CodeInvalidRequest, apperrorsx.ErrInvalidRequest.ErrorCode
}
default:
return apperrorsx.CodeInternalServerError, apperrorsx.ErrInternal.ErrorCode
}
}