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

Source identity

Field	Recorded value
Source type	GitHub source
Original record	Janady13/missionmatch / frontend/src/lib/types.ts
Date	Not specified in source
Repository	Janady13/missionmatch
Revision	39df94f92b2a33f852481fe1954dabed841524bb
Branch	w0-aedt-compliance
Path or archive member	frontend/src/lib/types.ts
Original SHA-256	d1d71a45efeec3e6bf63fd4a6e4e77907c3a1c57ea9089b7f0c293aa0d3c1471
Git blob SHA	2550313c2402a6af0d3f7e76d5887b3da0cae6e9
Reading-copy SHA-256	d1d71a45efeec3e6bf63fd4a6e4e77907c3a1c57ea9089b7f0c293aa0d3c1471
Original source ↗
Recovered source transcript

Download complete source text ↓459 lines · 10.6 KB
// TypeScript mirrors of the Go API DTOs (internal/modules/matching). Scores are strings (decimal).

export type Band = 'green' | 'yellow' | 'red'
export type ReadinessState = 'ready' | 'partial' | 'gap'

export interface ComponentView {
  component: string
  weight: string
  raw: string
  weighted: string
  rationale: string
}

export interface MatchedSkillView {
  required_skill: string
  candidate_skill?: string
  similarity: string
  exact: boolean
  matched: boolean
}

export interface MatchResultView {
  candidate_id: string
  requirement_id: string
  total_score: string
  band: Band
  band_label: string
  components: Record<string, string>
  explanation: string
  gap_summary: string[]
  matched_skills: MatchedSkillView[]
  trace: ComponentView[]
}

export interface ReadinessCategory {
  name: string
  score: string
  weight: string
  state: ReadinessState
}

export interface MissionReadiness {
  status: string
  status_code: ReadinessState
  score: string
  band: Band
  categories: ReadinessCategory[]
}

export interface BattleCard {
  strengths: string[]
  gaps: string[]
}

export interface ClearanceIntel {
  current: string
  status: string
  sci_eligible: boolean
  ci_poly_eligible: boolean
  full_scope_poly: boolean
  expired: boolean
  investigation_age_months?: number
  expires_at?: string
  reinvestigation_due_at?: string
  recent_classified_support: boolean
}

export interface RequirementArea {
  area: string
  met: boolean
}

export interface RiskArea {
  severity: 'warning' | 'info'
  message: string
}

export interface ContractReadiness {
  areas: RequirementArea[]
  risks: RiskArea[]
}

export interface WinImpact {
  level: string
  level_code: 'high' | 'medium' | 'low'
  staffing_strength: string
  reasons: string[]
}

export interface NextStep {
  action: string
  reason: string
}

export interface ScreenView {
  match: MatchResultView
  mission_readiness: MissionReadiness
  battle_card: BattleCard
  clearance_intelligence: ClearanceIntel
  contract_readiness: ContractReadiness
  win_impact: WinImpact
  next_steps: NextStep[]
}

export interface CandidateListView {
  id: string
  full_name: string
  clearance_level: string
  clearance_status: string
  years_experience: number
  location?: string
  available: boolean
}

export interface RequirementListView {
  id: string
  title: string
  required_level: string
  customer_agency?: string
  key_personnel: boolean
}

export interface SlateMemberView {
  candidate_id: string
  rank: number
  total_score: string
  band: Band
  band_label: string
  explanation: string
  gap_summary: string[]
}

export interface SlateResult {
  slate_id: string
  requirement_id: string
  name: string
  members: SlateMemberView[]
}

// AEDT adverse impact report (the four fifths analysis). Every figure is computed from recorded
// outcomes joined to consented demographics by the compliance role; nothing is fabricated.
export interface ImpactRow {
  group: string
  considered: number
  selected: number
  rate: string
  impact_ratio: string
  flagged: boolean
}

export interface AnalysisSection {
  stage: string
  total_n: number
  unknown_count: number
  no_demographics_count: number
  by_gender: ImpactRow[]
  by_race_ethnicity: ImpactRow[]
  intersectional: ImpactRow[]
}

export interface AdverseImpactReport {
  generated_at: string
  data_from: string
  data_to: string
  source: string
  method: string
  selection: AnalysisSection
  screening: AnalysisSection
}

export interface OpportunityFitView {
  requirement_id: string
  title: string
  customer_agency?: string
  score: string
  band: Band
  status: string
}

export interface RankedCandidateView {
  candidate_id: string
  full_name: string
  clearance_level: string
  clearance_status: string
  years_experience: number
  location?: string
  available: boolean
  score: string
  band: Band
  status: string
}

// ---- SAM.gov Contract Opportunities (cached federal opportunity feed) ----
export interface SamPOC {
  type?: string
  fullName?: string
  title?: string
  email?: string
  phone?: string
  fax?: string
}
export interface SamOpportunity {
  notice_id: string
  title: string
  solicitation_number: string
  department: string
  sub_agency: string
  full_agency_path: string
  naics_code: string
  psc_code: string
  set_aside_code: string
  set_aside: string
  type: string
  posted_date: string
  response_deadline: string
  active: boolean
  place_of_performance: { city: string; state: string; zip: string }
  ui_link: string
  description_url: string
  resource_links: string[]
  point_of_contact: SamPOC[]
  source: string
  synced_at: string
}
export interface OpportunityFilters {
  naics?: string[]
  set_aside?: string[]
  state?: string[]
  department?: string[]
  sub_agency?: string[]
  q?: string
  active_only?: boolean
  limit?: number
}

