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.

imphnen-cms/src/v1/landing/events/events_controller.rs

@@ -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 event list", body = ResponseListSuccessDto<Vec<EventsListItemDto>>)
+        (status = 200, description = "[PUBLIC] Get event list", body = ResponseListSuccessDto<Vec<EventsListItemDto>>)
     ),
     tag = "Events"
 )]
@@ -45,7 +45,7 @@ pub async fn get_event_list(
         ("id" = String, Path, description = "Event ID")
     ),
     responses(
-        (status = 200, description = "Get event by ID", body = ResponseSuccessDto<EventsDetailItemDto>)
+        (status = 200, description = "[PUBLIC] Get event by ID", body = ResponseSuccessDto<EventsDetailItemDto>)
     ),
     tag = "Events"
 )]
@@ -64,7 +64,7 @@ pub async fn get_event_by_id(
     path = "/v1/cms/landing/events/create",
     request_body = EventsCreateRequestDto,
     responses(
-        (status = 201, description = "Create new event", body = MessageResponseDto)
+        (status = 201, description = "[ADMIN] Create new event", body = MessageResponseDto)
     ),
     tag = "Events"
 )]
@@ -90,7 +90,7 @@ pub async fn post_create_event(
     ),
     request_body = EventsUpdateRequestDto,
     responses(
-        (status = 200, description = "Update event", body = MessageResponseDto)
+        (status = 200, description = "[ADMIN] Update event", body = MessageResponseDto)
     ),
     tag = "Events"
 )]
@@ -116,7 +116,7 @@ pub async fn patch_update_event(
         ("id" = String, Path, description = "Event ID")
     ),
     responses(
-        (status = 200, description = "Soft delete event", body = MessageResponseDto)
+        (status = 200, description = "[ADMIN] Soft delete event", body = MessageResponseDto)
     ),
     tag = "Events"
 )]

imphnen-cms/src/v1/landing/testimonials/testimonials_controller.rs

@@ -28,7 +28,7 @@ use imphnen_iam::permissions_guard;
         ("filter_by" = Option<String>, Query, description = "Field to filter by"),
     ),
     responses(
-        (status = 200, description = "Get testimonial list", body = ResponseListSuccessDto<Vec<TestimonialsListItemDto>>)
+        (status = 200, description = "[PUBLIC] Get testimonial list", body = ResponseListSuccessDto<Vec<TestimonialsListItemDto>>)
     ),
     tag = "Testimonials"
 )]
@@ -46,7 +46,7 @@ pub async fn get_testimonial_list(
         ("id" = String, Path, description = "Testimonial ID")
     ),
     responses(
-        (status = 200, description = "Get testimonial by ID", body = ResponseSuccessDto<TestimonialsDetailItemDto>)
+        (status = 200, description = "[PUBLIC] Get testimonial by ID", body = ResponseSuccessDto<TestimonialsDetailItemDto>)
     ),
     tag = "Testimonials"
 )]
@@ -65,7 +65,7 @@ pub async fn get_testimonial_by_id(
     path = "/v1/cms/landing/testimonials/create",
     request_body = TestimonialsCreateRequestDto,
     responses(
-        (status = 201, description = "Create new testimonial", body = MessageResponseDto)
+        (status = 201, description = "[USER] Create new testimonial", body = MessageResponseDto)
     ),
     tag = "Testimonials"
 )]
@@ -92,7 +92,7 @@ pub async fn post_create_testimonial(
     ),
     request_body = TestimonialsUpdateRequestDto,
     responses(
-        (status = 200, description = "Update testimonial", body = MessageResponseDto)
+        (status = 200, description = "[USER] Update testimonial", body = MessageResponseDto)
     ),
     tag = "Testimonials"
 )]
@@ -119,7 +119,7 @@ pub async fn patch_update_testimonial(
         ("id" = String, Path, description = "Testimonial ID")
     ),
     responses(
-        (status = 200, description = "Soft delete testimonial", body = MessageResponseDto)
+        (status = 200, description = "[USER] Soft delete testimonial", body = MessageResponseDto)
     ),
     tag = "Testimonials"
 )]