init push

internal/transport/http/handlers/other_person_handler.go

@@ -0,0 +1,185 @@
+package handlers
+
+import (
+	"errors"
+	"strconv"
+	"strings"
+
+	"github.com/gofiber/fiber/v2"
+
+	otherperson "wucher/internal/domain/other_person"
+	"wucher/internal/shared/pkg/apperrorsx"
+	"wucher/internal/shared/pkg/uuidv7"
+	requestdto "wucher/internal/transport/http/dto/request"
+	responsedto "wucher/internal/transport/http/dto/response"
+	"wucher/internal/transport/http/response"
+)
+
+// OtherPersonHandler serves the reusable, non-staff "other person" master (a picker for
+// takeover other-people). It never mixes with contacts/staff.
+type OtherPersonHandler struct {
+	svc otherperson.Service
+}
+
+func NewOtherPersonHandler(svc otherperson.Service) *OtherPersonHandler {
+	return &OtherPersonHandler{svc: svc}
+}
+
+func otherPersonResource(p *otherperson.OtherPerson) responsedto.OtherPersonResource {
+	return responsedto.OtherPersonResource{
+		Type: "other_person",
+		ID:   idString(p.ID),
+		Attributes: responsedto.OtherPersonAttributes{
+			Name:        p.Name,
+			MobilePhone: p.MobilePhone,
+			Email:       p.Email,
+		},
+	}
+}
+
+// writeOtherPersonError maps service/domain errors to the right HTTP status.
+func writeOtherPersonError(c *fiber.Ctx, err error) error {
+	switch {
+	case errors.Is(err, otherperson.ErrNameRequired):
+		return apperrorsx.Write(c, apperrorsx.New(apperrorsx.ErrValidation).WithCause(err))
+	case errors.Is(err, otherperson.ErrDuplicate):
+		return apperrorsx.Write(c, apperrorsx.New(apperrorsx.ErrBusinessRuleFailed).WithCause(err))
+	case errors.Is(err, otherperson.ErrNotFound):
+		return apperrorsx.Write(c, apperrorsx.New(apperrorsx.ErrDataNotFound).WithCause(err))
+	default:
+		return apperrorsx.Write(c, apperrorsx.New(apperrorsx.ErrInternal).WithCause(err))
+	}
+}
+
+// Search godoc
+// @Summary Search reusable "other people" (non-staff) for the takeover picker
+// @Description Lists master other-people whose name/mobile_phone/email matches `q` (empty `q` = most recent). Pick one and pass its id as `other_person_id` in a takeover's other_person to reuse without re-entering the data.
+// @Tags Contact - Other People
+// @Produce json
+// @Param q query string false "Search text (name / mobile_phone / email)"
+// @Param limit query int false "Max results (default 20)"
+// @Param offset query int false "Offset"
+// @Success 200 {object} responsedto.OtherPersonListResponse
+// @Router /api/v1/contact/other [get]
+func (h *OtherPersonHandler) Search(c *fiber.Ctx) error {
+	q := strings.TrimSpace(c.Query("q"))
+	limit, _ := strconv.Atoi(c.Query("limit"))
+	offset, _ := strconv.Atoi(c.Query("offset"))
+	rows, total, err := h.svc.Search(c.UserContext(), q, limit, offset)
+	if err != nil {
+		return apperrorsx.Write(c, apperrorsx.New(apperrorsx.ErrInternal).WithCause(err))
+	}
+	data := make([]responsedto.OtherPersonResource, 0, len(rows))
+	for i := range rows {
+		data = append(data, otherPersonResource(&rows[i]))
+	}
+	return response.WriteWithMeta(c, fiber.StatusOK, data, map[string]any{"total": total})
+}
+
+// Get godoc
+// @Summary Get one reusable "other person"
+// @Tags Contact - Other People
+// @Produce json
+// @Param id path string true "Other person id"
+// @Success 200 {object} responsedto.OtherPersonResponse
+// @Router /api/v1/contact/other/get/{id} [get]
+func (h *OtherPersonHandler) Get(c *fiber.Ctx) error {
+	id, err := uuidv7.ParseString(strings.TrimSpace(c.Params("id")))
+	if err != nil {
+		return apperrorsx.Write(c, apperrorsx.New(apperrorsx.ErrInvalidRequest).WithCause(err))
+	}
+	row, err := h.svc.GetByID(c.UserContext(), id)
+	if err != nil {
+		return apperrorsx.Write(c, apperrorsx.New(apperrorsx.ErrInternal).WithCause(err))
+	}
+	if row == nil {
+		return apperrorsx.Write(c, apperrorsx.New(apperrorsx.ErrDataNotFound))
+	}
+	return response.Write(c, fiber.StatusOK, otherPersonResource(row))
+}
+
+// Create godoc
+// @Summary Create a reusable "other person" (non-staff)
+// @Description Registers a person in the other-people master so it can be reused across takeovers. The (name, mobile_phone, email) identity must be unique.
+// @Tags Contact - Other People
+// @Accept json
+// @Produce json
+// @Param request body requestdto.OtherPersonRequest true "Other person"
+// @Success 201 {object} responsedto.OtherPersonResponse
+// @Router /api/v1/contact/other/create [post]
+func (h *OtherPersonHandler) Create(c *fiber.Ctx) error {
+	var req requestdto.OtherPersonRequest
+	if err := c.BodyParser(&req); err != nil {
+		return writeBodyParseError(c, err, apperrorsx.ErrInvalidRequest)
+	}
+	actor := actorUserID(c)
+	p := &otherperson.OtherPerson{
+		Name:        req.Data.Attributes.Name,
+		MobilePhone: req.Data.Attributes.MobilePhone,
+		Email:       req.Data.Attributes.Email,
+		CreatedBy:   actor,
+		UpdatedBy:   actor,
+	}
+	if err := h.svc.Create(c.UserContext(), p); err != nil {
+		return writeOtherPersonError(c, err)
+	}
+	return response.Write(c, fiber.StatusCreated, otherPersonResource(p))
+}
+
+// Update godoc
+// @Summary Update a reusable "other person"
+// @Description Replaces the name/mobile_phone/email of a master person. The new identity must not collide with another person.
+// @Tags Contact - Other People
+// @Accept json
+// @Produce json
+// @Param id path string true "Other person id"
+// @Param request body requestdto.OtherPersonRequest true "Other person"
+// @Success 200 {object} responsedto.OtherPersonResponse
+// @Router /api/v1/contact/other/update/{id} [patch]
+func (h *OtherPersonHandler) Update(c *fiber.Ctx) error {
+	id, err := uuidv7.ParseString(strings.TrimSpace(c.Params("id")))
+	if err != nil {
+		return apperrorsx.Write(c, apperrorsx.New(apperrorsx.ErrInvalidRequest).WithCause(err))
+	}
+	var req requestdto.OtherPersonRequest
+	if err := c.BodyParser(&req); err != nil {
+		return writeBodyParseError(c, err, apperrorsx.ErrInvalidRequest)
+	}
+	p := &otherperson.OtherPerson{
+		ID:          id,
+		Name:        req.Data.Attributes.Name,
+		MobilePhone: req.Data.Attributes.MobilePhone,
+		Email:       req.Data.Attributes.Email,
+		UpdatedBy:   actorUserID(c),
+	}
+	if err := h.svc.Update(c.UserContext(), p); err != nil {
+		return writeOtherPersonError(c, err)
+	}
+	row, err := h.svc.GetByID(c.UserContext(), id)
+	if err != nil {
+		return apperrorsx.Write(c, apperrorsx.New(apperrorsx.ErrInternal).WithCause(err))
+	}
+	if row == nil {
+		return apperrorsx.Write(c, apperrorsx.New(apperrorsx.ErrDataNotFound))
+	}
+	return response.Write(c, fiber.StatusOK, otherPersonResource(row))
+}
+
+// Delete godoc
+// @Summary Delete a reusable "other person"
+// @Description Soft-deletes a master person. Existing takeover snapshots keep their own copy of the data.
+// @Tags Contact - Other People
+// @Produce json
+// @Param id path string true "Other person id"
+// @Success 200 {object} map[string]interface{}
+// @Router /api/v1/contact/other/delete/{id} [delete]
+func (h *OtherPersonHandler) Delete(c *fiber.Ctx) error {
+	id, err := uuidv7.ParseString(strings.TrimSpace(c.Params("id")))
+	if err != nil {
+		return apperrorsx.Write(c, apperrorsx.New(apperrorsx.ErrInvalidRequest).WithCause(err))
+	}
+	if err := h.svc.Delete(c.UserContext(), id, actorUserID(c)); err != nil {
+		return writeOtherPersonError(c, err)
+	}
+	return response.Write(c, fiber.StatusOK, map[string]any{"id": idString(id), "deleted": true})
+}