Skip to main content
Version: V2-Next

Introduction

CIVITAS/CORE Model Forge is the embedded design-time runtime for data modelling, versioning and integration configuration in the CIVITAS/CORE urban data platform.

It is consumed as Java/Spring Boot modules by a host application. The host integrating it is portal-backend from civitas-core-platform. Model Forge is not a standalone service.

What Model Forge Does​

CapabilityDescription
Schema registryImport, version and search JSON Schema / XSDXML Schema DefinitionA W3C language for describing the structure of XML documents. Model Management imports XSD into JSON Schema and can serialize an Element as XSD. Elements
Dependency graph$ref relationships as a queryable graph: dependencies, dependents, impact analysis
ViewsGenerated projections: inlined and bundled ($defs)
ValidationJSON Schema 2020-12 validation plus registry-aware existence checks for x-core-ref foreign keys
CompositionDataSet manifests referencing artifacts by URN
DataStructuresNamed, versioned groupings of Elements
Standards importXÖV standards from XRepository (XSDXML Schema DefinitionA W3C language for describing the structure of XML documents. Model Management imports XSD into JSON Schema and can serialize an Element as XSD. → JSON Schema) and FIWARE Smart Data Models from GitHub
CORE-IRCORE Intermediate RepresentationThe JSON-based exchange format between Model Management, UI, registry, Configuration Adapters and downstream generators. exportDataSet manifests and their referenced artifacts for downstream pipeline engines

Technology​

ConcernTechnology
RuntimeJava 25, Spring Boot 4 compatible starter
Integration boundaryEmbedded Java facade
Schema formatJSON Schema 2020-12
RegistryPostgreSQL artifact registry, migrated with Flyway in a dedicated schema
Validationnetworknt json-schema-validator
TypeScript artifactsZod / TypeScript types generated from the CORE-IRCORE Intermediate RepresentationThe JSON-based exchange format between Model Management, UI, registry, Configuration Adapters and downstream generators. JSON Schemas