{
  "mapping": "catalogue",
  "version": 1,
  "updated": "2026-11-08",
  "updated_by": "asset-interchange (first draft, for Setup to edit)",
  "about": "The product catalogue (product-catalogue@1) in JSM Assets and Jira. An installed base item becomes an Installed item object, a catalogue model becomes a Catalogue model object, and a plan placement becomes a proposed install issue linked to the installed item it serves. Values the catalogue holds as not_known are written as not known, with the reason.",
  "source": {
    "cite": "missionsight-product-catalogue contracts/product-catalogue (README, schema, api.md), read at d9d2fa3ca2cd61bd; 8 November 2026",
    "read": "2026-11-08"
  },
  "contract": "product-catalogue@1",
  "jira": {
    "object_schema": {
      "name": "Site equipment",
      "key": "SEQ",
      "description": "The site's installed base and the catalogue models a plan names, copied and linked from the product catalogue."
    },
    "label_attribute": "Data label",
    "labels": {
      "fixture": "fixture: written to the fixture Jira site, not a real Jira",
      "real": "real"
    }
  },
  "installed_item": {
    "object_type": "Installed item",
    "tag_attribute": "Installed item id",
    "attributes": [
      { "name": "Installed item id", "type": "Text", "from": "id" },
      { "name": "Name", "type": "Text", "from": "name" },
      { "name": "Asset class", "type": "Text", "from": "asset_class" },
      { "name": "Maker", "type": "Text", "from": "maker" },
      { "name": "Model", "type": "Text", "from": "model" },
      { "name": "Installed", "type": "Text", "from": "installed" },
      { "name": "Count", "type": "Text", "from": "count" },
      { "name": "Zone", "type": "Text", "from": "location.zone" },
      { "name": "3D component", "type": "Text", "from": "scene_component" },
      { "name": "Site", "type": "Text", "from": "site" },
      { "name": "Installed base version", "type": "Integer", "from": "installed_base_version" },
      { "name": "Sources", "type": "Textarea", "from": "sources" }
    ]
  },
  "model": {
    "object_type": "Catalogue model",
    "tag_attribute": "Model id",
    "attributes": [
      { "name": "Model id", "type": "Text", "from": "id" },
      { "name": "Name", "type": "Text", "from": "name" },
      { "name": "Maker", "type": "Text", "from": "maker" },
      { "name": "Kind", "type": "Text", "from": "kind" },
      { "name": "Status", "type": "Text", "from": "status" },
      { "name": "Price band", "type": "Text", "from": "price" },
      { "name": "Documents", "type": "Textarea", "from": "documents" },
      { "name": "Catalogue version", "type": "Text", "from": "catalogue_version" },
      { "name": "Sources", "type": "Textarea", "from": "sources" }
    ]
  },
  "install_ticket": {
    "issuetype": "Task",
    "summary": "Proposed install: {what_name} for {for_name}",
    "labels": ["proposed-install", "product-plan"],
    "state": "proposed",
    "note": "A proposal from the plan, never an order: a person decides in Jira. The issue type and labels are to confirm on the test project."
  }
}
