use actix_web::{HttpResponse, web}; use serde::Deserialize; use utoipa::IntoParams; use crate::api::response::{ApiErrorResponse, ApiResponse}; use crate::error::AppError; use crate::models::base_info::{self, UserBaseInfo}; use crate::models::issues::IssueDetail; use crate::service::AppService; use crate::service::issues::core::CreateIssueParams; use crate::session::Session; #[derive(Debug, Deserialize, IntoParams)] pub struct PathParams { /// Workspace name (unique identifier) pub workspace_name: String, } /// Create an issue /// /// Creates a new issue in the specified workspace. /// Requires at least Member role in the workspace. /// /// Parameters: /// - title: Issue title (required) /// - body: Issue body in markdown (optional) /// - priority: Priority level (optional, defaults to "none") /// - visibility: Visibility setting (optional, defaults to "public") /// - due_at: Due date (optional) /// - repo_ids: Related repository IDs /// - label_ids: Label IDs to apply /// - assignee_ids: User IDs to assign /// - milestone_id: Milestone ID to attach /// /// Effects: /// - Issue is created with auto-incrementing number /// - Author is automatically subscribed /// - Relations, labels, and assignees are attached /// - Workspace stats are updated /// /// Returns the created issue with full metadata. #[utoipa::path( post, path = "/api/v1/workspaces/{workspace_name}/issues", tag = "Issues", operation_id = "issueCreate", params(PathParams), request_body( content = CreateIssueParams, description = "Issue creation parameters", content_type = "application/json" ), responses( (status = 201, description = "Issue created successfully. Returns the newly created issue with full metadata.", body = ApiResponse), (status = 400, description = "Invalid parameters: empty title, invalid repository/label/milestone references", body = ApiErrorResponse), (status = 401, description = "Authentication required or session expired", body = ApiErrorResponse), (status = 403, description = "Insufficient permissions (requires Member role or higher)", body = ApiErrorResponse), (status = 404, description = "Workspace or referenced resource not found", body = ApiErrorResponse), (status = 500, description = "Internal server error", body = ApiErrorResponse), ), security( ("session_cookie" = []) ) )] pub async fn create( service: web::Data, session: Session, path: web::Path, params: web::Json, ) -> Result { let issue = service .issue .issue_create(&session, &path.workspace_name, params.into_inner()) .await?; let author_id = issue.author_id; let users = base_info::resolve_users(&service.ctx.db, &[author_id]).await?; let author = users .get(&author_id) .cloned() .unwrap_or_else(|| UserBaseInfo::placeholder(author_id)); Ok(HttpResponse::Created().json(ApiResponse::new(issue.into_detail(author)))) }