@documentation-robotics/cli 0.1.0

package/dist/schemas/bundled/02-business-layer.schema.json

@@ -0,0 +1,1293 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://example.com/schemas/02-business-layer.schema.json",
+  "title": "Business Layer Layer Schema",
+  "description": "Represents business services, processes, actors, and objects that define the organization's operational structure and capabilities.",
+  "layerMetadata": {
+    "layerId": "02-business-layer",
+    "layerName": "Business Layer",
+    "intraLayerRelationshipSupport": true,
+    "crossLayerRelationshipSupport": true,
+    "relationshipCatalogVersion": "2.1.0"
+  },
+  "intraLayerRelationships": {
+    "$comment": "Relationships between entities within this layer. References relationship-catalog.json by ID.",
+    "allowed": [
+      {
+        "relationshipTypeId": "composition",
+        "sourceTypes": ["BusinessCollaboration", "TestCoverageModel", "TestCoverageTarget"],
+        "targetTypes": ["BusinessRole", "OutcomeCategory", "TestCoverageTarget"],
+        "examples": [
+          {
+            "source": "BusinessCollaboration",
+            "target": "BusinessRole",
+            "description": "Business collaboration composes business roles that participate in it"
+          },
+          {
+            "source": "TestCoverageModel",
+            "target": "TestCoverageTarget",
+            "description": "Coverage model composes targets defining what needs testing",
+            "layer": "12-testing"
+          },
+          {
+            "source": "TestCoverageTarget",
+            "target": "OutcomeCategory",
+            "description": "Coverage target composes expected outcome categories",
+            "layer": "12-testing"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "aggregation",
+        "sourceTypes": ["CoverageRequirement", "Goal", "InputPartitionSelection"],
+        "targetTypes": ["ContextVariation", "Goal", "PartitionValue"],
+        "examples": [
+          {
+            "source": "Goal",
+            "target": "Goal",
+            "description": "High-level goal aggregates sub-goals",
+            "layer": "01-motivation"
+          },
+          {
+            "source": "InputPartitionSelection",
+            "target": "PartitionValue",
+            "description": "Partition selection aggregates multiple partition values to cover",
+            "layer": "12-testing"
+          },
+          {
+            "source": "CoverageRequirement",
+            "target": "ContextVariation",
+            "description": "Requirement aggregates selected contexts for testing",
+            "layer": "12-testing"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "specialization",
+        "sourceTypes": ["PremiumAccount", "Schema"],
+        "targetTypes": ["Account", "Schema"],
+        "examples": [
+          {
+            "source": "PremiumAccount",
+            "target": "Account",
+            "description": "Premium account specializes the general account concept"
+          },
+          {
+            "source": "Schema",
+            "target": "Schema",
+            "description": "API schema specializes another via allOf/oneOf/anyOf composition",
+            "layer": "06-api"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "realization",
+        "sourceTypes": ["ApplicationService", "Goal", "Outcome"],
+        "targetTypes": ["BusinessService", "Goal", "Value"],
+        "examples": [
+          {
+            "source": "Goal",
+            "target": "Value",
+            "description": "Goal realizes value for stakeholders",
+            "layer": "01-motivation"
+          },
+          {
+            "source": "Outcome",
+            "target": "Goal",
+            "description": "Outcome realizes achievement of goal",
+            "layer": "01-motivation"
+          },
+          {
+            "source": "ApplicationService",
+            "target": "BusinessService",
+            "description": "Application service realizes business service capability"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "assignment",
+        "sourceTypes": ["BusinessActor"],
+        "targetTypes": ["BusinessRole"],
+        "examples": [
+          {
+            "source": "BusinessActor",
+            "target": "BusinessRole",
+            "description": "Business actor assigned to business role"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "association",
+        "sourceTypes": ["Requirement", "Stakeholder"],
+        "targetTypes": ["Constraint", "Driver", "Goal"],
+        "examples": [
+          {
+            "source": "Stakeholder",
+            "target": "Driver",
+            "description": "Stakeholder has concern represented by driver",
+            "layer": "01-motivation"
+          },
+          {
+            "source": "Stakeholder",
+            "target": "Goal",
+            "description": "Stakeholder has interest in goal",
+            "layer": "01-motivation"
+          },
+          {
+            "source": "Requirement",
+            "target": "Constraint",
+            "description": "Requirement is limited by constraint",
+            "layer": "01-motivation"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "influence",
+        "sourceTypes": ["Assessment", "Driver"],
+        "targetTypes": ["Assessment", "Goal"],
+        "examples": [
+          {
+            "source": "Driver",
+            "target": "Assessment",
+            "description": "Driver creates need for assessment",
+            "layer": "01-motivation"
+          },
+          {
+            "source": "Driver",
+            "target": "Goal",
+            "description": "Driver motivates goal definition",
+            "layer": "01-motivation"
+          },
+          {
+            "source": "Assessment",
+            "target": "Goal",
+            "description": "Assessment informs goal setting",
+            "layer": "01-motivation"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "triggering",
+        "sourceTypes": ["BusinessEvent", "CoverageGap", "PartitionDependency"],
+        "targetTypes": ["BusinessProcess", "CoverageRequirement", "PartitionValue"],
+        "examples": [
+          {
+            "source": "BusinessEvent",
+            "target": "BusinessProcess",
+            "description": "Business event triggers business process execution"
+          },
+          {
+            "source": "PartitionDependency",
+            "target": "PartitionValue",
+            "description": "Dependency condition triggers inclusion/exclusion of partition values",
+            "layer": "12-testing"
+          },
+          {
+            "source": "CoverageGap",
+            "target": "CoverageRequirement",
+            "description": "Identified gap triggers need for additional coverage",
+            "layer": "12-testing"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "flow",
+        "sourceTypes": ["BusinessProcess", "CoverageRequirement", "TestCoverageTarget"],
+        "targetTypes": ["BusinessProcess", "CoverageRequirement", "TestCaseSketch"],
+        "examples": [
+          {
+            "source": "BusinessProcess",
+            "target": "BusinessProcess",
+            "description": "One business process flows to the next in sequence"
+          },
+          {
+            "source": "TestCoverageTarget",
+            "target": "CoverageRequirement",
+            "description": "Target flows to requirements that specify its coverage",
+            "layer": "12-testing"
+          },
+          {
+            "source": "CoverageRequirement",
+            "target": "TestCaseSketch",
+            "description": "Requirement flows to sketches that implement it",
+            "layer": "12-testing"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "serving",
+        "sourceTypes": ["BusinessService", "ContextVariation", "InputSpacePartition"],
+        "targetTypes": ["BusinessActor", "TestCoverageTarget"],
+        "examples": [
+          {
+            "source": "BusinessService",
+            "target": "BusinessActor",
+            "description": "Business service serves business actor"
+          },
+          {
+            "source": "InputSpacePartition",
+            "target": "TestCoverageTarget",
+            "description": "Partition serves target by defining testable input space",
+            "layer": "12-testing"
+          },
+          {
+            "source": "ContextVariation",
+            "target": "TestCoverageTarget",
+            "description": "Context serves target by defining execution environments",
+            "layer": "12-testing"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "access",
+        "sourceTypes": ["BusinessProcess", "CoverageRequirement", "TestCaseSketch"],
+        "targetTypes": ["BusinessObject", "InputPartitionSelection", "InputSelection"],
+        "examples": [
+          {
+            "source": "BusinessProcess",
+            "target": "BusinessObject",
+            "description": "Business process accesses business object data"
+          },
+          {
+            "source": "TestCaseSketch",
+            "target": "InputSelection",
+            "description": "Test sketch accesses input selections for test execution",
+            "layer": "12-testing"
+          },
+          {
+            "source": "CoverageRequirement",
+            "target": "InputPartitionSelection",
+            "description": "Requirement accesses partition selections for coverage",
+            "layer": "12-testing"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "uses",
+        "sourceTypes": ["ApplicationComponent"],
+        "targetTypes": ["TechnologyService"],
+        "examples": [
+          {
+            "source": "ApplicationComponent",
+            "target": "TechnologyService",
+            "description": "Application component uses technology service"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "supports-goals",
+        "sourceTypes": ["BusinessService", "Operation"],
+        "targetTypes": ["Goal"],
+        "examples": [
+          {
+            "source": "BusinessService",
+            "sourceLayer": "02-business",
+            "target": "Goal",
+            "targetLayer": "01-motivation",
+            "value": "goal-revenue-growth",
+            "description": "Payment service supports revenue growth goal"
+          },
+          {
+            "source": "Operation",
+            "sourceLayer": "06-api",
+            "target": "Goal",
+            "targetLayer": "01-motivation",
+            "value": "goal-customer-satisfaction",
+            "description": "GET /products operation supports customer satisfaction goal"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "fulfills-requirements",
+        "sourceTypes": ["ApplicationService", "Operation"],
+        "targetTypes": ["Requirement"],
+        "examples": [
+          {
+            "source": "ApplicationService",
+            "target": "Requirement",
+            "description": "OAuth service fulfills authentication requirement"
+          },
+          {
+            "source": "Operation",
+            "sourceLayer": "06-api",
+            "target": "Requirement",
+            "targetLayer": "01-motivation",
+            "value": "req-product-creation-capability",
+            "description": "POST /products operation fulfills product creation requirement"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "delivers-value",
+        "sourceTypes": ["BusinessService"],
+        "targetTypes": ["Value"],
+        "examples": [
+          {
+            "source": "BusinessService",
+            "target": "Value",
+            "description": "Loyalty program delivers customer retention value"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "governed-by-principles",
+        "sourceTypes": ["APIOperation"],
+        "targetTypes": ["Principle"],
+        "examples": [
+          {
+            "source": "APIOperation",
+            "target": "Principle",
+            "description": "REST API governed by RESTful design principles"
+          }
+        ]
+      }
+    ]
+  },
+  "crossLayerRelationships": {
+    "$comment": "Relationships to/from entities in other layers",
+    "outgoing": [
+      {
+        "id": "archimate-application-master-data-source",
+        "predicate": "master-data-source",
+        "inversePredicate": "referenced-by",
+        "targetLayer": "04-application",
+        "targetTypes": ["MasterDataSource"],
+        "sourceTypes": ["BusinessObject"],
+        "fieldPath": "application.master-data-source",
+        "cardinality": "single",
+        "format": "string",
+        "strength": "medium",
+        "required": false,
+        "description": "BusinessObject master data source from DataObject",
+        "examples": []
+      },
+      {
+        "id": "archimate-application-process-steps",
+        "predicate": "process-steps",
+        "inversePredicate": "referenced-by",
+        "targetLayer": "04-application",
+        "targetTypes": ["ProcessStep"],
+        "sourceTypes": ["BusinessProcess"],
+        "fieldPath": "application.process-steps",
+        "cardinality": "array",
+        "format": "reference",
+        "strength": "medium",
+        "required": false,
+        "description": "which specific ApplicationProcess steps realize this business process",
+        "examples": []
+      },
+      {
+        "id": "archimate-application-realized-by-process",
+        "predicate": "realized-by-process",
+        "inversePredicate": "referenced-by",
+        "targetLayer": "04-application",
+        "targetTypes": ["RealizedByProces"],
+        "sourceTypes": ["BusinessProcess"],
+        "fieldPath": "application.realized-by-process",
+        "cardinality": "single",
+        "format": "reference",
+        "strength": "medium",
+        "required": false,
+        "description": "ApplicationService - **BusinessProcess** automated by ApplicationProcess",
+        "examples": []
+      },
+      {
+        "id": "archimate-application-represented-by-dataobject",
+        "predicate": "represented-by-dataobject",
+        "inversePredicate": "referenced-by",
+        "targetLayer": "04-application",
+        "targetTypes": ["RepresentedByDataobject"],
+        "sourceTypes": ["BusinessObject"],
+        "fieldPath": "application.represented-by-dataobject",
+        "cardinality": "single",
+        "format": "string",
+        "strength": "medium",
+        "required": false,
+        "description": "BusinessObject represented in DataObject",
+        "examples": []
+      },
+      {
+        "id": "business-apm-business-metrics",
+        "predicate": "business-metrics",
+        "inversePredicate": "referenced-by",
+        "targetLayer": "02-business",
+        "targetTypes": ["BusinessMetric"],
+        "sourceTypes": ["BusinessProcess"],
+        "fieldPath": "apm.business-metrics",
+        "cardinality": "array",
+        "format": "reference",
+        "strength": "medium",
+        "required": false,
+        "description": "comma-separated business metric IDs this service tracks",
+        "examples": [
+          {
+            "elementType": "BusinessProcess",
+            "elementId": "order-process",
+            "elementName": "Order Fulfillment Process",
+            "fieldPath": "apm.business-metrics",
+            "value": "metric-order-fulfillment-time,metric-order-success-rate",
+            "layer": "02-business"
+          }
+        ]
+      },
+      {
+        "id": "data-governance-owner",
+        "predicate": "governance-owner",
+        "inversePredicate": "referenced-by",
+        "targetLayer": "07-data-model",
+        "targetTypes": ["GovernanceOwner"],
+        "sourceTypes": ["BusinessObject"],
+        "fieldPath": "data.governance-owner",
+        "cardinality": "single",
+        "format": "reference",
+        "strength": "medium",
+        "required": false,
+        "description": "BusinessObject ownership by BusinessActor",
+        "examples": [
+          {
+            "elementType": "BusinessObject",
+            "elementId": "order-object",
+            "elementName": "Order",
+            "fieldPath": "data.governance-owner",
+            "value": "sales-rep",
+            "layer": "02-business"
+          }
+        ]
+      },
+      {
+        "id": "motivation-delivers-value",
+        "predicate": "delivers-value",
+        "inversePredicate": "delivered-by",
+        "targetLayer": "01-motivation",
+        "targetTypes": ["DeliversValue"],
+        "sourceTypes": ["BusinessService"],
+        "fieldPath": "motivation.delivers-value",
+        "cardinality": "array",
+        "format": "reference",
+        "strength": "medium",
+        "required": false,
+        "description": "BusinessService delivers Value",
+        "examples": [
+          {
+            "elementType": "BusinessService",
+            "elementId": "order-service",
+            "elementName": "Order Processing Service",
+            "fieldPath": "motivation.delivers-value",
+            "value": "value-customer-convenience,value-operational-efficiency",
+            "layer": "02-business"
+          },
+          {
+            "elementType": "ApplicationService",
+            "elementId": "product-service",
+            "elementName": "product-service",
+            "fieldPath": "motivation.delivers-value",
+            "value": "value-customer-convenience",
+            "layer": "04-application"
+          }
+        ]
+      },
+      {
+        "id": "motivation-governed-by-principles",
+        "predicate": "governed-by-principles",
+        "inversePredicate": "governs",
+        "targetLayer": "01-motivation",
+        "targetTypes": ["GovernedByPrinciple"],
+        "sourceTypes": ["BusinessService"],
+        "fieldPath": "motivation.governed-by-principles",
+        "cardinality": "array",
+        "format": "reference",
+        "strength": "high",
+        "required": false,
+        "description": "BusinessService governed by Principles",
+        "examples": [
+          {
+            "elementType": "BusinessService",
+            "elementId": "order-service",
+            "elementName": "Order Processing Service",
+            "fieldPath": "motivation.governed-by-principles",
+            "value": "principle-customer-first,principle-automation",
+            "layer": "02-business"
+          },
+          {
+            "elementType": "ApplicationService",
+            "elementId": "product-service",
+            "elementName": "product-service",
+            "fieldPath": "motivation.governed-by-principles",
+            "value": "principle-api-first,principle-cloud-native",
+            "layer": "04-application"
+          }
+        ]
+      },
+      {
+        "id": "motivation-supports-goals",
+        "predicate": "supports-goals",
+        "inversePredicate": "supported-by",
+        "targetLayer": "01-motivation",
+        "targetTypes": ["SupportsGoal"],
+        "sourceTypes": ["BusinessService"],
+        "fieldPath": "motivation.supports-goals",
+        "cardinality": "array",
+        "format": "reference",
+        "strength": "high",
+        "required": false,
+        "description": "BusinessService supports Goals",
+        "examples": [
+          {
+            "elementType": "BusinessService",
+            "elementId": "order-service",
+            "elementName": "Order Processing Service",
+            "fieldPath": "motivation.supports-goals",
+            "value": "goal-customer-satisfaction,goal-revenue-growth",
+            "layer": "02-business"
+          },
+          {
+            "elementType": "ApplicationService",
+            "elementId": "product-service",
+            "elementName": "product-service",
+            "fieldPath": "motivation.supports-goals",
+            "value": "goal-product-catalog-accuracy,goal-customer-satisfaction",
+            "layer": "04-application"
+          }
+        ]
+      },
+      {
+        "id": "security-classification",
+        "predicate": "classification",
+        "inversePredicate": "referenced-by",
+        "targetLayer": "03-security",
+        "targetTypes": ["Classification"],
+        "sourceTypes": ["Artifact"],
+        "fieldPath": "security.classification",
+        "cardinality": "single",
+        "format": "string",
+        "strength": "low",
+        "required": false,
+        "description": "Links to Classification in target layer",
+        "examples": [
+          {
+            "elementType": "Artifact",
+            "elementId": "product-db",
+            "elementName": "product-db",
+            "fieldPath": "security.classification",
+            "value": "internal",
+            "layer": "05-technology"
+          },
+          {
+            "elementType": "Artifact",
+            "elementId": "customer-db",
+            "elementName": "customer-db",
+            "fieldPath": "security.classification",
+            "value": "restricted",
+            "layer": "05-technology"
+          }
+        ]
+      },
+      {
+        "id": "security-process-security-controls",
+        "predicate": "security-controls",
+        "inversePredicate": "referenced-by",
+        "targetLayer": "03-security",
+        "targetTypes": ["SecurityControl"],
+        "sourceTypes": ["BusinessProcess"],
+        "fieldPath": "process.security-controls",
+        "cardinality": "array",
+        "format": "string",
+        "strength": "high",
+        "required": false,
+        "description": "security control references",
+        "examples": [
+          {
+            "elementType": "BusinessProcess",
+            "elementId": "order-process",
+            "elementName": "Order Fulfillment Process",
+            "fieldPath": "process.security-controls",
+            "value": "control-order-approval,control-payment-verification",
+            "layer": "02-business"
+          }
+        ]
+      },
+      {
+        "id": "security-process-separation-of-duty",
+        "predicate": "separation-of-duty",
+        "inversePredicate": "referenced-by",
+        "targetLayer": "03-security",
+        "targetTypes": ["SeparationOfDuty"],
+        "sourceTypes": ["BusinessProcess"],
+        "fieldPath": "process.separation-of-duty",
+        "cardinality": "single",
+        "format": "boolean",
+        "strength": "medium",
+        "required": false,
+        "description": "Links to SeparationOfDuty in target layer",
+        "examples": [
+          {
+            "elementType": "BusinessProcess",
+            "elementId": "order-process",
+            "elementName": "Order Fulfillment Process",
+            "fieldPath": "process.separation-of-duty",
+            "value": "true",
+            "layer": "02-business"
+          }
+        ]
+      }
+    ],
+    "incoming": [
+      {
+        "id": "business-apm-business-metrics",
+        "predicate": "referenced-by",
+        "inversePredicate": "business-metrics",
+        "sourceLayer": "02-business",
+        "sourceTypes": ["BusinessProcess"],
+        "targetTypes": ["BusinessMetric"],
+        "fieldPath": "apm.business-metrics",
+        "cardinality": "array",
+        "description": "Inverse of: comma-separated business metric IDs this service tracks"
+      },
+      {
+        "id": "business-apm-business-metrics",
+        "predicate": "referenced-by",
+        "inversePredicate": "business-metrics",
+        "sourceLayer": "04-application",
+        "sourceTypes": ["ApplicationService"],
+        "targetTypes": ["BusinessMetric"],
+        "fieldPath": "apm.business-metrics",
+        "cardinality": "array",
+        "description": "Inverse of: comma-separated business metric IDs this service tracks"
+      },
+      {
+        "id": "business-apm-business-metrics",
+        "predicate": "referenced-by",
+        "inversePredicate": "business-metrics",
+        "sourceLayer": "06-api",
+        "sourceTypes": ["Operation", "SecurityScheme"],
+        "targetTypes": ["BusinessMetric"],
+        "fieldPath": "apm.business-metrics",
+        "cardinality": "array",
+        "description": "Inverse of: comma-separated business metric IDs this service tracks"
+      },
+      {
+        "id": "business-interface-ref",
+        "predicate": "referenced-by",
+        "inversePredicate": "business-interface-ref",
+        "sourceLayer": "06-api",
+        "sourceTypes": ["Operation", "SecurityScheme"],
+        "targetTypes": ["BusinessInterface"],
+        "fieldPath": "x-business-interface-ref",
+        "cardinality": "single",
+        "description": "Inverse of: string (BusinessInterface.id, optional)"
+      },
+      {
+        "id": "business-object-ref",
+        "predicate": "referenced-by",
+        "inversePredicate": "business-object-ref",
+        "sourceLayer": "07-data-model",
+        "sourceTypes": ["JSONSchema", "x-business-object-ref Extension", "x-security Extension"],
+        "targetTypes": ["BusinessObject"],
+        "fieldPath": "x-business-object-ref",
+        "cardinality": "single",
+        "description": "Inverse of: string (BusinessObject.id reference, optional)"
+      },
+      {
+        "id": "business-service-ref",
+        "predicate": "referenced-by",
+        "inversePredicate": "business-service-ref",
+        "sourceLayer": "06-api",
+        "sourceTypes": ["Operation", "SecurityScheme"],
+        "targetTypes": ["BusinessService"],
+        "fieldPath": "x-business-service-ref",
+        "cardinality": "single",
+        "description": "Inverse of: string (BusinessService.id, optional)"
+      }
+    ]
+  },
+  "type": "object",
+  "properties": {
+    "business-actors": {
+      "type": "array",
+      "description": "Collection of BusinessActor entities",
+      "items": {
+        "$ref": "#/definitions/BusinessActor"
+      }
+    },
+    "business-roles": {
+      "type": "array",
+      "description": "Collection of BusinessRole entities",
+      "items": {
+        "$ref": "#/definitions/BusinessRole"
+      }
+    },
+    "business-collaborations": {
+      "type": "array",
+      "description": "Collection of BusinessCollaboration entities",
+      "items": {
+        "$ref": "#/definitions/BusinessCollaboration"
+      }
+    },
+    "business-interfaces": {
+      "type": "array",
+      "description": "Collection of BusinessInterface entities",
+      "items": {
+        "$ref": "#/definitions/BusinessInterface"
+      }
+    },
+    "business-processes": {
+      "type": "array",
+      "description": "Collection of BusinessProcess entities",
+      "items": {
+        "$ref": "#/definitions/BusinessProcess"
+      }
+    },
+    "business-functions": {
+      "type": "array",
+      "description": "Collection of BusinessFunction entities",
+      "items": {
+        "$ref": "#/definitions/BusinessFunction"
+      }
+    },
+    "business-interactions": {
+      "type": "array",
+      "description": "Collection of BusinessInteraction entities",
+      "items": {
+        "$ref": "#/definitions/BusinessInteraction"
+      }
+    },
+    "business-events": {
+      "type": "array",
+      "description": "Collection of BusinessEvent entities",
+      "items": {
+        "$ref": "#/definitions/BusinessEvent"
+      }
+    },
+    "business-services": {
+      "type": "array",
+      "description": "Collection of BusinessService entities",
+      "items": {
+        "$ref": "#/definitions/BusinessService"
+      }
+    },
+    "business-objects": {
+      "type": "array",
+      "description": "Collection of BusinessObject entities",
+      "items": {
+        "$ref": "#/definitions/BusinessObject"
+      }
+    },
+    "contracts": {
+      "type": "array",
+      "description": "Collection of Contract entities",
+      "items": {
+        "$ref": "#/definitions/Contract"
+      }
+    },
+    "representations": {
+      "type": "array",
+      "description": "Collection of Representation entities",
+      "items": {
+        "$ref": "#/definitions/Representation"
+      }
+    },
+    "products": {
+      "type": "array",
+      "description": "Collection of Product entities",
+      "items": {
+        "$ref": "#/definitions/Product"
+      }
+    }
+  },
+  "definitions": {
+    "EventType": {
+      "type": "string",
+      "enum": ["time-driven", "state-change", "external"]
+    },
+    "RepresentationFormat": {
+      "type": "string",
+      "enum": ["document", "report", "form", "message"]
+    },
+    "BusinessActor": {
+      "type": "object",
+      "description": "An organizational entity capable of performing behavior",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "documentation": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "BusinessRole": {
+      "type": "object",
+      "description": "The responsibility for performing specific behavior",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "documentation": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "BusinessCollaboration": {
+      "type": "object",
+      "description": "Aggregate of business roles working together",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "documentation": {
+          "type": "string",
+          "minLength": 1
+        },
+        "properties": {
+          "type": "object",
+          "description": "Cross-layer properties",
+          "properties": {
+            "collaboration": {
+              "type": "object",
+              "properties": {
+                "security-actors": {
+                  "type": "string",
+                  "description": "optional, Security Actor IDs"
+                },
+                "shared-permissions": {
+                  "type": "string",
+                  "description": "optional"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "BusinessInterface": {
+      "type": "object",
+      "description": "Point of access where business service is available",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "documentation": {
+          "type": "string",
+          "minLength": 1
+        },
+        "properties": {
+          "type": "object",
+          "description": "Cross-layer properties",
+          "properties": {
+            "interface": {
+              "type": "object",
+              "properties": {
+                "api-operations": {
+                  "type": "string",
+                  "description": "optional, comma-separated OpenAPI operation IDs"
+                },
+                "digital-channel": {
+                  "type": "string",
+                  "description": "optional"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "BusinessProcess": {
+      "type": "object",
+      "description": "Sequence of business behaviors achieving a result",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "documentation": {
+          "type": "string",
+          "minLength": 1
+        },
+        "properties": {
+          "type": "object",
+          "description": "Cross-layer properties",
+          "properties": {
+            "process": {
+              "type": "object",
+              "properties": {
+                "bpmn": {
+                  "type": "string",
+                  "description": "optional"
+                },
+                "security-controls": {
+                  "type": "string",
+                  "description": "optional, security control references"
+                },
+                "audit-required": {
+                  "type": "string",
+                  "description": "optional"
+                },
+                "separation-of-duty": {
+                  "type": "string",
+                  "description": "optional"
+                },
+                "kpi-target": {
+                  "type": "string",
+                  "description": "optional"
+                }
+              }
+            },
+            "apm": {
+              "type": "object",
+              "properties": {
+                "business-metrics": {
+                  "type": "string",
+                  "description": "optional, business metric IDs"
+                }
+              }
+            },
+            "application": {
+              "type": "object",
+              "properties": {
+                "realized-by-process": {
+                  "type": "string",
+                  "description": "optional, ApplicationProcess ID that automates this business process"
+                },
+                "process-steps": {
+                  "type": "string",
+                  "description": "optional, which specific ApplicationProcess steps realize this business process"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "BusinessFunction": {
+      "type": "object",
+      "description": "Collection of business behavior based on criteria",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "documentation": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "BusinessInteraction": {
+      "type": "object",
+      "description": "Unit of collective behavior by collaboration",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "documentation": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "BusinessEvent": {
+      "type": "object",
+      "description": "Something that happens and influences behavior",
+      "required": ["id", "name", "type"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "documentation": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "$ref": "#/definitions/EventType"
+        },
+        "properties": {
+          "type": "object",
+          "description": "Cross-layer properties",
+          "properties": {
+            "event": {
+              "type": "object",
+              "properties": {
+                "application-ref": {
+                  "type": "string",
+                  "description": "optional, reference to ApplicationEvent"
+                },
+                "topic": {
+                  "type": "string",
+                  "description": "optional, event bus topic"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "BusinessService": {
+      "type": "object",
+      "description": "Service that fulfills a business need",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "documentation": {
+          "type": "string",
+          "minLength": 1
+        },
+        "properties": {
+          "type": "object",
+          "description": "Cross-layer properties",
+          "properties": {
+            "sla": {
+              "type": "object",
+              "properties": {
+                "availability": {
+                  "type": "string",
+                  "description": "optional"
+                },
+                "response-time": {
+                  "type": "string",
+                  "description": "optional"
+                }
+              }
+            },
+            "motivation": {
+              "type": "object",
+              "properties": {
+                "delivers-value": {
+                  "type": "string",
+                  "description": "optional, comma-separated Value IDs"
+                },
+                "supports-goals": {
+                  "type": "string",
+                  "description": "optional, comma-separated Goal IDs"
+                },
+                "governed-by-principles": {
+                  "type": "string",
+                  "description": "optional, comma-separated Principle IDs"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "BusinessObject": {
+      "type": "object",
+      "description": "Concept used within business domain",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "documentation": {
+          "type": "string",
+          "minLength": 1
+        },
+        "properties": {
+          "type": "object",
+          "description": "Cross-layer properties",
+          "properties": {
+            "spec": {
+              "type": "object",
+              "properties": {
+                "schema": {
+                  "type": "string",
+                  "description": "optional"
+                },
+                "schema-id": {
+                  "type": "string",
+                  "description": "optional, formal reference to Data Model Layer"
+                }
+              }
+            },
+            "data": {
+              "type": "object",
+              "properties": {
+                "governance-owner": {
+                  "type": "string",
+                  "description": "optional, data owner reference"
+                }
+              }
+            },
+            "application": {
+              "type": "object",
+              "properties": {
+                "represented-by-dataobject": {
+                  "type": "string",
+                  "description": "optional, DataObject ID that represents this business concept in applications"
+                },
+                "master-data-source": {
+                  "type": "string",
+                  "description": "optional, authoritative DataObject for this business object"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "Contract": {
+      "type": "object",
+      "description": "Formal specification of agreement",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "documentation": {
+          "type": "string",
+          "minLength": 1
+        },
+        "properties": {
+          "type": "object",
+          "description": "Cross-layer properties",
+          "properties": {
+            "contract": {
+              "type": "object",
+              "properties": {
+                "constraint-refs": {
+                  "type": "string",
+                  "description": "optional, comma-separated Constraint IDs"
+                },
+                "sla-metrics": {
+                  "type": "string",
+                  "description": "optional, measurable SLA commitments"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "Representation": {
+      "type": "object",
+      "description": "Perceptible form of business object",
+      "required": ["id", "name", "format"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "documentation": {
+          "type": "string",
+          "minLength": 1
+        },
+        "format": {
+          "$ref": "#/definitions/RepresentationFormat"
+        }
+      }
+    },
+    "Product": {
+      "type": "object",
+      "description": "Coherent collection of services with a value",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "documentation": {
+          "type": "string",
+          "minLength": 1
+        },
+        "services": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        },
+        "contracts": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  }
+}