// ---- USASpending federal awards (incumbent intel + Galapagos past performance) ----
export interface FederalAward {
  award_uid: string
  award_id: string
  recipient_name: string
  recipient_uei: string
  award_amount: string
  awarding_agency: string
  awarding_sub_agency: string
  pop_start_date: string
  pop_end_date: string
  naics_code: string
  naics_description: string
  description: string
  is_galapagos: boolean
  source: string
  synced_at: string
}

// ---- BLS OEWS regional wage baseline ----
export interface WageArea {
  area: string
  area_name: string
  annual_mean: string
  annual_median: string
}
export interface WageBaseline {
  occupation_code: string
  occupation_title: string
  role: string
  year: string
  areas: WageArea[]
  source: string
  synced_at: string
}

// ---- External candidate sourcing (People Data Labs) ----
export interface ExternalCandidate {
  id: string
  full_name: string
  email: string
  headline: string
  location: string
  years_experience: number
  available: boolean
  external_id: string
  source: string
  clearance: string
  created_at: string
}
export interface SourcingLogEntry {
  id: string
  candidate_id: string
  external_id: string
  source: string
  provider: string
  legal_basis: string
  collected_at: string
}

// ---- Candidate workforce intelligence (computed, never hardcoded) ----
export interface IntelClearance {
  level: string
  status: string
  sci_eligible: boolean
  sci_known: boolean
  investigation_year?: string
  available: boolean
}
export interface IntelReadiness {
  score: string
  band: Band
  status: string
}
export interface IntelProposal {
  value: string // YES or REVIEW
  reason: string
}
export interface IntelWinImpact {
  level: string // HIGH, MEDIUM, LOW
  basis: string
}
export interface IntelBestFit {
  requirement_id: string
  name: string
  customer_agency?: string
  score: string
  band: Band
}
export interface CandidateIntelligence {
  id: string
  full_name: string
  source: string // seed or external
  headline?: string
  years_experience: number
  location?: string
  available: boolean
  clearance: IntelClearance
  mission_readiness: IntelReadiness
  proposal_ready: IntelProposal
  win_impact: IntelWinImpact
  best_fit: IntelBestFit
  labor_category_coverage: string[]
}

// ---- Workforce Command Center ----
export interface CCBanner {
  total_cleared_workforce: number
  available_candidates: number
  proposal_ready_candidates: number
  active_requirements: number
  staffing_gaps: number
  high_risk_opportunities: number
}
export interface CCDriver { key: string; label: string; pct: string; state: ReadinessState; weight: string }
export interface CCMissionReadiness {
  score: string
  band: Band
  status: string
  drivers: CCDriver[]
  availability_req_coverage: string
  flags: string[]
}
export interface CCOpportunity {
  opportunity_id: string
  name: string
  customer_agency?: string
  solicitation_number?: string
  due_date?: string
  value: string | null
  readiness_score: string
  total_requirements: number
  covered_requirements: number
  headcount_needed: number
  headcount_covered: number
  key_personnel_open: number
  staffing_risk: string
  staffing_risk_code: 'high' | 'medium' | 'low'
}
export interface CCGap {
  labor_category: string
  required_level: string
  required_level_label: string
  unmet: number
  blocks_key_personnel: boolean
  impacted_opportunities: string[]
  value_at_risk: string | null
  headline: string
  recommendation: string
}
export interface CCLevelCount { level: string; label: string; total: number; available: number }
export interface CCPolyCount { poly: string; label: string; total: number; available: number }
export interface CCExpiryAlert {
  candidate_id: string
  full_name: string
  clearance_level: string
  days_until_expiry: number
  severity: 'critical' | 'warning' | 'info'
}
export interface CCClearanceIntel {
  inventory_by_level: CCLevelCount[]
  inventory_by_poly: CCPolyCount[]
  availability_windows: { now: number; d30: number; d60: number; d90: number }
  expiring: {
    expired: number
    due_30: number
    due_60: number
    due_90: number
    reinvestigation_overdue: number
    alerts: CCExpiryAlert[]
  }
}
export interface CCLcatCoverage { labor_category: string; filled: number; demanded: number; coverage: string; color: Band }
export interface CCOppRef { opportunity_id: string; name: string }
export interface CCProposalReadiness {
  ready: number
  at_risk: number
  key_personnel_missing: number
  labor_categories_missing: number
  ready_opportunities: CCOppRef[]
  at_risk_opportunities: CCOppRef[]
  key_personnel_missing_opportunities: CCOppRef[]
  labor_categories_missing_opportunities: CCOppRef[]
}
export interface CCWinCandidate {
  candidate_id: string
  full_name: string
  clearance_level: string
  poly: string
  years_experience: number
}
export interface CCHeatMetro { metro: string; total: number; available: number; cleared: number }
export interface CCRecommendation {
  severity: 'high' | 'medium' | 'low'
  message: string
  action_target: string
  related_ids: string[]
  source_ref: string
}
export interface CCLaunch { product: string; action: string; label: string; route: string }
export interface CommandCenterView {
  as_of: string
  organization_id: string
  generated_at: string
  meta: { empty: boolean; notes: string[] }
  banner: CCBanner
  mission_readiness: CCMissionReadiness
  active_opportunities: CCOpportunity[]
  staffing_gaps: CCGap[]
  clearance_intelligence: CCClearanceIntel
  labor_category_coverage: CCLcatCoverage[]
  proposal_readiness: CCProposalReadiness
  win_impact: { high_impact_count: number; top: CCWinCandidate[] }
  heat_map: CCHeatMetro[]
  ai_recommendations: CCRecommendation[]
  action_center: {
    suggested_requirement_id: string | null
    suggested_opportunity_id: string | null
    open_opportunities_without_slate: number
    requirements_unscreened: number
    launch: CCLaunch[]
  }
}