feat(api): add REST API for repository project boards

models/project/column.go

@@ -257,6 +257,23 @@ func (p *Project) GetColumns(ctx context.Context) (ColumnList, error) {
 	return columns, nil
 }
 
+// CountColumns returns the total number of columns for a project
+func (p *Project) CountColumns(ctx context.Context) (int64, error) {
+	return db.GetEngine(ctx).Where("project_id=?", p.ID).Count(&Column{})
+}
+
+// GetColumnsPaginated fetches a page of columns for a project
+func (p *Project) GetColumnsPaginated(ctx context.Context, opts db.ListOptions) (ColumnList, error) {
+	columns := make([]*Column, 0, opts.PageSize)
+	if err := db.SetSessionPagination(db.GetEngine(ctx), &opts).
+		Where("project_id=?", p.ID).
+		OrderBy("sorting, id").
+		Find(&columns); err != nil {
+		return nil, err
+	}
+	return columns, nil
+}
+
 // getDefaultColumn return default column and ensure only one exists
 func (p *Project) getDefaultColumn(ctx context.Context) (*Column, error) {
 	var column Column

models/project/column_test.go

@@ -7,6 +7,7 @@ import (
 	"fmt"
 	"testing"
 
+	"code.gitea.io/gitea/models/db"
 	"code.gitea.io/gitea/models/unittest"
 
 	"github.com/stretchr/testify/assert"
@@ -123,3 +124,39 @@ func Test_NewColumn(t *testing.T) {
 	assert.Error(t, err)
 	assert.Contains(t, err.Error(), "maximum number of columns reached")
 }
+
+func TestCountColumns(t *testing.T) {
+	assert.NoError(t, unittest.PrepareTestDatabase())
+
+	project, err := GetProjectByID(t.Context(), 1)
+	assert.NoError(t, err)
+
+	count, err := project.CountColumns(t.Context())
+	assert.NoError(t, err)
+	assert.EqualValues(t, 3, count)
+}
+
+func TestGetColumnsPaginated(t *testing.T) {
+	assert.NoError(t, unittest.PrepareTestDatabase())
+
+	project, err := GetProjectByID(t.Context(), 1)
+	assert.NoError(t, err)
+
+	// Page 1, limit 2 — returns first 2 columns
+	page1, err := project.GetColumnsPaginated(t.Context(), db.ListOptions{Page: 1, PageSize: 2})
+	assert.NoError(t, err)
+	assert.Len(t, page1, 2)
+
+	// Page 2, limit 2 — returns remaining column
+	page2, err := project.GetColumnsPaginated(t.Context(), db.ListOptions{Page: 2, PageSize: 2})
+	assert.NoError(t, err)
+	assert.Len(t, page2, 1)
+
+	// Page 1 and page 2 together cover all columns with no overlap
+	allIDs := make(map[int64]bool)
+	for _, c := range append(page1, page2...) {
+		assert.False(t, allIDs[c.ID], "duplicate column ID %d across pages", c.ID)
+		allIDs[c.ID] = true
+	}
+	assert.Len(t, allIDs, 3)
+}

modules/structs/project.go

@@ -0,0 +1,139 @@
+// Copyright 2025 The Gitea Authors. All rights reserved.
+// SPDX-License-Identifier: MIT
+
+package structs
+
+import (
+	"time"
+)
+
+// Project represents a project
+// swagger:model
+type Project struct {
+	// Unique identifier of the project
+	ID int64 `json:"id"`
+	// Project title
+	Title string `json:"title"`
+	// Project description
+	Description string `json:"description"`
+	// Owner ID (for organization or user projects)
+	OwnerID int64 `json:"owner_id,omitempty"`
+	// Repository ID (for repository projects)
+	RepoID int64 `json:"repo_id,omitempty"`
+	// Creator ID
+	CreatorID int64 `json:"creator_id"`
+	// Whether the project is closed
+	IsClosed bool `json:"is_closed"`
+	// Template type: 0=none, 1=basic_kanban, 2=bug_triage
+	TemplateType int `json:"template_type"`
+	// Card type: 0=text_only, 1=images_and_text
+	CardType int `json:"card_type"`
+	// Project type: 1=individual, 2=repository, 3=organization
+	Type int `json:"type"`
+	// Number of open issues
+	NumOpenIssues int64 `json:"num_open_issues,omitempty"`
+	// Number of closed issues
+	NumClosedIssues int64 `json:"num_closed_issues,omitempty"`
+	// Total number of issues
+	NumIssues int64 `json:"num_issues,omitempty"`
+	// Created time
+	// swagger:strfmt date-time
+	Created time.Time `json:"created"`
+	// Updated time
+	// swagger:strfmt date-time
+	Updated time.Time `json:"updated"`
+	// Closed time
+	// swagger:strfmt date-time
+	ClosedDate *time.Time `json:"closed_date,omitempty"`
+	// Project URL
+	URL string `json:"url,omitempty"`
+}
+
+// CreateProjectOption represents options for creating a project
+// swagger:model
+type CreateProjectOption struct {
+	// required: true
+	Title string `json:"title" binding:"Required"`
+	// Project description
+	Description string `json:"description"`
+	// Template type: 0=none, 1=basic_kanban, 2=bug_triage
+	TemplateType int `json:"template_type"`
+	// Card type: 0=text_only, 1=images_and_text
+	CardType int `json:"card_type"`
+}
+
+// EditProjectOption represents options for editing a project
+// swagger:model
+type EditProjectOption struct {
+	// Project title
+	Title *string `json:"title,omitempty"`
+	// Project description
+	Description *string `json:"description,omitempty"`
+	// Card type: 0=text_only, 1=images_and_text
+	CardType *int `json:"card_type,omitempty"`
+	// Whether the project is closed
+	IsClosed *bool `json:"is_closed,omitempty"`
+}
+
+// ProjectColumn represents a project column (board)
+// swagger:model
+type ProjectColumn struct {
+	// Unique identifier of the column
+	ID int64 `json:"id"`
+	// Column title
+	Title string `json:"title"`
+	// Whether this is the default column
+	Default bool `json:"default"`
+	// Sorting order
+	Sorting int `json:"sorting"`
+	// Column color (hex format)
+	Color string `json:"color,omitempty"`
+	// Project ID
+	ProjectID int64 `json:"project_id"`
+	// Creator ID
+	CreatorID int64 `json:"creator_id"`
+	// Number of issues in this column
+	NumIssues int64 `json:"num_issues,omitempty"`
+	// Created time
+	// swagger:strfmt date-time
+	Created time.Time `json:"created"`
+	// Updated time
+	// swagger:strfmt date-time
+	Updated time.Time `json:"updated"`
+}
+
+// CreateProjectColumnOption represents options for creating a project column
+// swagger:model
+type CreateProjectColumnOption struct {
+	// required: true
+	Title string `json:"title" binding:"Required"`
+	// Column color (hex format, e.g., #FF0000)
+	Color string `json:"color,omitempty"`
+}
+
+// EditProjectColumnOption represents options for editing a project column
+// swagger:model
+type EditProjectColumnOption struct {
+	// Column title
+	Title *string `json:"title,omitempty"`
+	// Column color (hex format)
+	Color *string `json:"color,omitempty"`
+	// Sorting order
+	Sorting *int `json:"sorting,omitempty"`
+}
+
+// MoveProjectColumnOption represents options for moving a project column
+// swagger:model
+type MoveProjectColumnOption struct {
+	// Position to move the column to (0-based index)
+	// required: true
+	Position int `json:"position" binding:"Required"`
+}
+
+// AddIssueToProjectColumnOption represents options for adding an issue to a project column
+// swagger:model
+type AddIssueToProjectColumnOption struct {
+	// Issue ID to add to the column
+	// required: true
+	IssueID int64 `json:"issue_id" binding:"Required"`
+}

routers/api/v1/api.go

@@ -1570,6 +1570,23 @@ func Routes() *web.Router {
 						Patch(reqToken(), reqRepoWriter(unit.TypeIssues, unit.TypePullRequests), bind(api.EditMilestoneOption{}), repo.EditMilestone).
 						Delete(reqToken(), reqRepoWriter(unit.TypeIssues, unit.TypePullRequests), repo.DeleteMilestone)
 				})
+				m.Group("/projects", func() {
+					m.Combo("").Get(repo.ListProjects).
+						Post(reqToken(), reqRepoWriter(unit.TypeProjects), mustNotBeArchived, bind(api.CreateProjectOption{}), repo.CreateProject)
+					m.Group("/{id}", func() {
+						m.Combo("").Get(repo.GetProject).
+							Patch(reqToken(), reqRepoWriter(unit.TypeProjects), bind(api.EditProjectOption{}), repo.EditProject).
+							Delete(reqToken(), reqRepoWriter(unit.TypeProjects), repo.DeleteProject)
+						m.Combo("/columns").Get(repo.ListProjectColumns).
+							Post(reqToken(), reqRepoWriter(unit.TypeProjects), mustNotBeArchived, bind(api.CreateProjectColumnOption{}), repo.CreateProjectColumn)
+					})
+					m.Group("/columns/{id}", func() {
+						m.Combo("").
+							Patch(reqToken(), reqRepoWriter(unit.TypeProjects), bind(api.EditProjectColumnOption{}), repo.EditProjectColumn).
+							Delete(reqToken(), reqRepoWriter(unit.TypeProjects), repo.DeleteProjectColumn)
+						m.Post("/issues", reqToken(), reqRepoWriter(unit.TypeProjects), mustNotBeArchived, bind(api.AddIssueToProjectColumnOption{}), repo.AddIssueToProjectColumn)
+					})
+				}, reqRepoReader(unit.TypeProjects))
 			}, repoAssignment(), checkTokenPublicOnly())
 		}, tokenRequiresScopes(auth_model.AccessTokenScopeCategoryIssue))