Janady13/missionmatch / internal/modules/staffing/dto.go

Source identity

Field	Recorded value
Source type	GitHub source
Original record	Janady13/missionmatch / internal/modules/staffing/dto.go
Date	Not specified in source
Repository	Janady13/missionmatch
Revision	720d47fae476b0d38477ae4401697d372b1ea2bc
Branch	feature/opportunity-to-outcome
Path or archive member	internal/modules/staffing/dto.go
Original SHA-256	f4af2fd338aac113b61d5cfa74de18a6c4ee5f81d4ba7852a65b91122a6d0e77
Git blob SHA	a3474504b7086e3a24d1fea8ee99bb6f51934e81
Reading-copy SHA-256	f4af2fd338aac113b61d5cfa74de18a6c4ee5f81d4ba7852a65b91122a6d0e77

Original source ↗

Every recorded occurrence

These 24 records contain identical original source bytes. Their paths and revisions remain part of the archive.

Original record	Branch or archive	Revision / identifier	Original location
Janady13/missionmatch / internal/modules/staffing/dto.go	feature/opportunity-to-outcome	720d47fae476b0d38477ae4401697d372b1ea2bc	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	per-tenant-routing	9bde0f9a74b89d01980fa658e5253acda7528d0c	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	collision-deconfliction	4ee5a09972608ed89f8377c6665542d5f450f0a6	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	ws6-retrieval	6c56e29231ec05735927fa265c97d517499dfeaf	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	m5-price-to-win	41000ad30fff4129fdaf5ec84e15ba14c27d4890	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	ws1-ontology-sync	b596f449a32a1016fbd403c36505cc00a1ac9ee6	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	master	1e9249840a4302ec82e123b9c9cb6f75badea3e4	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	ws8-teaching-loop	c823f0fb6bb2aba0f39001eb6de96f4000d9321f	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	w3-ai-staffing-recommendations	43d56387270ef4da4cabd794d97ca6a49909bc7d	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	mag-substrate	b82c7100a492dec67dfd1eda6b3f53def859be35	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	ws3-clearance	4b8e7ce594c068621867f9c9deed0ec64ae6c553	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	phase2-eval-fairness	d361af254701975fe239927656ababb56374655e	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	time-to-fill-survival	b66e1e505863d4f17741a4b9ede73509e45bd6c6	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	graphrag-foundation	b0ddeb9f633fd138d09309d1a17b7d13bc3a67f7	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	deploy-and-ops	bdacd9d0b4d5998d25fc74bf4007f4c3ec538c7a	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	ws9-bench-ingestion	f585a9ef32fa554663ce1fba9a414a54b6e49cf0	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	ws2-alias-relationship	e4dada4601c6eb101830f9d223a9655dfa120616	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	presentation-readiness	eb574acaa29d71ce4d0f852572e87c275c79fdb7	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	vendor-intelligence	fe9796a19c261951d3f2565206c0c1b5ac294465	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	ws7-federal-signal	6a9f6ce9cfb13345ffb47770d4960e7c2d9c17c2	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	ai-brain-live	aac32fc49c878cc5bca099459307611562d0bac1	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	phase2-connectors	e038d4c687aec16f8bd9bc4d907eea14d91f8704	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	feature/aioe-upgrade	2178e7298d0e5d9af83afa12402fd587f0ba6ed8	Open original
Janady13/missionmatch / internal/modules/staffing/dto.go	capture-readiness	bae6af7cb2997e819174a9e9cfff5e16067a1975	Open original

Recovered source transcript

Download complete source text ↓134 lines · 4.7 KB

package staffing

import (
	"encoding/json"
	"time"

	"github.com/missionworkforce/missionmatch/internal/platform/database/dbgen"
)

// The wire contract for the W3 endpoints. This is the backend interface handoff the future frontend
// consumes; the decision fields mirror slate_members so the existing approve and reject UI carries over.

// GapRequest is the body of POST /recommendations/gap/{requirementID}. Both fields are optional per run
// overrides; the values actually used are recorded in the run's parameters.
type GapRequest struct {
	StaffingFloor      *string `json:"staffing_floor,omitempty"`      // decimal string in [0,100]; default 75
	AdjacencyThreshold *string `json:"adjacency_threshold,omitempty"` // decimal string in [0,2]; default 0.40
}

