Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go

Source identity

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

Original source ↗

Every recorded occurrence

These 35 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/opportunity_intelligence/record.go	feature/opportunity-to-outcome	720d47fae476b0d38477ae4401697d372b1ea2bc	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	per-tenant-routing	9bde0f9a74b89d01980fa658e5253acda7528d0c	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	collision-deconfliction	4ee5a09972608ed89f8377c6665542d5f450f0a6	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	ws6-retrieval	6c56e29231ec05735927fa265c97d517499dfeaf	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	workstream-a-shared-core	e0de03ac3a1ec826bd15d0e048e3b02baa23eeff	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	m5-price-to-win	41000ad30fff4129fdaf5ec84e15ba14c27d4890	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	workstream-c-slatematch	5cd60c918301b46ecd6ed3e03e20c395da0062e2	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	ws1-ontology-sync	b596f449a32a1016fbd403c36505cc00a1ac9ee6	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	master	1e9249840a4302ec82e123b9c9cb6f75badea3e4	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	ws8-teaching-loop	c823f0fb6bb2aba0f39001eb6de96f4000d9321f	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	w3-ai-staffing-recommendations	43d56387270ef4da4cabd794d97ca6a49909bc7d	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	mag-substrate	b82c7100a492dec67dfd1eda6b3f53def859be35	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	ws3-clearance	4b8e7ce594c068621867f9c9deed0ec64ae6c553	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	workstream-d-command-center	255e7d1d420abf5e277d0cd8c9b14f6f72b6acb9	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	phase2-eval-fairness	d361af254701975fe239927656ababb56374655e	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	workstream-e-dataflow-deploy	433815a042f9741411e60fa553fe72143e9b10db	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	ruthless-debug-sweep	b7d742f8f032984be3817efffa3eb8b13b651c1f	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	time-to-fill-survival	b66e1e505863d4f17741a4b9ede73509e45bd6c6	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	ai-intelligence-layer	5d5ddff70393a197c5f54a45280bb5dd42b24755	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	graphrag-foundation	b0ddeb9f633fd138d09309d1a17b7d13bc3a67f7	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	workstream-a-opportunity-intelligence	1675031db74316e100782d063e9eda1a597fe3a1	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	deploy-and-ops	bdacd9d0b4d5998d25fc74bf4007f4c3ec538c7a	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	ws9-bench-ingestion	f585a9ef32fa554663ce1fba9a414a54b6e49cf0	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	ws2-alias-relationship	e4dada4601c6eb101830f9d223a9655dfa120616	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	presentation-readiness	eb574acaa29d71ce4d0f852572e87c275c79fdb7	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	vendor-intelligence	fe9796a19c261951d3f2565206c0c1b5ac294465	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	workstream-b-screenmatch	09015496d565a172bcaa15cfe9a8e4b072b13df0	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	ws7-federal-signal	6a9f6ce9cfb13345ffb47770d4960e7c2d9c17c2	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	workstream-e-commercial-stubs	4437da660539284a400ee380b9b427a300c369ee	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	ai-brain-live	aac32fc49c878cc5bca099459307611562d0bac1	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	workstream-d-missionmatch	3be46ba89edb737182075a2b320509b42dc916f8	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	phase2-connectors	e038d4c687aec16f8bd9bc4d907eea14d91f8704	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	workstream-b-sam-contract-awards	d5101cceb98e70000cebb31d3e7ac73d747d3a6d	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	feature/aioe-upgrade	2178e7298d0e5d9af83afa12402fd587f0ba6ed8	Open original
Janady13/missionmatch / internal/modules/opportunity_intelligence/record.go	capture-readiness	bae6af7cb2997e819174a9e9cfff5e16067a1975	Open original

Recovered source transcript

Download complete source text ↓96 lines · 3.2 KB

// Package oppintel is the Opportunity Intelligence ingestion layer. It defines one normalized record
// shape and one OpportunitySource protocol that every federal feed (active SAM solicitations, contract
// awards, agency forecasts) implements, so the readiness and Command Center layers read a single
// provenance tagged catalog instead of one table per feed. The ingester retains each raw payload to
// object storage, upserts the normalized record into the global opportunity_records catalog, and writes
// one audit event per run. Counts are always derived from records actually fetched, never fabricated.
package oppintel

import (
	"encoding/json"
	"time"

	"github.com/shopspring/decimal"
)

// RecordKind classifies a normalized record. An active solicitation is an open SAM notice a candidate
// could be staffed against now; a contract award carries incumbent and dollar context for past
// performance; a forecast is a planned, not yet posted opportunity and is always planning data.
type RecordKind string

const (
	KindActiveSolicitation RecordKind = "active_solicitation"
	KindContractAward      RecordKind = "contract_award"
	KindForecast           RecordKind = "forecast"
)

// Valid reports whether k is one of the known kinds (matches the migration CHECK constraint).
func (k RecordKind) Valid() bool {
	switch k {
	case KindActiveSolicitation, KindContractAward, KindForecast:
		return true
	}
	return false
}

// Place is a normalized place of performance.
type Place struct {
	City    string
	State   string
	Country string
	Zip     string
}

// OpportunityRecord is the single normalized shape every feed yields. It is provider independent and
// carries its own provenance (SourceName, SourceRecordID, FetchedAt) plus the Raw payload the ingester
// retains in object storage. EstimatedValue is a pointer so absent is distinct from a real zero, and is
// only ever set from a genuine source field, never fabricated. IsPlanning marks forecast rows the UI
// must label as planning data subject to change.
type OpportunityRecord struct {
	SourceName     string
	SourceRecordID string
	DedupeKey      string
	Kind           RecordKind

	Title           string
	Agency          string
	SubAgency       string
	NAICS           string
	PSC             string
	Place           Place
	SetAside        string
	SetAsideCode    string
	ContractVehicle string

	EstimatedValue *decimal.Decimal
	ValueSource    string // how the dollar figure is known (the source field), for provenance

	Posted             *time.Time
	ResponseDeadline   *time.Time
	AwardDate          *time.Time
	EstimatedAwardDate *time.Time
	PopStart           *time.Time
	PopEnd             *time.Time

	IncumbentName string
	IncumbentUEI  string
	UILink        string
	IsPlanning    bool

	FetchedAt time.Time
	Raw       json.RawMessage
}

// OpportunityQuery is the provider independent pull scope. A source uses the subset that applies to it
// (SAM iterates NAICS over a posted window; an awards source filters by agency and state). Empty fields
// mean no filter on that dimension.
type OpportunityQuery struct {
	NAICS    []string
	States   []string
	Agency   string
	SetAside string
	From     time.Time
	To       time.Time
	PageCap  int
}