KIT Artifacts
Status | Created | Post-History |
---|---|---|
Draft | 04-Apr-2024 | Initial contribution |
This explains each artifact a KIT can or must follow - depending on the graduation stage TRG 9.01. An artifact is textual content or a technical component that is part of a KIT (e.g. a Vision statement).
CHANGELOG
To achieve uniformity, we use semantic versioning. Concrete examples in our already published KITs. For a KIT we distinguish between three phases sandbox, incubating and graduated.
Sandbox Phase
Has no changelog - it´s a preview for the KIT.
Incubating Phase
The first released version of the KIT. It´s ready to be used by data providers / consumers, app-/service providers or operators.
Graduated Phase
Upon reaching the Graduation Phase, a KIT got verified by a data providers / consumers, app-/service providers or operators. Since the KITs are maintained and further developed by the community, changes can be made that result in an incompatibility.
Business View
The business view gives a general introduction to the KIT. It aims to provide insights to industry problems, the KIT is addressing. Mandatory for every KIT and all graduation stages The vision describes the strategic objectives of a KIT and how it aims to inspire solution providers. Deliverables:
- Vision catch phrase + context
- Mission catch phrase
- Context to the use case
Starting with the vision of the KIT (one or two catching phrases)
Example from BPDM:
Unique business partner data sets for the whole data space. Basis for integration value-adding services in the area of business partner data management.
The missions of the KIT
Mandatory for every KIT and all graduation stages
The mission explains why we are providing the KIT describing a concrete industry problem.
Example from BPDM:
“The KIT provides a homogenous semantic with an open data model, high data quality and one access point to the business partner data sets.”
Giving more context with explaining the connection to the use case
Example from BPDM:
The BusinessPartner KIT provides high-quality data records of business partners called golden record, including a unique identifier, the business partner number (BPN).
…
Business Value
Mandatory for every KIT that is related to a use case and all graduation stages
The business value describes the benefits for an service provider by using a KIT in order to create a commercial or non-profit solution for the Catena-X marketplaces.
Deliverable:
About 3 to 5 top business values (title + description)
Example from BPDM:
One open data model: Application and Service provider can reduce investments to integrate due to one data model / API specification and open interface. The pool API enables the integration and offering of value-added services and innovation based on high-quality master data.
Access to new market potentials: Potential to scale customer group and access new market potentials via Catena-X marketplace and shared service network. The BP KIT enables an interoperable foundation for value-added services.
The unique identifier: BPN is the unique number to identify and find partners in the Catena-X network. It will also provide high quality data sets from business partners, their legal unit, sites and addresses.
Use Case / Domain explanation
Mandatory for every KIT that is related to a use case and all graduation stages This gives more insights into the use case or domain itself.
- Todays challenge
- Values for taking the challenge
- Benefits for OEM, SME, Solution Provider
Deliverable: Status quo, challenge and the benefits from different perspectives
Example from BPDM:
Business Partner KIT comes from the use case Business Partner Data Management. Status Quo / Todays challenge:
Most of today’s automotive companies have to invest a significant amount to keep their individual partner master data updated and correct, since outdated or incorrect data records result in federal fines and wrong claims / billing processes. The industry spends a vast amount into an area that is non differentiating, regulated and executed redundantly across the partners. For this, cutting individual company costs by offering the golden master data record as a shared service and proactively reduce Business Partner risk via collaborative value-add services. This will become the industry’s largest golden record collection as a shared and cost-optimized service (quality tested by the biggest players). OEMs and small-medium enterprises can: - Reduce today’s individual investments in master data mgt.
- Re-allocate freed-up resources to differentiating / critical tasks
- Time to value within 6 months, due to standard interfaces and mapping tools (e.g. SAP)
- Increase data quality and use industry collective wisdom to act pro-actively (e.g. fraud alerts) Solution Provider:
- Reduce investments to integrate due to one Data Model and open interface.
- The KIT enables the offering of value-add services and innovation based on golden record and collective wisdom.
- Potential to scale customer group and access new market potentials via marketplace and shared service network.
Tutorials
Mandatory for the 'Graduated' stage. Optional for 'sandbox' and 'incubating' A tutorial provides educational resources that provides step-by-step guidance on how to use a KIT. Tutorials can be delivered in various formats, such as videos or written text. It may also provide additional resources for further exploration of the topic. Deliverables:
- Description
- Tutorial video or screenshot documentation
Whitepaper
Optional A whitepaper outlines the overall objectives of a KIT regarding a specific business problem. It provides readers with background information on the topic, identifies key challenges and solutions to those challenges, evaluates alternative approaches to solving the business problem at hand, and offers recommendations for action. Deliverable:
- Description
- Link to the whitepaper
Semantic Models
Mandatory for every KIT that is related to a use case + for the 'incubating' stage The semantic data models are a method of structuring data that includes semantic information that adds a basic meaning to the data and the relationships that lie between them to enable interoperability. Deliverables:
- Description
- Link to the semantic data models (GitHub)
Example from Traceability:
Traceability Semantic Models
Logic / Schema
Mandatory for every KIT that is related to a use case + for the 'incubating' stage Logic / schemas provides a definition of the minimum viable business process that must be implemented to enable interoperability. Deliverables: Description
Business Process
Mandatory for every KIT that is related to a use case + for the 'incubating' stage Data sovereignty is one of the main principles of Catena-X and a major topic for the participants in the data space. This part should help to understand how the business process works and provides a blue print on how access & usage policies could look like.
- Business Architecture
- Access & Usage Policies
Standards
Mandatory for every KIT that wants to go to the 'incubating' stage
Links to the relevant standards (Association Library). Add the relevant number of the standard, the name and version of the standard.
Example:
CX - 001 Standardname (Version 2.0)
Notice
Mandatory for every KIT and all graduation stages
KIT documentation works under the CC-BY-4.0 license. Therefore you need to add the "notice" part to make transparent which companies worked on this KIT.
Example:
This work is licensed under the CC-BY-4.0.
- SPDX-License-Identifier: CC-BY-4.0
- SPDX-FileCopyrightText: 2023,2024 ZF Friedrichshafen AG
- SPDX-FileCopyrightText: 2023,2024 Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
- SPDX-FileCopyrightText: 2023,2024 SAP SE
- SPDX-FileCopyrightText: 2023,2024 Volkswagen AG
- SPDX-FileCopyrightText: 2023,2024 Robert Bosch GmbH
- SPDX-FileCopyrightText: 2023,2024 Mercedes Benz Group
- SPDX-FileCopyrightText: 2023,2024 BASF SE
- SPDX-FileCopyrightText: 2023,2024 Schaeffler AG
- SPDX-FileCopyrightText: 2023,2024 Contributors to the Eclipse Foundation
- Source URL: BPDM GitHub repository
Development View
The development view provides developers with resources to accelerate the development of apps and services.
API Specifications
Mandatory for every KIT that wants to go to the 'incubating' stage Deliverables:
- Introduction to the API / specification of the API
- Whats the main focus of the API
- Integration of the OpenAPI file
- Use case examples for the API endpoints and how to use them
Example from DataChain KIT:
The API of the Item Relationship Service (IRS) for retrieving item graphs along the value chain of Catena-X partners.Example for OpenAPI integration:
Sample Data
Deliverable:
- Description on how to use the sample data
- File with sample data
Reference Implementation
Deliverable:
- Description
- Link to repository
Documentation in the context of development
Deliverable:
- Arch42
- Usage examples
- More explanation on how to use the API in different scenarios
Operations View
... provides resources to deploy and operate centralized & decentralized Catena-X offerings in your IT environment (e.g., on-prem, cloud). Deliverables: Quick Setup Guide / Installation Instructions
- Prerequisites (if they exist)
- Authorization information
- Deployment Deployment Scripts
Architecture View
The architecture view is an optional chapter. It offers an architecture perspective including the main building blocks and the runtime view. It can be extended with more architecture documentation like an ARC42.
Example for an Architecture View:
.