feat: api endpoints for projects

models/project/project.go

@@ -91,6 +91,7 @@ type Project struct {
 	RepoID       int64                  `xorm:"INDEX"`
 	Repo         *repo_model.Repository `xorm:"-"`
 	CreatorID    int64                  `xorm:"NOT NULL"`
+	Creator      *user_model.User       `xorm:"-"`
 	IsClosed     bool                   `xorm:"INDEX"`
 	TemplateType TemplateType           `xorm:"'board_type'"` // TODO: rename the column to template_type
 	CardType     CardType
@@ -118,6 +119,14 @@ func (p *Project) LoadOwner(ctx context.Context) (err error) {
 	return err
 }
 
+func (p *Project) LoadCreator(ctx context.Context) (err error) {
+	if p.Creator != nil {
+		return nil
+	}
+	p.Creator, err = user_model.GetUserByID(ctx, p.CreatorID)
+	return err
+}
+
 func (p *Project) LoadRepo(ctx context.Context) (err error) {
 	if p.RepoID == 0 || p.Repo != nil {
 		return nil

modules/structs/project.go

@@ -0,0 +1,43 @@
+// Copyright 2023 The Gitea Authors. All rights reserved.
+// SPDX-License-Identifier: MIT
+
+package structs
+
+import "time"
+
+// swagger:model
+type NewProjectPayload struct {
+	// required:true
+	Title string `json:"title"       binding:"Required"`
+	// required:true
+	BoardType uint8 `json:"board_type"`
+	// required:true
+	CardType    uint8  `json:"card_type"`
+	Description string `json:"description"`
+}
+
+// swagger:model
+type UpdateProjectPayload struct {
+	// required:true
+	Title       string `json:"title"       binding:"Required"`
+	Description string `json:"description"`
+}
+
+// swagger:model
+type Project struct {
+	ID           int64  `json:"id"`
+	Title        string `json:"title"`
+	Description  string `json:"description"`
+	TemplateType uint8  `json:"board_type"`
+	IsClosed     bool   `json:"is_closed"`
+	// swagger:strfmt date-time
+	Created time.Time `json:"created_at"`
+	// swagger:strfmt date-time
+	Updated time.Time `json:"updated_at"`
+	// swagger:strfmt date-time
+	Closed time.Time `json:"closed_at"`
+
+	Repo    *RepositoryMeta `json:"repository"`
+	Creator *User           `json:"creator"`
+	Owner   *User           `json:"owner"`
+}

routers/api/v1/api.go

@@ -89,6 +89,7 @@ import (
 	"code.gitea.io/gitea/routers/api/v1/notify"
 	"code.gitea.io/gitea/routers/api/v1/org"
 	"code.gitea.io/gitea/routers/api/v1/packages"
+	"code.gitea.io/gitea/routers/api/v1/projects"
 	"code.gitea.io/gitea/routers/api/v1/repo"
 	"code.gitea.io/gitea/routers/api/v1/settings"
 	"code.gitea.io/gitea/routers/api/v1/user"
@@ -1454,6 +1455,10 @@ 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(projects.ListRepoProjects).
+						Post(bind(api.NewProjectPayload{}), projects.CreateRepoProject)
+				}, mustEnableIssues)
 			}, repoAssignment())
 		}, tokenRequiresScopes(auth_model.AccessTokenScopeCategoryIssue))
 
@@ -1598,6 +1603,11 @@ func Routes() *web.Router {
 			})
 		}, tokenRequiresScopes(auth_model.AccessTokenScopeCategoryAdmin), reqToken(), reqSiteAdmin())
 
+		m.Group("/projects", func() {
+			m.Combo("/{id}").Get(projects.GetProject).
+				Patch(bind(api.UpdateProjectPayload{}), projects.UpdateProject).
+				Delete(projects.DeleteProject)
+		}, tokenRequiresScopes(auth_model.AccessTokenScopeCategoryIssue), reqToken())
 		m.Group("/topics", func() {
 			m.Get("/search", repo.TopicSearch)
 		}, tokenRequiresScopes(auth_model.AccessTokenScopeCategoryRepository))