Internals

Purpose

Hold and serve the current public model of the job market. Internals is a blueprint label for JobCache Core and its immediate processing boundary; it is not a third product.

Canonical model

role → ad → workspace job

Core owns the role and ad rungs. CareerVector owns private workspace job state. Role facts aggregate evidence across ads without erasing disagreement or analyzing identical text twice.

CrateDB authority

• Canonical current roles and ads.
• Structured facts with evidence and temporal validity.
• Embeddings and search projections.
• Role/ad reconciliation and revision lineage.
• Shared reusable enrichment results and public aggregate outputs.

Raw observations remain in object storage. Unfinished pipeline work remains in rebuildable operational state. Product-local session and workspace state remains in product D1/Yjs.

Invariants

• CrateDB is the only canonical public-corpus database.
• Publication is idempotent, revisioned, and traceable to immutable observations.
• A role aggregate never hides conflicting ad evidence.
• Product-local identifiers do not enter Core.
• One-node CrateDB is an explicit resource constraint, not an excuse for a second truth store.
• Customer reads take precedence over asynchronous publication pressure.

Completion evidence

Schema and query budgets for 100,000 ads; temporal role/ad reconstruction; vector and hybrid search benchmarks; publication atomicity; lineage queries; and privacy-boundary tests.