{
  "schema_version": "1.1.0",
  "dataset": "equipment-intelligence.json",
  "mode": "static_snapshot",
  "connections": {
    "google_cloud": "not_configured",
    "SDOS": "not_configured",
    "CRM": "not_configured",
    "HTS": "not_configured"
  },
  "primary_key": "equipment[].id",
  "identity_policy": "IDs are retained on edits; new legacy imports must map source row IDs and aliases before inserting. Series and model/variant records are distinct. Candidate matches require review.",
  "joins": [
    {
      "tool": "HTS/import analysis",
      "keys": [
        "equipment_id",
        "configuration_id",
        "jurisdiction",
        "code",
        "revision",
        "effective_date",
        "classification_source"
      ],
      "rule": "No category-based automatic 10-digit assignment. Trade facts retain period, country, value, quantity and quantity unit; not equipment installed-base counts."
    },
    {
      "tool": "component/supplier research",
      "keys": [
        "equipment_id",
        "configuration_id",
        "component_id",
        "supplier_id",
        "function_id",
        "evidence_id"
      ],
      "rule": "Class function hypotheses are not confirmed installed parts."
    },
    {
      "tool": "opportunity tracker",
      "keys": [
        "equipment_id",
        "configuration_id",
        "commercial_brief_id",
        "component_or_service_scope",
        "external_record_id"
      ],
      "rule": "Private prices, contacts and account data stay in the commercial system."
    },
    {
      "tool": "media/photo index",
      "keys": [
        "equipment_id",
        "asset_id",
        "story_id"
      ],
      "rule": "Source identity and publication rights remain in the media system."
    }
  ],
  "specification_fields": [
    "metric",
    "value",
    "unit",
    "basis",
    "configuration_id",
    "source_url",
    "source_revision",
    "checked_date",
    "evidence_status"
  ],
  "value_types": "number or {min:number,max:number}; missing = null or absent, never 0",
  "evidence_states": [
    "unverified_inventory",
    "unverified_class_hypothesis",
    "manufacturer_published",
    "independent_test",
    "derived",
    "disputed",
    "superseded",
    "commercial_hypothesis"
  ],
  "normalization": "Retain original value and unit when converting. Derived values must retain formula and input fact IDs; do not combine unrelated peak ratings.",
  "change_policy": "Schema version changes when field meaning changes. Retain old IDs and source provenance; never merge by model name alone.",
  "commercial_briefs": {
    "path": "commercial_briefs[]",
    "key": "id",
    "joins_to": "equipment[].id via equipment_id",
    "status": "Research hypotheses; no confirmed buyer access, fitment or economics.",
    "technical_evidence": "Source-linked specifications retained with units, rating and configuration.",
    "commercial_fields": [
      "system",
      "sellable_scope",
      "customer_value",
      "buyer_roles_to_validate",
      "commercial_question",
      "next_evidence",
      "external_opportunity_id"
    ],
    "economics": "Nullable assumptions and derived annual values; attach source, period, currency and scenario ID in the commercial system. Unknown is not zero.",
    "ranking_policy": "Rank qualified opportunities by attainable annual contribution, supporting evidence and route to the buyer; no financial rank assigned to unestimated records.",
    "oem_revenue_formula": "annual_equipment_units * components_per_machine * supplier_unit_price * attainable_share",
    "service_revenue_formula": "accessible_installed_base * service_events_per_machine_per_year * service_revenue_per_event * attainable_share",
    "contribution_formula": "annual_revenue * gross_margin - annual_incremental_cost",
    "rate_units": "attainable_share and gross_margin are fractions from 0 to 1",
    "scope_rule": "Do not add overlapping OEM, distributor and service invoices as independent market value. Keep one-time qualification costs distinct from recurring costs."
  }
}