Add Inquiry Management Functionality and Update API Documentation

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

internal/inquiry/form.go

@@ -0,0 +1,85 @@
+package inquiry
+
+import "tm/pkg/response"
+
+// Inquiry DTOs
+
+// CreateInquiryForm represents the data required to create a new inquiry
+type CreateInquiryForm struct {
+	FullName    string `json:"full_name" valid:"required,length(2|100)" example:"John Doe"`       // Full name of the inquirer
+	CompanyName string `json:"company_name" valid:"required,length(2|100)" example:"Opplens"`     // Company name
+	WorkEmail   string `json:"work_email" valid:"required,email" example:"info@opplens.com"`      // Work email address
+	PhoneNumber string `json:"phone_number" valid:"required,length(10|20)" example:"+1234567890"` // Phone number
+}
+
+// UpdateInquiryStatusForm represents the data required to update inquiry status
+type UpdateInquiryStatusForm struct {
+	Status      string `json:"status" valid:"required,in(pending|reviewed|approved|rejected)" example:"reviewed"`       // New status
+	Reason      string `json:"reason" valid:"required,length(5|500)" example:"Initial review completed"`                // Reason for status change
+	Description string `json:"description" valid:"optional,length(0|1000)" example:"Additional notes about the review"` // Optional description
+}
+
+// SearchInquiriesForm represents search and filter parameters for inquiries
+type SearchInquiriesForm struct {
+	Search    *string `query:"q" valid:"optional"`                                                               // Search term for full name, company name, or email
+	Status    *string `query:"status" valid:"optional,in(pending|reviewed|approved|rejected)"`                   // Filter by status
+	Limit     *int    `query:"limit" valid:"optional,range(1|100)"`                                              // Limit results
+	Offset    *int    `query:"offset" valid:"optional,min(0)"`                                                   // Offset results
+	SortBy    *string `query:"sort_by" valid:"optional,in(full_name|company_name|work_email|status|created_at)"` // Sort field
+	SortOrder *string `query:"sort_order" valid:"optional,in(asc|desc)"`                                         // Sort order
+}
+
+// Response DTOs
+
+// StatusHistoryResponse represents status history in API responses
+type StatusHistoryResponse struct {
+	Status      string `json:"status"`
+	Reason      string `json:"reason"`
+	ChangedAt   int64  `json:"changed_at"`
+	Description string `json:"description"`
+}
+
+// InquiryResponse represents the inquiry data in API responses
+type InquiryResponse struct {
+	ID            string                  `json:"id"`
+	FullName      string                  `json:"full_name"`
+	CompanyName   string                  `json:"company_name"`
+	WorkEmail     string                  `json:"work_email"`
+	PhoneNumber   string                  `json:"phone_number"`
+	Status        string                  `json:"status"`
+	StatusHistory []StatusHistoryResponse `json:"status_history"`
+	CreatedAt     int64                   `json:"created_at"`
+	UpdatedAt     int64                   `json:"updated_at"`
+}
+
+// InquiryListResponse represents a paginated list of inquiries
+type InquiryListResponse struct {
+	Inquiries []*InquiryResponse `json:"inquiries"`
+	Meta      *response.Meta     `json:"meta"`
+}
+
+// Helper function to convert Inquiry to InquiryResponse
+func (i *Inquiry) ToResponse() *InquiryResponse {
+	// Convert status history
+	var statusHistoryResponses []StatusHistoryResponse
+	for _, history := range i.StatusHistory {
+		statusHistoryResponses = append(statusHistoryResponses, StatusHistoryResponse{
+			Status:      history.Status,
+			Reason:      history.Reason,
+			ChangedAt:   history.ChangedAt,
+			Description: history.Description,
+		})
+	}
+
+	return &InquiryResponse{
+		ID:            i.ID.Hex(),
+		FullName:      i.FullName,
+		CompanyName:   i.CompanyName,
+		WorkEmail:     i.WorkEmail,
+		PhoneNumber:   i.PhoneNumber,
+		Status:        i.Status,
+		StatusHistory: statusHistoryResponses,
+		CreatedAt:     i.CreatedAt,
+		UpdatedAt:     i.UpdatedAt,
+	}
+}