Janady13/missionmatch / frontend/src/lib/types.ts

1// TypeScript mirrors of the Go API DTOs (internal/modules/matching). Scores are strings (decimal). 2 3export type Band = 'green' | 'yellow' | 'red' 4// ReadinessState is the per category state (a score bucket). MissionStatusCode is the overall mission 5// readiness verdict, a distinct code space the backend emits as ready | review | recruiting; the two 6// were conflated under one type, which hid review and recruiting and wrongly admitted partial and gap. 7export type ReadinessState = 'ready' | 'partial' | 'gap' 8export type MissionStatusCode = 'ready' | 'review' | 'recruiting' 9 10export interface ComponentView { 11 component: string 12 weight: string 13 raw: string 14 weighted: string 15 rationale: string 16} 17 18export interface MatchedSkillView { 19 required_skill: string 20 candidate_skill?: string 21 similarity: string 22 exact: boolean 23 matched: boolean 24} 25 26export interface MatchResultView { 27 candidate_id: string 28 requirement_id: string 29 total_score: string 30 band: Band 31 band_label: string 32 components: Record<string, string> 33 explanation: string 34 gap_summary: string[] 35 matched_skills: MatchedSkillView[] 36 trace: ComponentView[] 37} 38 39export interface ReadinessCategory { 40 name: string 41 score: string 42 weight: string 43 state: ReadinessState 44} 45 46export interface MissionReadiness { 47 status: string 48 status_code: MissionStatusCode 49 score: string 50 band: Band 51 categories: ReadinessCategory[] 52} 53 54export interface BattleCard { 55 strengths: string[] 56 gaps: string[] 57} 58 59export interface ClearanceIntel { 60 current: string 61 status: string 62 sci_eligible: boolean 63 ci_poly_eligible: boolean 64 full_scope_poly: boolean 65 expired: boolean 66 investigation_age_months?: number 67 expires_at?: string 68 reinvestigation_due_at?: string 69 recent_classified_support: boolean 70 provenance: string 71 provenance_label: string 72 verified: boolean 73 verified_at?: string 74} 75 76export interface RequirementArea { 77 area: string 78 met: boolean 79} 80 81export interface RiskArea { 82 severity: 'warning' | 'info' 83 message: string 84} 85 86export interface ContractReadiness { 87 areas: RequirementArea[] 88 risks: RiskArea[] 89} 90 91export interface WinImpact { 92 level: string 93 level_code: 'high' | 'medium' | 'low' 94 staffing_strength: string 95 reasons: string[] 96} 97 98export interface NextStep { 99 action: string 100 reason: string 101} 102 103export interface ScreenView { 104 match: MatchResultView 105 mission_readiness: MissionReadiness 106 battle_card: BattleCard 107 clearance_intelligence: ClearanceIntel 108 contract_readiness: ContractReadiness 109 win_impact: WinImpact 110 next_steps: NextStep[] 111} 112 113export interface CandidateListView { 114 id: string 115 full_name: string 116 clearance_level: string 117 clearance_status: string 118 years_experience: number 119 location?: string 120 available: boolean 121} 122 123export interface RequirementListView { 124 id: string 125 title: string 126 required_level: string 127 customer_agency?: string 128 key_personnel: boolean 129} 130 131export interface SlateMemberView { 132 candidate_id: string 133 rank: number 134 total_score: string 135 band: Band 136 band_label: string 137 explanation: string 138 gap_summary: string[] 139} 140 141export interface SlateResult { 142 slate_id: string 143 requirement_id: string 144 name: string 145 members: SlateMemberView[] 146} 147 148// slateMATCH list, detail, and proposal readiness views (read from the stored slate, never rescored). 149export interface SlateSummaryView { 150 slate_id: string 151 name: string 152 status: string 153 member_count: number 154 created_at: string 155} 156 157export interface SlateMemberDetailView { 158 candidate_id: string 159 full_name: string 160 rank: number 161 total_score: string 162 band: Band 163 band_label: string 164 components: Record<string, string> 165 explanation: string 166 gap_summary: string[] 167 decision: 'pending' | 'approved' | 'rejected' 168 decision_note: string 169} 170 171export interface ProposalReadinessView { 172 slate_id: string 173 requirement_id: string 174 total_members: number 175 approved: number 176 rejected: number 177 pending: number 178 proposal_ready: number 179 potential: number 180 recruiting: number 181 approved_ready: number 182 readiness_pct: string 183 status: string 184} 185 186export interface SlateDetailView { 187 slate_id: string 188 requirement_id: string 189 requirement_title: string 190 name: string 191 status: string 192 members: SlateMemberDetailView[] 193 readiness: ProposalReadinessView 194} 195 196// AEDT adverse impact report (the four fifths analysis). Every figure is computed from recorded 197// outcomes joined to consented demographics by the compliance role; nothing is fabricated. 198export interface ImpactRow { 199 group: string 200 considered: number 201 selected: number 202 rate: string 203 impact_ratio: string 204 flagged: boolean 205} 206 207export interface AnalysisSection { 208 stage: string 209 total_n: number 210 unknown_count: number 211 no_demographics_count: number 212 by_gender: ImpactRow[] 213 by_race_ethnicity: ImpactRow[] 214 intersectional: ImpactRow[] 215} 216 217export interface AdverseImpactReport { 218 generated_at: string 219 data_from: string 220 data_to: string 221 source: string 222 method: string 223 selection: AnalysisSection 224 screening: AnalysisSection 225} 226 227export interface OpportunityFitView { 228 requirement_id: string 229 title: string 230 customer_agency?: string 231 score: string 232 band: Band 233 status: string 234} 235 236// ---------- Mission Check (W1) ---------- 237// The Mission Check advisory recommendation. DO NOT SUBMIT is a derived label on the Red band. 238export type MissionRecommendation = 'SUBMIT' | 'REVIEW' | 'DO NOT SUBMIT' 239 240export interface MissionCheckFitRow extends OpportunityFitView { 241 recommendation: MissionRecommendation 242 recommendation_reason: string 243} 244 245// ParsedCandidate is what the extractor read from the resume, surfaced so the user can review and Save it. 246export interface ParsedCandidate { 247 full_name: string 248 clearance_level: string 249 clearance_poly: string 250 clearance_status: string 251 years_experience: number 252 location: string 253 skills: string[] 254 certifications: string[] 255 customer_experience: string[] 256} 257 258// ParsedRequirement is what the JD parsed to, so the Mode B requirement panel reflects what was scored. 259export interface ParsedRequirement { 260 title: string 261 required_level: string 262 customer_agency: string 263 key_personnel: boolean 264} 265 266// Mode A: the resume scored against every open opportunity, ranked. 267export interface MissionCheckModeAResult { 268 rows: MissionCheckFitRow[] 269 candidate: ParsedCandidate 270 assumptions: string[] 271 data_categories: string[] 272} 273 274// Mode B: the resume scored against one pasted job description. view is the exact ScreenView /screen returns. 275export interface MissionCheckModeBResult { 276 view: ScreenView 277 recommendation: MissionRecommendation 278 recommendation_reason: string 279 candidate: ParsedCandidate 280 requirement: ParsedRequirement 281 assumptions: string[] 282 data_categories: string[] 283} 284 285// SaveCandidateRequest is the reviewed, structured candidate the user chose to persist from a result. 286// Clearance fields are DB codes; clearance is a self reported indicator the user confirmed, not verified. 287export interface SaveCandidateRequest { 288 full_name: string 289 clearance_level: string 290 clearance_poly: string 291 clearance_status: string 292 years_experience: number 293 location: string 294 remote: boolean 295 relocatable: boolean 296 available: boolean 297 skills: string[] 298 certifications: string[] 299 customer_experience: string[] 300} 301 302export interface RankedCandidateView { 303 candidate_id: string 304 full_name: string 305 clearance_level: string 306 clearance_status: string 307 years_experience: number 308 location?: string 309 available: boolean 310 score: string 311 band: Band 312 status: string 313} 314 315// ---- SAM.gov Contract Opportunities (cached federal opportunity feed) ---- 316export interface SamPOC { 317 type?: string 318 fullName?: string 319 title?: string 320 email?: string 321 phone?: string 322 fax?: string 323} 324export interface SamOpportunity { 325 notice_id: string 326 title: string 327 solicitation_number: string 328 department: string 329 sub_agency: string 330 full_agency_path: string 331 naics_code: string 332 psc_code: string 333 set_aside_code: string 334 set_aside: string 335 type: string 336 posted_date: string 337 response_deadline: string 338 active: boolean 339 place_of_performance: { city: string; state: string; zip: string } 340 ui_link: string 341 description_url: string 342 resource_links: string[] 343 point_of_contact: SamPOC[] 344 source: string 345 synced_at: string 346} 347export interface OpportunityFilters { 348 naics?: string[] 349 set_aside?: string[] 350 state?: string[] 351 department?: string[] 352 sub_agency?: string[] 353 q?: string 354 active_only?: boolean 355 limit?: number 356} 357 358// ---- USASpending federal awards (incumbent intel + Galapagos past performance) ---- 359export interface FederalAward { 360 award_uid: string 361 award_id: string 362 recipient_name: string 363 recipient_uei: string 364 award_amount: string 365 awarding_agency: string 366 awarding_sub_agency: string 367 pop_start_date: string 368 pop_end_date: string 369 naics_code: string 370 naics_description: string 371 description: string 372 is_galapagos: boolean 373 source: string 374 synced_at: string 375} 376 377// ---- BLS OEWS regional wage baseline ---- 378export interface WageArea { 379 area: string 380 area_name: string 381 annual_mean: string 382 annual_median: string 383} 384export interface WageBaseline { 385 occupation_code: string 386 occupation_title: string 387 role: string 388 year: string 389 areas: WageArea[] 390 source: string 391 synced_at: string 392} 393 394// ---- External candidate sourcing (People Data Labs) ---- 395export interface ExternalCandidate { 396 id: string 397 full_name: string 398 email: string 399 headline: string 400 location: string 401 years_experience: number 402 available: boolean 403 external_id: string 404 source: string 405 clearance: string 406 created_at: string 407} 408export interface SourcingLogEntry { 409 id: string 410 candidate_id: string 411 external_id: string 412 source: string 413 provider: string 414 legal_basis: string 415 collected_at: string 416} 417 418// ---- Candidate workforce intelligence (computed, never hardcoded) ---- 419export interface IntelClearance { 420 level: string 421 status: string 422 sci_eligible: boolean 423 sci_known: boolean 424 investigation_year?: string 425 provenance: string 426 verified: boolean 427 available: boolean 428} 429export interface IntelReadiness { 430 score: string 431 band: Band 432 status: string 433} 434export interface IntelProposal { 435 value: string // YES or REVIEW 436 reason: string 437} 438export interface IntelWinImpact { 439 level: string // HIGH, MEDIUM, LOW 440 basis: string 441} 442export interface IntelBestFit { 443 requirement_id: string 444 name: string 445 customer_agency?: string 446 score: string 447 band: Band 448} 449export interface CandidateIntelligence { 450 id: string 451 full_name: string 452 source: string // seed or external 453 headline?: string 454 years_experience: number 455 location?: string 456 available: boolean 457 clearance: IntelClearance 458 mission_readiness: IntelReadiness 459 proposal_ready: IntelProposal 460 win_impact: IntelWinImpact 461 best_fit: IntelBestFit 462 labor_category_coverage: string[] 463} 464 465// ---- Workforce Command Center ---- 466export interface CCBanner { 467 total_cleared_workforce: number 468 available_candidates: number 469 proposal_ready_candidates: number 470 active_requirements: number 471 staffing_gaps: number 472 high_risk_opportunities: number 473} 474export interface CCDriver { key: string; label: string; pct: string; state: ReadinessState; weight: string } 475export interface CCMissionReadiness { 476 score: string 477 band: Band 478 status: string 479 drivers: CCDriver[] 480 availability_req_coverage: string 481 flags: string[] 482} 483export interface CCOpportunity { 484 opportunity_id: string 485 name: string 486 customer_agency?: string 487 solicitation_number?: string 488 due_date?: string 489 value: string | null 490 readiness_score: string 491 total_requirements: number 492 covered_requirements: number 493 headcount_needed: number 494 headcount_covered: number 495 key_personnel_open: number 496 staffing_risk: string 497 staffing_risk_code: 'high' | 'medium' | 'low' 498} 499export interface CCGap { 500 labor_category: string 501 required_level: string 502 required_level_label: string 503 unmet: number 504 blocks_key_personnel: boolean 505 impacted_opportunities: string[] 506 value_at_risk: string | null 507 priced_opportunities: number 508 unpriced_opportunities: number 509 total_opportunities: number 510 value_representative: boolean 511 value_basis: string 512 impact_modeled_pct: string 513 impact_modeled_label: string 514 headline: string 515 recommendation: string 516} 517export interface CCLevelCount { level: string; label: string; total: number; available: number } 518export interface CCPolyCount { poly: string; label: string; total: number; available: number } 519export interface CCExpiryAlert { 520 candidate_id: string 521 full_name: string 522 clearance_level: string 523 days_until_expiry: number 524 severity: 'critical' | 'warning' | 'info' 525} 526export interface CCClearanceIntel { 527 inventory_by_level: CCLevelCount[] 528 inventory_by_poly: CCPolyCount[] 529 availability_windows: { now: number; d30: number; d60: number; d90: number } 530 expiring: { 531 expired: number 532 due_30: number 533 due_60: number 534 due_90: number 535 reinvestigation_overdue: number 536 alerts: CCExpiryAlert[] 537 } 538} 539export interface CCLcatCoverage { labor_category: string; filled: number; demanded: number; coverage: string; color: Band } 540export interface CCOppRef { opportunity_id: string; name: string } 541export interface CCProposalReadiness { 542 ready: number 543 at_risk: number 544 key_personnel_missing: number 545 labor_categories_missing: number 546 ready_opportunities: CCOppRef[] 547 at_risk_opportunities: CCOppRef[] 548 key_personnel_missing_opportunities: CCOppRef[] 549 labor_categories_missing_opportunities: CCOppRef[] 550} 551export interface CCWinCandidate { 552 candidate_id: string 553 full_name: string 554 clearance_level: string 555 poly: string 556 years_experience: number 557} 558export interface CCHeatMetro { metro: string; total: number; available: number; cleared: number } 559export interface CCRecommendation { 560 severity: 'high' | 'medium' | 'low' 561 message: string 562 action_target: string 563 related_ids: string[] 564 source_ref: string 565} 566export interface CCLaunch { product: string; action: string; label: string; route: string } 567// CCUpcomingOpportunity is one planning stage forecast surfaced beside the current readiness. It never 568// changes the current numbers. available_cleared_in_state is a real bench count; the comparable 569// requirement coverage is the engine backed eligibility of the org's similar requirements; fit_note 570// states honestly that a bare forecast has no precise match score. 571export interface CCUpcomingOpportunity { 572 record_id: string 573 title: string 574 agency: string 575 naics?: string 576 place_of_performance?: string 577 state?: string 578 set_aside?: string 579 estimated_value: string | null 580 estimated_award_date?: string 581 incumbent_name?: string 582 planning_note: string 583 available_cleared_in_state: number 584 comparable_requirements: number 585 comparable_covered: number 586 fit_note: string 587 adoptable: boolean 588} 589 590// CCIncumbentRef is one incumbent and award context row from the contract award feed. 591export interface CCIncumbentRef { 592 record_id: string 593 incumbent: string 594 incumbent_uei?: string 595 agency: string 596 naics?: string 597 value: string | null 598 value_source?: string 599 award_date?: string 600 source: string 601} 602 603// AdoptForecastInput turns a forecast into a real requirement the engine scores. 604export interface AdoptForecastInput { 605 required_level: string 606 required_poly: string 607 required_years: number 608 key_personnel: boolean 609 skills: string[] 610} 611export interface AdoptForecastResult { 612 requirement_id: string 613 title: string 614} 615 616export interface CommandCenterView { 617 as_of: string 618 organization_id: string 619 generated_at: string 620 meta: { empty: boolean; notes: string[] } 621 banner: CCBanner 622 mission_readiness: CCMissionReadiness 623 active_opportunities: CCOpportunity[] 624 staffing_gaps: CCGap[] 625 clearance_intelligence: CCClearanceIntel 626 labor_category_coverage: CCLcatCoverage[] 627 proposal_readiness: CCProposalReadiness 628 win_impact: { high_impact_count: number; top: CCWinCandidate[] } 629 heat_map: CCHeatMetro[] 630 upcoming_opportunities: CCUpcomingOpportunity[] 631 incumbent_landscape: CCIncumbentRef[] 632 ai_recommendations: CCRecommendation[] 633 action_center: { 634 suggested_requirement_id: string | null 635 suggested_opportunity_id: string | null 636 open_opportunities_without_slate: number 637 requirements_unscreened: number 638 launch: CCLaunch[] 639 } 640} 641