{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://intelligentism.isilp.org/schemas/transaction-value-record.schema.json",
  "title": "Transaction Value Record",
  "description": "A conventional settlement record extended with a structured, provenance-bearing description of the value a transaction produced and who received it. Research framework — not an accounting standard.",
  "type": "object",
  "required": ["id", "version", "settlement", "value", "provenance"],
  "additionalProperties": false,
  "properties": {
    "id": { "type": "string", "description": "Stable identifier for this record." },
    "version": { "type": "string", "description": "Framework version the record conforms to." },
    "settlement": {
      "type": "object",
      "required": ["price", "currency", "timestamp"],
      "additionalProperties": false,
      "properties": {
        "price": { "type": "number", "minimum": 0 },
        "currency": { "type": "string", "minLength": 3, "maxLength": 3 },
        "timestamp": { "type": "string", "format": "date-time" },
        "buyerRef": { "type": "string", "description": "Pseudonymous counterparty reference. Must not carry identity." },
        "sellerRef": { "type": "string", "description": "Pseudonymous counterparty reference. Must not carry identity." }
      }
    },
    "value": {
      "type": "object",
      "required": ["valueProduced", "verifiedCosts", "buyerValueReceived", "sellerValueReceived"],
      "additionalProperties": false,
      "properties": {
        "valueProduced": { "type": "number" },
        "verifiedCosts": { "type": "number", "minimum": 0 },
        "positiveExternalities": { "type": "number", "default": 0 },
        "risks": { "type": "number", "default": 0 },
        "buyerValueReceived": { "type": "number" },
        "sellerValueReceived": { "type": "number" },
        "netValueCreated": { "type": "number", "description": "NVC = VP - VC + E - R" },
        "valueEfficiency": { "type": "number", "description": "Total value received divided by price." },
        "intelligentValueScore": { "type": "number", "minimum": 0, "maximum": 100 }
      }
    },
    "dimensions": {
      "type": "object",
      "description": "Optional dimensional breakdown. Each entry is a currency-denominated estimate.",
      "additionalProperties": false,
      "properties": {
        "timeSaved": { "type": "number" },
        "knowledgeTransferred": { "type": "number" },
        "productivityCreated": { "type": "number" },
        "innovationEnabled": { "type": "number" },
        "trustBuilt": { "type": "number" },
        "riskReduced": { "type": "number" },
        "infrastructureImproved": { "type": "number" },
        "futureOpportunity": { "type": "number" },
        "environmentalEffect": { "type": "number" },
        "communityEffect": { "type": "number" },
        "systemEffect": { "type": "number" }
      }
    },
    "provenance": {
      "type": "object",
      "required": ["method", "confidence"],
      "additionalProperties": false,
      "description": "A value figure without provenance is an assertion, not a record.",
      "properties": {
        "method": { "type": "string", "description": "Published method identifier used to produce the estimates." },
        "confidence": {
          "type": "string",
          "enum": ["self-reported", "counterparty-confirmed", "sampled", "audited", "independently-verified"]
        },
        "confidenceInterval": {
          "type": "object",
          "additionalProperties": false,
          "properties": { "low": { "type": "number" }, "high": { "type": "number" } }
        },
        "evidenceRefs": { "type": "array", "items": { "type": "string" } },
        "auditor": { "type": "string" }
      }
    },
    "privacy": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "detailedRecordingConsent": { "type": "boolean", "default": false },
        "retentionDays": { "type": "integer", "minimum": 0 },
        "aggregationOnly": { "type": "boolean", "default": false }
      }
    }
  }
}