package controller import ( "netidhub-saas-be/app/middleware" "netidhub-saas-be/app/module/clients/request" "netidhub-saas-be/app/module/clients/service" "netidhub-saas-be/utils/paginator" "github.com/gofiber/fiber/v2" "github.com/google/uuid" "github.com/rs/zerolog" utilRes "netidhub-saas-be/utils/response" utilVal "netidhub-saas-be/utils/validator" ) type clientsController struct { clientsService service.ClientsService Log zerolog.Logger } type ClientsController interface { All(c *fiber.Ctx) error Show(c *fiber.Ctx) error Save(c *fiber.Ctx) error Update(c *fiber.Ctx) error Delete(c *fiber.Ctx) error // New hierarchy endpoints GetHierarchy(c *fiber.Ctx) error GetSubClients(c *fiber.Ctx) error CreateSubClient(c *fiber.Ctx) error MoveClient(c *fiber.Ctx) error GetClientStats(c *fiber.Ctx) error BulkCreateSubClients(c *fiber.Ctx) error } func NewClientsController(clientsService service.ClientsService, log zerolog.Logger) ClientsController { return &clientsController{ clientsService: clientsService, Log: log, } } // All get all Clients // @Summary Get all Clients // @Description API for getting all Clients with hierarchy filtering // @Tags Clients // @Security Bearer // @Param X-Client-Key header string true "Insert the X-Client-Key" // @Param Authorization header string false "Insert your access token" default(Bearer ) // @Param name query string false "Filter by client name" // @Param clientType query string false "Filter by client type (parent_client, sub_client, standalone)" // @Param parentClientId query string false "Filter by parent client ID" // @Param includeSubClients query boolean false "Include all descendants" // @Param onlyParentClients query boolean false "Only clients with children" // @Param onlyStandalone query boolean false "Only standalone clients" // @Param onlyRootClients query boolean false "Only root level clients" // @Param isActive query boolean false "Filter by active status" // @Param createdById query string false "Filter by creator ID" // @Param page query int false "Page number" // @Param limit query int false "Items per page" // @Param sort query string false "Sort field" // @Param sortBy query string false "Sort direction (asc, desc)" // @Success 200 {object} response.Response // @Failure 400 {object} response.BadRequestError // @Failure 401 {object} response.UnauthorizedError // @Failure 500 {object} response.InternalServerError // @Router /clients [get] func (_i *clientsController) All(c *fiber.Ctx) error { paginate, err := paginator.Paginate(c) if err != nil { return err } reqContext := request.ClientsQueryRequestContext{ Name: c.Query("name"), ClientType: c.Query("clientType"), ParentClientId: c.Query("parentClientId"), IncludeSubClients: c.Query("includeSubClients"), OnlyParentClients: c.Query("onlyParentClients"), OnlyStandalone: c.Query("onlyStandalone"), IsActive: c.Query("isActive"), CreatedById: c.Query("createdById"), } req := reqContext.ToParamRequest() req.Pagination = paginate // Get ClientId from context clientId := middleware.GetClientID(c) _i.Log.Info().Interface("clientId", clientId).Msg("") clientsData, paging, err := _i.clientsService.All(clientId, req) if err != nil { return err } return utilRes.Resp(c, utilRes.Response{ Success: true, Messages: utilRes.Messages{"Clients list successfully retrieved"}, Data: clientsData, Meta: paging, }) } // Show get one Clients // @Summary Get one Clients // @Description API for getting one Clients // @Tags Clients // @Security Bearer // @Param id path int true "Clients ID" // @Success 200 {object} response.Response // @Failure 400 {object} response.BadRequestError // @Failure 401 {object} response.UnauthorizedError // @Failure 500 {object} response.InternalServerError // @Router /clients/{id} [get] func (_i *clientsController) Show(c *fiber.Ctx) error { idStr := c.Params("id") id, err := uuid.Parse(idStr) if err != nil { return err } clientsData, err := _i.clientsService.Show(id) if err != nil { return err } return utilRes.Resp(c, utilRes.Response{ Success: true, Messages: utilRes.Messages{"Clients successfully retrieved"}, Data: clientsData, }) } // Save create Clients // @Summary Create Clients // @Description API for create Clients // @Tags Clients // @Security Bearer // @Param Authorization header string false "Insert your access token" default(Bearer ) // @Param payload body request.ClientsCreateRequest true "Required payload" // @Success 200 {object} response.Response // @Failure 400 {object} response.BadRequestError // @Failure 401 {object} response.UnauthorizedError // @Failure 500 {object} response.InternalServerError // @Router /clients [post] func (_i *clientsController) Save(c *fiber.Ctx) error { req := new(request.CreateClientRequest) if err := utilVal.ParseAndValidate(c, req); err != nil { return err } authToken := c.Get("Authorization") dataResult, err := _i.clientsService.Save(*req, authToken) if err != nil { return err } return utilRes.Resp(c, utilRes.Response{ Success: true, Messages: utilRes.Messages{"Clients successfully created"}, Data: dataResult, }) } // Update update Clients // @Summary update Clients // @Description API for update Clients // @Tags Clients // @Security Bearer // @Param payload body request.ClientsUpdateRequest true "Required payload" // @Param id path string true "Clients ID" // @Success 200 {object} response.Response // @Failure 400 {object} response.BadRequestError // @Failure 401 {object} response.UnauthorizedError // @Failure 500 {object} response.InternalServerError // @Router /clients/{id} [put] func (_i *clientsController) Update(c *fiber.Ctx) error { idStr := c.Params("id") id, err := uuid.Parse(idStr) if err != nil { return err } req := new(request.UpdateClientRequest) if err := utilVal.ParseAndValidate(c, req); err != nil { return err } err = _i.clientsService.Update(id, *req) if err != nil { return err } return utilRes.Resp(c, utilRes.Response{ Success: true, Messages: utilRes.Messages{"Clients successfully updated"}, }) } // Delete delete Clients // @Summary delete Clients // @Description API for delete Clients // @Tags Clients // @Security Bearer // @Param id path string true "Clients ID" // @Success 200 {object} response.Response // @Failure 400 {object} response.BadRequestError // @Failure 401 {object} response.UnauthorizedError // @Failure 500 {object} response.InternalServerError // @Router /clients/{id} [delete] func (_i *clientsController) Delete(c *fiber.Ctx) error { idStr := c.Params("id") id, err := uuid.Parse(idStr) if err != nil { return err } err = _i.clientsService.Delete(id) if err != nil { return err } return utilRes.Resp(c, utilRes.Response{ Success: true, Messages: utilRes.Messages{"Clients successfully deleted"}, }) } // ===================================================================== // NEW HIERARCHY ENDPOINTS // ===================================================================== // GetHierarchy gets client tree structure // @Summary Get client hierarchy // @Description API for getting client tree structure // @Tags Clients // @Security Bearer // @Param id path string true "Client ID" // @Success 200 {object} response.Response // @Failure 400 {object} response.BadRequestError // @Failure 401 {object} response.UnauthorizedError // @Failure 500 {object} response.InternalServerError // @Router /clients/{id}/hierarchy [get] func (_i *clientsController) GetHierarchy(c *fiber.Ctx) error { clientId, err := uuid.Parse(c.Params("id")) if err != nil { return utilRes.Resp(c, utilRes.Response{ Success: false, Messages: utilRes.Messages{"Invalid client ID"}, }) } hierarchy, err := _i.clientsService.GetHierarchy(clientId) if err != nil { return utilRes.Resp(c, utilRes.Response{ Success: false, Messages: utilRes.Messages{"Client not found"}, }) } return utilRes.Resp(c, utilRes.Response{ Success: true, Messages: utilRes.Messages{"Client hierarchy successfully retrieved"}, Data: hierarchy, }) } // GetSubClients gets direct children // @Summary Get sub-clients // @Description API for getting direct children of a client // @Tags Clients // @Security Bearer // @Param id path string true "Parent Client ID" // @Success 200 {object} response.Response // @Failure 400 {object} response.BadRequestError // @Failure 401 {object} response.UnauthorizedError // @Failure 500 {object} response.InternalServerError // @Router /clients/{id}/sub-clients [get] func (_i *clientsController) GetSubClients(c *fiber.Ctx) error { parentId, err := uuid.Parse(c.Params("id")) if err != nil { return utilRes.Resp(c, utilRes.Response{ Success: false, Messages: utilRes.Messages{"Invalid parent client ID"}, }) } // For now, use GetAll with parent filter req := request.ClientsQueryRequest{ ParentClientId: &parentId, Pagination: &paginator.Pagination{Page: 1, Limit: 100}, } subClients, _, err := _i.clientsService.All(nil, req) if err != nil { return utilRes.Resp(c, utilRes.Response{ Success: false, Messages: utilRes.Messages{"Failed to get sub-clients"}, }) } return utilRes.Resp(c, utilRes.Response{ Success: true, Messages: utilRes.Messages{"Sub-clients successfully retrieved"}, Data: subClients, }) } // CreateSubClient creates client under parent // @Summary Create sub-client // @Description API for creating a client under a parent // @Tags Clients // @Security Bearer // @Param id path string true "Parent Client ID" // @Param payload body request.CreateClientRequest true "Required payload" // @Success 200 {object} response.Response // @Failure 400 {object} response.BadRequestError // @Failure 401 {object} response.UnauthorizedError // @Failure 500 {object} response.InternalServerError // @Router /clients/{id}/sub-clients [post] func (_i *clientsController) CreateSubClient(c *fiber.Ctx) error { parentId, err := uuid.Parse(c.Params("id")) if err != nil { return utilRes.Resp(c, utilRes.Response{ Success: false, Messages: utilRes.Messages{"Invalid parent client ID"}, }) } req := new(request.CreateClientRequest) if err := utilVal.ParseAndValidate(c, req); err != nil { return err } client, err := _i.clientsService.CreateSubClient(parentId, *req) if err != nil { return utilRes.Resp(c, utilRes.Response{ Success: false, Messages: utilRes.Messages{err.Error()}, }) } return utilRes.Resp(c, utilRes.Response{ Success: true, Messages: utilRes.Messages{"Sub-client successfully created"}, Data: client, }) } // MoveClient moves client to different parent // @Summary Move client // @Description API for moving a client to different parent // @Tags Clients // @Security Bearer // @Param id path string true "Client ID" // @Param payload body request.MoveClientRequest true "Required payload" // @Success 200 {object} response.Response // @Failure 400 {object} response.BadRequestError // @Failure 401 {object} response.UnauthorizedError // @Failure 500 {object} response.InternalServerError // @Router /clients/{id}/move [put] func (_i *clientsController) MoveClient(c *fiber.Ctx) error { clientId, err := uuid.Parse(c.Params("id")) if err != nil { return utilRes.Resp(c, utilRes.Response{ Success: false, Messages: utilRes.Messages{"Invalid client ID"}, }) } req := new(request.MoveClientRequest) if err := utilVal.ParseAndValidate(c, req); err != nil { return err } err = _i.clientsService.MoveClient(clientId, *req) if err != nil { return utilRes.Resp(c, utilRes.Response{ Success: false, Messages: utilRes.Messages{err.Error()}, }) } return utilRes.Resp(c, utilRes.Response{ Success: true, Messages: utilRes.Messages{"Client moved successfully"}, }) } // GetClientStats gets statistics // @Summary Get client statistics // @Description API for getting client statistics // @Tags Clients // @Security Bearer // @Param id path string true "Client ID" // @Success 200 {object} response.Response // @Failure 400 {object} response.BadRequestError // @Failure 401 {object} response.UnauthorizedError // @Failure 500 {object} response.InternalServerError // @Router /clients/{id}/stats [get] func (_i *clientsController) GetClientStats(c *fiber.Ctx) error { clientId, err := uuid.Parse(c.Params("id")) if err != nil { return utilRes.Resp(c, utilRes.Response{ Success: false, Messages: utilRes.Messages{"Invalid client ID"}, }) } stats, err := _i.clientsService.GetClientStats(clientId) if err != nil { return utilRes.Resp(c, utilRes.Response{ Success: false, Messages: utilRes.Messages{"Client not found"}, }) } return utilRes.Resp(c, utilRes.Response{ Success: true, Messages: utilRes.Messages{"Client statistics successfully retrieved"}, Data: stats, }) } // BulkCreateSubClients creates multiple sub-clients // @Summary Bulk create sub-clients // @Description API for creating multiple sub-clients at once // @Tags Clients // @Security Bearer // @Param payload body request.BulkCreateSubClientsRequest true "Required payload" // @Success 200 {object} response.Response // @Failure 400 {object} response.BadRequestError // @Failure 401 {object} response.UnauthorizedError // @Failure 500 {object} response.InternalServerError // @Router /clients/bulk-sub-clients [post] func (_i *clientsController) BulkCreateSubClients(c *fiber.Ctx) error { req := new(request.BulkCreateSubClientsRequest) if err := utilVal.ParseAndValidate(c, req); err != nil { return err } result, err := _i.clientsService.BulkCreateSubClients(*req) if err != nil { return utilRes.Resp(c, utilRes.Response{ Success: false, Messages: utilRes.Messages{err.Error()}, }) } return utilRes.Resp(c, utilRes.Response{ Success: true, Messages: utilRes.Messages{"Bulk operation completed"}, Data: result, }) }