// Copyright 2020 The Gitea Authors. All rights reserved. // SPDX-License-Identifier: MIT package project import ( "context" "fmt" "code.gitea.io/gitea/models/db" repo_model "code.gitea.io/gitea/models/repo" user_model "code.gitea.io/gitea/models/user" "code.gitea.io/gitea/modules/log" "code.gitea.io/gitea/modules/setting" "code.gitea.io/gitea/modules/timeutil" "code.gitea.io/gitea/modules/util" "xorm.io/builder" ) type ( // BoardConfig is used to identify the type of board that is being created BoardConfig struct { BoardType BoardType Translation string } // CardConfig is used to identify the type of board card that is being used CardConfig struct { CardType CardType Translation string } // Type is used to identify the type of project in question and ownership Type uint8 ) const ( // TypeIndividual is a type of project board that is owned by an individual TypeIndividual Type = iota + 1 // TypeRepository is a project that is tied to a repository TypeRepository // TypeOrganization is a project that is tied to an organisation TypeOrganization ) // ErrProjectNotExist represents a "ProjectNotExist" kind of error. type ErrProjectNotExist struct { ID int64 RepoID int64 } // IsErrProjectNotExist checks if an error is a ErrProjectNotExist func IsErrProjectNotExist(err error) bool { _, ok := err.(ErrProjectNotExist) return ok } func (err ErrProjectNotExist) Error() string { return fmt.Sprintf("projects does not exist [id: %d]", err.ID) } func (err ErrProjectNotExist) Unwrap() error { return util.ErrNotExist } // ErrProjectBoardNotExist represents a "ProjectBoardNotExist" kind of error. type ErrProjectBoardNotExist struct { BoardID int64 } // IsErrProjectBoardNotExist checks if an error is a ErrProjectBoardNotExist func IsErrProjectBoardNotExist(err error) bool { _, ok := err.(ErrProjectBoardNotExist) return ok } func (err ErrProjectBoardNotExist) Error() string { return fmt.Sprintf("project board does not exist [id: %d]", err.BoardID) } func (err ErrProjectBoardNotExist) Unwrap() error { return util.ErrNotExist } // Project represents a project board type Project struct { ID int64 `xorm:"pk autoincr"` Title string `xorm:"INDEX NOT NULL"` Description string `xorm:"TEXT"` OwnerID int64 `xorm:"INDEX"` Owner *user_model.User `xorm:"-"` RepoID int64 `xorm:"INDEX"` Repo *repo_model.Repository `xorm:"-"` CreatorID int64 `xorm:"NOT NULL"` IsClosed bool `xorm:"INDEX"` BoardType BoardType CardType CardType Type Type RenderedContent string `xorm:"-"` CreatedUnix timeutil.TimeStamp `xorm:"INDEX created"` UpdatedUnix timeutil.TimeStamp `xorm:"INDEX updated"` ClosedDateUnix timeutil.TimeStamp } func (p *Project) LoadOwner(ctx context.Context) (err error) { if p.Owner != nil { return nil } p.Owner, err = user_model.GetUserByID(ctx, p.OwnerID) return err } func (p *Project) LoadRepo(ctx context.Context) (err error) { if p.RepoID == 0 || p.Repo != nil { return nil } p.Repo, err = repo_model.GetRepositoryByID(ctx, p.RepoID) return err } // Link returns the project's relative URL. func (p *Project) Link() string { if p.OwnerID > 0 { err := p.LoadOwner(db.DefaultContext) if err != nil { log.Error("LoadOwner: %v", err) return "" } return fmt.Sprintf("%s/-/projects/%d", p.Owner.HomeLink(), p.ID) } if p.RepoID > 0 { err := p.LoadRepo(db.DefaultContext) if err != nil { log.Error("LoadRepo: %v", err) return "" } return fmt.Sprintf("%s/projects/%d", p.Repo.Link(), p.ID) } return "" } func (p *Project) IsOrganizationProject() bool { return p.Type == TypeOrganization } func init() { db.RegisterModel(new(Project)) } // GetBoardConfig retrieves the types of configurations project boards could have func GetBoardConfig() []BoardConfig { return []BoardConfig{ {BoardTypeNone, "repo.projects.type.none"}, {BoardTypeBasicKanban, "repo.projects.type.basic_kanban"}, {BoardTypeBugTriage, "repo.projects.type.bug_triage"}, } } // GetCardConfig retrieves the types of configurations project board cards could have func GetCardConfig() []CardConfig { return []CardConfig{ {CardTypeTextOnly, "repo.projects.card_type.text_only"}, {CardTypeImagesAndText, "repo.projects.card_type.images_and_text"}, } } // IsTypeValid checks if a project type is valid func IsTypeValid(p Type) bool { switch p { case TypeRepository, TypeOrganization: return true default: return false } } // SearchOptions are options for GetProjects type SearchOptions struct { OwnerID int64 RepoID int64 Page int IsClosed util.OptionalBool SortType string Type Type } func (opts *SearchOptions) toConds() builder.Cond { cond := builder.NewCond() if opts.RepoID > 0 { cond = cond.And(builder.Eq{"repo_id": opts.RepoID}) } switch opts.IsClosed { case util.OptionalBoolTrue: cond = cond.And(builder.Eq{"is_closed": true}) case util.OptionalBoolFalse: cond = cond.And(builder.Eq{"is_closed": false}) } if opts.Type > 0 { cond = cond.And(builder.Eq{"type": opts.Type}) } if opts.OwnerID > 0 { cond = cond.And(builder.Eq{"owner_id": opts.OwnerID}) } return cond } // CountProjects counts projects func CountProjects(ctx context.Context, opts SearchOptions) (int64, error) { return db.GetEngine(ctx).Where(opts.toConds()).Count(new(Project)) } // FindProjects returns a list of all projects that have been created in the repository func FindProjects(ctx context.Context, opts SearchOptions) ([]*Project, int64, error) { e := db.GetEngine(ctx).Where(opts.toConds()) projects := make([]*Project, 0, setting.UI.IssuePagingNum) if opts.Page > 0 { e = e.Limit(setting.UI.IssuePagingNum, (opts.Page-1)*setting.UI.IssuePagingNum) } switch opts.SortType { case "oldest": e.Desc("created_unix") case "recentupdate": e.Desc("updated_unix") case "leastupdate": e.Asc("updated_unix") default: e.Asc("created_unix") } count, err := e.FindAndCount(&projects) return projects, count, err } // NewProject creates a new Project func NewProject(p *Project) error { if !IsBoardTypeValid(p.BoardType) { p.BoardType = BoardTypeNone } if !IsCardTypeValid(p.CardType) { p.CardType = CardTypeTextOnly } if !IsTypeValid(p.Type) { return util.NewInvalidArgumentErrorf("project type is not valid") } ctx, committer, err := db.TxContext(db.DefaultContext) if err != nil { return err } defer committer.Close() if err := db.Insert(ctx, p); err != nil { return err } if p.RepoID > 0 { if _, err := db.Exec(ctx, "UPDATE `repository` SET num_projects = num_projects + 1 WHERE id = ?", p.RepoID); err != nil { return err } } if err := createBoardsForProjectsType(ctx, p); err != nil { return err } return committer.Commit() } // GetProjectByID returns the projects in a repository func GetProjectByID(ctx context.Context, id int64) (*Project, error) { p := new(Project) has, err := db.GetEngine(ctx).ID(id).Get(p) if err != nil { return nil, err } else if !has { return nil, ErrProjectNotExist{ID: id} } return p, nil } // UpdateProject updates project properties func UpdateProject(ctx context.Context, p *Project) error { if !IsCardTypeValid(p.CardType) { p.CardType = CardTypeTextOnly } _, err := db.GetEngine(ctx).ID(p.ID).Cols( "title", "description", "card_type", ).Update(p) return err } func updateRepositoryProjectCount(ctx context.Context, repoID int64) error { if _, err := db.GetEngine(ctx).Exec(builder.Update( builder.Eq{ "`num_projects`": builder.Select("count(*)").From("`project`"). Where(builder.Eq{"`project`.`repo_id`": repoID}. And(builder.Eq{"`project`.`type`": TypeRepository})), }).From("`repository`").Where(builder.Eq{"id": repoID})); err != nil { return err } if _, err := db.GetEngine(ctx).Exec(builder.Update( builder.Eq{ "`num_closed_projects`": builder.Select("count(*)").From("`project`"). Where(builder.Eq{"`project`.`repo_id`": repoID}. And(builder.Eq{"`project`.`type`": TypeRepository}). And(builder.Eq{"`project`.`is_closed`": true})), }).From("`repository`").Where(builder.Eq{"id": repoID})); err != nil { return err } return nil } // ChangeProjectStatusByRepoIDAndID toggles a project between opened and closed func ChangeProjectStatusByRepoIDAndID(repoID, projectID int64, isClosed bool) error { ctx, committer, err := db.TxContext(db.DefaultContext) if err != nil { return err } defer committer.Close() p := new(Project) has, err := db.GetEngine(ctx).ID(projectID).Where("repo_id = ?", repoID).Get(p) if err != nil { return err } else if !has { return ErrProjectNotExist{ID: projectID, RepoID: repoID} } if err := changeProjectStatus(ctx, p, isClosed); err != nil { return err } return committer.Commit() } // ChangeProjectStatus toggle a project between opened and closed func ChangeProjectStatus(p *Project, isClosed bool) error { ctx, committer, err := db.TxContext(db.DefaultContext) if err != nil { return err } defer committer.Close() if err := changeProjectStatus(ctx, p, isClosed); err != nil { return err } return committer.Commit() } func changeProjectStatus(ctx context.Context, p *Project, isClosed bool) error { p.IsClosed = isClosed p.ClosedDateUnix = timeutil.TimeStampNow() count, err := db.GetEngine(ctx).ID(p.ID).Where("repo_id = ? AND is_closed = ?", p.RepoID, !isClosed).Cols("is_closed", "closed_date_unix").Update(p) if err != nil { return err } if count < 1 { return nil } return updateRepositoryProjectCount(ctx, p.RepoID) } // DeleteProjectByID deletes a project from a repository. if it's not in a database // transaction, it will start a new database transaction func DeleteProjectByID(ctx context.Context, id int64) error { return db.WithTx(ctx, func(ctx context.Context) error { p, err := GetProjectByID(ctx, id) if err != nil { if IsErrProjectNotExist(err) { return nil } return err } if err := deleteProjectIssuesByProjectID(ctx, id); err != nil { return err } if err := deleteBoardByProjectID(ctx, id); err != nil { return err } if _, err = db.GetEngine(ctx).ID(p.ID).Delete(new(Project)); err != nil { return err } return updateRepositoryProjectCount(ctx, p.RepoID) }) } func DeleteProjectByRepoID(ctx context.Context, repoID int64) error { switch { case setting.Database.UseSQLite3: if _, err := db.GetEngine(ctx).Exec("DELETE FROM project_issue WHERE project_issue.id IN (SELECT project_issue.id FROM project_issue INNER JOIN project WHERE project.id = project_issue.project_id AND project.repo_id = ?)", repoID); err != nil { return err } if _, err := db.GetEngine(ctx).Exec("DELETE FROM project_board WHERE project_board.id IN (SELECT project_board.id FROM project_board INNER JOIN project WHERE project.id = project_board.project_id AND project.repo_id = ?)", repoID); err != nil { return err } if _, err := db.GetEngine(ctx).Table("project").Where("repo_id = ? ", repoID).Delete(&Project{}); err != nil { return err } case setting.Database.UsePostgreSQL: if _, err := db.GetEngine(ctx).Exec("DELETE FROM project_issue USING project WHERE project.id = project_issue.project_id AND project.repo_id = ? ", repoID); err != nil { return err } if _, err := db.GetEngine(ctx).Exec("DELETE FROM project_board USING project WHERE project.id = project_board.project_id AND project.repo_id = ? ", repoID); err != nil { return err } if _, err := db.GetEngine(ctx).Table("project").Where("repo_id = ? ", repoID).Delete(&Project{}); err != nil { return err } default: if _, err := db.GetEngine(ctx).Exec("DELETE project_issue FROM project_issue INNER JOIN project ON project.id = project_issue.project_id WHERE project.repo_id = ? ", repoID); err != nil { return err } if _, err := db.GetEngine(ctx).Exec("DELETE project_board FROM project_board INNER JOIN project ON project.id = project_board.project_id WHERE project.repo_id = ? ", repoID); err != nil { return err } if _, err := db.GetEngine(ctx).Table("project").Where("repo_id = ? ", repoID).Delete(&Project{}); err != nil { return err } } return updateRepositoryProjectCount(ctx, repoID) }