Deploy files from GitHub repository

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "postman.settings.dotenv-detection-notification-visibility": false
+}

Quzuu_API_Collection.postman_collection.json

@@ -0,0 +1,2078 @@
+{
+  "info": {
+    "_postman_id": "quzuu-api-collection-2024",
+    "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"
+  },
+  "item": [
+    {
+      "name": "Health Check",
+      "item": [
+        {
+          "name": "Health Check",
+          "request": {
+            "method": "GET",
+            "header": [],
+            "url": {
+              "raw": "{{base_url}}/health-check",
+              "host": ["{{base_url}}"],
+              "path": ["health-check"]
+            },
+            "description": "Check if the service is up and running"
+          },
+          "response": []
+        },
+        {
+          "name": "Welcome",
+          "request": {
+            "method": "GET",
+            "header": [],
+            "url": {
+              "raw": "{{base_url}}/",
+              "host": ["{{base_url}}"],
+              "path": [""]
+            },
+            "description": "Welcome endpoint"
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "Authentication",
+      "item": [
+        {
+          "name": "External Login",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"provider\": \"google\",\n  \"token\": \"external_token_here\"\n}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/authentication/external-login",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "authentication", "external-login"]
+            },
+            "description": "Login using external provider (Google, etc)"
+          },
+          "response": []
+        },
+        {
+          "name": "Login",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"email\": \"user@example.com\",\n  \"password\": \"password123\"\n}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/authentication/login",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "authentication", "login"]
+            },
+            "description": "Sign in with email and password"
+          },
+          "response": []
+        },
+        {
+          "name": "Register",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"email\": \"newuser@example.com\",\n  \"password\": \"password123\",\n  \"full_name\": \"New User\"\n}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/authentication/register",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "authentication", "register"]
+            },
+            "description": "Register a new user account"
+          },
+          "response": []
+        },
+        {
+          "name": "Change Password",
+          "request": {
+            "method": "PUT",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              },
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"old_password\": \"old_password123\",\n  \"new_password\": \"new_password123\"\n}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/authentication/change-password",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "authentication", "change-password"]
+            },
+            "description": "Change user password (requires authentication)"
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "Forgot Password",
+      "item": [
+        {
+          "name": "Request Password Reset",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"email\": \"user@example.com\"\n}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/authentication/forgot-password/",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "authentication", "forgot-password", ""]
+            },
+            "description": "Request password reset for an account"
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "Account Details",
+      "item": [
+        {
+          "name": "Get Profile",
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "url": {
+              "raw": "{{base_url}}/api/v1/account/me",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "account", "me"]
+            },
+            "description": "Get authenticated user's profile details"
+          },
+          "response": []
+        },
+        {
+          "name": "Update Profile",
+          "request": {
+            "method": "PUT",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              },
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"full_name\": \"Updated Name\",\n  \"phone\": \"08123456789\",\n  \"address\": \"Jl. Contoh No. 1\"\n}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/account/me",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "account", "me"]
+            },
+            "description": "Update authenticated user's profile details"
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "Email Verification",
+      "item": [
+        {
+          "name": "Create Verification",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"email\": \"user@example.com\"\n}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/email/create-verification",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "email", "create-verification"]
+            },
+            "description": "Create email verification request"
+          },
+          "response": []
+        },
+        {
+          "name": "Verify Email",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"email\": \"user@example.com\",\n  \"code\": \"123456\"\n}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/email/verify",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "email", "verify"]
+            },
+            "description": "Verify email with verification code"
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "Events",
+      "item": [
+        {
+          "name": "List Events",
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "url": {
+              "raw": "{{base_url}}/api/v1/events/",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "events", ""]
+            },
+            "description": "List all events"
+          },
+          "response": []
+        },
+        {
+          "name": "Get Event Detail",
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "url": {
+              "raw": "{{base_url}}/api/v1/events/:event_slug",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "events", ":event_slug"],
+              "variable": [
+                {
+                  "key": "event_slug",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Get event detail by slug"
+          },
+          "response": []
+        },
+        {
+          "name": "Register to Event",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              },
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"code\": \"event_code\"\n}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/events/register-event",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "events", "register-event"]
+            },
+            "description": "Register user to an event"
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "Event Exams",
+      "item": [
+        {
+          "name": "List Event Exams",
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "url": {
+              "raw": "{{base_url}}/api/v1/events/:event_slug/exam",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "events", ":event_slug", "exam"],
+              "variable": [
+                {
+                  "key": "event_slug",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "List exams in an event"
+          },
+          "response": []
+        },
+        {
+          "name": "Start Exam Attempt",
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "url": {
+              "raw": "{{base_url}}/api/v1/events/:event_slug/exam/:exam_slug/attempt",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "events", ":event_slug", "exam", ":exam_slug", "attempt"],
+              "variable": [
+                {
+                  "key": "event_slug",
+                  "value": ""
+                },
+                {
+                  "key": "exam_slug",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Start exam attempt"
+          },
+          "response": []
+        },
+        {
+          "name": "Answer Question",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              },
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"question_id\": \"question_id\",\n  \"answer\": \"answer_text_or_option_id\"\n}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/events/:event_slug/exam/:attempt_id/answer_question",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "events", ":event_slug", "exam", ":attempt_id", "answer_question"],
+              "variable": [
+                {
+                  "key": "event_slug",
+                  "value": ""
+                },
+                {
+                  "key": "attempt_id",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Submit answer to a question during exam"
+          },
+          "response": []
+        },
+        {
+          "name": "Submit Exam",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              },
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/events/:event_slug/exam/:attempt_id/submit",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "events", ":event_slug", "exam", ":attempt_id", "submit"],
+              "variable": [
+                {
+                  "key": "event_slug",
+                  "value": ""
+                },
+                {
+                  "key": "attempt_id",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Submit completed exam"
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "Event Exam Proctoring",
+      "item": [
+        {
+          "name": "Create Proctoring Log",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              },
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"event_slug\": \"event_slug\",\n  \"exam_slug\": \"exam_slug\",\n  \"log_data\": \"proctoring_event_data\"\n}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/proctoring/:event_slug/exam/:exam_slug/proctoring",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "proctoring", ":event_slug", "exam", ":exam_slug", "proctoring"],
+              "variable": [
+                {
+                  "key": "event_slug",
+                  "value": ""
+                },
+                {
+                  "key": "exam_slug",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Create proctoring log entry during exam"
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "Academy",
+      "item": [
+        {
+          "name": "List Academies",
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "url": {
+              "raw": "{{base_url}}/api/v1/academy/",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "academy", ""]
+            },
+            "description": "List all academies available to user"
+          },
+          "response": []
+        },
+        {
+          "name": "Join Academy",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              },
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"code\": \"academy_code\"\n}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/academy/join",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "academy", "join"]
+            },
+            "description": "Join academy using academy code"
+          },
+          "response": []
+        },
+        {
+          "name": "Get Academy Detail",
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "url": {
+              "raw": "{{base_url}}/api/v1/academy/:academy_slug",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "academy", ":academy_slug"],
+              "variable": [
+                {
+                  "key": "academy_slug",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Get academy detail by slug"
+          },
+          "response": []
+        },
+        {
+          "name": "Get Academy Material",
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "url": {
+              "raw": "{{base_url}}/api/v1/academy/:academy_slug/:material_slug",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "academy", ":academy_slug", ":material_slug"],
+              "variable": [
+                {
+                  "key": "academy_slug",
+                  "value": ""
+                },
+                {
+                  "key": "material_slug",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Get material details in an academy"
+          },
+          "response": []
+        },
+        {
+          "name": "Get Academy Content",
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "url": {
+              "raw": "{{base_url}}/api/v1/academy/:academy_slug/:material_slug/:order",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "academy", ":academy_slug", ":material_slug", ":order"],
+              "variable": [
+                {
+                  "key": "academy_slug",
+                  "value": ""
+                },
+                {
+                  "key": "material_slug",
+                  "value": ""
+                },
+                {
+                  "key": "order",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Get specific content in academy material"
+          },
+          "response": []
+        },
+        {
+          "name": "Update Content Progress",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              },
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"progress\": 100\n}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/academy/:academy_slug/:material_slug/:order",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "academy", ":academy_slug", ":material_slug", ":order"],
+              "variable": [
+                {
+                  "key": "academy_slug",
+                  "value": ""
+                },
+                {
+                  "key": "material_slug",
+                  "value": ""
+                },
+                {
+                  "key": "order",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Update progress on academy content"
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "Academy Exams",
+      "item": [
+        {
+          "name": "List Academy Exams",
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "url": {
+              "raw": "{{base_url}}/api/v1/academy/:academy_slug/exam",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "academy", ":academy_slug", "exam"],
+              "variable": [
+                {
+                  "key": "academy_slug",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "List exams in an academy"
+          },
+          "response": []
+        },
+        {
+          "name": "Start Exam Attempt",
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "url": {
+              "raw": "{{base_url}}/api/v1/academy/:academy_slug/exam/:exam_slug/attempt",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "academy", ":academy_slug", "exam", ":exam_slug", "attempt"],
+              "variable": [
+                {
+                  "key": "academy_slug",
+                  "value": ""
+                },
+                {
+                  "key": "exam_slug",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Start exam attempt in academy"
+          },
+          "response": []
+        },
+        {
+          "name": "Answer Question",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              },
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"question_id\": \"question_id\",\n  \"answer\": \"answer_text_or_option_id\"\n}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/academy/:academy_slug/exam/:attempt_id/answer_question",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "academy", ":academy_slug", "exam", ":attempt_id", "answer_question"],
+              "variable": [
+                {
+                  "key": "academy_slug",
+                  "value": ""
+                },
+                {
+                  "key": "attempt_id",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Submit answer during academy exam"
+          },
+          "response": []
+        },
+        {
+          "name": "Submit Exam",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              },
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/academy/:academy_slug/exam/:attempt_id/submit",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "academy", ":academy_slug", "exam", ":attempt_id", "submit"],
+              "variable": [
+                {
+                  "key": "academy_slug",
+                  "value": ""
+                },
+                {
+                  "key": "attempt_id",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Submit completed academy exam"
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "File Upload",
+      "item": [
+        {
+          "name": "Upload File",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "formdata",
+              "formdata": [
+                {
+                  "key": "file",
+                  "type": "file",
+                  "src": ""
+                }
+              ]
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/files/",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "files", ""]
+            },
+            "description": "Upload a file"
+          },
+          "response": []
+        },
+        {
+          "name": "Get File",
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "url": {
+              "raw": "{{base_url}}/api/v1/files/:id",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "files", ":id"],
+              "variable": [
+                {
+                  "key": "id",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Get file by ID"
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "Options & Regions",
+      "item": [
+        {
+          "name": "Create Options (Bulk)",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"slug\": \"option_slug\",\n  \"options\": [\n    {\n      \"name\": \"Option 1\",\n      \"value\": \"value_1\"\n    },\n    {\n      \"name\": \"Option 2\",\n      \"value\": \"value_2\"\n    }\n  ]\n}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/options/create",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "options", "create"]
+            },
+            "description": "Create options in bulk by slug"
+          },
+          "response": []
+        },
+        {
+          "name": "Get Options by Slug",
+          "request": {
+            "method": "GET",
+            "header": [],
+            "url": {
+              "raw": "{{base_url}}/api/v1/options/list/:slug",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "options", "list", ":slug"],
+              "variable": [
+                {
+                  "key": "slug",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Get options list by slug"
+          },
+          "response": []
+        },
+        {
+          "name": "List Provinces",
+          "request": {
+            "method": "GET",
+            "header": [],
+            "url": {
+              "raw": "{{base_url}}/api/v1/options/region/provinces",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "options", "region", "provinces"]
+            },
+            "description": "List all provinces"
+          },
+          "response": []
+        },
+        {
+          "name": "List Cities by Province",
+          "request": {
+            "method": "GET",
+            "header": [],
+            "url": {
+              "raw": "{{base_url}}/api/v1/options/region/cities?province_id={{province_id}}",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "options", "region", "cities"],
+              "query": [
+                {
+                  "key": "province_id",
+                  "value": "{{province_id}}"
+                }
+              ]
+            },
+            "description": "List cities by province ID"
+          },
+          "response": []
+        },
+        {
+          "name": "Seed Provinces",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/options/region/seed-provinces",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "options", "region", "seed-provinces"]
+            },
+            "description": "Seed provinces data (admin only)"
+          },
+          "response": []
+        },
+        {
+          "name": "Seed Cities",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/options/region/seed-cities",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "options", "region", "seed-cities"]
+            },
+            "description": "Seed cities data (admin only)"
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "Admin",
+      "item": [
+        {
+          "name": "Events Management",
+          "item": [
+            {
+              "name": "Create Event",
+              "request": {
+                "method": "POST",
+                "header": [
+                  {
+                    "key": "Content-Type",
+                    "value": "application/json",
+                    "type": "text"
+                  },
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"name\": \"Event Name\",\n  \"slug\": \"event-slug\",\n  \"description\": \"Event description\",\n  \"start_date\": \"2024-03-15\",\n  \"end_date\": \"2024-03-20\"\n}"
+                },
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/events/",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "events", ""]
+                },
+                "description": "Create new event (admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "Update Event",
+              "request": {
+                "method": "PUT",
+                "header": [
+                  {
+                    "key": "Content-Type",
+                    "value": "application/json",
+                    "type": "text"
+                  },
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"name\": \"Updated Event Name\",\n  \"description\": \"Updated description\"\n}"
+                },
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/events/:id",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "events", ":id"],
+                  "variable": [
+                    {
+                      "key": "id",
+                      "value": ""
+                    }
+                  ]
+                },
+                "description": "Update event (admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "Delete Event",
+              "request": {
+                "method": "DELETE",
+                "header": [
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/events/:id",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "events", ":id"],
+                  "variable": [
+                    {
+                      "key": "id",
+                      "value": ""
+                    }
+                  ]
+                },
+                "description": "Delete event (admin)"
+              },
+              "response": []
+            }
+          ]
+        },
+        {
+          "name": "Academy Management",
+          "item": [
+            {
+              "name": "Create Academy",
+              "request": {
+                "method": "POST",
+                "header": [
+                  {
+                    "key": "Content-Type",
+                    "value": "application/json",
+                    "type": "text"
+                  },
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"name\": \"Academy Name\",\n  \"slug\": \"academy-slug\",\n  \"description\": \"Academy description\"\n}"
+                },
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/academy/",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "academy", ""]
+                },
+                "description": "Create new academy (admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "Get Academy Detail",
+              "request": {
+                "method": "GET",
+                "header": [
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/academy/id/:id/detail",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "academy", "id", ":id", "detail"],
+                  "variable": [
+                    {
+                      "key": "id",
+                      "value": ""
+                    }
+                  ]
+                },
+                "description": "Get academy detail by ID (admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "Update Academy",
+              "request": {
+                "method": "PUT",
+                "header": [
+                  {
+                    "key": "Content-Type",
+                    "value": "application/json",
+                    "type": "text"
+                  },
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"name\": \"Updated Academy Name\",\n  \"description\": \"Updated description\"\n}"
+                },
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/academy/id/:id",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "academy", "id", ":id"],
+                  "variable": [
+                    {
+                      "key": "id",
+                      "value": ""
+                    }
+                  ]
+                },
+                "description": "Update academy (admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "Delete Academy",
+              "request": {
+                "method": "DELETE",
+                "header": [
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/academy/id/:id",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "academy", "id", ":id"],
+                  "variable": [
+                    {
+                      "key": "id",
+                      "value": ""
+                    }
+                  ]
+                },
+                "description": "Delete academy (admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "Create Material",
+              "request": {
+                "method": "POST",
+                "header": [
+                  {
+                    "key": "Content-Type",
+                    "value": "application/json",
+                    "type": "text"
+                  },
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"academy_id\": \"academy_id\",\n  \"name\": \"Material Name\",\n  \"slug\": \"material-slug\",\n  \"description\": \"Material description\"\n}"
+                },
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/academy/materials",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "academy", "materials"]
+                },
+                "description": "Create academy material (admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "Delete Material",
+              "request": {
+                "method": "DELETE",
+                "header": [
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/academy/materials/:id",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "academy", "materials", ":id"],
+                  "variable": [
+                    {
+                      "key": "id",
+                      "value": ""
+                    }
+                  ]
+                },
+                "description": "Delete academy material (admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "Create Content",
+              "request": {
+                "method": "POST",
+                "header": [
+                  {
+                    "key": "Content-Type",
+                    "value": "application/json",
+                    "type": "text"
+                  },
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"material_id\": \"material_id\",\n  \"title\": \"Content Title\",\n  \"content\": \"Content data\",\n  \"order\": 1\n}"
+                },
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/academy/contents",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "academy", "contents"]
+                },
+                "description": "Create academy content (admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "Delete Content",
+              "request": {
+                "method": "DELETE",
+                "header": [
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/academy/contents/:id",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "academy", "contents", ":id"],
+                  "variable": [
+                    {
+                      "key": "id",
+                      "value": ""
+                    }
+                  ]
+                },
+                "description": "Delete academy content (admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "Assign Account to Academy",
+              "request": {
+                "method": "POST",
+                "header": [
+                  {
+                    "key": "Content-Type",
+                    "value": "application/json",
+                    "type": "text"
+                  },
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"account_id\": \"account_id\",\n  \"academy_id\": \"academy_id\"\n}"
+                },
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/academy/assign",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "academy", "assign"]
+                },
+                "description": "Assign user account to academy (admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "Unassign Account from Academy",
+              "request": {
+                "method": "DELETE",
+                "header": [
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/academy/assign/:id",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "academy", "assign", ":id"],
+                  "variable": [
+                    {
+                      "key": "id",
+                      "value": ""
+                    }
+                  ]
+                },
+                "description": "Unassign user account from academy (admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "List Academy Assignments",
+              "request": {
+                "method": "GET",
+                "header": [
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/academy/assign/:academy_id",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "academy", "assign", ":academy_id"],
+                  "variable": [
+                    {
+                      "key": "academy_id",
+                      "value": ""
+                    }
+                  ]
+                },
+                "description": "List academy assignments by academy ID (admin)"
+              },
+              "response": []
+            }
+          ]
+        },
+        {
+          "name": "Proctoring Management",
+          "item": [
+            {
+              "name": "List Proctoring Logs",
+              "request": {
+                "method": "GET",
+                "header": [
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/proctoring/events/:event_slug/exam/:exam_slug/proctoring",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "proctoring", "events", ":event_slug", "exam", ":exam_slug", "proctoring"],
+                  "variable": [
+                    {
+                      "key": "event_slug",
+                      "value": ""
+                    },
+                    {
+                      "key": "exam_slug",
+                      "value": ""
+                    }
+                  ]
+                },
+                "description": "List proctoring logs for an exam (admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "Get Proctoring Log Detail",
+              "request": {
+                "method": "GET",
+                "header": [
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/proctoring/events/:event_slug/exam/:exam_slug/proctoring/:log_id",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "proctoring", "events", ":event_slug", "exam", ":exam_slug", "proctoring", ":log_id"],
+                  "variable": [
+                    {
+                      "key": "event_slug",
+                      "value": ""
+                    },
+                    {
+                      "key": "exam_slug",
+                      "value": ""
+                    },
+                    {
+                      "key": "log_id",
+                      "value": ""
+                    }
+                  ]
+                },
+                "description": "Get proctoring log detail (admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "Update Proctoring Log",
+              "request": {
+                "method": "PUT",
+                "header": [
+                  {
+                    "key": "Content-Type",
+                    "value": "application/json",
+                    "type": "text"
+                  },
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"status\": \"reviewed\",\n  \"notes\": \"Proctoring notes\"\n}"
+                },
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/proctoring/events/:event_slug/exam/:exam_slug/proctoring/:log_id",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "proctoring", "events", ":event_slug", "exam", ":exam_slug", "proctoring", ":log_id"],
+                  "variable": [
+                    {
+                      "key": "event_slug",
+                      "value": ""
+                    },
+                    {
+                      "key": "exam_slug",
+                      "value": ""
+                    },
+                    {
+                      "key": "log_id",
+                      "value": ""
+                    }
+                  ]
+                },
+                "description": "Update proctoring log (admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "Delete Proctoring Log",
+              "request": {
+                "method": "DELETE",
+                "header": [
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/proctoring/events/:event_slug/exam/:exam_slug/proctoring/:log_id",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "proctoring", "events", ":event_slug", "exam", ":exam_slug", "proctoring", ":log_id"],
+                  "variable": [
+                    {
+                      "key": "event_slug",
+                      "value": ""
+                    },
+                    {
+                      "key": "exam_slug",
+                      "value": ""
+                    },
+                    {
+                      "key": "log_id",
+                      "value": ""
+                    }
+                  ]
+                },
+                "description": "Delete proctoring log (admin)"
+              },
+              "response": []
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Exam Management",
+      "item": [
+        {
+          "name": "Create Exam",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              },
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"title\": \"Exam Title\",\n  \"slug\": \"exam-slug\",\n  \"description\": \"Exam description\",\n  \"duration_minutes\": 120\n}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/admin/exam",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "admin", "exam"]
+            },
+            "description": "Create new exam (admin)"
+          },
+          "response": []
+        },
+        {
+          "name": "List Exams",
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "url": {
+              "raw": "{{base_url}}/api/v1/admin/exam",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "admin", "exam"]
+            },
+            "description": "List all exams (admin)"
+          },
+          "response": []
+        },
+        {
+          "name": "Update Exam",
+          "request": {
+            "method": "PUT",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              },
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"title\": \"Updated Exam Title\",\n  \"description\": \"Updated description\"\n}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/admin/exam/:id",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "admin", "exam", ":id"],
+              "variable": [
+                {
+                  "key": "id",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Update exam (admin)"
+          },
+          "response": []
+        },
+        {
+          "name": "Delete Exam",
+          "request": {
+            "method": "DELETE",
+            "header": [
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "url": {
+              "raw": "{{base_url}}/api/v1/admin/exam/:id",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "admin", "exam", ":id"],
+              "variable": [
+                {
+                  "key": "id",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Delete exam (admin)"
+          },
+          "response": []
+        },
+        {
+          "name": "Get Exam Detail",
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "url": {
+              "raw": "{{base_url}}/api/v1/admin/exam/:id",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "admin", "exam", ":id"],
+              "variable": [
+                {
+                  "key": "id",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Get exam detail (admin)"
+          },
+          "response": []
+        },
+        {
+          "name": "Assign Exam to Event",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              },
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/admin/exam/:exam_id/event/:event_id",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "admin", "exam", ":exam_id", "event", ":event_id"],
+              "variable": [
+                {
+                  "key": "exam_id",
+                  "value": ""
+                },
+                {
+                  "key": "event_id",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Assign exam to event (admin)"
+          },
+          "response": []
+        },
+        {
+          "name": "Assign Exam to Academy",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              },
+              {
+                "key": "Authorization",
+                "value": "Bearer {{access_token}}",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/admin/exam/:exam_id/academy/:academy_id",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "admin", "exam", ":exam_id", "academy", ":academy_id"],
+              "variable": [
+                {
+                  "key": "exam_id",
+                  "value": ""
+                },
+                {
+                  "key": "academy_id",
+                  "value": ""
+                }
+              ]
+            },
+            "description": "Assign exam to academy (admin)"
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "Super Admin",
+      "item": [
+        {
+          "name": "Users Management",
+          "item": [
+            {
+              "name": "List Users",
+              "request": {
+                "method": "GET",
+                "header": [
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "url": {
+                  "raw": "{{base_url}}/api/v1/super-admin/users/",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "super-admin", "users", ""]
+                },
+                "description": "List all users (super admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "Create User",
+              "request": {
+                "method": "POST",
+                "header": [
+                  {
+                    "key": "Content-Type",
+                    "value": "application/json",
+                    "type": "text"
+                  },
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"email\": \"newuser@example.com\",\n  \"password\": \"password123\",\n  \"full_name\": \"New User\",\n  \"role\": \"user\"\n}"
+                },
+                "url": {
+                  "raw": "{{base_url}}/api/v1/super-admin/users/",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "super-admin", "users", ""]
+                },
+                "description": "Create user (super admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "Bulk Create Users",
+              "request": {
+                "method": "POST",
+                "header": [
+                  {
+                    "key": "Content-Type",
+                    "value": "application/json",
+                    "type": "text"
+                  },
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"users\": [\n    {\n      \"email\": \"user1@example.com\",\n      \"password\": \"password123\",\n      \"full_name\": \"User One\",\n      \"role\": \"user\"\n    },\n    {\n      \"email\": \"user2@example.com\",\n      \"password\": \"password123\",\n      \"full_name\": \"User Two\",\n      \"role\": \"user\"\n    }\n  ]\n}"
+                },
+                "url": {
+                  "raw": "{{base_url}}/api/v1/super-admin/users/bulk",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "super-admin", "users", "bulk"]
+                },
+                "description": "Create multiple users at once (super admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "Update User",
+              "request": {
+                "method": "PUT",
+                "header": [
+                  {
+                    "key": "Content-Type",
+                    "value": "application/json",
+                    "type": "text"
+                  },
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"full_name\": \"Updated Name\",\n  \"email\": \"newemail@example.com\"\n}"
+                },
+                "url": {
+                  "raw": "{{base_url}}/api/v1/super-admin/users/:id",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "super-admin", "users", ":id"],
+                  "variable": [
+                    {
+                      "key": "id",
+                      "value": ""
+                    }
+                  ]
+                },
+                "description": "Update user (super admin)"
+              },
+              "response": []
+            },
+            {
+              "name": "Delete User",
+              "request": {
+                "method": "DELETE",
+                "header": [
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "url": {
+                  "raw": "{{base_url}}/api/v1/super-admin/users/:id",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "super-admin", "users", ":id"],
+                  "variable": [
+                    {
+                      "key": "id",
+                      "value": ""
+                    }
+                  ]
+                },
+                "description": "Delete user (super admin)"
+              },
+              "response": []
+            }
+          ]
+        },
+        {
+          "name": "Authentication Management",
+          "item": [
+            {
+              "name": "Update User Role",
+              "request": {
+                "method": "PUT",
+                "header": [
+                  {
+                    "key": "Content-Type",
+                    "value": "application/json",
+                    "type": "text"
+                  },
+                  {
+                    "key": "Authorization",
+                    "value": "Bearer {{access_token}}",
+                    "type": "text"
+                  }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"role\": \"admin\"\n}"
+                },
+                "url": {
+                  "raw": "{{base_url}}/api/v1/admin/authentication/:account_id/assign",
+                  "host": ["{{base_url}}"],
+                  "path": ["api", "v1", "admin", "authentication", ":account_id", "assign"],
+                  "variable": [
+                    {
+                      "key": "account_id",
+                      "value": ""
+                    }
+                  ]
+                },
+                "description": "Update user role (super admin)"
+              },
+              "response": []
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Payment",
+      "item": [
+        {
+          "name": "Payment Callback",
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json",
+                "type": "text"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"transaction_id\": \"txn_id\",\n  \"status\": \"success\",\n  \"amount\": 100000,\n  \"timestamp\": \"2024-03-15T10:30:00Z\"\n}"
+            },
+            "url": {
+              "raw": "{{base_url}}/api/v1/payment/callback",
+              "host": ["{{base_url}}"],
+              "path": ["api", "v1", "payment", "callback"]
+            },
+            "description": "Handle payment callback from payment gateway"
+          },
+          "response": []
+        }
+      ]
+    }
+  ],
+  "variable": [
+    {
+      "key": "base_url",
+      "value": "http://localhost:8080",
+      "type": "string"
+    },
+    {
+      "key": "access_token",
+      "value": "your_jwt_token_here",
+      "type": "string"
+    },
+    {
+      "key": "province_id",
+      "value": "",
+      "type": "string"
+    }
+  ]
+}

Quzuu_Dev_Environment.postman_environment.json

@@ -0,0 +1,98 @@
+{
+  "name": "Quzuu Development",
+  "values": [
+    {
+      "key": "base_url",
+      "value": "http://localhost:8080",
+      "enabled": true,
+      "type": "default"
+    },
+    {
+      "key": "access_token",
+      "value": "",
+      "enabled": true,
+      "type": "secret"
+    },
+    {
+      "key": "province_id",
+      "value": "",
+      "enabled": true,
+      "type": "default"
+    },
+    {
+      "key": "account_id",
+      "value": "",
+      "enabled": true,
+      "type": "default"
+    },
+    {
+      "key": "event_id",
+      "value": "",
+      "enabled": true,
+      "type": "default"
+    },
+    {
+      "key": "event_slug",
+      "value": "",
+      "enabled": true,
+      "type": "default"
+    },
+    {
+      "key": "academy_id",
+      "value": "",
+      "enabled": true,
+      "type": "default"
+    },
+    {
+      "key": "academy_slug",
+      "value": "",
+      "enabled": true,
+      "type": "default"
+    },
+    {
+      "key": "exam_id",
+      "value": "",
+      "enabled": true,
+      "type": "default"
+    },
+    {
+      "key": "exam_slug",
+      "value": "",
+      "enabled": true,
+      "type": "default"
+    },
+    {
+      "key": "attempt_id",
+      "value": "",
+      "enabled": true,
+      "type": "default"
+    },
+    {
+      "key": "material_slug",
+      "value": "",
+      "enabled": true,
+      "type": "default"
+    },
+    {
+      "key": "order",
+      "value": "",
+      "enabled": true,
+      "type": "default"
+    },
+    {
+      "key": "log_id",
+      "value": "",
+      "enabled": true,
+      "type": "default"
+    },
+    {
+      "key": "file_id",
+      "value": "",
+      "enabled": true,
+      "type": "default"
+    }
+  ],
+  "_postman_variable_scope": "environment",
+  "_postman_exported_at": "2024-03-10T00:00:00.000Z",
+  "_postman_exported_using": "Postman/v11.0.0"
+}

controllers/user_controller.go

@@ -1,7 +1,10 @@
 package controllers
 
 import (
+	"strconv"
+
 	"abdanhafidz.com/go-boilerplate/models/dto"
+	entity "abdanhafidz.com/go-boilerplate/models/entity"
 	http_error "abdanhafidz.com/go-boilerplate/models/error"
 	"abdanhafidz.com/go-boilerplate/services"
 	"github.com/gin-gonic/gin"
@@ -26,17 +29,52 @@ func NewUserController(accountService services.AccountService) UserController {
 
 // ListUsers godoc
 // @Summary      List All Users
-// @Description  Retrieve a list of all users in the system
+// @Description  Retrieve a paginated list of users with optional role filter
 // @Tags         Admin Users
 // @Accept       json
 // @Produce      json
 // @Security     BearerAuth
+// @Param        page      query     int     false  "Page number"                  default(1)
+// @Param        limit     query     int     false  "Number of items per page"     default(10)
+// @Param        role      query     string  false  "Filter by role (user, admin, super admin)"
 // @Success      200  {object}  dto.SuccessResponse[[]dto.UserResponse]
 // @Failure      401  {object}  dto.ErrorResponse
 // @Failure      403  {object}  dto.ErrorResponse
-// @Router       /api/v1/admin/users [get]
+// @Router       /api/v1/super-admin/users [get]
 func (c *userController) ListUsers(ctx *gin.Context) {
-	accounts, err := c.accountService.GetAllAccounts(ctx.Request.Context())
+	limit, _ := strconv.Atoi(ctx.DefaultQuery("limit", "10"))
+	page, _ := strconv.Atoi(ctx.DefaultQuery("page", "1"))
+	role := ctx.DefaultQuery("role", "user")
+
+	if limit < 1 {
+		limit = 1
+	} else if limit > 50 {
+		limit = 50
+	}
+
+	if page < 1 {
+		page = 1
+	}
+
+	validRoles := map[string]bool{
+		"user":        true,
+		"admin":       true,
+		"super_admin": true,
+	}
+
+	if role != "" && !validRoles[role] {
+		ResponseJSON(ctx, gin.H{}, []dto.UserResponse{}, http_error.BAD_REQUEST_ERROR)
+		return
+	}
+
+	offset := (page - 1) * limit
+	p := entity.Pagination{
+		Limit:  limit,
+		Offset: offset,
+		Role:   role,
+	}
+
+	accounts, total, err := c.accountService.GetAllAccountsWithPagination(ctx.Request.Context(), p)
 	if err != nil {
 		ResponseJSON(ctx, gin.H{}, []dto.UserResponse{}, err)
 		return
@@ -55,7 +93,25 @@ func (c *userController) ListUsers(ctx *gin.Context) {
 		})
 	}
 
-	ResponseJSON(ctx, gin.H{}, users, nil)
+	var totalPages int
+	if total == 0 {
+		totalPages = 1
+	} else {
+		totalPages = int((total + int64(limit) - 1) / int64(limit))
+	}
+
+	if page > totalPages {
+		page = totalPages
+	}
+
+	meta := gin.H{
+		"totalItems":  total,
+		"totalPages":  totalPages,
+		"currentPage": page,
+		"limit":       limit,
+	}
+
+	ResponseJSON(ctx, meta, users, nil)
 }
 
 // CreateUser godoc
@@ -70,7 +126,7 @@ func (c *userController) ListUsers(ctx *gin.Context) {
 // @Failure      400      {object}  dto.ErrorResponse
 // @Failure      401      {object}  dto.ErrorResponse
 // @Failure      403      {object}  dto.ErrorResponse
-// @Router       /api/v1/admin/users [post]
+// @Router       /api/v1/super-admin/users [post]
 func (c *userController) CreateUser(ctx *gin.Context) {
 	req := RequestJSON[dto.CreateUserRequest](ctx)
 
@@ -111,7 +167,7 @@ func (c *userController) CreateUser(ctx *gin.Context) {
 // @Failure      400       {object}  dto.ErrorResponse
 // @Failure      401       {object}  dto.ErrorResponse
 // @Failure      403       {object}  dto.ErrorResponse
-// @Router       /api/v1/admin/users/bulk [post]
+// @Router       /api/v1/super-admin/users/bulk [post]
 func (c *userController) BulkCreateUsers(ctx *gin.Context) {
 	var requests []dto.CreateUserRequest
 	if err := ctx.ShouldBindJSON(&requests); err != nil {
@@ -138,7 +194,7 @@ func (c *userController) BulkCreateUsers(ctx *gin.Context) {
 // @Failure      401      {object}  dto.ErrorResponse
 // @Failure      403      {object}  dto.ErrorResponse
 // @Failure      404      {object}  dto.ErrorResponse
-// @Router       /api/v1/admin/users/{id} [put]
+// @Router       /api/v1/super-admin/users/{id} [put]
 func (c *userController) UpdateUser(ctx *gin.Context) {
 	idParam := ctx.Param("id")
 	userId, err := uuid.Parse(idParam)
@@ -198,7 +254,7 @@ func (c *userController) UpdateUser(ctx *gin.Context) {
 // @Failure      401 {object}  dto.ErrorResponse
 // @Failure      403 {object}  dto.ErrorResponse
 // @Failure      404 {object}  dto.ErrorResponse
-// @Router       /api/v1/admin/users/{id} [delete]
+// @Router       /api/v1/super-admin/users/{id} [delete]
 func (c *userController) DeleteUser(ctx *gin.Context) {
 	idParam := ctx.Param("id")
 	userId, err := uuid.Parse(idParam)

models/entity/constant.go

@@ -29,4 +29,5 @@ type Pagination struct {
 	Order          string
 	RegisterStatus *int
 	Status         *string
+	Role           string
 }

provider/provider.go

@@ -29,6 +29,7 @@ func NewAppProvider() AppProvider {
 
 	log.Println("[BOOT] Creating Gin Router")
 	ginRouter := gin.Default()
+	ginRouter.SetTrustedProxies(nil)
 
 	log.Println("[BOOT] Initializing Config Provider")
 	configProvider := NewConfigProvider()

repositories/account_repository.go

@@ -14,6 +14,7 @@ type AccountRepository interface {
 	GetAccountByEmail(ctx context.Context, email string) (entity.Account, error)
 	GetAccountByUsername(ctx context.Context, username string) (entity.Account, error)
 	GetAllaccount(ctx context.Context) ([]entity.Account, error)
+	GetAllAccountsWithPagination(ctx context.Context, pagination entity.Pagination) ([]entity.Account, int64, error)
 	UpdateAccount(ctx context.Context, account entity.Account) (entity.Account, error)
 	SoftDeleteAccount(ctx context.Context, accountId uuid.UUID) error
 	DeleteAccount(ctx context.Context, accountId uuid.UUID) error
@@ -66,6 +67,27 @@ func (r *accountRepository) GetAllaccount(ctx context.Context) ([]entity.Account
 	return account, nil
 }
 
+func (r *accountRepository) GetAllAccountsWithPagination(ctx context.Context, pagination entity.Pagination) ([]entity.Account, int64, error) {
+	var accounts []entity.Account
+	var total int64
+
+	query := r.db.WithContext(ctx)
+
+	if pagination.Role != "" {
+		query = query.Where("role = ?", pagination.Role)
+	}
+
+	if err := query.Model(&entity.Account{}).Count(&total).Error; err != nil {
+		return nil, 0, err
+	}
+
+	if err := query.Limit(pagination.Limit).Offset(pagination.Offset).Find(&accounts).Error; err != nil {
+		return nil, 0, err
+	}
+
+	return accounts, total, nil
+}
+
 func (r *accountRepository) UpdateAccount(ctx context.Context, account entity.Account) (entity.Account, error) {
 	if err := r.db.WithContext(ctx).Save(&account).Error; err != nil {
 		return entity.Account{}, err

services/account_service.go

@@ -27,6 +27,7 @@ type AccountService interface {
 	CreateEmptyDetail(ctx context.Context, accountId uuid.UUID) (dto.AccountDetailResponse, error)
 	UpdateDetail(ctx context.Context, details entity.AccountDetail) (dto.AccountDetailResponse, error)
 	GetAllAccounts(ctx context.Context) ([]entity.Account, error)
+	GetAllAccountsWithPagination(ctx context.Context, pagination entity.Pagination) ([]entity.Account, int64, error)
 	BulkCreateAccounts(ctx context.Context, requests []dto.CreateUserRequest) (dto.BulkCreateUserResponse, error)
 	DeleteAccount(ctx context.Context, accountId uuid.UUID) error
 }
@@ -208,6 +209,10 @@ func (s *accountService) GetAllAccounts(ctx context.Context) ([]entity.Account,
 	return s.accountRepo.GetAllaccount(ctx)
 }
 
+func (s *accountService) GetAllAccountsWithPagination(ctx context.Context, pagination entity.Pagination) ([]entity.Account, int64, error) {
+	return s.accountRepo.GetAllAccountsWithPagination(ctx, pagination)
+}
+
 func (s *accountService) BulkCreateAccounts(ctx context.Context, requests []dto.CreateUserRequest) (dto.BulkCreateUserResponse, error) {
 	response := dto.BulkCreateUserResponse{
 		SuccessCount: 0,

swag.json

@@ -14,7 +14,6 @@
   "host": "",
   "basePath": "/",
   "schemes": [
-    "http",
     "https"
   ],
   "consumes": [

swagger/docs/docs.go

@@ -1488,290 +1488,6 @@ const docTemplate = `{
                 }
             }
         },
-        "/api/v1/admin/users": {
-            "get": {
-                "security": [
-                    {
-                        "BearerAuth": []
-                    }
-                ],
-                "description": "Retrieve a list of all users in the system",
-                "consumes": [
-                    "application/json"
-                ],
-                "produces": [
-                    "application/json"
-                ],
-                "tags": [
-                    "Admin Users"
-                ],
-                "summary": "List All Users",
-                "responses": {
-                    "200": {
-                        "description": "OK",
-                        "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-array_dto_UserResponse"
-                        }
-                    },
-                    "401": {
-                        "description": "Unauthorized",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "403": {
-                        "description": "Forbidden",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    }
-                }
-            },
-            "post": {
-                "security": [
-                    {
-                        "BearerAuth": []
-                    }
-                ],
-                "description": "Create a new user account by providing user details",
-                "consumes": [
-                    "application/json"
-                ],
-                "produces": [
-                    "application/json"
-                ],
-                "tags": [
-                    "Admin Users"
-                ],
-                "summary": "Create Single User",
-                "parameters": [
-                    {
-                        "description": "Create User Request",
-                        "name": "request",
-                        "in": "body",
-                        "required": true,
-                        "schema": {
-                            "$ref": "#/definitions/dto.CreateUserRequest"
-                        }
-                    }
-                ],
-                "responses": {
-                    "200": {
-                        "description": "OK",
-                        "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-dto_UserResponse"
-                        }
-                    },
-                    "400": {
-                        "description": "Bad Request",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "401": {
-                        "description": "Unauthorized",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "403": {
-                        "description": "Forbidden",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    }
-                }
-            }
-        },
-        "/api/v1/admin/users/bulk": {
-            "post": {
-                "security": [
-                    {
-                        "BearerAuth": []
-                    }
-                ],
-                "description": "Create multiple user accounts at once",
-                "consumes": [
-                    "application/json"
-                ],
-                "produces": [
-                    "application/json"
-                ],
-                "tags": [
-                    "Admin Users"
-                ],
-                "summary": "Bulk Create Users",
-                "parameters": [
-                    {
-                        "description": "Bulk Create User Requests",
-                        "name": "requests",
-                        "in": "body",
-                        "required": true,
-                        "schema": {
-                            "type": "array",
-                            "items": {
-                                "$ref": "#/definitions/dto.CreateUserRequest"
-                            }
-                        }
-                    }
-                ],
-                "responses": {
-                    "200": {
-                        "description": "OK",
-                        "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-dto_CreateUserRequest"
-                        }
-                    },
-                    "400": {
-                        "description": "Bad Request",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "401": {
-                        "description": "Unauthorized",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "403": {
-                        "description": "Forbidden",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    }
-                }
-            }
-        },
-        "/api/v1/admin/users/{id}": {
-            "put": {
-                "security": [
-                    {
-                        "BearerAuth": []
-                    }
-                ],
-                "description": "Update user information by ID",
-                "consumes": [
-                    "application/json"
-                ],
-                "produces": [
-                    "application/json"
-                ],
-                "tags": [
-                    "Admin Users"
-                ],
-                "summary": "Edit User",
-                "parameters": [
-                    {
-                        "type": "string",
-                        "description": "User ID",
-                        "name": "id",
-                        "in": "path",
-                        "required": true
-                    },
-                    {
-                        "description": "Update User Request",
-                        "name": "request",
-                        "in": "body",
-                        "required": true,
-                        "schema": {
-                            "$ref": "#/definitions/dto.UpdateUserRequest"
-                        }
-                    }
-                ],
-                "responses": {
-                    "200": {
-                        "description": "OK",
-                        "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-dto_UserResponse"
-                        }
-                    },
-                    "400": {
-                        "description": "Bad Request",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "401": {
-                        "description": "Unauthorized",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "403": {
-                        "description": "Forbidden",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "404": {
-                        "description": "Not Found",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    }
-                }
-            },
-            "delete": {
-                "security": [
-                    {
-                        "BearerAuth": []
-                    }
-                ],
-                "description": "Delete a user account by ID",
-                "consumes": [
-                    "application/json"
-                ],
-                "produces": [
-                    "application/json"
-                ],
-                "tags": [
-                    "Admin Users"
-                ],
-                "summary": "Delete User",
-                "parameters": [
-                    {
-                        "type": "string",
-                        "description": "User ID",
-                        "name": "id",
-                        "in": "path",
-                        "required": true
-                    }
-                ],
-                "responses": {
-                    "200": {
-                        "description": "OK",
-                        "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-any"
-                        }
-                    },
-                    "400": {
-                        "description": "Bad Request",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "401": {
-                        "description": "Unauthorized",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "403": {
-                        "description": "Forbidden",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "404": {
-                        "description": "Not Found",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    }
-                }
-            }
-        },
         "/api/v1/authentication/external-login": {
             "post": {
                 "description": "Authenticate user using external OAuth provider",
@@ -2463,9 +2179,164 @@ const docTemplate = `{
                 }
             }
         },
-        "/api/v1/options/create": {
+        "/api/v1/options/create": {
+            "post": {
+                "description": "Create multiple options in bulk",
+                "consumes": [
+                    "application/json"
+                ],
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Option"
+                ],
+                "summary": "Create Bulk Options",
+                "parameters": [
+                    {
+                        "description": "Bulk Options Request",
+                        "name": "request",
+                        "in": "body",
+                        "required": true,
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/definitions/dto.OptionsRequest"
+                            }
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/dto.SuccessResponse-any"
+                        }
+                    },
+                    "400": {
+                        "description": "Bad Request",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    }
+                }
+            }
+        },
+        "/api/v1/options/list/{slug}": {
+            "get": {
+                "description": "Retrieve option details using its slug",
+                "consumes": [
+                    "application/json"
+                ],
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Option"
+                ],
+                "summary": "Get Option by Slug",
+                "parameters": [
+                    {
+                        "type": "string",
+                        "description": "Option Slug",
+                        "name": "slug",
+                        "in": "path",
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/dto.SuccessResponse-models_Options"
+                        }
+                    },
+                    "400": {
+                        "description": "Bad Request",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    }
+                }
+            }
+        },
+        "/api/v1/options/region/cities": {
+            "get": {
+                "description": "Retrieve a list of cities within a specific province",
+                "consumes": [
+                    "application/json"
+                ],
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Region"
+                ],
+                "summary": "List Cities by Province",
+                "parameters": [
+                    {
+                        "description": "Province ID",
+                        "name": "request",
+                        "in": "body",
+                        "required": true,
+                        "schema": {
+                            "type": "object",
+                            "properties": {
+                                "province_id": {
+                                    "type": "integer"
+                                }
+                            }
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/dto.SuccessResponse-array_models_RegionCity"
+                        }
+                    },
+                    "400": {
+                        "description": "Bad Request",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    }
+                }
+            }
+        },
+        "/api/v1/options/region/provinces": {
+            "get": {
+                "description": "Retrieve a list of all provinces",
+                "consumes": [
+                    "application/json"
+                ],
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Region"
+                ],
+                "summary": "List Provinces",
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/dto.SuccessResponse-array_models_RegionProvince"
+                        }
+                    },
+                    "400": {
+                        "description": "Bad Request",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    }
+                }
+            }
+        },
+        "/api/v1/options/region/seed-cities": {
             "post": {
-                "description": "Create multiple options in bulk",
+                "description": "Seed multiple cities into the system",
                 "consumes": [
                     "application/json"
                 ],
@@ -2473,19 +2344,19 @@ const docTemplate = `{
                     "application/json"
                 ],
                 "tags": [
-                    "Option"
+                    "Region"
                 ],
-                "summary": "Create Bulk Options",
+                "summary": "Seed Cities",
                 "parameters": [
                     {
-                        "description": "Bulk Options Request",
+                        "description": "Seed Cities Request",
                         "name": "request",
                         "in": "body",
                         "required": true,
                         "schema": {
                             "type": "array",
                             "items": {
-                                "$ref": "#/definitions/dto.OptionsRequest"
+                                "$ref": "#/definitions/models.RegionCity"
                             }
                         }
                     }
@@ -2494,7 +2365,7 @@ const docTemplate = `{
                     "200": {
                         "description": "OK",
                         "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-any"
+                            "$ref": "#/definitions/dto.SuccessResponse-array_models_RegionCity"
                         }
                     },
                     "400": {
@@ -2506,9 +2377,9 @@ const docTemplate = `{
                 }
             }
         },
-        "/api/v1/options/list/{slug}": {
-            "get": {
-                "description": "Retrieve option details using its slug",
+        "/api/v1/options/region/seed-provinces": {
+            "post": {
+                "description": "Seed multiple provinces into the system",
                 "consumes": [
                     "application/json"
                 ],
@@ -2516,23 +2387,28 @@ const docTemplate = `{
                     "application/json"
                 ],
                 "tags": [
-                    "Option"
+                    "Region"
                 ],
-                "summary": "Get Option by Slug",
+                "summary": "Seed Provinces",
                 "parameters": [
                     {
-                        "type": "string",
-                        "description": "Option Slug",
-                        "name": "slug",
-                        "in": "path",
-                        "required": true
+                        "description": "Seed Provinces Request",
+                        "name": "request",
+                        "in": "body",
+                        "required": true,
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/definitions/models.RegionProvince"
+                            }
+                        }
                     }
                 ],
                 "responses": {
                     "200": {
                         "description": "OK",
                         "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-models_Options"
+                            "$ref": "#/definitions/dto.SuccessResponse-any"
                         }
                     },
                     "400": {
@@ -2544,9 +2420,9 @@ const docTemplate = `{
                 }
             }
         },
-        "/api/v1/options/region/cities": {
-            "get": {
-                "description": "Retrieve a list of cities within a specific province",
+        "/api/v1/payment/callback": {
+            "post": {
+                "description": "Receive and process payment status updates from Xendit",
                 "consumes": [
                     "application/json"
                 ],
@@ -2554,22 +2430,18 @@ const docTemplate = `{
                     "application/json"
                 ],
                 "tags": [
-                    "Region"
+                    "Payment"
                 ],
-                "summary": "List Cities by Province",
+                "summary": "Handle Xendit Payment Callback",
                 "parameters": [
                     {
-                        "description": "Province ID",
+                        "description": "Xendit Callback Payload",
                         "name": "request",
                         "in": "body",
                         "required": true,
                         "schema": {
                             "type": "object",
-                            "properties": {
-                                "province_id": {
-                                    "type": "integer"
-                                }
-                            }
+                            "additionalProperties": true
                         }
                     }
                 ],
@@ -2577,7 +2449,7 @@ const docTemplate = `{
                     "200": {
                         "description": "OK",
                         "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-array_models_RegionCity"
+                            "$ref": "#/definitions/dto.SuccessResponse-any"
                         }
                     },
                     "400": {
@@ -2589,9 +2461,14 @@ const docTemplate = `{
                 }
             }
         },
-        "/api/v1/options/region/provinces": {
+        "/api/v1/super-admin/users": {
             "get": {
-                "description": "Retrieve a list of all provinces",
+                "security": [
+                    {
+                        "BearerAuth": []
+                    }
+                ],
+                "description": "Retrieve a list of all users in the system",
                 "consumes": [
                     "application/json"
                 ],
@@ -2599,28 +2476,37 @@ const docTemplate = `{
                     "application/json"
                 ],
                 "tags": [
-                    "Region"
+                    "Admin Users"
                 ],
-                "summary": "List Provinces",
+                "summary": "List All Users",
                 "responses": {
                     "200": {
                         "description": "OK",
                         "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-array_models_RegionProvince"
+                            "$ref": "#/definitions/dto.SuccessResponse-array_dto_UserResponse"
                         }
                     },
-                    "400": {
-                        "description": "Bad Request",
+                    "401": {
+                        "description": "Unauthorized",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    },
+                    "403": {
+                        "description": "Forbidden",
                         "schema": {
                             "$ref": "#/definitions/dto.ErrorResponse"
                         }
                     }
                 }
-            }
-        },
-        "/api/v1/options/region/seed-cities": {
+            },
             "post": {
-                "description": "Seed multiple cities into the system",
+                "security": [
+                    {
+                        "BearerAuth": []
+                    }
+                ],
+                "description": "Create a new user account by providing user details",
                 "consumes": [
                     "application/json"
                 ],
@@ -2628,20 +2514,17 @@ const docTemplate = `{
                     "application/json"
                 ],
                 "tags": [
-                    "Region"
+                    "Admin Users"
                 ],
-                "summary": "Seed Cities",
+                "summary": "Create Single User",
                 "parameters": [
                     {
-                        "description": "Seed Cities Request",
+                        "description": "Create User Request",
                         "name": "request",
                         "in": "body",
                         "required": true,
                         "schema": {
-                            "type": "array",
-                            "items": {
-                                "$ref": "#/definitions/models.RegionCity"
-                            }
+                            "$ref": "#/definitions/dto.CreateUserRequest"
                         }
                     }
                 ],
@@ -2649,7 +2532,7 @@ const docTemplate = `{
                     "200": {
                         "description": "OK",
                         "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-array_models_RegionCity"
+                            "$ref": "#/definitions/dto.SuccessResponse-dto_UserResponse"
                         }
                     },
                     "400": {
@@ -2657,13 +2540,30 @@ const docTemplate = `{
                         "schema": {
                             "$ref": "#/definitions/dto.ErrorResponse"
                         }
+                    },
+                    "401": {
+                        "description": "Unauthorized",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    },
+                    "403": {
+                        "description": "Forbidden",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
                     }
                 }
             }
         },
-        "/api/v1/options/region/seed-provinces": {
+        "/api/v1/super-admin/users/bulk": {
             "post": {
-                "description": "Seed multiple provinces into the system",
+                "security": [
+                    {
+                        "BearerAuth": []
+                    }
+                ],
+                "description": "Create multiple user accounts at once",
                 "consumes": [
                     "application/json"
                 ],
@@ -2671,19 +2571,19 @@ const docTemplate = `{
                     "application/json"
                 ],
                 "tags": [
-                    "Region"
+                    "Admin Users"
                 ],
-                "summary": "Seed Provinces",
+                "summary": "Bulk Create Users",
                 "parameters": [
                     {
-                        "description": "Seed Provinces Request",
-                        "name": "request",
+                        "description": "Bulk Create User Requests",
+                        "name": "requests",
                         "in": "body",
                         "required": true,
                         "schema": {
                             "type": "array",
                             "items": {
-                                "$ref": "#/definitions/models.RegionProvince"
+                                "$ref": "#/definitions/dto.CreateUserRequest"
                             }
                         }
                     }
@@ -2692,7 +2592,7 @@ const docTemplate = `{
                     "200": {
                         "description": "OK",
                         "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-any"
+                            "$ref": "#/definitions/dto.SuccessResponse-dto_CreateUserRequest"
                         }
                     },
                     "400": {
@@ -2700,13 +2600,30 @@ const docTemplate = `{
                         "schema": {
                             "$ref": "#/definitions/dto.ErrorResponse"
                         }
+                    },
+                    "401": {
+                        "description": "Unauthorized",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    },
+                    "403": {
+                        "description": "Forbidden",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
                     }
                 }
             }
         },
-        "/api/v1/payment/callback": {
-            "post": {
-                "description": "Receive and process payment status updates from Xendit",
+        "/api/v1/super-admin/users/{id}": {
+            "put": {
+                "security": [
+                    {
+                        "BearerAuth": []
+                    }
+                ],
+                "description": "Update user information by ID",
                 "consumes": [
                     "application/json"
                 ],
@@ -2714,20 +2631,85 @@ const docTemplate = `{
                     "application/json"
                 ],
                 "tags": [
-                    "Payment"
+                    "Admin Users"
                 ],
-                "summary": "Handle Xendit Payment Callback",
+                "summary": "Edit User",
                 "parameters": [
                     {
-                        "description": "Xendit Callback Payload",
+                        "type": "string",
+                        "description": "User ID",
+                        "name": "id",
+                        "in": "path",
+                        "required": true
+                    },
+                    {
+                        "description": "Update User Request",
                         "name": "request",
                         "in": "body",
                         "required": true,
                         "schema": {
-                            "type": "object",
-                            "additionalProperties": true
+                            "$ref": "#/definitions/dto.UpdateUserRequest"
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/dto.SuccessResponse-dto_UserResponse"
+                        }
+                    },
+                    "400": {
+                        "description": "Bad Request",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    },
+                    "401": {
+                        "description": "Unauthorized",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    },
+                    "403": {
+                        "description": "Forbidden",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    },
+                    "404": {
+                        "description": "Not Found",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
                         }
                     }
+                }
+            },
+            "delete": {
+                "security": [
+                    {
+                        "BearerAuth": []
+                    }
+                ],
+                "description": "Delete a user account by ID",
+                "consumes": [
+                    "application/json"
+                ],
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Admin Users"
+                ],
+                "summary": "Delete User",
+                "parameters": [
+                    {
+                        "type": "string",
+                        "description": "User ID",
+                        "name": "id",
+                        "in": "path",
+                        "required": true
+                    }
                 ],
                 "responses": {
                     "200": {
@@ -2741,6 +2723,24 @@ const docTemplate = `{
                         "schema": {
                             "$ref": "#/definitions/dto.ErrorResponse"
                         }
+                    },
+                    "401": {
+                        "description": "Unauthorized",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    },
+                    "403": {
+                        "description": "Forbidden",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    },
+                    "404": {
+                        "description": "Not Found",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
                     }
                 }
             }
@@ -4726,7 +4726,7 @@ var SwaggerInfo = &swag.Spec{
 	Version:          "1.0.0",
 	Host:             "localhost:8000",
 	BasePath:         "/",
-	Schemes:          []string{"http", "https"},
+	Schemes:          []string{"https"},
 	Title:            "Go Boilerplate API",
 	Description:      "Backend API documentation",
 	InfoInstanceName: "swagger",

swagger/docs/swagger.json

@@ -1,6 +1,5 @@
 {
     "schemes": [
-        "http",
         "https"
     ],
     "swagger": "2.0",
@@ -1486,290 +1485,6 @@
                 }
             }
         },
-        "/api/v1/admin/users": {
-            "get": {
-                "security": [
-                    {
-                        "BearerAuth": []
-                    }
-                ],
-                "description": "Retrieve a list of all users in the system",
-                "consumes": [
-                    "application/json"
-                ],
-                "produces": [
-                    "application/json"
-                ],
-                "tags": [
-                    "Admin Users"
-                ],
-                "summary": "List All Users",
-                "responses": {
-                    "200": {
-                        "description": "OK",
-                        "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-array_dto_UserResponse"
-                        }
-                    },
-                    "401": {
-                        "description": "Unauthorized",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "403": {
-                        "description": "Forbidden",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    }
-                }
-            },
-            "post": {
-                "security": [
-                    {
-                        "BearerAuth": []
-                    }
-                ],
-                "description": "Create a new user account by providing user details",
-                "consumes": [
-                    "application/json"
-                ],
-                "produces": [
-                    "application/json"
-                ],
-                "tags": [
-                    "Admin Users"
-                ],
-                "summary": "Create Single User",
-                "parameters": [
-                    {
-                        "description": "Create User Request",
-                        "name": "request",
-                        "in": "body",
-                        "required": true,
-                        "schema": {
-                            "$ref": "#/definitions/dto.CreateUserRequest"
-                        }
-                    }
-                ],
-                "responses": {
-                    "200": {
-                        "description": "OK",
-                        "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-dto_UserResponse"
-                        }
-                    },
-                    "400": {
-                        "description": "Bad Request",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "401": {
-                        "description": "Unauthorized",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "403": {
-                        "description": "Forbidden",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    }
-                }
-            }
-        },
-        "/api/v1/admin/users/bulk": {
-            "post": {
-                "security": [
-                    {
-                        "BearerAuth": []
-                    }
-                ],
-                "description": "Create multiple user accounts at once",
-                "consumes": [
-                    "application/json"
-                ],
-                "produces": [
-                    "application/json"
-                ],
-                "tags": [
-                    "Admin Users"
-                ],
-                "summary": "Bulk Create Users",
-                "parameters": [
-                    {
-                        "description": "Bulk Create User Requests",
-                        "name": "requests",
-                        "in": "body",
-                        "required": true,
-                        "schema": {
-                            "type": "array",
-                            "items": {
-                                "$ref": "#/definitions/dto.CreateUserRequest"
-                            }
-                        }
-                    }
-                ],
-                "responses": {
-                    "200": {
-                        "description": "OK",
-                        "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-dto_CreateUserRequest"
-                        }
-                    },
-                    "400": {
-                        "description": "Bad Request",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "401": {
-                        "description": "Unauthorized",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "403": {
-                        "description": "Forbidden",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    }
-                }
-            }
-        },
-        "/api/v1/admin/users/{id}": {
-            "put": {
-                "security": [
-                    {
-                        "BearerAuth": []
-                    }
-                ],
-                "description": "Update user information by ID",
-                "consumes": [
-                    "application/json"
-                ],
-                "produces": [
-                    "application/json"
-                ],
-                "tags": [
-                    "Admin Users"
-                ],
-                "summary": "Edit User",
-                "parameters": [
-                    {
-                        "type": "string",
-                        "description": "User ID",
-                        "name": "id",
-                        "in": "path",
-                        "required": true
-                    },
-                    {
-                        "description": "Update User Request",
-                        "name": "request",
-                        "in": "body",
-                        "required": true,
-                        "schema": {
-                            "$ref": "#/definitions/dto.UpdateUserRequest"
-                        }
-                    }
-                ],
-                "responses": {
-                    "200": {
-                        "description": "OK",
-                        "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-dto_UserResponse"
-                        }
-                    },
-                    "400": {
-                        "description": "Bad Request",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "401": {
-                        "description": "Unauthorized",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "403": {
-                        "description": "Forbidden",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "404": {
-                        "description": "Not Found",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    }
-                }
-            },
-            "delete": {
-                "security": [
-                    {
-                        "BearerAuth": []
-                    }
-                ],
-                "description": "Delete a user account by ID",
-                "consumes": [
-                    "application/json"
-                ],
-                "produces": [
-                    "application/json"
-                ],
-                "tags": [
-                    "Admin Users"
-                ],
-                "summary": "Delete User",
-                "parameters": [
-                    {
-                        "type": "string",
-                        "description": "User ID",
-                        "name": "id",
-                        "in": "path",
-                        "required": true
-                    }
-                ],
-                "responses": {
-                    "200": {
-                        "description": "OK",
-                        "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-any"
-                        }
-                    },
-                    "400": {
-                        "description": "Bad Request",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "401": {
-                        "description": "Unauthorized",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "403": {
-                        "description": "Forbidden",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    },
-                    "404": {
-                        "description": "Not Found",
-                        "schema": {
-                            "$ref": "#/definitions/dto.ErrorResponse"
-                        }
-                    }
-                }
-            }
-        },
         "/api/v1/authentication/external-login": {
             "post": {
                 "description": "Authenticate user using external OAuth provider",
@@ -2461,9 +2176,164 @@
                 }
             }
         },
-        "/api/v1/options/create": {
+        "/api/v1/options/create": {
+            "post": {
+                "description": "Create multiple options in bulk",
+                "consumes": [
+                    "application/json"
+                ],
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Option"
+                ],
+                "summary": "Create Bulk Options",
+                "parameters": [
+                    {
+                        "description": "Bulk Options Request",
+                        "name": "request",
+                        "in": "body",
+                        "required": true,
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/definitions/dto.OptionsRequest"
+                            }
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/dto.SuccessResponse-any"
+                        }
+                    },
+                    "400": {
+                        "description": "Bad Request",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    }
+                }
+            }
+        },
+        "/api/v1/options/list/{slug}": {
+            "get": {
+                "description": "Retrieve option details using its slug",
+                "consumes": [
+                    "application/json"
+                ],
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Option"
+                ],
+                "summary": "Get Option by Slug",
+                "parameters": [
+                    {
+                        "type": "string",
+                        "description": "Option Slug",
+                        "name": "slug",
+                        "in": "path",
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/dto.SuccessResponse-models_Options"
+                        }
+                    },
+                    "400": {
+                        "description": "Bad Request",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    }
+                }
+            }
+        },
+        "/api/v1/options/region/cities": {
+            "get": {
+                "description": "Retrieve a list of cities within a specific province",
+                "consumes": [
+                    "application/json"
+                ],
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Region"
+                ],
+                "summary": "List Cities by Province",
+                "parameters": [
+                    {
+                        "description": "Province ID",
+                        "name": "request",
+                        "in": "body",
+                        "required": true,
+                        "schema": {
+                            "type": "object",
+                            "properties": {
+                                "province_id": {
+                                    "type": "integer"
+                                }
+                            }
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/dto.SuccessResponse-array_models_RegionCity"
+                        }
+                    },
+                    "400": {
+                        "description": "Bad Request",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    }
+                }
+            }
+        },
+        "/api/v1/options/region/provinces": {
+            "get": {
+                "description": "Retrieve a list of all provinces",
+                "consumes": [
+                    "application/json"
+                ],
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Region"
+                ],
+                "summary": "List Provinces",
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/dto.SuccessResponse-array_models_RegionProvince"
+                        }
+                    },
+                    "400": {
+                        "description": "Bad Request",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    }
+                }
+            }
+        },
+        "/api/v1/options/region/seed-cities": {
             "post": {
-                "description": "Create multiple options in bulk",
+                "description": "Seed multiple cities into the system",
                 "consumes": [
                     "application/json"
                 ],
@@ -2471,19 +2341,19 @@
                     "application/json"
                 ],
                 "tags": [
-                    "Option"
+                    "Region"
                 ],
-                "summary": "Create Bulk Options",
+                "summary": "Seed Cities",
                 "parameters": [
                     {
-                        "description": "Bulk Options Request",
+                        "description": "Seed Cities Request",
                         "name": "request",
                         "in": "body",
                         "required": true,
                         "schema": {
                             "type": "array",
                             "items": {
-                                "$ref": "#/definitions/dto.OptionsRequest"
+                                "$ref": "#/definitions/models.RegionCity"
                             }
                         }
                     }
@@ -2492,7 +2362,7 @@
                     "200": {
                         "description": "OK",
                         "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-any"
+                            "$ref": "#/definitions/dto.SuccessResponse-array_models_RegionCity"
                         }
                     },
                     "400": {
@@ -2504,9 +2374,9 @@
                 }
             }
         },
-        "/api/v1/options/list/{slug}": {
-            "get": {
-                "description": "Retrieve option details using its slug",
+        "/api/v1/options/region/seed-provinces": {
+            "post": {
+                "description": "Seed multiple provinces into the system",
                 "consumes": [
                     "application/json"
                 ],
@@ -2514,23 +2384,28 @@
                     "application/json"
                 ],
                 "tags": [
-                    "Option"
+                    "Region"
                 ],
-                "summary": "Get Option by Slug",
+                "summary": "Seed Provinces",
                 "parameters": [
                     {
-                        "type": "string",
-                        "description": "Option Slug",
-                        "name": "slug",
-                        "in": "path",
-                        "required": true
+                        "description": "Seed Provinces Request",
+                        "name": "request",
+                        "in": "body",
+                        "required": true,
+                        "schema": {
+                            "type": "array",
+                            "items": {
+                                "$ref": "#/definitions/models.RegionProvince"
+                            }
+                        }
                     }
                 ],
                 "responses": {
                     "200": {
                         "description": "OK",
                         "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-models_Options"
+                            "$ref": "#/definitions/dto.SuccessResponse-any"
                         }
                     },
                     "400": {
@@ -2542,9 +2417,9 @@
                 }
             }
         },
-        "/api/v1/options/region/cities": {
-            "get": {
-                "description": "Retrieve a list of cities within a specific province",
+        "/api/v1/payment/callback": {
+            "post": {
+                "description": "Receive and process payment status updates from Xendit",
                 "consumes": [
                     "application/json"
                 ],
@@ -2552,22 +2427,18 @@
                     "application/json"
                 ],
                 "tags": [
-                    "Region"
+                    "Payment"
                 ],
-                "summary": "List Cities by Province",
+                "summary": "Handle Xendit Payment Callback",
                 "parameters": [
                     {
-                        "description": "Province ID",
+                        "description": "Xendit Callback Payload",
                         "name": "request",
                         "in": "body",
                         "required": true,
                         "schema": {
                             "type": "object",
-                            "properties": {
-                                "province_id": {
-                                    "type": "integer"
-                                }
-                            }
+                            "additionalProperties": true
                         }
                     }
                 ],
@@ -2575,7 +2446,7 @@
                     "200": {
                         "description": "OK",
                         "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-array_models_RegionCity"
+                            "$ref": "#/definitions/dto.SuccessResponse-any"
                         }
                     },
                     "400": {
@@ -2587,9 +2458,14 @@
                 }
             }
         },
-        "/api/v1/options/region/provinces": {
+        "/api/v1/super-admin/users": {
             "get": {
-                "description": "Retrieve a list of all provinces",
+                "security": [
+                    {
+                        "BearerAuth": []
+                    }
+                ],
+                "description": "Retrieve a list of all users in the system",
                 "consumes": [
                     "application/json"
                 ],
@@ -2597,28 +2473,37 @@
                     "application/json"
                 ],
                 "tags": [
-                    "Region"
+                    "Admin Users"
                 ],
-                "summary": "List Provinces",
+                "summary": "List All Users",
                 "responses": {
                     "200": {
                         "description": "OK",
                         "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-array_models_RegionProvince"
+                            "$ref": "#/definitions/dto.SuccessResponse-array_dto_UserResponse"
                         }
                     },
-                    "400": {
-                        "description": "Bad Request",
+                    "401": {
+                        "description": "Unauthorized",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    },
+                    "403": {
+                        "description": "Forbidden",
                         "schema": {
                             "$ref": "#/definitions/dto.ErrorResponse"
                         }
                     }
                 }
-            }
-        },
-        "/api/v1/options/region/seed-cities": {
+            },
             "post": {
-                "description": "Seed multiple cities into the system",
+                "security": [
+                    {
+                        "BearerAuth": []
+                    }
+                ],
+                "description": "Create a new user account by providing user details",
                 "consumes": [
                     "application/json"
                 ],
@@ -2626,20 +2511,17 @@
                     "application/json"
                 ],
                 "tags": [
-                    "Region"
+                    "Admin Users"
                 ],
-                "summary": "Seed Cities",
+                "summary": "Create Single User",
                 "parameters": [
                     {
-                        "description": "Seed Cities Request",
+                        "description": "Create User Request",
                         "name": "request",
                         "in": "body",
                         "required": true,
                         "schema": {
-                            "type": "array",
-                            "items": {
-                                "$ref": "#/definitions/models.RegionCity"
-                            }
+                            "$ref": "#/definitions/dto.CreateUserRequest"
                         }
                     }
                 ],
@@ -2647,7 +2529,7 @@
                     "200": {
                         "description": "OK",
                         "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-array_models_RegionCity"
+                            "$ref": "#/definitions/dto.SuccessResponse-dto_UserResponse"
                         }
                     },
                     "400": {
@@ -2655,13 +2537,30 @@
                         "schema": {
                             "$ref": "#/definitions/dto.ErrorResponse"
                         }
+                    },
+                    "401": {
+                        "description": "Unauthorized",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    },
+                    "403": {
+                        "description": "Forbidden",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
                     }
                 }
             }
         },
-        "/api/v1/options/region/seed-provinces": {
+        "/api/v1/super-admin/users/bulk": {
             "post": {
-                "description": "Seed multiple provinces into the system",
+                "security": [
+                    {
+                        "BearerAuth": []
+                    }
+                ],
+                "description": "Create multiple user accounts at once",
                 "consumes": [
                     "application/json"
                 ],
@@ -2669,19 +2568,19 @@
                     "application/json"
                 ],
                 "tags": [
-                    "Region"
+                    "Admin Users"
                 ],
-                "summary": "Seed Provinces",
+                "summary": "Bulk Create Users",
                 "parameters": [
                     {
-                        "description": "Seed Provinces Request",
-                        "name": "request",
+                        "description": "Bulk Create User Requests",
+                        "name": "requests",
                         "in": "body",
                         "required": true,
                         "schema": {
                             "type": "array",
                             "items": {
-                                "$ref": "#/definitions/models.RegionProvince"
+                                "$ref": "#/definitions/dto.CreateUserRequest"
                             }
                         }
                     }
@@ -2690,7 +2589,7 @@
                     "200": {
                         "description": "OK",
                         "schema": {
-                            "$ref": "#/definitions/dto.SuccessResponse-any"
+                            "$ref": "#/definitions/dto.SuccessResponse-dto_CreateUserRequest"
                         }
                     },
                     "400": {
@@ -2698,13 +2597,30 @@
                         "schema": {
                             "$ref": "#/definitions/dto.ErrorResponse"
                         }
+                    },
+                    "401": {
+                        "description": "Unauthorized",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    },
+                    "403": {
+                        "description": "Forbidden",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
                     }
                 }
             }
         },
-        "/api/v1/payment/callback": {
-            "post": {
-                "description": "Receive and process payment status updates from Xendit",
+        "/api/v1/super-admin/users/{id}": {
+            "put": {
+                "security": [
+                    {
+                        "BearerAuth": []
+                    }
+                ],
+                "description": "Update user information by ID",
                 "consumes": [
                     "application/json"
                 ],
@@ -2712,20 +2628,85 @@
                     "application/json"
                 ],
                 "tags": [
-                    "Payment"
+                    "Admin Users"
                 ],
-                "summary": "Handle Xendit Payment Callback",
+                "summary": "Edit User",
                 "parameters": [
                     {
-                        "description": "Xendit Callback Payload",
+                        "type": "string",
+                        "description": "User ID",
+                        "name": "id",
+                        "in": "path",
+                        "required": true
+                    },
+                    {
+                        "description": "Update User Request",
                         "name": "request",
                         "in": "body",
                         "required": true,
                         "schema": {
-                            "type": "object",
-                            "additionalProperties": true
+                            "$ref": "#/definitions/dto.UpdateUserRequest"
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/dto.SuccessResponse-dto_UserResponse"
+                        }
+                    },
+                    "400": {
+                        "description": "Bad Request",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    },
+                    "401": {
+                        "description": "Unauthorized",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    },
+                    "403": {
+                        "description": "Forbidden",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    },
+                    "404": {
+                        "description": "Not Found",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
                         }
                     }
+                }
+            },
+            "delete": {
+                "security": [
+                    {
+                        "BearerAuth": []
+                    }
+                ],
+                "description": "Delete a user account by ID",
+                "consumes": [
+                    "application/json"
+                ],
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Admin Users"
+                ],
+                "summary": "Delete User",
+                "parameters": [
+                    {
+                        "type": "string",
+                        "description": "User ID",
+                        "name": "id",
+                        "in": "path",
+                        "required": true
+                    }
                 ],
                 "responses": {
                     "200": {
@@ -2739,6 +2720,24 @@
                         "schema": {
                             "$ref": "#/definitions/dto.ErrorResponse"
                         }
+                    },
+                    "401": {
+                        "description": "Unauthorized",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    },
+                    "403": {
+                        "description": "Forbidden",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
+                    },
+                    "404": {
+                        "description": "Not Found",
+                        "schema": {
+                            "$ref": "#/definitions/dto.ErrorResponse"
+                        }
                     }
                 }
             }

swagger/docs/swagger.yaml

@@ -2267,187 +2267,6 @@ paths:
       summary: Update Proctoring Log
       tags:
       - Event Exam Proctoring
-  /api/v1/admin/users:
-    get:
-      consumes:
-      - application/json
-      description: Retrieve a list of all users in the system
-      produces:
-      - application/json
-      responses:
-        "200":
-          description: OK
-          schema:
-            $ref: '#/definitions/dto.SuccessResponse-array_dto_UserResponse'
-        "401":
-          description: Unauthorized
-          schema:
-            $ref: '#/definitions/dto.ErrorResponse'
-        "403":
-          description: Forbidden
-          schema:
-            $ref: '#/definitions/dto.ErrorResponse'
-      security:
-      - BearerAuth: []
-      summary: List All Users
-      tags:
-      - Admin Users
-    post:
-      consumes:
-      - application/json
-      description: Create a new user account by providing user details
-      parameters:
-      - description: Create User Request
-        in: body
-        name: request
-        required: true
-        schema:
-          $ref: '#/definitions/dto.CreateUserRequest'
-      produces:
-      - application/json
-      responses:
-        "200":
-          description: OK
-          schema:
-            $ref: '#/definitions/dto.SuccessResponse-dto_UserResponse'
-        "400":
-          description: Bad Request
-          schema:
-            $ref: '#/definitions/dto.ErrorResponse'
-        "401":
-          description: Unauthorized
-          schema:
-            $ref: '#/definitions/dto.ErrorResponse'
-        "403":
-          description: Forbidden
-          schema:
-            $ref: '#/definitions/dto.ErrorResponse'
-      security:
-      - BearerAuth: []
-      summary: Create Single User
-      tags:
-      - Admin Users
-  /api/v1/admin/users/{id}:
-    delete:
-      consumes:
-      - application/json
-      description: Delete a user account by ID
-      parameters:
-      - description: User ID
-        in: path
-        name: id
-        required: true
-        type: string
-      produces:
-      - application/json
-      responses:
-        "200":
-          description: OK
-          schema:
-            $ref: '#/definitions/dto.SuccessResponse-any'
-        "400":
-          description: Bad Request
-          schema:
-            $ref: '#/definitions/dto.ErrorResponse'
-        "401":
-          description: Unauthorized
-          schema:
-            $ref: '#/definitions/dto.ErrorResponse'
-        "403":
-          description: Forbidden
-          schema:
-            $ref: '#/definitions/dto.ErrorResponse'
-        "404":
-          description: Not Found
-          schema:
-            $ref: '#/definitions/dto.ErrorResponse'
-      security:
-      - BearerAuth: []
-      summary: Delete User
-      tags:
-      - Admin Users
-    put:
-      consumes:
-      - application/json
-      description: Update user information by ID
-      parameters:
-      - description: User ID
-        in: path
-        name: id
-        required: true
-        type: string
-      - description: Update User Request
-        in: body
-        name: request
-        required: true
-        schema:
-          $ref: '#/definitions/dto.UpdateUserRequest'
-      produces:
-      - application/json
-      responses:
-        "200":
-          description: OK
-          schema:
-            $ref: '#/definitions/dto.SuccessResponse-dto_UserResponse'
-        "400":
-          description: Bad Request
-          schema:
-            $ref: '#/definitions/dto.ErrorResponse'
-        "401":
-          description: Unauthorized
-          schema:
-            $ref: '#/definitions/dto.ErrorResponse'
-        "403":
-          description: Forbidden
-          schema:
-            $ref: '#/definitions/dto.ErrorResponse'
-        "404":
-          description: Not Found
-          schema:
-            $ref: '#/definitions/dto.ErrorResponse'
-      security:
-      - BearerAuth: []
-      summary: Edit User
-      tags:
-      - Admin Users
-  /api/v1/admin/users/bulk:
-    post:
-      consumes:
-      - application/json
-      description: Create multiple user accounts at once
-      parameters:
-      - description: Bulk Create User Requests
-        in: body
-        name: requests
-        required: true
-        schema:
-          items:
-            $ref: '#/definitions/dto.CreateUserRequest'
-          type: array
-      produces:
-      - application/json
-      responses:
-        "200":
-          description: OK
-          schema:
-            $ref: '#/definitions/dto.SuccessResponse-dto_CreateUserRequest'
-        "400":
-          description: Bad Request
-          schema:
-            $ref: '#/definitions/dto.ErrorResponse'
-        "401":
-          description: Unauthorized
-          schema:
-            $ref: '#/definitions/dto.ErrorResponse'
-        "403":
-          description: Forbidden
-          schema:
-            $ref: '#/definitions/dto.ErrorResponse'
-      security:
-      - BearerAuth: []
-      summary: Bulk Create Users
-      tags:
-      - Admin Users
   /api/v1/authentication/external-login:
     post:
       consumes:
@@ -3090,8 +2909,188 @@ paths:
       summary: Handle Xendit Payment Callback
       tags:
       - Payment
+  /api/v1/super-admin/users:
+    get:
+      consumes:
+      - application/json
+      description: Retrieve a list of all users in the system
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            $ref: '#/definitions/dto.SuccessResponse-array_dto_UserResponse'
+        "401":
+          description: Unauthorized
+          schema:
+            $ref: '#/definitions/dto.ErrorResponse'
+        "403":
+          description: Forbidden
+          schema:
+            $ref: '#/definitions/dto.ErrorResponse'
+      security:
+      - BearerAuth: []
+      summary: List All Users
+      tags:
+      - Admin Users
+    post:
+      consumes:
+      - application/json
+      description: Create a new user account by providing user details
+      parameters:
+      - description: Create User Request
+        in: body
+        name: request
+        required: true
+        schema:
+          $ref: '#/definitions/dto.CreateUserRequest'
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            $ref: '#/definitions/dto.SuccessResponse-dto_UserResponse'
+        "400":
+          description: Bad Request
+          schema:
+            $ref: '#/definitions/dto.ErrorResponse'
+        "401":
+          description: Unauthorized
+          schema:
+            $ref: '#/definitions/dto.ErrorResponse'
+        "403":
+          description: Forbidden
+          schema:
+            $ref: '#/definitions/dto.ErrorResponse'
+      security:
+      - BearerAuth: []
+      summary: Create Single User
+      tags:
+      - Admin Users
+  /api/v1/super-admin/users/{id}:
+    delete:
+      consumes:
+      - application/json
+      description: Delete a user account by ID
+      parameters:
+      - description: User ID
+        in: path
+        name: id
+        required: true
+        type: string
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            $ref: '#/definitions/dto.SuccessResponse-any'
+        "400":
+          description: Bad Request
+          schema:
+            $ref: '#/definitions/dto.ErrorResponse'
+        "401":
+          description: Unauthorized
+          schema:
+            $ref: '#/definitions/dto.ErrorResponse'
+        "403":
+          description: Forbidden
+          schema:
+            $ref: '#/definitions/dto.ErrorResponse'
+        "404":
+          description: Not Found
+          schema:
+            $ref: '#/definitions/dto.ErrorResponse'
+      security:
+      - BearerAuth: []
+      summary: Delete User
+      tags:
+      - Admin Users
+    put:
+      consumes:
+      - application/json
+      description: Update user information by ID
+      parameters:
+      - description: User ID
+        in: path
+        name: id
+        required: true
+        type: string
+      - description: Update User Request
+        in: body
+        name: request
+        required: true
+        schema:
+          $ref: '#/definitions/dto.UpdateUserRequest'
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            $ref: '#/definitions/dto.SuccessResponse-dto_UserResponse'
+        "400":
+          description: Bad Request
+          schema:
+            $ref: '#/definitions/dto.ErrorResponse'
+        "401":
+          description: Unauthorized
+          schema:
+            $ref: '#/definitions/dto.ErrorResponse'
+        "403":
+          description: Forbidden
+          schema:
+            $ref: '#/definitions/dto.ErrorResponse'
+        "404":
+          description: Not Found
+          schema:
+            $ref: '#/definitions/dto.ErrorResponse'
+      security:
+      - BearerAuth: []
+      summary: Edit User
+      tags:
+      - Admin Users
+  /api/v1/super-admin/users/bulk:
+    post:
+      consumes:
+      - application/json
+      description: Create multiple user accounts at once
+      parameters:
+      - description: Bulk Create User Requests
+        in: body
+        name: requests
+        required: true
+        schema:
+          items:
+            $ref: '#/definitions/dto.CreateUserRequest'
+          type: array
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            $ref: '#/definitions/dto.SuccessResponse-dto_CreateUserRequest'
+        "400":
+          description: Bad Request
+          schema:
+            $ref: '#/definitions/dto.ErrorResponse'
+        "401":
+          description: Unauthorized
+          schema:
+            $ref: '#/definitions/dto.ErrorResponse'
+        "403":
+          description: Forbidden
+          schema:
+            $ref: '#/definitions/dto.ErrorResponse'
+      security:
+      - BearerAuth: []
+      summary: Bulk Create Users
+      tags:
+      - Admin Users
 schemes:
-- http
 - https
 securityDefinitions:
   BearerAuth:

swagger/swagger_info.go

@@ -16,7 +16,7 @@ package swagger
 
 // @host            localhost:8000
 // @BasePath        /
-// @schemes         http https
+// @schemes         https
 
 // =====================
 // Security