Deploy files from GitHub repository

Quzuu_API_Collection.postman_collection.json

@@ -1,11 +1,11 @@
 {
   "info": {
-    "_postman_id": "e33fddc6-52e9-4005-9c5f-a144547d5bbc",
+    "_postman_id": "5114459b-535e-4021-bd3c-6145a5d8fc61",
     "name": "Quzuu API Collection",
     "description": "Complete API collection for Quzuu Platform with all endpoints organized by modules.",
     "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
     "_exporter_id": "43539486",
-    "_collection_link": "https://go.postman.co/collection/43539486-e33fddc6-52e9-4005-9c5f-a144547d5bbc?source=collection_link"
+    "_collection_link": "https://go.postman.co/collection/43539486-5114459b-535e-4021-bd3c-6145a5d8fc61?source=collection_link"
   },
   "item": [
     {
@@ -4157,6 +4157,61 @@
                     "description": "Delete academy (admin)"
                   },
                   "response": []
+                },
+                {
+                  "name": "Academy - List",
+                  "request": {
+                    "method": "GET",
+                    "header": [
+                      {
+                        "key": "Authorization",
+                        "value": "Bearer {{access_token}}",
+                        "type": "text"
+                      }
+                    ],
+                    "url": {
+                      "raw": "{{base_url}}/api/v1/admin/academy/?page=1&limit=10&search=&sortBy=created_at&orderBy=desc",
+                      "host": [
+                        "{{base_url}}"
+                      ],
+                      "path": [
+                        "api",
+                        "v1",
+                        "admin",
+                        "academy",
+                        ""
+                      ],
+                      "query": [
+                        {
+                          "key": "page",
+                          "value": "1",
+                          "description": "Page number"
+                        },
+                        {
+                          "key": "limit",
+                          "value": "10",
+                          "description": "Items per page (max 100)"
+                        },
+                        {
+                          "key": "search",
+                          "value": "",
+                          "description": "Search by title / slug / code"
+                        },
+                        {
+                          "key": "sortBy",
+                          "value": "created_at",
+                          "description": "Sort field (title, slug, code, created_at, is_public)"
+                        },
+                        {
+                          "key": "orderBy",
+                          "value": "desc",
+                          "description": "Sort direction (asc / desc)"
+                        }
+                      ]
+                    },
+                    "description": "List all academies (private and public) with pagination (admin)"
+                  },
+                  "response": []
                 }
               ]
             },

controllers/admin_academy_controller.go

@@ -12,6 +12,7 @@ import (
 )
 
 type AdminAcademyController interface {
+	ListAcademies(ctx *gin.Context)
 	CreateAcademy(ctx *gin.Context)
 	GetAcademyDetail(ctx *gin.Context)
 	UpdateAcademy(ctx *gin.Context)
@@ -46,6 +47,66 @@ func NewAdminAcademyController(service services.AdminAcademyService) AdminAcadem
 	return &adminAcademyController{service: service}
 }
 
+// ListAcademies godoc
+// @Summary      Admin: List Academies
+// @Description  List all academies (private and public)
+// @Tags         Admin Academy
+// @Accept       json
+// @Produce      json
+// @Security     BearerAuth
+// @Param        limit       query     int     false  "Items per page"  default(10)
+// @Param        page        query     int     false  "Page number"     default(1)
+// @Param        search      query     string  false  "Search by title / slug / code"
+// @Param        sortBy      query     string  false  "Sort field (title, slug, code, created_at, is_public)"
+// @Param        orderBy     query     string  false  "Sort direction (asc / desc)"
+// @Success      200         {object}  dto.SuccessResponse[[]entity.Academy]
+// @Failure      400         {object}  dto.ErrorResponse
+// @Router       /api/v1/admin/academy [get]
+func (c *adminAcademyController) ListAcademies(ctx *gin.Context) {
+	limit, _ := strconv.Atoi(ctx.DefaultQuery("limit", "10"))
+	page, _ := strconv.Atoi(ctx.DefaultQuery("page", "1"))
+	search := ctx.DefaultQuery("search", "")
+	sortBy := ctx.DefaultQuery("sortBy", "")
+	order := ctx.DefaultQuery("orderBy", "")
+	if order == "" {
+		order = ctx.DefaultQuery("order", "")
+	}
+
+	if limit < 1 {
+		limit = 10
+	} else if limit > 100 {
+		limit = 100
+	}
+	if page < 1 {
+		page = 1
+	}
+
+	offset := (page - 1) * limit
+	p := entity.Pagination{Limit: limit, Offset: offset, Search: search, SortBy: sortBy, Order: order}
+
+	list, total, err := c.service.ListAcademies(ctx.Request.Context(), p)
+	if err != nil {
+		ResponseJSON[any, any](ctx, nil, nil, err)
+		return
+	}
+
+	totalPages := int((total + int64(limit) - 1) / int64(limit))
+	if total == 0 {
+		totalPages = 1
+	}
+	if page > totalPages {
+		page = totalPages
+	}
+
+	meta := gin.H{
+		"totalItems":  total,
+		"totalPages":  totalPages,
+		"currentPage": page,
+		"limit":       limit,
+	}
+	ResponseJSON(ctx, meta, list, nil)
+}
+
 // CreateAcademy godoc
 // @Summary      Create Academy
 // @Description  Create a new academy

