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.

internal/company_category/form.go

@@ -0,0 +1,52 @@
+package company_category
+
+import "tm/pkg/response"
+
+// CategoryForm represents the form for creating/updating a category
+type CategoryForm struct {
+	Name        string  `json:"name" valid:"required,length(2|100)" example:"Technology"`
+	Description *string `json:"description,omitempty" valid:"optional,length(10|500)" example:"Technology related companies"`
+	Thumbnail   *string `json:"thumbnail,omitempty" valid:"optional,url" example:"https://example.com/thumbnail.jpg"`
+}
+
+// SearchForm represents the form for searching categories with filters
+type SearchForm struct {
+	Search    *string `query:"q" valid:"optional"`
+	Published *bool   `query:"published" valid:"optional"`
+	Limit     *int    `query:"limit" valid:"optional,range(1|100)"`
+	Offset    *int    `query:"offset" valid:"optional,min(0)"`
+	SortBy    *string `query:"sort_by" valid:"optional,in(name|created_at|updated_at|published_at)"`
+	SortOrder *string `query:"sort_order" valid:"optional,in(asc|desc)"`
+}
+
+// CategoryListResponse represents the response for listing categories
+type CategoryListResponse struct {
+	Categories []*CategoryResponse `json:"categories"`
+	Meta       *response.Meta      `json:"-"`
+}
+
+// CategoryResponse represents the category data sent in API responses
+type CategoryResponse struct {
+	ID          string  `json:"id"`
+	Name        string  `json:"name"`
+	Description *string `json:"description,omitempty"`
+	Thumbnail   *string `json:"thumbnail,omitempty"`
+	Published   bool    `json:"published"`
+	PublishedAt *int64  `json:"published_at,omitempty"`
+	CreatedAt   int64   `json:"created_at"`
+	UpdatedAt   int64   `json:"updated_at"`
+}
+
+// ToResponse converts Category to CategoryResponse
+func (c *Category) ToResponse() *CategoryResponse {
+	return &CategoryResponse{
+		ID:          c.ID.Hex(),
+		Name:        c.Name,
+		Description: c.Description,
+		Thumbnail:   c.Thumbnail,
+		Published:   c.Published,
+		PublishedAt: c.PublishedAt,
+		CreatedAt:   c.CreatedAt,
+		UpdatedAt:   c.UpdatedAt,
+	}
+}