Versioned source of truth for shared Dream Consistency Realm system catalogs, package manifests, stable UUID identities, validation, and embedded JSON content.
DreamConsistency.RealmCatalogs is an internal Dream Consistency NuGet package
containing versioned system catalog content for Realm databases.
The package targets .NET Standard 2.1 so it can be consumed by console applications, APIs, validation tools, provisioning tools, and future platform components without depending on a specific product runtime.
DreamConsistency.RealmCatalogs is one of the shared system catalog content libraries.
The single DreamConsistency.SystemCatalogInstaller.Cnsl executable installs and upgrades
Realm, Management, Billing, and future shared Dream Consistency catalogs.
DreamConsistency.SystemCatalogInstaller.Cnsl.
| Property | Value |
|---|---|
| Project Type | Class Library / internal NuGet package |
| Target Framework | netstandard2.1 |
| Language Version | C# 10 |
| Package ID | DreamConsistency.RealmCatalogs |
| Versioning | Semantic Versioning: MAJOR.MINOR.PATCH |
| NuGet Feed | https://nuget.dreamconsistency.com/v3/index.json |
| Repository | dreamconsistency.realmcatalogs |
| Package | Purpose |
|---|---|
DreamConsistency.Realm.Foundation |
Minimum Realm catalogs required before Realm bootstrap. |
DreamConsistency.Realm.Applications |
Shared Dream Consistency application catalog. |
DreamConsistency.Realm.Common |
Currencies, languages, and communication contact types. |
DreamConsistency.Realm.Commerce |
Markets, tax behaviors, and related commercial catalogs. |
DreamConsistency.Realm.Subscriptions |
Subscription statuses, payment frequencies, types, and pricing component catalogs. |
DreamConsistency.Realm.ServiceRegistry |
Shared service registry status catalogs. |
DreamConsistency.Realm.TenantApplications |
Tenant application operational and onboarding catalogs. |
DreamConsistency.Realm.Notifications |
Shared Realm notification type catalog. |
DreamConsistency.Realm.Foundation contains the minimum system catalog content
required before the Realm can be initialized:
INF_EnvironmentsINF_RealmOperationalStatusesDreamConsistency.RealmBootstrap.Cnsl does not install
DreamConsistency.Realm.Foundation.
It verifies that Foundation is installed and then creates the self Realm and first Core operator.
The package.json manifest defines the stable package identity,
logical version, target database, minimum schema version, dependencies,
included resources, model types, and update modes.
Catalog JSON files contain stable UUID values and package-managed business fields. They do not contain database RefID values, timestamps, connection strings, environment secrets, or runtime registry data.
| Representation | Purpose |
|---|---|
| Embedded assembly resource | Runtime loading through the catalog provider. |
NuGet catalogs/ content |
Inspection, audit, and release transparency. |
| Service | Responsibility |
|---|---|
IRealmCatalogPackageProvider |
Public contract for package and catalog access. |
RealmCatalogPackageProvider |
Loads and caches embedded manifests and catalog resources. |
RealmCatalogJsonSerializer |
Deserializes embedded JSON into strongly typed models. |
RealmCatalogTypeResolver |
Maps manifest model types to concrete catalog model classes. |
RealmCatalogContentHasher |
Calculates deterministic SHA-256 package content hashes. |
RealmCatalogPackageValidator |
Validates manifests, dependencies, UUIDs, duplicates, fields, and cross-catalog references. |
These services do not open database connections and do not persist catalog rows.
The provider and validator are consumed by the system catalog installer, Realm bootstrap validation, catalog validation tools, tests, and release pipelines.
DreamConsistency.SystemCatalogInstaller.Cnsl
persists Realm catalog content into a Realm database.
Validation must complete successfully before publishing a new NuGet version.
| Property | Value |
|---|---|
| Job Name | DreamConsistency.RealmCatalogs - NuGet Release |
| Description | Builds, validates, packages, and optionally publishes the versioned Realm catalogs NuGet package. |
| Execution | Manual Jenkins pipeline from SCM |
| Docker Image | mcr.microsoft.com/dotnet/sdk:10.0 |
| NuGet Credential | dreamconsistency-nuget-api-key |
| Target Feed | https://nuget.dreamconsistency.com/v3/index.json |
| Parameter | Purpose |
|---|---|
PACKAGE_VERSION |
NuGet version in MAJOR.MINOR.PATCH format, for example 1.0.0. |
PUBLISH_PACKAGE |
When enabled, publishes the generated package to the internal NuGet feed. |
--skip-duplicate.
Publishing an already existing version must fail.
| Version | Meaning |
|---|---|
| NuGet Version | Immutable distribution version of the complete library. |
| Logical Package Version | Version of a specific package such as DreamConsistency.Realm.Foundation. |
| Manifest Format Version | Version of the package.json contract. |
When any manifest or catalog JSON resource changes:
DreamConsistency.RealmCatalogs NuGet version.DreamConsistency.SystemCatalogInstaller.Cnsl.| Shared Realm System Catalogs | Hestino / Legislator Product Catalogs |
|---|---|
Stored in DreamConsistency.RealmCatalogs. |
Stored in product-specific catalog package projects. |
| Installed into a physical Realm platform database. | Deployed to a specific product or TenantApplication. |
Installed by SystemCatalogInstaller.Cnsl. |
Managed through the product Management package workflow. |
| Product-neutral platform content. | Product-specific business content and defaults. |
| Document | Purpose |
|---|---|
docs/package-format.md |
JSON logical package and manifest contract. |
docs/catalog-inventory.md |
Catalog and package ownership inventory. |
docs/legacy-identities.md |
Preserved legacy UUID identities. |
docs/maintenance.md |
Rules for changing published packages, versions, UUIDs, and JSON content. |
| Date | Change | Author |
|---|---|---|
| 2026-08-31 | Added `RealmCatalogIdentities` as the product-neutral public UUID surface for finite canonical Realm vocabularies used explicitly by runtime code. | Branko |
| 2026-08-08 | Added Countries and Timezones catalogs. | Branko |
| 2026-08-02 | Initial Wiki documentation for DreamConsistency.RealmCatalogs. |
Branko |