repositories/admin_academy_repository.go

@@ -11,6 +11,7 @@ import (
 
 type AdminAcademyRepository interface {
 	Atomic(ctx context.Context, fn func(r AdminAcademyRepository) error) error
+	ListAcademiesWithPagination(ctx context.Context, p entity.Pagination) ([]entity.Academy, int64, error)
 
 	GetAcademyByID(ctx context.Context, id uuid.UUID) (entity.Academy, error)
 	GetAcademyBySlug(ctx context.Context, slug string) (entity.Academy, error)
@@ -74,6 +75,59 @@ func (r *adminAcademyRepository) Atomic(ctx context.Context, fn func(rr AdminAca
 	})
 }
 
+func (r *adminAcademyRepository) ListAcademiesWithPagination(ctx context.Context, p entity.Pagination) ([]entity.Academy, int64, error) {
+	var list []entity.Academy
+
+	countQ := r.db.WithContext(ctx).
+		Model(&entity.Academy{}).
+		Where("deleted_at IS NULL")
+
+	if s := strings.TrimSpace(p.Search); s != "" {
+		like := "%" + s + "%"
+		countQ = countQ.Where("title ILIKE ? OR slug ILIKE ? OR code ILIKE ?", like, like, like)
+	}
+
+	var total int64
+	if err := countQ.Count(&total).Error; err != nil {
+		return nil, 0, err
+	}
+
+	q := r.db.WithContext(ctx).
+		Model(&entity.Academy{}).
+		Where("deleted_at IS NULL")
+
+	if s := strings.TrimSpace(p.Search); s != "" {
+		like := "%" + s + "%"
+		q = q.Where("title ILIKE ? OR slug ILIKE ? OR code ILIKE ?", like, like, like)
+	}
+
+	col := strings.ToLower(strings.TrimSpace(p.SortBy))
+	ord := strings.ToLower(strings.TrimSpace(p.Order))
+	if ord != "asc" {
+		ord = "desc"
+	}
+
+	switch col {
+	case "title", "slug", "code", "created_at", "is_public":
+		q = q.Order(col + " " + ord)
+	default:
+		q = q.Order("created_at " + ord)
+	}
+
+	if p.Limit > 0 {
+		q = q.Limit(p.Limit)
+	}
+	if p.Offset > 0 {
+		q = q.Offset(p.Offset)
+	}
+
+	if err := q.Find(&list).Error; err != nil {
+		return nil, 0, err
+	}
+
+	return list, total, nil
+}
+
 func (r *adminAcademyRepository) GetAcademyByID(ctx context.Context, id uuid.UUID) (entity.Academy, error) {
 	return r.academyRepo.GetAcademyByID(ctx, id)
 }

router/admin_academy_router.go

@@ -12,6 +12,7 @@ func AdminAcademyRouter(router *gin.Engine, middleware provider.MiddlewareProvid
 
 	adminAcademyGroup := router.Group("/api/v1/admin/academy", authenticationMiddleware.VerifyAccount, authorizationMiddleware.VerifyAdmin)
 	{
+		adminAcademyGroup.GET("/", adminAcademyController.ListAcademies)
 		adminAcademyGroup.POST("/", adminAcademyController.CreateAcademy)
 		adminAcademyGroup.GET("/id/:academy_id/detail", adminAcademyController.GetAcademyDetail)
 		adminAcademyGroup.PUT("/id/:academy_id", adminAcademyController.UpdateAcademy)

services/admin_academy_service.go

@@ -15,6 +15,7 @@ import (
 )
 
 type AdminAcademyService interface {
+	ListAcademies(ctx context.Context, p entity.Pagination) ([]entity.Academy, int64, error)
 	CreateAcademy(ctx context.Context, req dto.CreateAcademyRequest) (entity.Academy, error)
 	GetAcademyDetail(ctx context.Context, id uuid.UUID) (entity.Academy, error)
 	UpdateAcademy(ctx context.Context, id uuid.UUID, req dto.UpdateAcademyRequest) (entity.Academy, error)
@@ -49,6 +50,10 @@ func NewAdminAcademyService(repo repositories.AdminAcademyRepository) AdminAcade
 	return &adminAcademyService{repo: repo}
 }
 
+func (s *adminAcademyService) ListAcademies(ctx context.Context, p entity.Pagination) ([]entity.Academy, int64, error) {
+	return s.repo.ListAcademiesWithPagination(ctx, p)
+}
+
 func (s *adminAcademyService) CreateAcademy(ctx context.Context, req dto.CreateAcademyRequest) (entity.Academy, error) {
 	if strings.TrimSpace(req.Title) == "" {
 		return entity.Academy{}, http_error.TITLE_REQUIRED

swagger/docs/docs.go

@@ -369,6 +369,72 @@ const docTemplate = `{
             }
         },
         "/api/v1/admin/academy": {
+            "get": {
+                "security": [
+                    {
+                        "BearerAuth": []
+                    }
+                ],
+                "description": "List all academies (private and public)",
+                "consumes": [
+                    "application/json"
+                ],
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Admin Academy"
+                ],
+                "summary": "Admin: List Academies",
+                "parameters": [
+                    {
+                        "type": "integer",
+                        "default": 10,
+                        "description": "Items per page",
+                        "name": "limit",
+                        "in": "query"
+                    },
+                    {
+                        "type": "integer",
+                        "default": 1,
+                        "description": "Page number",
+                        "name": "page",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "Search by title / slug / code",
+                        "name": "search",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "Sort field (title, slug, code, created_at, is_public)",
+                        "name": "sortBy",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "Sort direction (asc / desc)",
+                        "name": "orderBy",
+                        "in": "query"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/dto.SuccessResponse-array_models_Academy"
+                        }
+                    },
+                    "400": {
+                        "description": "Bad Request",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    }
+                }
+            },
             "post": {
                 "security": [
                     {
@@ -7006,6 +7072,22 @@ const docTemplate = `{
                 }
             }
         },
+        "dto.SuccessResponse-array_models_Academy": {
+            "type": "object",
+            "properties": {
+                "data": {
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/definitions/models.Academy"
+                    }
+                },
+                "message": {},
+                "meta_data": {},
+                "status": {
+                    "type": "string"
+                }
+            }
+        },
         "dto.SuccessResponse-array_models_AcademyAssign": {
             "type": "object",
             "properties": {

swagger/docs/swagger.json

@@ -366,6 +366,72 @@
             }
         },
         "/api/v1/admin/academy": {
+            "get": {
+                "security": [
+                    {
+                        "BearerAuth": []
+                    }
+                ],
+                "description": "List all academies (private and public)",
+                "consumes": [
+                    "application/json"
+                ],
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Admin Academy"
+                ],
+                "summary": "Admin: List Academies",
+                "parameters": [
+                    {
+                        "type": "integer",
+                        "default": 10,
+                        "description": "Items per page",
+                        "name": "limit",
+                        "in": "query"
+                    },
+                    {
+                        "type": "integer",
+                        "default": 1,
+                        "description": "Page number",
+                        "name": "page",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "Search by title / slug / code",
+                        "name": "search",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "Sort field (title, slug, code, created_at, is_public)",
+                        "name": "sortBy",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "Sort direction (asc / desc)",
+                        "name": "orderBy",
+                        "in": "query"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/dto.SuccessResponse-array_models_Academy"
+                        }
+                    },
+                    "400": {
+                        "description": "Bad Request",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    }
+                }
+            },
             "post": {
                 "security": [
                     {
@@ -7003,6 +7069,22 @@
                 }
             }
         },
+        "dto.SuccessResponse-array_models_Academy": {
+            "type": "object",
+            "properties": {
+                "data": {
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/definitions/models.Academy"
+                    }
+                },
+                "message": {},
+                "meta_data": {},
+                "status": {
+                    "type": "string"
+                }
+            }
+        },
         "dto.SuccessResponse-array_models_AcademyAssign": {
             "type": "object",
             "properties": {

swagger/docs/swagger.yaml

@@ -657,6 +657,17 @@ definitions:
       status:
         type: string
     type: object
+  dto.SuccessResponse-array_models_Academy:
+    properties:
+      data:
+        items:
+          $ref: '#/definitions/models.Academy'
+        type: array
+      message: {}
+      meta_data: {}
+      status:
+        type: string
+    type: object
   dto.SuccessResponse-array_models_AcademyAssign:
     properties:
       data:
@@ -2007,6 +2018,49 @@ paths:
       tags:
       - Account Detail
   /api/v1/admin/academy:
+    get:
+      consumes:
+      - application/json
+      description: List all academies (private and public)
+      parameters:
+      - default: 10
+        description: Items per page
+        in: query
+        name: limit
+        type: integer
+      - default: 1
+        description: Page number
+        in: query
+        name: page
+        type: integer
+      - description: Search by title / slug / code
+        in: query
+        name: search
+        type: string
+      - description: Sort field (title, slug, code, created_at, is_public)
+        in: query
+        name: sortBy
+        type: string
+      - description: Sort direction (asc / desc)
+        in: query
+        name: orderBy
+        type: string
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            $ref: '#/definitions/dto.SuccessResponse-array_models_Academy'
+        "400":
+          description: Bad Request
+          schema:
+            $ref: '#/definitions/dto.ErrorResponse'
+      security:
+      - BearerAuth: []
+      summary: 'Admin: List Academies'
+      tags:
+      - Admin Academy
     post:
       consumes:
       - application/json