Rename project board -> column to make the UI less confusing

docs/content/administration/config-cheat-sheet.en-us.md

@@ -828,7 +828,7 @@ and
 
 ## Project (`project`)
 
-Default templates for project boards:
+Default templates for project board view:
 
 - `PROJECT_BOARD_BASIC_KANBAN_TYPE`: **To Do, In Progress, Done**
 - `PROJECT_BOARD_BUG_TRIAGE_TYPE`: **Needs Triage, High Priority, Low Priority, Closed**

docs/content/index.en-us.md

@@ -37,7 +37,7 @@ You can try it out using [the online demo](https://try.gitea.io/).
 
 - CI/CD: Gitea Actions supports CI/CD functionality, compatible with GitHub Actions. Users can write workflows in familiar YAML format and reuse a variety of existing Actions plugins. Actions plugins support downloading from any Git website.
 
-- Project Management: Gitea tracks project requirements, features, and bugs through boards and issues. Issues support features like branches, tags, milestones, assignments, time tracking, due dates, dependencies, and more.
+- Project Management: Gitea tracks project requirements, features, and bugs through columns and issues. Issues support features like branches, tags, milestones, assignments, time tracking, due dates, dependencies, and more.
 
 - Artifact Repository: Gitea supports over 20 different types of public or private software package management, including Cargo, Chef, Composer, Conan, Conda, Container, Helm, Maven, npm, NuGet, Pub, PyPI, RubyGems, Vagrant, and more.
 

docs/content/installation/comparison.en-us.md

@@ -104,7 +104,7 @@ _Symbols used in table:_
 | Comment reactions | ✓ | ✘ | ✓ | ✓ | ✓ | ✘ | ✘ | ✘ |
 | Lock Discussion | ✓ | ✘ | ✓ | ✓ | ✓ | ✘ | ✘ | ✘ |
 | Batch issue handling | ✓ | ✘ | ✓ | ✓ | ✓ | ✘ | ✘ | ✘ |
-| Issue Boards (Kanban) | [/](https://github.com/go-gitea/gitea/issues/14710) | ✘ | ✘ | ✓ | ✓ | ✘ | ✘ | ✘ |
+| Projects  | [/](https://github.com/go-gitea/gitea/issues/14710) | ✘ | ✘ | ✓ | ✓ | ✘ | ✘ | ✘ |
 | Create branch from issue | [✘](https://github.com/go-gitea/gitea/issues/20226) | ✘ | ✘ | ✓ | ✓ | ✘ | ✘ | ✘ |
 | Convert comment to new issue | ✓ | ✘ | ✓ | ✓ | ✓ | ✘ | ✘ | ✘ |
 | Issue search | ✓ | ✘ | ✓ | ✓ | ✓ | ✓ | ✘ | ✘ |

docs/content/usage/permissions.en-us.md

@@ -48,7 +48,7 @@ With different permissions, people could do different things with these units.
 | Wiki | View wiki pages. Clone the wiki repository. | Create/Edit wiki pages, push | - |
 | ExternalWiki | Link to an external wiki | - | - |
 | ExternalTracker | Link to an external issue tracker | - | - |
-| Projects | View the boards   | Change issues across boards  | - |
+| Projects | View the columns of projects | Change issues across columns | - |
 | Packages | View the packages | Upload/Delete packages | - |
 | Actions | View the Actions logs | Approve / Cancel / Restart | - |
 | Settings | - | - | Manage the repository |

models/activities/statistic.go

@@ -30,7 +30,7 @@ type Statistic struct {
  Mirror, Release, AuthSource, Webhook,
  Milestone, Label, HookTask,
  Team, UpdateTask, Project,
- ProjectBoard, Attachment,
+ ProjectColumn, Attachment,
  Branches, Tags, CommitStatus int64
  IssueByLabel []IssueByLabelCount
  IssueByRepository []IssueByRepositoryCount
@@ -115,6 +115,6 @@ func GetStatistic(ctx context.Context) (stats Statistic) {
  stats.Counter.Team, _ = e.Count(new(organization.Team))
  stats.Counter.Attachment, _ = e.Count(new(repo_model.Attachment))
  stats.Counter.Project, _ = e.Count(new(project_model.Project))
- stats.Counter.ProjectBoard, _ = e.Count(new(project_model.Board))
+ stats.Counter.ProjectColumn, _ = e.Count(new(project_model.Column))
  return stats
 }

models/issues/comment.go

@@ -100,8 +100,8 @@ const (
  CommentTypeMergePull // 28 merge pull request
  CommentTypePullRequestPush // 29 push to PR head branch
 
- CommentTypeProject // 30 Project changed
- CommentTypeProjectBoard // 31 Project board changed
+ CommentTypeProject  // 30 Project changed
+ CommentTypeProjectColumn // 31 Project column changed
 
  CommentTypeDismissReview // 32 Dismiss Review
 
@@ -146,7 +146,7 @@ var commentStrings = []string{
  "merge_pull",
  "pull_push",
  "project",
- "project_board",
+ "project_board", // FIXME: the name should be project_column
  "dismiss_review",
  "change_issue_ref",
  "pull_scheduled_merge",

models/issues/issue_project.go

@@ -37,32 +37,32 @@ func (issue *Issue) projectID(ctx context.Context) int64 {
  return ip.ProjectID
 }
 
-// ProjectBoardID return project board id if issue was assigned to one
-func (issue *Issue) ProjectBoardID(ctx context.Context) int64 {
+// ProjectColumnID return project column id if issue was assigned to one
+func (issue *Issue) ProjectColumnID(ctx context.Context) int64 {
  var ip project_model.ProjectIssue
  has, err := db.GetEngine(ctx).Where("issue_id=?", issue.ID).Get(&ip)
  if err != nil || !has {
  return 0
  }
- return ip.ProjectBoardID
+ return ip.ProjectColumnID
 }
 
-// LoadIssuesFromBoard load issues assigned to this board
-func LoadIssuesFromBoard(ctx context.Context, b *project_model.Board) (IssueList, error) {
+// LoadIssuesFromColumn load issues assigned to this column
+func LoadIssuesFromColumn(ctx context.Context, b *project_model.Column) (IssueList, error) {
  issueList, err := Issues(ctx, &IssuesOptions{
- ProjectBoardID: b.ID,
- ProjectID: b.ProjectID,
- SortType: "project-column-sorting",
+ ProjectColumnID: b.ID,
+ ProjectID:  b.ProjectID,
+ SortType:  "project-column-sorting",
  })
  if err != nil {
  return nil, err
  }
 
  if b.Default {
  issues, err := Issues(ctx, &IssuesOptions{
- ProjectBoardID: db.NoConditionID,
- ProjectID: b.ProjectID,
- SortType: "project-column-sorting",
+ ProjectColumnID: db.NoConditionID,
+ ProjectID:  b.ProjectID,
+ SortType:  "project-column-sorting",
  })
  if err != nil {
  return nil, err
@@ -77,11 +77,11 @@ func LoadIssuesFromBoard(ctx context.Context, b *project_model.Board) (IssueList
  return issueList, nil
 }
 
-// LoadIssuesFromBoardList load issues assigned to the boards
-func LoadIssuesFromBoardList(ctx context.Context, bs project_model.BoardList) (map[int64]IssueList, error) {
+// LoadIssuesFromColumnList load issues assigned to the columns
+func LoadIssuesFromColumnList(ctx context.Context, bs project_model.ColumnList) (map[int64]IssueList, error) {
  issuesMap := make(map[int64]IssueList, len(bs))
  for i := range bs {
- il, err := LoadIssuesFromBoard(ctx, bs[i])
+ il, err := LoadIssuesFromColumn(ctx, bs[i])
  if err != nil {
  return nil, err
  }
@@ -110,7 +110,7 @@ func IssueAssignOrRemoveProject(ctx context.Context, issue *Issue, doer *user_mo
  return util.NewPermissionDeniedErrorf("issue %d can't be accessed by project %d", issue.ID, newProject.ID)
  }
  if newColumnID == 0 {
- newDefaultColumn, err := newProject.GetDefaultBoard(ctx)
+ newDefaultColumn, err := newProject.GetDefaultColumn(ctx)
  if err != nil {
  return err
  }
@@ -153,10 +153,10 @@ func IssueAssignOrRemoveProject(ctx context.Context, issue *Issue, doer *user_mo
  }
  newSorting := util.Iif(res.IssueCount > 0, res.MaxSorting+1, 0)
  return db.Insert(ctx, &project_model.ProjectIssue{
- IssueID: issue.ID,
- ProjectID: newProjectID,
- ProjectBoardID: newColumnID,
- Sorting: newSorting,
+ IssueID:  issue.ID,
+ ProjectID:  newProjectID,
+ ProjectColumnID: newColumnID,
+ Sorting:  newSorting,
  })
  })
 }

models/issues/issue_search.go

@@ -33,7 +33,7 @@ type IssuesOptions struct { //nolint
  SubscriberID int64
  MilestoneIDs []int64
  ProjectID int64
- ProjectBoardID  int64
+ ProjectColumnID int64
  IsClosed optional.Option[bool]
  IsPull optional.Option[bool]
  LabelIDs []int64
@@ -169,12 +169,12 @@ func applyProjectCondition(sess *xorm.Session, opts *IssuesOptions) *xorm.Sessio
  return sess
 }
 
-func applyProjectBoardCondition(sess *xorm.Session, opts *IssuesOptions) *xorm.Session {
- // opts.ProjectBoardID == 0 means all project boards,
+func applyProjectColumnCondition(sess *xorm.Session, opts *IssuesOptions) *xorm.Session {
+ // opts.ProjectColumnID == 0 means all project columns,
  // do not need to apply any condition
- if opts.ProjectBoardID > 0 {
- sess.In("issue.id", builder.Select("issue_id").From("project_issue").Where(builder.Eq{"project_board_id": opts.ProjectBoardID}))
- } else if opts.ProjectBoardID == db.NoConditionID {
+ if opts.ProjectColumnID > 0 {
+ sess.In("issue.id", builder.Select("issue_id").From("project_issue").Where(builder.Eq{"project_board_id": opts.ProjectColumnID}))
+ } else if opts.ProjectColumnID == db.NoConditionID {
  sess.In("issue.id", builder.Select("issue_id").From("project_issue").Where(builder.Eq{"project_board_id": 0}))
  }
  return sess
@@ -246,7 +246,7 @@ func applyConditions(sess *xorm.Session, opts *IssuesOptions) *xorm.Session {
 
  applyProjectCondition(sess, opts)
 
- applyProjectBoardCondition(sess, opts)
+ applyProjectColumnCondition(sess, opts)
 
  if opts.IsPull.Has() {
  sess.And("issue.is_pull=?", opts.IsPull.Value())

models/migrations/v1_22/v293_test.go

@@ -15,30 +15,30 @@ import (
 
 func Test_CheckProjectColumnsConsistency(t *testing.T) {
  // Prepare and load the testing database
- x, deferable := base.PrepareTestEnv(t, 0, new(project.Project), new(project.Board))
+ x, deferable := base.PrepareTestEnv(t, 0, new(project.Project), new(project.Column))
  defer deferable()
  if x == nil || t.Failed() {
  return
  }
 
  assert.NoError(t, CheckProjectColumnsConsistency(x))
 
- // check if default board was added
- var defaultBoard project.Board
- has, err := x.Where("project_id=? AND `default` = ?", 1, true).Get(&defaultBoard)
+ // check if default column was added
+ var defaultColumn project.Column
+ has, err := x.Where("project_id=? AND `default` = ?", 1, true).Get(&defaultColumn)
  assert.NoError(t, err)
  assert.True(t, has)
- assert.Equal(t, int64(1), defaultBoard.ProjectID)
- assert.True(t, defaultBoard.Default)
+ assert.Equal(t, int64(1), defaultColumn.ProjectID)
+ assert.True(t, defaultColumn.Default)
 
  // check if multiple defaults, previous were removed and last will be kept
- expectDefaultBoard, err := project.GetBoard(db.DefaultContext, 2)
+ expectDefaultColumn, err := project.GetColumn(db.DefaultContext, 2)
  assert.NoError(t, err)
- assert.Equal(t, int64(2), expectDefaultBoard.ProjectID)
- assert.False(t, expectDefaultBoard.Default)
+ assert.Equal(t, int64(2), expectDefaultColumn.ProjectID)
+ assert.False(t, expectDefaultColumn.Default)
 
- expectNonDefaultBoard, err := project.GetBoard(db.DefaultContext, 3)
+ expectNonDefaultColumn, err := project.GetColumn(db.DefaultContext, 3)
  assert.NoError(t, err)
- assert.Equal(t, int64(2), expectNonDefaultBoard.ProjectID)
- assert.True(t, expectNonDefaultBoard.Default)
+ assert.Equal(t, int64(2), expectNonDefaultColumn.ProjectID)
+ assert.True(t, expectNonDefaultColumn.Default)
 }