Oleks
1cd81ff925
Adds two improvements to the user/org/repo project-board REST API: * state filter on column-issues endpoints (issue #4) GET /api/v1/{users,orgs}/{name}/-/projects/{id}/columns/{col}/issues GET /api/v1/repos/{owner}/{repo}/projects/{id}/columns/{col}/issues Now accept ?state=open|closed|all (default open), matching the convention on the project-list endpoint and on /repos/.../issues. Applied at the IssuesOptions layer so all three scopes inherit the filter. * populated num_issues / num_open_issues / num_closed_issues on column-list (issue #5) ColumnList.LoadIssueCounts runs two grouped queries against project_issue joined with issue (one open, one closed). All three List*Columns handlers call it before converting, so num_issues stops being null and consumers can render a kanban summary in a single round trip instead of N+1. Tests: * unit: empty-input fast path on ColumnList.LoadIssueCounts. * integration: extended testAPIListProjectColumnIssues / -User / -Org to close an issue, then verify default=open hides it, state=closed and state=all return it, and the column-list response carries the correct open/closed/total split. Closes #4, closes #5
110 lines
3.7 KiB
Go
110 lines
3.7 KiB
Go
// Copyright 2026 The Gitea Authors. All rights reserved.
|
|
// SPDX-License-Identifier: MIT
|
|
|
|
package structs
|
|
|
|
import (
|
|
"time"
|
|
)
|
|
|
|
// Project represents a project.
|
|
//
|
|
// Gitea projects can only contain issues — note cards and pull requests are
|
|
// not modeled as project items.
|
|
//
|
|
// swagger:model
|
|
type Project struct {
|
|
ID int64 `json:"id"`
|
|
Title string `json:"title"`
|
|
Description string `json:"description"`
|
|
OwnerID int64 `json:"owner_id,omitempty"`
|
|
RepoID int64 `json:"repo_id,omitempty"`
|
|
Creator *User `json:"creator,omitempty"`
|
|
State StateType `json:"state"`
|
|
// Template type: "none", "basic_kanban" or "bug_triage"
|
|
TemplateType string `json:"template_type"`
|
|
// Card type: "text_only" or "images_and_text"
|
|
CardType string `json:"card_type"`
|
|
// Project type: "individual", "repository" or "organization"
|
|
Type string `json:"type"`
|
|
NumOpenIssues int64 `json:"num_open_issues,omitempty"`
|
|
NumClosedIssues int64 `json:"num_closed_issues,omitempty"`
|
|
NumIssues int64 `json:"num_issues,omitempty"`
|
|
// swagger:strfmt date-time
|
|
CreatedAt time.Time `json:"created_at"`
|
|
// swagger:strfmt date-time
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
// swagger:strfmt date-time
|
|
ClosedAt *time.Time `json:"closed_at,omitempty"`
|
|
HTMLURL string `json:"html_url,omitempty"`
|
|
}
|
|
|
|
// CreateProjectOption represents options for creating a project
|
|
// swagger:model
|
|
type CreateProjectOption struct {
|
|
// required: true
|
|
Title string `json:"title" binding:"Required"`
|
|
Description string `json:"description"`
|
|
// Template type: "none", "basic_kanban" or "bug_triage"
|
|
TemplateType string `json:"template_type"`
|
|
// Card type: "text_only" or "images_and_text"
|
|
CardType string `json:"card_type"`
|
|
}
|
|
|
|
// EditProjectOption represents options for editing a project
|
|
// swagger:model
|
|
type EditProjectOption struct {
|
|
Title *string `json:"title,omitempty"`
|
|
Description *string `json:"description,omitempty"`
|
|
// Card type: "text_only" or "images_and_text"
|
|
CardType *string `json:"card_type,omitempty"`
|
|
State *StateType `json:"state,omitempty"`
|
|
}
|
|
|
|
// ProjectColumn represents a project column (board)
|
|
// swagger:model
|
|
type ProjectColumn struct {
|
|
ID int64 `json:"id"`
|
|
Title string `json:"title"`
|
|
Default bool `json:"default"`
|
|
Sorting int `json:"sorting"`
|
|
Color string `json:"color,omitempty"`
|
|
ProjectID int64 `json:"project_id"`
|
|
Creator *User `json:"creator,omitempty"`
|
|
NumOpenIssues int64 `json:"num_open_issues"`
|
|
NumClosedIssues int64 `json:"num_closed_issues"`
|
|
NumIssues int64 `json:"num_issues"`
|
|
// swagger:strfmt date-time
|
|
CreatedAt time.Time `json:"created_at"`
|
|
// swagger:strfmt date-time
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
}
|
|
|
|
// CreateProjectColumnOption represents options for creating a project column
|
|
// swagger:model
|
|
type CreateProjectColumnOption struct {
|
|
// required: true
|
|
Title string `json:"title" binding:"Required"`
|
|
// Column color in 6-digit hex format, e.g. #FF0000
|
|
Color string `json:"color,omitempty"`
|
|
}
|
|
|
|
// EditProjectColumnOption represents options for editing a project column
|
|
// swagger:model
|
|
type EditProjectColumnOption struct {
|
|
Title *string `json:"title,omitempty"`
|
|
// Column color in 6-digit hex format, e.g. #FF0000
|
|
Color *string `json:"color,omitempty"`
|
|
Sorting *int `json:"sorting,omitempty"`
|
|
}
|
|
|
|
// MoveProjectIssueOption represents options for moving an issue between columns
|
|
// swagger:model
|
|
type MoveProjectIssueOption struct {
|
|
// Target column to move the issue into
|
|
// required: true
|
|
ColumnID int64 `json:"column_id" binding:"Required"`
|
|
// Optional sorting position within the target column
|
|
Sorting *int64 `json:"sorting,omitempty"`
|
|
}
|