✨ Add task dashboard report. (#720)

Better support succeeded with errors.

closes #725 

needed by: konveyor/tackle2-ui#1997

Example:
GET /tasks/report/dashboard
```
- id: 7
  createUser: admin.noauth
  createTime: 2024-07-15T15:35:53.198405073Z
  name: Daytrader7.1.windup
  kind: analyzer
  addon: analyzer
  state: Succeeded
  application:
    id: 1
    name: Daytrader7
  started: 2024-07-15T15:35:53.514805251Z
  terminated: 2024-07-15T15:39:40.54619695Z
- id: 8
  createTime: 2024-07-15T18:29:25.26836735Z
  name: Daytrader8-
  kind: language-discovery
  addon: language-discovery
  state: Failed
  application:
    id: 2
    name: Daytrader8
  started: 2024-07-15T18:29:25.648121267Z
  terminated: 2024-07-15T18:29:29.798022283Z
  errors: 1
- id: 9
  createTime: 2024-07-15T18:29:25.26883083Z
  name: Daytrader8-
  kind: tech-discovery
  addon: tech-discovery
  state: Failed
  application:
    id: 2
    name: Daytrader8
  started: 2024-07-15T18:29:29.798635671Z
  terminated: 2024-07-15T18:29:32.944556989Z
  errors: 1
```

Signed-off-by: Jeff Ortel <[email protected]>

Author: jortel

api/task.go

@@ -21,16 +21,17 @@ import (
 
 // Routes
 const (
-	TasksRoot             = "/tasks"
-	TasksReportRoot       = TasksRoot + "/report"
-	TasksReportQueueRoot  = TasksReportRoot + "/queue"
-	TaskRoot              = TasksRoot + "/:" + ID
-	TaskReportRoot        = TaskRoot + "/report"
-	TaskAttachedRoot      = TaskRoot + "/attached"
-	TaskBucketRoot        = TaskRoot + "/bucket"
-	TaskBucketContentRoot = TaskBucketRoot + "/*" + Wildcard
-	TaskSubmitRoot        = TaskRoot + "/submit"
-	TaskCancelRoot        = TaskRoot + "/cancel"
+	TasksRoot                = "/tasks"
+	TasksReportRoot          = TasksRoot + "/report"
+	TasksReportQueueRoot     = TasksReportRoot + "/queue"
+	TasksReportDashboardRoot = TasksReportRoot + "/dashboard"
+	TaskRoot                 = TasksRoot + "/:" + ID
+	TaskReportRoot           = TaskRoot + "/report"
+	TaskAttachedRoot         = TaskRoot + "/attached"
+	TaskBucketRoot           = TaskRoot + "/bucket"
+	TaskBucketContentRoot    = TaskBucketRoot + "/*" + Wildcard
+	TaskSubmitRoot           = TaskRoot + "/submit"
+	TaskCancelRoot           = TaskRoot + "/cancel"
 )
 
 const (
@@ -54,6 +55,7 @@ func (h TaskHandler) AddRoutes(e *gin.Engine) {
 	routeGroup.PATCH(TaskRoot, Transaction, h.Update)
 	routeGroup.DELETE(TaskRoot, h.Delete)
 	routeGroup.GET(TasksReportQueueRoot, h.Queued)
+	routeGroup.GET(TasksReportDashboardRoot, h.Dashboard)
 	// Actions
 	routeGroup.PUT(TaskSubmitRoot, Transaction, h.Submit)
 	routeGroup.PUT(TaskCancelRoot, h.Cancel)
@@ -181,6 +183,7 @@ func (h TaskHandler) List(ctx *gin.Context) {
 	db := h.DB(ctx)
 	db = db.Model(&model.Task{})
 	db = db.Joins("Application")
+	db = db.Joins("Report")
 	db = sort.Sorted(db)
 	db = filter.Where(db)
 	var m model.Task
@@ -272,6 +275,83 @@ func (h TaskHandler) Queued(ctx *gin.Context) {
 	h.Respond(ctx, http.StatusOK, r)
 }
 
+// Dashboard godoc
+// @summary List all task dashboard resources.
+// @description List all task dashboard resources.
+// @description Filters:
+// @description - kind
+// @description - createUser
+// @description - addon
+// @description - name
+// @description - locator
+// @description - state
+// @description - application.id
+// @description - application.name
+// @tags tasks
+// @produce json
+// @success 200 {object} []api.TaskDashboard
+// @router /tasks [get]
+func (h TaskHandler) Dashboard(ctx *gin.Context) {
+	resources := []TaskDashboard{}
+	// filter
+	filter, err := qf.New(ctx,
+		[]qf.Assert{
+			{Field: "id", Kind: qf.LITERAL},
+			{Field: "createUser", Kind: qf.STRING},
+			{Field: "kind", Kind: qf.STRING},
+			{Field: "addon", Kind: qf.STRING},
+			{Field: "name", Kind: qf.STRING},
+			{Field: "locator", Kind: qf.STRING},
+			{Field: "state", Kind: qf.STRING},
+			{Field: "application.id", Kind: qf.STRING},
+			{Field: "application.name", Kind: qf.STRING},
+		})
+	if err != nil {
+		_ = ctx.Error(err)
+		return
+	}
+	filter = filter.Renamed("application.id", "application__id")
+	filter = filter.Renamed("application.name", "application__name")
+	filter = filter.Renamed("createUser", "task\\.createUser")
+	filter = filter.Renamed("id", "task\\.id")
+	filter = filter.Renamed("name", "task\\.name")
+	// sort
+	sort := Sort{}
+	sort.Add("task.id", "id")
+	sort.Add("task.createUser", "createUser")
+	sort.Add("task.name", "name")
+	sort.Add("application__id", "application.id")
+	sort.Add("application__name", "application.name")
+	err = sort.With(ctx, &model.Task{})
+	if err != nil {
+		_ = ctx.Error(err)
+		return
+	}
+	// Fetch
+	db := h.DB(ctx)
+	db = db.Model(&model.Task{})
+	db = db.Joins("Application")
+	db = db.Joins("Report")
+	db = sort.Sorted(db)
+	db = filter.Where(db)
+	var list []model.Task
+	page := Page{}
+	page.With(ctx)
+	err = db.Find(&list).Error
+	if err != nil {
+		_ = ctx.Error(err)
+		return
+	}
+	for i := range list {
+		m := &list[i]
+		r := TaskDashboard{}
+		r.With(m)
+		resources = append(resources, r)
+	}
+
+	h.Respond(ctx, http.StatusOK, resources)
+}
+
 // Create godoc
 // @summary Create a task.
 // @description Create a task.
@@ -496,6 +576,7 @@ func (h TaskHandler) CreateReport(ctx *gin.Context) {
 	report := &TaskReport{}
 	err := h.Bind(ctx, report)
 	if err != nil {
+		_ = ctx.Error(err)
 		return
 	}
 	report.TaskID = id
@@ -827,3 +908,30 @@ type TaskQueue struct {
 	Pending   int `json:"pending"`
 	Running   int `json:"running"`
 }
+
+// TaskDashboard report.
+type TaskDashboard struct {
+	Resource    `yaml:",inline"`
+	Name        string     `json:"name,omitempty" yaml:",omitempty"`
+	Kind        string     `json:"kind,omitempty" yaml:",omitempty"`
+	Addon       string     `json:"addon,omitempty" yaml:",omitempty"`
+	State       string     `json:"state,omitempty" yaml:",omitempty"`
+	Locator     string     `json:"locator,omitempty" yaml:",omitempty"`
+	Application *Ref       `json:"application,omitempty" yaml:",omitempty"`
+	Started     *time.Time `json:"started,omitempty" yaml:",omitempty"`
+	Terminated  *time.Time `json:"terminated,omitempty" yaml:",omitempty"`
+	Errors      int        `json:"errors,omitempty" yaml:",omitempty"`
+}
+
+func (r *TaskDashboard) With(m *model.Task) {
+	r.Resource.With(&m.Model)
+	r.Name = m.Name
+	r.Kind = m.Kind
+	r.Addon = m.Addon
+	r.State = m.State
+	r.Locator = m.Locator
+	r.Application = r.refPtr(m.ApplicationID, m.Application)
+	r.Started = m.Started
+	r.Terminated = m.Terminated
+	r.Errors = len(m.Errors)
+}