Add access level descriptions to API responses across multiple controllers

- Updated event controller to specify public and admin access levels in response descriptions.
- Modified testimonials controller to indicate public access for list and detail responses.
- Enhanced mentors controller with admin access labels for various responses.
- Adjusted gacha claims and items controllers to reflect admin access in response descriptions.
- Updated hackathon controller to clarify public and admin access levels in response messages.
- Revised authentication controller to specify public access for login and registration responses.
- Enhanced admin teams controller with admin access labels for team-related responses.
- Updated users controller to clarify admin and user access levels in response descriptions.
This commit is contained in:
MythEclipse
2025-10-07 17:45:47 +07:00
parent 018124f7b3
commit 8c2527d61e
10 changed files with 151 additions and 151 deletions
@@ -15,7 +15,7 @@ use crate::v1::gacha_claims::{GachaClaimItemDto, GachaClaimRequestDto, GachaClai
),
params(("id" = String, Path, description = "Gacha Claim ID")),
responses(
(status = 200, description = "Get Gacha Claim by ID", body = ResponseSuccessDto<GachaClaimItemDto>)
(status = 200, description = "[ADMIN] Get Gacha Claim by ID", body = ResponseSuccessDto<GachaClaimItemDto>)
),
tag = "Gacha"
)]
@@ -44,7 +44,7 @@ pub async fn get_detail_gacha_claim(
path = "/v1/gacha/claims/create",
request_body = GachaClaimRequestDto,
responses(
(status = 201, description = "Create new gacha claim", body = MessageResponseDto)
(status = 201, description = "[ADMIN] Create new gacha claim", body = MessageResponseDto)
),
tag = "Gacha"
)]
@@ -27,7 +27,7 @@ use imphnen_iam::{PermissionsEnum, permissions_guard};
("filter_by" = Option<String>, Query, description = "Field to filter by"),
),
responses(
(status = 200, description = "Get gacha item list", body = ResponseListSuccessDto<Vec<GachaItemDto>>)
(status = 200, description = "[ADMIN] Get gacha item list", body = ResponseListSuccessDto<Vec<GachaItemDto>>)
),
tag = "Gacha"
)]
@@ -56,7 +56,7 @@ pub async fn get_gacha_item_list(
),
params(("id" = String, Path, description = "Gacha Item ID")),
responses(
(status = 200, description = "Get gacha item by ID", body = ResponseSuccessDto<GachaItemDto>)
(status = 200, description = "[ADMIN] Get gacha item by ID", body = ResponseSuccessDto<GachaItemDto>)
),
tag = "Gacha"
)]
@@ -85,7 +85,7 @@ pub async fn get_gacha_item_by_id(
),
request_body = GachaItemRequestDto,
responses(
(status = 201, description = "Create gacha item", body = MessageResponseDto)
(status = 201, description = "[ADMIN] Create gacha item", body = MessageResponseDto)
),
tag = "Gacha"
)]
@@ -114,7 +114,7 @@ pub async fn post_create_gacha_item(
),
request_body = GachaItemUpdateRequestDto,
responses(
(status = 200, description = "Update gacha item", body = MessageResponseDto)
(status = 200, description = "[ADMIN] Update gacha item", body = MessageResponseDto)
),
tag = "Gacha"
)]
@@ -143,7 +143,7 @@ pub async fn put_update_gacha_item(
("Bearer" = [])
),
responses(
(status = 200, description = "Delete gacha item", body = MessageResponseDto)
(status = 200, description = "[ADMIN] Delete gacha item", body = MessageResponseDto)
),
tag = "Gacha"
)]
@@ -15,7 +15,7 @@ use imphnen_iam::{PermissionsEnum, permissions_guard};
),
params(("id" = String, Path, description = "Gacha Roll ID")),
responses(
(status = 200, description = "Get Gacha Roll by ID", body = ResponseSuccessDto<GachaRollItemDto>)
(status = 200, description = "[ADMIN] Get Gacha Roll by ID", body = ResponseSuccessDto<GachaRollItemDto>)
),
tag = "Gacha"
)]
@@ -44,7 +44,7 @@ pub async fn get_detail_gacha_roll(
),
request_body = GachaRollRequestDto,
responses(
(status = 201, description = "Create new gacha roll", body = MessageResponseDto)
(status = 201, description = "[ADMIN] Create new gacha roll", body = MessageResponseDto)
),
tag = "Gacha"
)]
@@ -72,7 +72,7 @@ pub async fn post_create_gacha_roll(
("Bearer" = [])
),
responses(
(status = 200, description = "Execute and get 1 gacha result", body = ResponseSuccessDto<GachaRollItemDto>)
(status = 200, description = "[ADMIN] Execute and get 1 gacha result", body = ResponseSuccessDto<GachaRollItemDto>)
),
tag = "Gacha"
)]
@@ -100,7 +100,7 @@ pub async fn post_execute_gacha_roll(
),
params(("id" = String, Path, description = "Gacha Roll ID")),
responses(
(status = 200, description = "Delete Gacha Roll (soft delete)", body = MessageResponseDto)
(status = 200, description = "[ADMIN] Delete Gacha Roll (soft delete)", body = MessageResponseDto)
),
tag = "Gacha"
)]