Glossary

Model Management uses a small, fixed vocabulary. Code and documentation use only these terms, defined as below. The terms under Deprecated must not be used as domain concepts.

Core terms

Model Artefakt (artifact)

Umbrella term for any persistable CORE unit: DataStructure, Package, Mapping, DataSource, DataSink, Pipeline, DataSet. Every artifact has a stable CORE URN identity and is versioned.

DataStructure

The umbrella for a single modelled domain type — a Class, an Enumeration, etc. A DataStructure is a JSON Schema 2020-12 document whose $id is a versioned CORE URN. It carries version, name, description, URN.

Package

A stored grouping of DataStructures. Importing one JSON Schema document (a root, optionally with $defs) automatically creates one Package that references the resulting DataStructures by URN — the module / provenance grouping ("these DataStructures were authored and imported together"). The Package is named after the imported document's title and is managed under /api/v1/packages. A Package is a stored artifact, not a View — it carries no content of its own and its members resolve on read.

DataSet

An integration composition: a manifest that references DataStructures, Mappings, Pipelines, DataSources and DataSinks by URN (the *Refs arrays). Where a Package groups DataStructures by provenance, a DataSet composes artifacts of all types into a deployable unit.

Bundle

A View that renders an artifact together with the (complete) graph of the artifacts it connects to, as one self-contained document. The bundled (embedded $defs) and dereferenced (inlined) schema projections are both Bundles.

Formatierung (format)

A View that serialises a DataStructure in a chosen representation — JSON Schema or XSD. A DataStructure's format is recorded per version.

View

Umbrella for a read-side projection of stored artifacts — currently Bundle and Formatierung. Views are generated on demand and never stored.

Deprecated terms

Do not use these as domain concepts:

Term	Use instead
Collection	Package (a group of DataStructures) or DataSet (a composition of artifacts)
Document	DataStructure / Package / Artefakt — "document" is allowed only as a plain description of a JSON Schema file, never as a domain entity
DataModel / Datenmodell	DataStructure (one type) or Package (a group)

Relationships at a glance

• Package and DataSet are both manifests of artifact URNs: Package is DataStructure-only and import-scoped; DataSet is all-types and composition-scoped.
• A Bundle is a View over an artifact and its dependency graph; Formatierung is a View choosing the serialisation. Both are kinds of View.
• The JSON-LD output was removed (no consumer) — there is no RDF/Linked-Data projection.