feat(api): expand API endpoints for repo, PR, user, workspace management

- Add git operation endpoints: archive, compare branches, diff, tree,
  repository extras
- Add repo endpoints: contributors, delete fork, get branch/commit
  status/deploy key/invitation/member/release/tag/webhook, topics,
  release assets, webhook deliveries/retry
- Add PR endpoints: review requests, templates
- Add user endpoints: block/unblock, follow/unfollow, presence,
  personal access tokens, account restore
- Add workspace endpoints: billing history, approvals, domains,
  integrations, invitations, members, webhooks, restore
- Add internal API, notification API, IM API modules
- Update route configuration and OpenAPI spec

api/workspace/upload_avatar.rs

@@ -1,34 +1,26 @@
+use actix_multipart::Multipart;
 use actix_web::{HttpResponse, web};
-use serde::Deserialize;
 
 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;
 
-#[derive(Deserialize, utoipa::IntoParams)]
-pub struct UploadAvatarQuery {
-    pub content_type: Option<String>,
-    pub file_name: Option<String>,
-}
-
 #[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.",
+    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."),
-        ("content_type" = Option<String>, Query, description = "MIME type of the uploaded image."),
-        ("file_name" = Option<String>, Query, description = "Original file name for extension detection.")
     ),
     request_body(
-        content = Vec<u8>,
-        description = "Raw image bytes.",
-        content_type = "application/octet-stream"
+        content_type = "multipart/form-data",
+        description = "Avatar image file in a multipart form field named 'avatar'."
     ),
     responses(
         (status = 200, description = "Avatar uploaded.", body = ApiResponse<Workspace>),
@@ -42,19 +34,13 @@ pub async fn handle(
     service: web::Data<AppService>,
     session: Session,
     path: web::Path<String>,
-    query: web::Query<UploadAvatarQuery>,
-    body: web::Bytes,
+    payload: Multipart,
 ) -> Result<HttpResponse, AppError> {
     let ws = service.workspace.find_workspace_by_name(&path).await?;
-    let data = service
+    let (data, content_type, file_name) = parse_avatar_field(payload).await?;
+    let ws = service
         .workspace
-        .workspace_upload_avatar(
-            &session,
-            &ws,
-            body.to_vec(),
-            query.content_type.clone(),
-            query.file_name.clone(),
-        )
+        .workspace_upload_avatar(&session, &ws, data, content_type, file_name)
         .await?;
-    Ok(HttpResponse::Ok().json(ApiResponse::new(data)))
+    Ok(HttpResponse::Ok().json(ApiResponse::new(ws)))
 }