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::IssueListFilters; use crate::session::Session; #[derive(Debug, Deserialize, IntoParams)] pub struct PathParams { /// Workspace name (unique identifier) pub workspace_name: String, } #[derive(Debug, Deserialize, IntoParams)] pub struct QueryParams { /// Filter by issue state ("open" or "closed") pub state: Option, /// Filter by priority level pub priority: Option, /// Filter by author user ID pub author_id: Option, /// Filter by assignee user ID pub assignee_id: Option, /// Filter by milestone ID pub milestone_id: Option, /// Filter by label ID pub label_id: Option, /// Maximum number of issues to return (default: 50, max: 100) pub limit: Option, /// Number of issues to skip for pagination (default: 0) pub offset: Option, } /// List issues in a workspace /// /// Returns a paginated list of issues in the workspace, sorted by issue number (newest first). /// Supports filtering by state, priority, author, assignee, milestone, and label. /// Only returns issues visible to the authenticated user (public + workspace member access). /// Requires authentication. #[utoipa::path( get, path = "/api/v1/workspaces/{workspace_name}/issues", tag = "Issues", operation_id = "issueList", params(PathParams, QueryParams), responses( (status = 200, description = "Issues listed successfully. Returns filtered array of issue objects with metadata.", body = ApiResponse>), (status = 401, description = "Authentication required or session expired", body = ApiErrorResponse), (status = 404, description = "Workspace not found", body = ApiErrorResponse), (status = 500, description = "Internal server error", body = ApiErrorResponse), ), security( ("session_cookie" = []) ) )] pub async fn list( service: web::Data, session: Session, path: web::Path, query: web::Query, ) -> Result { let filters = IssueListFilters { state: query.state.clone(), priority: query.priority.clone(), author_id: query.author_id, assignee_id: query.assignee_id, milestone_id: query.milestone_id, label_id: query.label_id, }; let issues = service .issue .issue_list( &session, &path.workspace_name, filters, query.limit.unwrap_or(50), query.offset.unwrap_or(0), ) .await?; let user_ids: Vec<_> = issues.iter().map(|i| i.author_id).collect(); let users = base_info::resolve_users(&service.ctx.db, &user_ids).await?; let details: Vec = issues .into_iter() .map(|i| { let author = users .get(&i.author_id) .cloned() .unwrap_or_else(|| UserBaseInfo::placeholder(i.author_id)); i.into_detail(author) }) .collect(); Ok(HttpResponse::Ok().json(ApiResponse::new(details))) }