// PortfolioRequest is the body of POST /recommendations/portfolio. RequirementIDs is an optional explicit
// subset; when empty the portfolio uses ALL open requirements.
type PortfolioRequest struct {
	RequirementIDs     []string `json:"requirement_ids,omitempty"`
	StaffingFloor      *string  `json:"staffing_floor,omitempty"`
	AdjacencyThreshold *string  `json:"adjacency_threshold,omitempty"`
}

// DecisionRequest is the body of POST /recommendations/{recommendationID}/decision.
type DecisionRequest struct {
	Decision string `json:"decision"` // approved | rejected | dismissed
	Note     string `json:"note,omitempty"`
}

// RunView is the run metadata.
type RunView struct {
	ID           string          `json:"id"`
	View         string          `json:"view"`
	ScopeRef     string          `json:"scope_ref,omitempty"`
	ModelVersion string          `json:"model_version"`
	Parameters   json.RawMessage `json:"parameters"`
	CreatedAt    string          `json:"created_at"`
}

// RecommendationView is one recommendation on the wire.
type RecommendationView struct {
	ID              string          `json:"id"`
	RunID           string          `json:"run_id"`
	RequirementID   string          `json:"requirement_id"`
	CandidateID     string          `json:"candidate_id,omitempty"`
	Action          string          `json:"action"`
	Rank            int             `json:"rank"`
	Confidence      string          `json:"confidence"`
	ValueScore      *int64          `json:"value_score,omitempty"`
	Rationale       string          `json:"rationale"`
	RationaleSource string          `json:"rationale_source"`
	Evidence        json.RawMessage `json:"evidence"`
	Status          string          `json:"status"`
	DecidedBy       string          `json:"decided_by,omitempty"`
	DecidedAt       string          `json:"decided_at,omitempty"`
	DecisionNote    string          `json:"decision_note,omitempty"`
	CreatedAt       string          `json:"created_at"`
}

// RunResponse is the generating endpoints' result: the run plus its recommendations in rank order.
type RunResponse struct {
	Run             RunView              `json:"run"`
	Recommendations []RecommendationView `json:"recommendations"`
}

// ProactiveResponse is the bench watch: the current pending proactive recommendations, paginated.
type ProactiveResponse struct {
	Recommendations []RecommendationView `json:"recommendations"`
	Limit           int                  `json:"limit"`
	Offset          int                  `json:"offset"`
}

func runView(r dbgen.RecommendationRun) RunView {
	v := RunView{
		ID:           r.ID.String(),
		View:         r.View,
		ModelVersion: r.ModelVersion,
		Parameters:   json.RawMessage(r.Parameters),
		CreatedAt:    r.CreatedAt.Format(time.RFC3339),
	}
	if r.ScopeRef != nil {
		v.ScopeRef = r.ScopeRef.String()
	}
	if len(v.Parameters) == 0 {
		v.Parameters = json.RawMessage("{}")
	}
	return v
}

func recommendationView(r dbgen.StaffingRecommendation) RecommendationView {
	v := RecommendationView{
		ID:              r.ID.String(),
		RunID:           r.RunID.String(),
		RequirementID:   r.RequirementID.String(),
		Action:          r.Action,
		Rank:            int(r.Rank),
		Confidence:      r.Confidence.String(),
		ValueScore:      r.ValueScore,
		Rationale:       r.Rationale,
		RationaleSource: r.RationaleSource,
		Evidence:        json.RawMessage(r.Evidence),
		Status:          r.Status,
		CreatedAt:       r.CreatedAt.Format(time.RFC3339),
	}
	if r.CandidateID != nil {
		v.CandidateID = r.CandidateID.String()
	}
	if r.DecidedBy != nil {
		v.DecidedBy = r.DecidedBy.String()
	}
	if r.DecidedAt != nil {
		v.DecidedAt = r.DecidedAt.Format(time.RFC3339)
	}
	if r.DecisionNote != nil {
		v.DecisionNote = *r.DecisionNote
	}
	if len(v.Evidence) == 0 {
		v.Evidence = json.RawMessage("{}")
	}
	return v
}

func recommendationViews(rows []dbgen.StaffingRecommendation) []RecommendationView {
	out := make([]RecommendationView, len(rows))
	for i, r := range rows {
		out[i] = recommendationView(r)
	}
	return out
}