use actix_multipart::Multipart; use actix_web::{HttpResponse, web}; use crate::api::response::{ApiErrorResponse, ApiResponse}; use crate::api::user::upload_avatar::parse_avatar_field; use crate::error::AppError; use crate::models::workspaces::Workspace; use crate::service::AppService; use crate::session::Session; #[utoipa::path( post, path = "/api/v1/workspaces/{workspace_name}/avatar", tag = "Workspaces", operation_id = "workspaceUploadAvatar", summary = "Upload workspace avatar", description = "Upload an avatar image for a workspace. Requires admin role. Maximum size 5 MB. Supported: png, jpg, gif, webp. Accepts multipart/form-data with a single 'avatar' field.", params( ("workspace_name" = String, Path, description = "Workspace name."), ), request_body( content_type = "multipart/form-data", description = "Avatar image file in a multipart form field named 'avatar'." ), responses( (status = 200, description = "Avatar uploaded.", body = ApiResponse), (status = 400, description = "Unsupported image format or file too large.", body = ApiErrorResponse), (status = 401, description = "Unauthenticated or insufficient role.", body = ApiErrorResponse), (status = 404, description = "Workspace not found.", body = ApiErrorResponse), (status = 500, description = "Storage or database failure.", body = ApiErrorResponse) ) )] pub async fn handle( service: web::Data, session: Session, path: web::Path, payload: Multipart, ) -> Result { let ws = service.workspace.find_workspace_by_name(&path).await?; let (data, content_type, file_name) = parse_avatar_field(payload).await?; let ws = service .workspace .workspace_upload_avatar(&session, &ws, data, content_type, file_name) .await?; Ok(HttpResponse::Ok().json(ApiResponse::new(ws))) }