Files
imphnen-backend-service/imphnen-hackathon/src/teams/infrastructure/http/handlers.rs
T
maulanasdqnandClaude Sonnet 4.6 e1bc336baa feat: add utoipa path annotations to hackathon and QR handlers, register in swagger
All hackathon endpoints (/v1/hackathon/*) and QR endpoints (/v1/qr/*)
are now visible in the Swagger UI at /docs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-03 01:22:38 +07:00

196 lines
5.8 KiB
Rust

use super::dto::*;
use crate::middleware::hackathon_auth::HackathonAuthUser;
use crate::teams::domain::service::TeamService;
use axum::{
Extension, Json,
extract::{Path, Query},
response::IntoResponse,
};
use imphnen_utils::{
errors::AppError,
response_format::{ApiMessage, ApiSuccess},
};
use std::sync::Arc;
use uuid::Uuid;
#[utoipa::path(
post,
path = "/v1/hackathon/teams",
request_body = CreateTeamRequest,
responses(
(status = 200, description = "Create a new team"),
(status = 401, description = "Unauthorized")
),
tag = "Hackathon - Teams",
security(("bearer_auth" = []))
)]
pub async fn create_team_handler(
Extension(service): Extension<Arc<dyn TeamService>>,
Extension(auth): Extension<HackathonAuthUser>,
Json(body): Json<CreateTeamRequest>,
) -> Result<axum::response::Response, AppError> {
let team = service.create_team(auth.user_id, body.into()).await?;
Ok(ApiSuccess(TeamResponse::from(team)).into_response())
}
#[utoipa::path(
get,
path = "/v1/hackathon/teams/{team_id}",
params(("team_id" = Uuid, Path, description = "Team ID")),
responses(
(status = 200, description = "Get team by ID"),
(status = 404, description = "Team not found")
),
tag = "Hackathon - Teams"
)]
pub async fn get_team_handler(
Extension(service): Extension<Arc<dyn TeamService>>,
Path(team_id): Path<Uuid>,
) -> Result<axum::response::Response, AppError> {
let team = service.get_team_by_id(team_id).await?;
Ok(ApiSuccess(TeamResponse::from(team)).into_response())
}
#[utoipa::path(
get,
path = "/v1/hackathon/teams/browse",
params(BrowseTeamsQuery),
responses(
(status = 200, description = "Browse teams with filters")
),
tag = "Hackathon - Teams"
)]
pub async fn browse_teams_handler(
Extension(service): Extension<Arc<dyn TeamService>>,
Query(query): Query<BrowseTeamsQuery>,
) -> Result<axum::response::Response, AppError> {
let result = service.browse_teams(query.into()).await?;
Ok(
ApiSuccess(TeamListResponse {
data: result.teams.into_iter().map(TeamResponse::from).collect(),
total: result.total,
page: result.page,
per_page: result.per_page,
})
.into_response(),
)
}
#[utoipa::path(
get,
path = "/v1/hackathon/teams/my",
responses(
(status = 200, description = "Get my teams"),
(status = 401, description = "Unauthorized")
),
tag = "Hackathon - Teams",
security(("bearer_auth" = []))
)]
pub async fn get_my_teams_handler(
Extension(service): Extension<Arc<dyn TeamService>>,
Extension(auth): Extension<HackathonAuthUser>,
) -> Result<axum::response::Response, AppError> {
let teams = service.get_user_teams(auth.user_id).await?;
Ok(
ApiSuccess(
teams
.into_iter()
.map(TeamResponse::from)
.collect::<Vec<_>>(),
)
.into_response(),
)
}
#[utoipa::path(
put,
path = "/v1/hackathon/teams/{team_id}",
params(("team_id" = Uuid, Path, description = "Team ID")),
request_body = UpdateTeamRequest,
responses(
(status = 200, description = "Update team"),
(status = 401, description = "Unauthorized"),
(status = 403, description = "Forbidden")
),
tag = "Hackathon - Teams",
security(("bearer_auth" = []))
)]
pub async fn update_team_handler(
Extension(service): Extension<Arc<dyn TeamService>>,
Extension(auth): Extension<HackathonAuthUser>,
Path(team_id): Path<Uuid>,
Json(body): Json<UpdateTeamRequest>,
) -> Result<axum::response::Response, AppError> {
let team = service
.update_team(team_id, auth.user_id, body.into())
.await?;
Ok(ApiSuccess(TeamResponse::from(team)).into_response())
}
#[utoipa::path(
delete,
path = "/v1/hackathon/teams/{team_id}",
params(("team_id" = Uuid, Path, description = "Team ID")),
responses(
(status = 200, description = "Delete team"),
(status = 401, description = "Unauthorized"),
(status = 403, description = "Forbidden")
),
tag = "Hackathon - Teams",
security(("bearer_auth" = []))
)]
pub async fn delete_team_handler(
Extension(service): Extension<Arc<dyn TeamService>>,
Extension(auth): Extension<HackathonAuthUser>,
Path(team_id): Path<Uuid>,
) -> Result<axum::response::Response, AppError> {
service.delete_team(team_id, auth.user_id).await?;
Ok(ApiMessage::ok("Team deleted successfully").into_response())
}
#[utoipa::path(
post,
path = "/v1/hackathon/teams/{team_id}/leave",
params(("team_id" = Uuid, Path, description = "Team ID")),
responses(
(status = 200, description = "Leave team"),
(status = 401, description = "Unauthorized")
),
tag = "Hackathon - Teams",
security(("bearer_auth" = []))
)]
pub async fn leave_team_handler(
Extension(service): Extension<Arc<dyn TeamService>>,
Extension(auth): Extension<HackathonAuthUser>,
Path(team_id): Path<Uuid>,
) -> Result<axum::response::Response, AppError> {
service.leave_team(team_id, auth.user_id).await?;
Ok(ApiMessage::ok("Left team successfully").into_response())
}
#[utoipa::path(
delete,
path = "/v1/hackathon/teams/{team_id}/members/{member_id}",
params(
("team_id" = Uuid, Path, description = "Team ID"),
("member_id" = Uuid, Path, description = "Member user ID")
),
responses(
(status = 200, description = "Remove team member"),
(status = 401, description = "Unauthorized"),
(status = 403, description = "Forbidden")
),
tag = "Hackathon - Teams",
security(("bearer_auth" = []))
)]
pub async fn remove_member_handler(
Extension(service): Extension<Arc<dyn TeamService>>,
Extension(auth): Extension<HackathonAuthUser>,
Path((team_id, member_id)): Path<(Uuid, Uuid)>,
) -> Result<axum::response::Response, AppError> {
service
.remove_team_member(team_id, auth.user_id, member_id)
.await?;
Ok(ApiMessage::ok("Member removed successfully").into_response())
}