✨ API updates for platform awareness. (#874)

Filter apps on platform id: GET /applications?filter=platform.id=1

Closes #872 

Add platform to the task dashboard.

Closes #875 

Add list of manifest (refs) to application.

Closes #876 

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Applications listing API now supports server-side filtering by
platform ID.
* Applications listing now includes manifest references for each
application.
* Task dashboard responses now include platform information for each
task when available.

* **Documentation**
* API docs updated to describe the platform ID filter and the new
manifest and platform fields in responses.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

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

Author: jortel

api/application.go

@@ -7,6 +7,7 @@ import (
 	"strings"
 
 	"github.com/gin-gonic/gin"
+	qf "github.com/konveyor/tackle2-hub/api/filter"
 	"github.com/konveyor/tackle2-hub/api/jsd"
 	"github.com/konveyor/tackle2-hub/assessment"
 	"github.com/konveyor/tackle2-hub/metrics"
@@ -145,6 +146,8 @@ func (h ApplicationHandler) Get(ctx *gin.Context) {
 // List godoc
 // @summary List all applications.
 // @description List all applications.
+// @description filters:
+// @description - platform.id
 // @tags applications
 // @produce json
 // @success 200 {object} []api.Application
@@ -173,6 +176,16 @@ func (h ApplicationHandler) List(ctx *gin.Context) {
 		return
 	}
 
+	filter, err := qf.New(ctx,
+		[]qf.Assert{
+			{Field: "platform.id", Kind: qf.LITERAL},
+		})
+	if err != nil {
+		_ = ctx.Error(err)
+		return
+	}
+	filter = filter.Renamed("platform.id", "PlatformId")
+
 	type M struct {
 		*model.Application
 		IdentityId      uint
@@ -189,6 +202,7 @@ func (h ApplicationHandler) List(ctx *gin.Context) {
 		PlatformName    string
 		ReviewId        uint
 		AssessmentId    uint
+		ManifestId      uint
 		QuestionnaireId uint
 		AnalysisId      uint
 		Effort          int
@@ -210,6 +224,7 @@ func (h ApplicationHandler) List(ctx *gin.Context) {
 		"pf.Name            PlatformName",
 		"rv.ID              ReviewId",
 		"at.ID              AssessmentId",
+		"mf.ID              ManifestId",
 		"at.QuestionnaireID QuestionnaireId",
 		"an.ID              AnalysisId",
 		"an.Effort          Effort",
@@ -225,8 +240,10 @@ func (h ApplicationHandler) List(ctx *gin.Context) {
 	db = db.Joins("LEFT JOIN Platform pf ON pf.ID = a.PlatformID")
 	db = db.Joins("LEFT JOIN Review rv ON rv.ApplicationID = a.ID")
 	db = db.Joins("LEFT JOIN Assessment at ON at.ApplicationID = a.ID")
+	db = db.Joins("LEFT JOIN Manifest mf ON mf.ApplicationID = a.ID")
 	db = db.Joins("LEFT JOIN Analysis an ON an.ApplicationID = a.ID")
 	db = db.Order("a.ID")
+	db = filter.Where(db)
 	page := Page{}
 	page.With(ctx)
 	cursor := Cursor{}
@@ -236,6 +253,7 @@ func (h ApplicationHandler) List(ctx *gin.Context) {
 		identities := make(map[uint]model.Identity)
 		contributors := make(map[uint]model.Stakeholder)
 		assessments := make(map[uint]model.Assessment)
+		manifests := make(map[uint]model.Manifest)
 		analyses := make(map[uint]model.Analysis)
 		for i := range batch {
 			m := batch[i].(*M)
@@ -282,6 +300,11 @@ func (h ApplicationHandler) List(ctx *gin.Context) {
 				ref.QuestionnaireID = m.QuestionnaireId
 				assessments[m.AssessmentId] = ref
 			}
+			if m.ManifestId > 0 {
+				ref := model.Manifest{}
+				ref.ID = m.ManifestId
+				manifests[m.ManifestId] = ref
+			}
 			if m.AnalysisId > 0 {
 				ref := model.Analysis{}
 				ref.ID = m.AnalysisId
@@ -298,6 +321,9 @@ func (h ApplicationHandler) List(ctx *gin.Context) {
 		for _, m := range assessments {
 			app.Assessments = append(app.Assessments, m)
 		}
+		for _, m := range manifests {
+			app.Manifest = append(app.Manifest, m)
+		}
 		for _, m := range analyses {
 			app.Analyses = append(app.Analyses, m)
 		}
@@ -1311,6 +1337,7 @@ type Application struct {
 	Platform        *Ref          `json:"platform"`
 	Archetypes      []Ref         `json:"archetypes"`
 	Assessments     []Ref         `json:"assessments"`
+	Manifests       []Ref         `json:"manifests"`
 	Assessed        bool          `json:"assessed"`
 	Risk            string        `json:"risk"`
 	Confidence      int           `json:"confidence"`
@@ -1381,6 +1408,10 @@ func (r *Application) With(m *model.Application, tags []AppTag) {
 		})
 		r.Effort = m.Analyses[len(m.Analyses)-1].Effort
 	}
+	r.Manifests = []Ref{}
+	for _, mf := range m.Manifest {
+		r.Manifests = append(r.Manifests, Ref{ID: mf.ID})
+	}
 	r.Risk = assessment.RiskUnassessed
 }
 

api/task.go

@@ -1006,6 +1006,7 @@ type TaskDashboard struct {
 	State       string     `json:"state,omitempty" yaml:",omitempty"`
 	Locator     string     `json:"locator,omitempty" yaml:",omitempty"`
 	Application *Ref       `json:"application,omitempty" yaml:",omitempty"`
+	Platform    *Ref       `json:"platform,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"`
@@ -1019,6 +1020,7 @@ func (r *TaskDashboard) With(m *model.Task) {
 	r.State = m.State
 	r.Locator = m.Locator
 	r.Application = r.refPtr(m.ApplicationID, m.Application)
+	r.Platform = r.refPtr(m.PlatformID, m.Platform)
 	r.Started = m.Started
 	r.Terminated = m.Terminated
 	r.Errors = len(m.Errors)