{
  "name": "Packrift packingsolver-compatible fixture data contract",
  "version": "v2026.05.31",
  "generated_at": "2026-05-31T16:12:00Z",
  "canonical_url": "https://packrift-benchmark-navigator.vercel.app/packingsolver-data-contract.html",
  "publisher": {
    "name": "Packrift",
    "url": "https://packrift.com/"
  },
  "standards": [
    {
      "name": "JSON Schema",
      "version": "Draft 2020-12",
      "url": "https://json-schema.org/draft/2020-12"
    },
    {
      "name": "W3C CSV on the Web (CSVW) metadata",
      "url": "https://w3c.github.io/csvw/metadata/"
    },
    {
      "name": "MLCommons Croissant",
      "version": "1.1",
      "url": "https://docs.mlcommons.org/croissant/docs/croissant-spec-1.1.html"
    }
  ],
  "count_treatment": "Owned Packrift public data-contract files only; not a third-party backlink, not SEO-tool-visible referring-domain proof, and not an endorsement claim.",
  "boundaries": [
    "Fixture orders are generated from public Packrift benchmark records and are not real customer orders.",
    "Target carton fields are scenario anchors for review and parser tests, not optimal solutions.",
    "The data contract describes field semantics, validation gates, and source boundaries for dataset venue reviewers and maintainers.",
    "No live pricing, live inventory, freight approval, or third-party acceptance is claimed."
  ],
  "files": {
    "html": "https://packrift-benchmark-navigator.vercel.app/packingsolver-data-contract.html",
    "json": "https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/data-contract.json",
    "csv": "https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/data-contract.csv",
    "csvw": "https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/csvw-metadata.json",
    "croissant": "https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/fixture-croissant.jsonld",
    "schemas": [
      "https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/schemas/fixture_cartons.schema.json",
      "https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/schemas/fixture_orders.schema.json",
      "https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/schemas/fixture_order_summaries.schema.json",
      "https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/schemas/instance_index.schema.json"
    ]
  },
  "table_counts": {
    "fixture_cartons": 120,
    "fixture_orders": 803,
    "fixture_order_summaries": 350,
    "instance_index": 350
  },
  "validation": {
    "status": "pass",
    "rowCounts": {
      "fixture_cartons": 120,
      "fixture_orders": 803,
      "fixture_order_summaries": 350,
      "instance_index": 350
    },
    "checks": [
      {
        "name": "CSV headers match the published data contract",
        "status": "pass"
      },
      {
        "name": "Required fields are populated",
        "status": "pass"
      },
      {
        "name": "Numeric fields parse as numbers",
        "status": "pass"
      },
      {
        "name": "All target cartons resolve to candidate carton SKUs",
        "status": "pass"
      },
      {
        "name": "All generated packingsolver file-set URLs exist locally",
        "status": "pass"
      },
      {
        "name": "Scenario order, summary, and instance-index keys reconcile",
        "status": "pass"
      },
      {
        "name": "No customer, freight, live-price, live-inventory, or optimal-solution claim is introduced",
        "status": "pass"
      }
    ],
    "errors": []
  },
  "field_sets": [
    {
      "id": "fixture_cartons",
      "title": "Fixture Cartons",
      "file": "https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/fixture_cartons_v2026.05.31.csv",
      "schema": "https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/schemas/fixture_cartons.schema.json",
      "description": "Candidate bin/carton records derived from public Packrift carton product records.",
      "primary_key": "carton_id",
      "row_count": 120,
      "fields": [
        {
          "name": "carton_id",
          "semantic_type": "string",
          "required": true,
          "description": "Stable generated carton row identifier."
        },
        {
          "name": "sku",
          "semantic_type": "string",
          "required": true,
          "description": "Packrift source SKU for the carton candidate."
        },
        {
          "name": "title",
          "semantic_type": "string",
          "required": true,
          "description": "Public product title used for review."
        },
        {
          "name": "length_in",
          "semantic_type": "number",
          "required": true,
          "description": "Parsed internal length in inches."
        },
        {
          "name": "width_in",
          "semantic_type": "number",
          "required": true,
          "description": "Parsed internal width in inches."
        },
        {
          "name": "height_in",
          "semantic_type": "number",
          "required": true,
          "description": "Parsed internal height in inches."
        },
        {
          "name": "volume_cuin",
          "semantic_type": "number",
          "required": true,
          "description": "Length x width x height in cubic inches."
        },
        {
          "name": "family",
          "semantic_type": "enum",
          "required": true,
          "description": "Source Packrift family."
        },
        {
          "name": "quality_score",
          "semantic_type": "integer",
          "required": true,
          "description": "Source quality score from the benchmark quality ledger."
        },
        {
          "name": "source_product_url",
          "semantic_type": "url",
          "required": true,
          "description": "Public Packrift product URL used as source evidence."
        },
        {
          "name": "carton_role",
          "semantic_type": "enum",
          "required": true,
          "description": "Fixture role for the row."
        }
      ]
    },
    {
      "id": "fixture_orders",
      "title": "Fixture Orders",
      "file": "https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/fixture_orders_v2026.05.31.csv",
      "schema": "https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/schemas/fixture_orders.schema.json",
      "description": "Generated scenario order-line records for parser and converter tests. These are not customer orders.",
      "primary_key": "order_id,item_sku",
      "row_count": 803,
      "fields": [
        {
          "name": "order_id",
          "semantic_type": "string",
          "required": true,
          "description": "Generated scenario identifier."
        },
        {
          "name": "scenario_family",
          "semantic_type": "enum",
          "required": true,
          "description": "Generated review scenario family."
        },
        {
          "name": "scenario_note",
          "semantic_type": "string",
          "required": true,
          "description": "Plain-English scenario description."
        },
        {
          "name": "target_carton_sku",
          "semantic_type": "string",
          "required": true,
          "description": "Scenario anchor carton SKU, not an optimal solution claim."
        },
        {
          "name": "target_carton_title",
          "semantic_type": "string",
          "required": true,
          "description": "Target carton public title."
        },
        {
          "name": "item_sku",
          "semantic_type": "string",
          "required": true,
          "description": "Packrift source item SKU."
        },
        {
          "name": "item_title",
          "semantic_type": "string",
          "required": true,
          "description": "Public item title used for review."
        },
        {
          "name": "item_family",
          "semantic_type": "enum",
          "required": true,
          "description": "Source item family."
        },
        {
          "name": "item_length_in",
          "semantic_type": "number",
          "required": true,
          "description": "Parsed item length in inches."
        },
        {
          "name": "item_width_in",
          "semantic_type": "number",
          "required": true,
          "description": "Parsed item width in inches."
        },
        {
          "name": "item_height_in",
          "semantic_type": "number",
          "required": true,
          "description": "Parsed item height in inches."
        },
        {
          "name": "item_count",
          "semantic_type": "integer",
          "required": true,
          "description": "Generated item quantity for the scenario line."
        },
        {
          "name": "estimated_item_volume_cuin",
          "semantic_type": "number",
          "required": true,
          "description": "Line-level estimated cube in cubic inches."
        },
        {
          "name": "source_product_url",
          "semantic_type": "url",
          "required": true,
          "description": "Public Packrift product URL used as source evidence."
        },
        {
          "name": "source_basis",
          "semantic_type": "string",
          "required": true,
          "description": "Boundary statement for source and scenario generation."
        }
      ]
    },
    {
      "id": "fixture_order_summaries",
      "title": "Fixture Order Summaries",
      "file": "https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/fixture_order_summaries_v2026.05.31.csv",
      "schema": "https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/schemas/fixture_order_summaries.schema.json",
      "description": "Scenario-level summaries used to audit total volume and cube-utilization bands.",
      "primary_key": "order_id",
      "row_count": 350,
      "fields": [
        {
          "name": "order_id",
          "semantic_type": "string",
          "required": true,
          "description": "Generated scenario identifier."
        },
        {
          "name": "scenario_family",
          "semantic_type": "enum",
          "required": true,
          "description": "Generated review scenario family."
        },
        {
          "name": "target_carton_sku",
          "semantic_type": "string",
          "required": true,
          "description": "Scenario anchor carton SKU."
        },
        {
          "name": "target_carton_volume_cuin",
          "semantic_type": "number",
          "required": true,
          "description": "Target carton cube in cubic inches."
        },
        {
          "name": "line_count",
          "semantic_type": "integer",
          "required": true,
          "description": "Number of order lines in fixture_orders."
        },
        {
          "name": "estimated_total_item_volume_cuin",
          "semantic_type": "number",
          "required": true,
          "description": "Sum of generated line cube."
        },
        {
          "name": "estimated_cube_utilization",
          "semantic_type": "number",
          "required": true,
          "description": "Estimated item cube divided by target carton cube."
        }
      ]
    },
    {
      "id": "instance_index",
      "title": "Instance Index",
      "file": "https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/instance-index.csv",
      "schema": "https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/schemas/instance_index.schema.json",
      "description": "Scenario-to-packingsolver input file map for bins.csv, items.csv, and parameters.csv.",
      "primary_key": "order_id",
      "row_count": 350,
      "fields": [
        {
          "name": "order_id",
          "semantic_type": "string",
          "required": true,
          "description": "Generated scenario identifier."
        },
        {
          "name": "scenario_family",
          "semantic_type": "enum",
          "required": true,
          "description": "Generated review scenario family."
        },
        {
          "name": "scenario_note",
          "semantic_type": "string",
          "required": true,
          "description": "Plain-English scenario description."
        },
        {
          "name": "target_carton_sku",
          "semantic_type": "string",
          "required": true,
          "description": "Scenario anchor carton SKU."
        },
        {
          "name": "line_count",
          "semantic_type": "integer",
          "required": true,
          "description": "Number of source item lines."
        },
        {
          "name": "estimated_total_item_volume_cuin",
          "semantic_type": "number",
          "required": true,
          "description": "Total estimated item cube."
        },
        {
          "name": "estimated_cube_utilization",
          "semantic_type": "number",
          "required": true,
          "description": "Estimated cube utilization."
        },
        {
          "name": "item_families",
          "semantic_type": "string",
          "required": true,
          "description": "Pipe-delimited source families present in the scenario."
        },
        {
          "name": "source_product_url_count",
          "semantic_type": "integer",
          "required": true,
          "description": "Unique Packrift product URLs used by the scenario."
        },
        {
          "name": "bins_csv_url",
          "semantic_type": "url",
          "required": true,
          "description": "Public bins.csv URL for the generated packingsolver input."
        },
        {
          "name": "items_csv_url",
          "semantic_type": "url",
          "required": true,
          "description": "Public items.csv URL for the generated packingsolver input."
        },
        {
          "name": "parameters_csv_url",
          "semantic_type": "url",
          "required": true,
          "description": "Public parameters.csv URL for the generated packingsolver input."
        },
        {
          "name": "file_set_present",
          "semantic_type": "boolean-string",
          "required": true,
          "description": "Whether all three generated input files are present."
        }
      ]
    }
  ]
}