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/main.go

@@ -35,6 +35,9 @@ package main
 // @tag.name Admin-Companies
 // @tag.description Administrative company management operations for web panel including CRUD operations, tag management, verification, status updates, comprehensive search and filtering, and statistical reporting
 
+// @tag.name Admin-Company-Categories
+// @tag.description Administrative company category management operations for web panel including CRUD operations, publish/unpublish status, and comprehensive filtering with pagination
+
 // @tag.name Admin-Tenders
 // @tag.description Administrative tender management operations for web panel including CRUD operations, search, statistics, and comprehensive filtering with pagination
 
@@ -71,6 +74,7 @@ import (
 	"net/http"
 	"time"
 	"tm/internal/company"
+	"tm/internal/company_category"
 	"tm/internal/customer"
 	"tm/internal/feedback"
 	"tm/internal/inquiry"
@@ -119,12 +123,13 @@ func main() {
 	userRepository := user.NewUserRepository(mongoManager, logger)
 	customerRepository := customer.NewCustomerRepository(mongoManager, logger)
 	companyRepository := company.NewCompanyRepository(mongoManager, logger)
+	categoryRepository := company_category.NewCategoryRepository(mongoManager, logger)
 	tenderRepository := tender.NewTenderRepository(mongoManager, logger)
 	feedbackRepo := feedback.NewFeedbackRepository(mongoManager, logger)
 	tenderApprovalRepository := tender_approval.NewTenderApprovalRepository(mongoManager, logger)
 	inquiryRepository := inquiry.NewInquiryRepository(mongoManager, logger)
 	logger.Info("Repositories initialized successfully", map[string]interface{}{
-		"repositories": []string{"customer", "user", "company", "tender", "feedback", "tender_approval"},
+		"repositories": []string{"customer", "user", "company", "category", "tender", "feedback", "tender_approval"},
 	})
 
 	// Initialize validation service
@@ -133,33 +138,35 @@ func main() {
 	// Initialize services with repositories
 	userService := user.NewUserService(userRepository, logger, userAuthService, userValidator)
 	companyService := company.NewCompanyService(companyRepository, logger)
+	categoryService := company_category.NewCategoryService(categoryRepository, logger)
 	customerService := customer.NewCustomerService(customerRepository, logger, customerAuthService, companyService)
 	tenderService := tender.NewTenderService(tenderRepository, companyService, logger)
 	feedbackService := feedback.NewFeedbackService(feedbackRepo, tenderService, logger)
 	tenderApprovalService := tender_approval.NewTenderApprovalService(tenderApprovalRepository, tenderService, logger)
 	inquiryService := inquiry.NewInquiryService(inquiryRepository, logger)
 	logger.Info("Services initialized successfully", map[string]interface{}{
-		"services": []string{"customer", "user", "company", "tender", "feedback", "tender_approval"},
+		"services": []string{"customer", "user", "company", "category", "tender", "feedback", "tender_approval"},
 	})
 
 	// Initialize handlers with services
 	userHandler := user.NewUserHandler(userService, logger, userValidator, userAuthService)
 	customerHandler := customer.NewHandler(customerService, userHandler, customerAuthService, logger)
 	companyHandler := company.NewHandler(companyService, userHandler, logger)
+	categoryHandler := company_category.NewHandler(categoryService, logger)
 	tenderHandler := tender.NewTenderHandler(tenderService, logger)
 	feedbackHandler := feedback.NewFeedbackHandler(feedbackService, userHandler, customerHandler, logger)
 	tenderApprovalHandler := tender_approval.NewHandler(tenderApprovalService, logger)
 	inquiryHandler := inquiry.NewHandler(inquiryService, logger)
 	logger.Info("Handlers initialized successfully", map[string]interface{}{
-		"handlers": []string{"customer", "user", "company", "tender", "feedback", "tender_approval"},
+		"handlers": []string{"customer", "user", "company", "category", "tender", "feedback", "tender_approval"},
 	})
 
 	// Initialize HTTP server
 	e := bootstrap.InitHTTPServer(conf, logger)
 
 	// Register routes
-	router.RegisterAdminRoutes(e, userHandler, companyHandler, customerHandler, tenderHandler, feedbackHandler, tenderApprovalHandler, inquiryHandler)
-	router.RegisterPublicRoutes(e, customerHandler, tenderHandler, feedbackHandler, tenderApprovalHandler, companyHandler, inquiryHandler)
+	router.RegisterAdminRoutes(e, userHandler, companyHandler, customerHandler, tenderHandler, feedbackHandler, tenderApprovalHandler, inquiryHandler, categoryHandler)
+	router.RegisterPublicRoutes(e, customerHandler, tenderHandler, feedbackHandler, tenderApprovalHandler, companyHandler, inquiryHandler, categoryHandler)
 
 	// Start server
 	serverAddr := fmt.Sprintf("%s:%d", conf.Server.Host, conf.Server.Port)