Add Company Category Management Functionality and Update API Documentation

- Introduced a new company category management feature, including CRUD operations for categories in both admin and public API endpoints.
- Implemented category entity, service, repository, and handler layers following clean architecture principles.
- Added new API routes for searching, retrieving, updating, deleting, and toggling publish status of categories, enhancing the overall functionality of the system.
- Updated Swagger and YAML documentation to include detailed descriptions and examples for the new category endpoints, ensuring clarity for API consumers.
- Enhanced error handling for duplicate categories and validation, improving the robustness of the category management process.
- Updated existing routes to integrate category handling, ensuring a seamless user experience across the application.

cmd/web/router/routes.go

@@ -2,6 +2,7 @@ package router
 
 import (
 	"tm/internal/company"
+	"tm/internal/company_category"
 	"tm/internal/customer"
 	"tm/internal/feedback"
 	"tm/internal/inquiry"
@@ -12,7 +13,7 @@ import (
 	"github.com/labstack/echo/v4"
 )
 
-func RegisterAdminRoutes(e *echo.Echo, userHandler *user.Handler, companyHandler *company.Handler, customerHandler *customer.Handler, tenderHandler *tender.TenderHandler, feedbackHandler *feedback.Handler, tenderApprovalHandler *tender_approval.Handler, inquiryHandler *inquiry.Handler) {
+func RegisterAdminRoutes(e *echo.Echo, userHandler *user.Handler, companyHandler *company.Handler, customerHandler *customer.Handler, tenderHandler *tender.TenderHandler, feedbackHandler *feedback.Handler, tenderApprovalHandler *tender_approval.Handler, inquiryHandler *inquiry.Handler, categoryHandler *company_category.Handler) {
 	adminV1 := e.Group("/admin/v1")
 
 	// Admin Users Routes
@@ -56,6 +57,18 @@ func RegisterAdminRoutes(e *echo.Echo, userHandler *user.Handler, companyHandler
 		companiesGP.PATCH("/:id/verification", companyHandler.UpdateVerification)
 	}
 
+	// Admin Categories Routes
+	categoriesGP := adminV1.Group("/company-categories")
+	{
+		categoriesGP.Use(userHandler.AuthMiddleware())
+		categoriesGP.POST("", categoryHandler.Create)
+		categoriesGP.GET("", categoryHandler.Search)
+		categoriesGP.GET("/:id", categoryHandler.Get)
+		categoriesGP.PUT("/:id", categoryHandler.Update)
+		categoriesGP.DELETE("/:id", categoryHandler.Delete)
+		categoriesGP.PATCH("/:id/publish", categoryHandler.TogglePublish)
+	}
+
 	// Admin Customers Routes
 	customersGP := adminV1.Group("/customers")
 	{
@@ -109,7 +122,7 @@ func RegisterAdminRoutes(e *echo.Echo, userHandler *user.Handler, companyHandler
 	}
 }
 
-func RegisterPublicRoutes(e *echo.Echo, customerHandler *customer.Handler, tenderHandler *tender.TenderHandler, feedbackHandler *feedback.Handler, tenderApprovalHandler *tender_approval.Handler, companyHandler *company.Handler, inquiryHandler *inquiry.Handler) {
+func RegisterPublicRoutes(e *echo.Echo, customerHandler *customer.Handler, tenderHandler *tender.TenderHandler, feedbackHandler *feedback.Handler, tenderApprovalHandler *tender_approval.Handler, companyHandler *company.Handler, inquiryHandler *inquiry.Handler, categoryHandler *company_category.Handler) {
 	v1 := e.Group("/api/v1")
 
 	customerGP := v1.Group("/profile")