Enhance Notification Management with New Endpoints and Response Structures

- Added new endpoints for retrieving notifications for both admins and users, improving the flexibility of the notification system.
- Implemented query parameters for filtering notifications by status, method, event type, type, and recipient, enhancing usability.
- Introduced new response structures for notifications, including pagination information, to provide better data handling in API responses.
- Updated API documentation with Swagger comments for the new endpoints and response formats, ensuring clarity for API consumers.
- Refactored notification handling logic to support the new features, promoting a more robust notification management system.

pkg/notification/interfaces.go

@@ -21,6 +21,9 @@ type NotificationService interface {
 	// SendOTP sends an OTP notification
 	SendOTP(ctx context.Context, model Model) (*NotificationResponse, error)
 
+	// GetNotifications retrieves a list of notifications
+	GetNotifications(ctx context.Context, req *GetNotificationsRequest) (*NotificationListResponse, error)
+
 	// Health checks if the notification service is available
 	Health(ctx context.Context) error