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

1// Package commandcenter computes the Workforce Command Center™ executive dashboard, an org-level, 2// RLS-scoped, set-based COVERAGE rollup answering "Can we staff this mission today?". It adds NO new 3// per-candidate scoring; it reuses the engine's clearance ordinals + effective-status rule (via the 4// mm_lvl_ord/mm_poly_ord SQL functions, locked to the engine by test) and the persisted slate bands. 5// All math is shopspring/decimal; every aggregate runs inside one tenant transaction. 6package commandcenter 7 8// View is the full GET /api/command-center payload. 9type View struct { 10 AsOf string `json:"as_of"` 11 OrganizationID string `json:"organization_id"` 12 GeneratedAt string `json:"generated_at"` 13 Meta Meta `json:"meta"` 14 Banner Banner `json:"banner"` 15 MissionReadiness MissionReadiness `json:"mission_readiness"` 16 ActiveOpportunities []Opportunity `json:"active_opportunities"` 17 StaffingGaps []Gap `json:"staffing_gaps"` 18 ClearanceIntelligence ClearanceIntel `json:"clearance_intelligence"` 19 LaborCategoryCoverage []LcatCoverage `json:"labor_category_coverage"` 20 ProposalReadiness ProposalReadiness `json:"proposal_readiness"` 21 WinImpact WinImpact `json:"win_impact"` 22 HeatMap []HeatMetro `json:"heat_map"` 23 UpcomingOpportunities []UpcomingOpportunity `json:"upcoming_opportunities"` 24 IncumbentLandscape []IncumbentRef `json:"incumbent_landscape"` 25 AIRecommendations []Recommendation `json:"ai_recommendations"` 26 ActionCenter ActionCenter `json:"action_center"` 27} 28 29// UpcomingOpportunity is one planning stage federal forecast surfaced beside the current readiness. It 30// is planning data subject to change and never alters the current readiness or Revenue at Risk numbers. 31// The fit is honest: AvailableClearedInState is a real bench count, and the comparable requirement 32// coverage is the engine backed eligibility of the org's similar requirements (no parallel scoring). A 33// bare forecast carries no skills, so there is no precise match score; FitNote states this plainly. 34type UpcomingOpportunity struct { 35 RecordID string `json:"record_id"` 36 Title string `json:"title"` 37 Agency string `json:"agency"` 38 NAICS string `json:"naics,omitempty"` 39 PlaceOfPerformance string `json:"place_of_performance,omitempty"` 40 State string `json:"state,omitempty"` 41 SetAside string `json:"set_aside,omitempty"` 42 EstimatedValue *string `json:"estimated_value"` 43 EstimatedAwardDate string `json:"estimated_award_date,omitempty"` 44 IncumbentName string `json:"incumbent_name,omitempty"` 45 PlanningNote string `json:"planning_note"` 46 47 AvailableClearedInState int `json:"available_cleared_in_state"` 48 ComparableRequirements int `json:"comparable_requirements"` 49 ComparableCovered int `json:"comparable_covered"` 50 FitNote string `json:"fit_note"` 51 Adoptable bool `json:"adoptable"` 52} 53 54// IncumbentRef is one incumbent and award context row from the contract award feed: who holds a contract 55// in the org's domain, with the real award value and its provenance. It is competitive intelligence read 56// beside the matched workforce, never a fabricated figure. 57type IncumbentRef struct { 58 RecordID string `json:"record_id"` 59 Incumbent string `json:"incumbent"` 60 IncumbentUEI string `json:"incumbent_uei,omitempty"` 61 Agency string `json:"agency"` 62 NAICS string `json:"naics,omitempty"` 63 Value *string `json:"value"` 64 ValueSource string `json:"value_source,omitempty"` 65 AwardDate string `json:"award_date,omitempty"` 66 Source string `json:"source"` 67} 68 69type Meta struct { 70 Empty bool `json:"empty"` 71 Notes []string `json:"notes"` 72} 73 74type Banner struct { 75 TotalClearedWorkforce int `json:"total_cleared_workforce"` 76 AvailableCandidates int `json:"available_candidates"` 77 ProposalReadyCandidates int `json:"proposal_ready_candidates"` 78 ActiveRequirements int `json:"active_requirements"` 79 StaffingGaps int `json:"staffing_gaps"` 80 HighRiskOpportunities int `json:"high_risk_opportunities"` 81} 82 83type MissionReadiness struct { 84 Score string `json:"score"` 85 Band string `json:"band"` 86 Status string `json:"status"` 87 Drivers []Driver `json:"drivers"` 88 AvailabilityReqCoverage string `json:"availability_req_coverage"` 89 Flags []string `json:"flags"` 90} 91 92type Driver struct { 93 Key string `json:"key"` 94 Label string `json:"label"` 95 Pct string `json:"pct"` 96 State string `json:"state"` 97 Weight string `json:"weight"` 98} 99 100type Opportunity struct { 101 OpportunityID string `json:"opportunity_id"` 102 Name string `json:"name"` 103 CustomerAgency string `json:"customer_agency,omitempty"` 104 SolicitationNumber string `json:"solicitation_number,omitempty"` 105 DueDate string `json:"due_date,omitempty"` 106 Value *string `json:"value"` 107 ReadinessScore string `json:"readiness_score"` 108 TotalRequirements int `json:"total_requirements"` 109 CoveredRequirements int `json:"covered_requirements"` 110 HeadcountNeeded int `json:"headcount_needed"` 111 HeadcountCovered int `json:"headcount_covered"` 112 KeyPersonnelOpen int `json:"key_personnel_open"` 113 StaffingRisk string `json:"staffing_risk"` 114 StaffingRiskCode string `json:"staffing_risk_code"` 115} 116 117type Gap struct { 118 LaborCategory string `json:"labor_category"` 119 RequiredLevel string `json:"required_level"` 120 RequiredLevelLabel string `json:"required_level_label"` 121 Unmet int `json:"unmet"` 122 BlocksKeyPersonnel bool `json:"blocks_key_personnel"` 123 ImpactedOpportunities []string `json:"impacted_opportunities"` 124 ValueAtRisk *string `json:"value_at_risk"` 125 // W2 counted basis: how the dollar was derived, so it is auditable, not a bare sum. 126 PricedOpportunities int `json:"priced_opportunities"` // opportunities with a value (counted) 127 UnpricedOpportunities int `json:"unpriced_opportunities"` // opportunities with a null value (excluded) 128 TotalOpportunities int `json:"total_opportunities"` // priced plus unpriced 129 ValueRepresentative bool `json:"value_representative"` // true unless every priced opp is sam or usaspending 130 ValueBasis string `json:"value_basis"` // human readable counted basis line 131 // W2 modeled Mission Readiness Impact: the coverage delta from filling this gap. 132 ImpactModeledPct string `json:"impact_modeled_pct"` // points of overall coverage, decimal StringFixed(2) 133 ImpactModeledLabel string `json:"impact_modeled_label"` // modeled framing copy 134 Headline string `json:"headline"` 135 Recommendation string `json:"recommendation"` 136} 137 138type ClearanceIntel struct { 139 InventoryByLevel []LevelCount `json:"inventory_by_level"` 140 InventoryByPoly []PolyCount `json:"inventory_by_poly"` 141 AvailabilityWindows AvailWindows `json:"availability_windows"` 142 Expiring ExpiringSummary `json:"expiring"` 143} 144 145type LevelCount struct { 146 Level string `json:"level"` 147 Label string `json:"label"` 148 Total int `json:"total"` 149 Available int `json:"available"` 150} 151type PolyCount struct { 152 Poly string `json:"poly"` 153 Label string `json:"label"` 154 Total int `json:"total"` 155 Available int `json:"available"` 156} 157type AvailWindows struct { 158 Now int `json:"now"` 159 D30 int `json:"d30"` 160 D60 int `json:"d60"` 161 D90 int `json:"d90"` 162} 163type ExpiringSummary struct { 164 Expired int `json:"expired"` 165 Due30 int `json:"due_30"` 166 Due60 int `json:"due_60"` 167 Due90 int `json:"due_90"` 168 ReinvestigationOverdue int `json:"reinvestigation_overdue"` 169 Alerts []ExpiryAlert `json:"alerts"` 170} 171type ExpiryAlert struct { 172 CandidateID string `json:"candidate_id"` 173 FullName string `json:"full_name"` 174 ClearanceLevel string `json:"clearance_level"` 175 DaysUntilExpiry int `json:"days_until_expiry"` 176 Severity string `json:"severity"` 177} 178 179type LcatCoverage struct { 180 LaborCategory string `json:"labor_category"` 181 Filled int `json:"filled"` 182 Demanded int `json:"demanded"` 183 Coverage string `json:"coverage"` 184 Color string `json:"color"` 185} 186 187type ProposalReadiness struct { 188 Ready int `json:"ready"` 189 AtRisk int `json:"at_risk"` 190 KeyPersonnelMissing int `json:"key_personnel_missing"` 191 LaborCategoriesMissing int `json:"labor_categories_missing"` 192 ReadyOpportunities []OppRef `json:"ready_opportunities"` 193 AtRiskOpportunities []OppRef `json:"at_risk_opportunities"` 194 KeyPersonnelMissingOpportunities []OppRef `json:"key_personnel_missing_opportunities"` 195 LaborCategoriesMissingOpportunities []OppRef `json:"labor_categories_missing_opportunities"` 196} 197type OppRef struct { 198 OpportunityID string `json:"opportunity_id"` 199 Name string `json:"name"` 200} 201 202type WinImpact struct { 203 HighImpactCount int `json:"high_impact_count"` 204 Top []WinCandidate `json:"top"` 205} 206type WinCandidate struct { 207 CandidateID string `json:"candidate_id"` 208 FullName string `json:"full_name"` 209 ClearanceLevel string `json:"clearance_level"` 210 Poly string `json:"poly"` 211 YearsExperience int `json:"years_experience"` 212} 213 214type HeatMetro struct { 215 Metro string `json:"metro"` 216 Total int `json:"total"` 217 Available int `json:"available"` 218 Cleared int `json:"cleared"` 219} 220 221type Recommendation struct { 222 Severity string `json:"severity"` 223 Message string `json:"message"` 224 ActionTarget string `json:"action_target"` 225 RelatedIDs []string `json:"related_ids"` 226 SourceRef string `json:"source_ref"` 227} 228 229type ActionCenter struct { 230 SuggestedRequirementID *string `json:"suggested_requirement_id"` 231 SuggestedOpportunityID *string `json:"suggested_opportunity_id"` 232 OpenOpportunitiesWithoutSlate int `json:"open_opportunities_without_slate"` 233 RequirementsUnscreened int `json:"requirements_unscreened"` 234 Launch []Launch `json:"launch"` 235} 236type Launch struct { 237 Product string `json:"product"` 238 Action string `json:"action"` 239 Label string `json:"label"` 240 Route string `json:"route"` 241} 242 243// AdoptForecastInput is the operator supplied detail that turns a bare forecast into a scorable 244// requirement. The forecast supplies the title, agency, and place of performance; the operator supplies 245// the clearance, years, and the mandatory skills the engine needs. 246type AdoptForecastInput struct { 247 RequiredLevel string `json:"required_level"` 248 RequiredPoly string `json:"required_poly"` 249 RequiredYears int `json:"required_years"` 250 KeyPersonnel bool `json:"key_personnel"` 251 Skills []string `json:"skills"` 252} 253 254// AdoptForecastResult returns the new requirement the engine will score on the next refresh. 255type AdoptForecastResult struct { 256 RequirementID string `json:"requirement_id"` 257 Title string `json:"title"` 258} 259