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 AIRecommendations []Recommendation `json:"ai_recommendations"` 24 ActionCenter ActionCenter `json:"action_center"` 25} 26 27type Meta struct { 28 Empty bool `json:"empty"` 29 Notes []string `json:"notes"` 30} 31 32type Banner struct { 33 TotalClearedWorkforce int `json:"total_cleared_workforce"` 34 AvailableCandidates int `json:"available_candidates"` 35 ProposalReadyCandidates int `json:"proposal_ready_candidates"` 36 ActiveRequirements int `json:"active_requirements"` 37 StaffingGaps int `json:"staffing_gaps"` 38 HighRiskOpportunities int `json:"high_risk_opportunities"` 39} 40 41type MissionReadiness struct { 42 Score string `json:"score"` 43 Band string `json:"band"` 44 Status string `json:"status"` 45 Drivers []Driver `json:"drivers"` 46 AvailabilityReqCoverage string `json:"availability_req_coverage"` 47 Flags []string `json:"flags"` 48} 49 50type Driver struct { 51 Key string `json:"key"` 52 Label string `json:"label"` 53 Pct string `json:"pct"` 54 State string `json:"state"` 55 Weight string `json:"weight"` 56} 57 58type Opportunity struct { 59 OpportunityID string `json:"opportunity_id"` 60 Name string `json:"name"` 61 CustomerAgency string `json:"customer_agency,omitempty"` 62 SolicitationNumber string `json:"solicitation_number,omitempty"` 63 DueDate string `json:"due_date,omitempty"` 64 Value *string `json:"value"` 65 ReadinessScore string `json:"readiness_score"` 66 TotalRequirements int `json:"total_requirements"` 67 CoveredRequirements int `json:"covered_requirements"` 68 HeadcountNeeded int `json:"headcount_needed"` 69 HeadcountCovered int `json:"headcount_covered"` 70 KeyPersonnelOpen int `json:"key_personnel_open"` 71 StaffingRisk string `json:"staffing_risk"` 72 StaffingRiskCode string `json:"staffing_risk_code"` 73} 74 75type Gap struct { 76 LaborCategory string `json:"labor_category"` 77 RequiredLevel string `json:"required_level"` 78 RequiredLevelLabel string `json:"required_level_label"` 79 Unmet int `json:"unmet"` 80 BlocksKeyPersonnel bool `json:"blocks_key_personnel"` 81 ImpactedOpportunities []string `json:"impacted_opportunities"` 82 ValueAtRisk *string `json:"value_at_risk"` 83 // W2 counted basis: how the dollar was derived, so it is auditable, not a bare sum. 84 PricedOpportunities int `json:"priced_opportunities"` // opportunities with a value (counted) 85 UnpricedOpportunities int `json:"unpriced_opportunities"` // opportunities with a null value (excluded) 86 TotalOpportunities int `json:"total_opportunities"` // priced plus unpriced 87 ValueRepresentative bool `json:"value_representative"` // true unless every priced opp is sam or usaspending 88 ValueBasis string `json:"value_basis"` // human readable counted basis line 89 // W2 modeled Mission Readiness Impact: the coverage delta from filling this gap. 90 ImpactModeledPct string `json:"impact_modeled_pct"` // points of overall coverage, decimal StringFixed(2) 91 ImpactModeledLabel string `json:"impact_modeled_label"` // modeled framing copy 92 Headline string `json:"headline"` 93 Recommendation string `json:"recommendation"` 94} 95 96type ClearanceIntel struct { 97 InventoryByLevel []LevelCount `json:"inventory_by_level"` 98 InventoryByPoly []PolyCount `json:"inventory_by_poly"` 99 AvailabilityWindows AvailWindows `json:"availability_windows"` 100 Expiring ExpiringSummary `json:"expiring"` 101} 102 103type LevelCount struct { 104 Level string `json:"level"` 105 Label string `json:"label"` 106 Total int `json:"total"` 107 Available int `json:"available"` 108} 109type PolyCount struct { 110 Poly string `json:"poly"` 111 Label string `json:"label"` 112 Total int `json:"total"` 113 Available int `json:"available"` 114} 115type AvailWindows struct { 116 Now int `json:"now"` 117 D30 int `json:"d30"` 118 D60 int `json:"d60"` 119 D90 int `json:"d90"` 120} 121type ExpiringSummary struct { 122 Expired int `json:"expired"` 123 Due30 int `json:"due_30"` 124 Due60 int `json:"due_60"` 125 Due90 int `json:"due_90"` 126 ReinvestigationOverdue int `json:"reinvestigation_overdue"` 127 Alerts []ExpiryAlert `json:"alerts"` 128} 129type ExpiryAlert struct { 130 CandidateID string `json:"candidate_id"` 131 FullName string `json:"full_name"` 132 ClearanceLevel string `json:"clearance_level"` 133 DaysUntilExpiry int `json:"days_until_expiry"` 134 Severity string `json:"severity"` 135} 136 137type LcatCoverage struct { 138 LaborCategory string `json:"labor_category"` 139 Filled int `json:"filled"` 140 Demanded int `json:"demanded"` 141 Coverage string `json:"coverage"` 142 Color string `json:"color"` 143} 144 145type ProposalReadiness struct { 146 Ready int `json:"ready"` 147 AtRisk int `json:"at_risk"` 148 KeyPersonnelMissing int `json:"key_personnel_missing"` 149 LaborCategoriesMissing int `json:"labor_categories_missing"` 150 ReadyOpportunities []OppRef `json:"ready_opportunities"` 151 AtRiskOpportunities []OppRef `json:"at_risk_opportunities"` 152 KeyPersonnelMissingOpportunities []OppRef `json:"key_personnel_missing_opportunities"` 153 LaborCategoriesMissingOpportunities []OppRef `json:"labor_categories_missing_opportunities"` 154} 155type OppRef struct { 156 OpportunityID string `json:"opportunity_id"` 157 Name string `json:"name"` 158} 159 160type WinImpact struct { 161 HighImpactCount int `json:"high_impact_count"` 162 Top []WinCandidate `json:"top"` 163} 164type WinCandidate struct { 165 CandidateID string `json:"candidate_id"` 166 FullName string `json:"full_name"` 167 ClearanceLevel string `json:"clearance_level"` 168 Poly string `json:"poly"` 169 YearsExperience int `json:"years_experience"` 170} 171 172type HeatMetro struct { 173 Metro string `json:"metro"` 174 Total int `json:"total"` 175 Available int `json:"available"` 176 Cleared int `json:"cleared"` 177} 178 179type Recommendation struct { 180 Severity string `json:"severity"` 181 Message string `json:"message"` 182 ActionTarget string `json:"action_target"` 183 RelatedIDs []string `json:"related_ids"` 184 SourceRef string `json:"source_ref"` 185} 186 187type ActionCenter struct { 188 SuggestedRequirementID *string `json:"suggested_requirement_id"` 189 SuggestedOpportunityID *string `json:"suggested_opportunity_id"` 190 OpenOpportunitiesWithoutSlate int `json:"open_opportunities_without_slate"` 191 RequirementsUnscreened int `json:"requirements_unscreened"` 192 Launch []Launch `json:"launch"` 193} 194type Launch struct { 195 Product string `json:"product"` 196 Action string `json:"action"` 197 Label string `json:"label"` 198 Route string `json:"route"` 199} 200