Versioned source of truth for shared Dream Consistency Management system catalogs, package manifests, stable UUID identities, validation, and embedded JSON content.
DreamConsistency.ManagementCatalogs is an internal Dream Consistency NuGet package
containing versioned system catalog content for Management databases.
The package targets .NET Standard 2.1 so it can be consumed by Dream Consistency console applications, APIs, validators, provisioning tools, and future platform components without depending on a specific product runtime.
| Area | Status |
|---|---|
| Management source model analysis | Completed |
| Shared catalog table identification | Completed |
| Extensible registry ownership classification | Proposed — confirm before publishing 1.0.0 |
| Logical package structure | Completed |
| Initial catalog values | Proposed — approval required before publishing 1.0.0 |
| Static project validation | Completed |
| Real restore, build, validation, and pack | Performed by Jenkins using the .NET 10 SDK image |
DreamConsistency.ManagementCatalogs 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 system catalogs.
The Management database is the shared operational-history contract for Dream Consistency product control planes. It records operations, steps, attempts, package installation state, usage snapshots, imports, internal notes, and management audit history.
DreamConsistency.SystemCatalogInstaller.Cnsl.
| Property | Value |
|---|---|
| Project Type | Class Library / internal NuGet package |
| Target Framework | netstandard2.1 |
| Language Version | C# 10 |
| Package ID | DreamConsistency.ManagementCatalogs |
| Initial Version | 1.0.0 |
| Versioning | Semantic Versioning: MAJOR.MINOR.PATCH |
| NuGet Feed | https://nuget.dreamconsistency.com/v3/index.json |
| Repository | https://bitbucket.org/skyrocket_novisad/dreamconsistency.managementcatalogs |
| Source Model | ManagementDB Current(1).mwb |
The initial catalog inventory was derived from the supplied Management Workbench model. The model contains 21 tables, of which 6 are shared system catalog tables.
| Table | Logical Package |
|---|---|
OPS_OperationStatuses |
DreamConsistency.Management.Foundation |
OPS_OperationTypes |
DreamConsistency.Management.Operations |
PKG_PackageInstallationStatuses |
DreamConsistency.Management.Packages |
USG_MetricValueTypes |
DreamConsistency.Management.Usage |
AUD_ActionTypes |
DreamConsistency.Management.Auditing |
IMP_ImportStatuses |
DreamConsistency.Management.Imports |
Each included table has a database-local identifier, a stable UUID,
a required Name, and an optional Description.
| Table | Ownership Reason |
|---|---|
PKG_Packages |
Runtime registry of product package identities and versions. |
USG_MetricTypes |
Product-extensible metric-definition registry referencing shared metric value types. |
IMP_ImportTypes |
Product-extensible import capability registry. |
INF_ManagementSchemaVersions is schema and contract version metadata.
It is managed by schema deployment and is not catalog package content.
These tables contain operations, history, package state, usage data, audit entries, notes, imports, or import issues. They are runtime Management data, not shared system catalogs.
| Package | Purpose | Dependencies |
|---|---|---|
DreamConsistency.Management.Foundation |
Minimum shared operation-status vocabulary required by Management workflows. | None |
DreamConsistency.Management.Operations |
Shared product-neutral Management operation types. | Management.Foundation >= 1.0.0 |
DreamConsistency.Management.Packages |
Shared package installation lifecycle statuses. |
Management.Foundation >= 1.0.0Management.Operations >= 1.0.0
|
DreamConsistency.Management.Usage |
Shared usage metric value-storage types. | Management.Foundation >= 1.0.0 |
DreamConsistency.Management.Auditing |
Shared product-neutral Management audit action types. | Management.Foundation >= 1.0.0 |
DreamConsistency.Management.Imports |
Shared Management data-import lifecycle statuses. |
Management.Foundation >= 1.0.0Management.Operations >= 1.0.0
|
| Catalog | Values |
|---|---|
OPS_OperationStatuses |
PENDING, IN_PROGRESS, SUCCEEDED,
PARTIALLY_SUCCEEDED, SKIPPED,
FAILED, CANCELLED
|
The same status catalog is used by operations, operation steps, and operation step attempts.
SKIPPED is included because an optional persisted step can be intentionally skipped.
| Catalog | Values |
|---|---|
OPS_OperationTypes |
PROVISION_TENANT,
SUSPEND_TENANT_APPLICATION,
REACTIVATE_TENANT_APPLICATION,
INSTALL_PACKAGE,
UPGRADE_PACKAGE,
UNINSTALL_PACKAGE,
IMPORT_DATA,
CAPTURE_USAGE,
REPAIR
|
These are product-neutral control-plane operation identities. Product-specific implementation steps remain in Hestino.Management.Api or Legislator.Management.Api.
| Catalog | Values |
|---|---|
PKG_PackageInstallationStatuses |
PENDING, INSTALLING, INSTALLED,
UPGRADING, UNINSTALLING,
UNINSTALLED, FAILED
|
| Catalog | Values |
|---|---|
USG_MetricValueTypes |
BOOLEAN, INTEGER,
DECIMAL, STRING
|
These values map directly to the nullable value columns in USG_SnapshotValues.
The shared catalog defines storage types; product-specific metric definitions remain in
USG_MetricTypes.
| Catalog | Values |
|---|---|
AUD_ActionTypes |
CREATE, UPDATE, DELETE,
STATUS_CHANGE, EXECUTE,
RETRY, CANCEL,
IMPORT, EXPORT
|
| Catalog | Values |
|---|---|
IMP_ImportStatuses |
PENDING, IN_PROGRESS,
SUCCEEDED, PARTIALLY_SUCCEEDED,
FAILED, CANCELLED
|
The supplied Management Workbench model contains no catalog rows and therefore contains no established Management catalog UUID values that could be preserved.
The initial unpublished version uses deterministic UUID v5 identities generated under the following project namespace:
1.0.0 is published, the UUID values already stored in JSON become the
source of truth and must never be regenerated during normal maintenance.
The package.json manifest defines the stable package identity,
logical package version, Management target database, minimum schema package version,
dependencies, included JSON 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-specific secrets, operation records, or product-specific registry data.
| Representation | Purpose |
|---|---|
| Embedded assembly resource | Runtime loading through the Management catalog provider. |
NuGet catalogs/ content |
Inspection, audit, release transparency, and package review. |
| Service | Responsibility |
|---|---|
IManagementCatalogPackageProvider |
Public contract for Management package and catalog access. |
ManagementCatalogPackageProvider |
Loads and caches embedded package manifests and catalog resources. |
ManagementCatalogJsonSerializer |
Deserializes embedded JSON into strongly typed Management catalog models. |
ManagementCatalogTypeResolver |
Maps manifest model types to concrete Management catalog model classes. |
ManagementCatalogContentHasher |
Calculates deterministic SHA-256 logical-package content hashes. |
ManagementCatalogPackageValidator |
Validates manifests, dependencies, UUIDs, duplicates, fields, ownership, and package structure. |
These services do not open database connections and do not persist catalog rows.
The provider and validator are consumed by the system catalog installer, catalog validation tools, unit and integration tests, and Jenkins release pipelines.
DreamConsistency.SystemCatalogInstaller.Cnsl
persists Management catalog content into a Management database.
This library is not executed directly. Its embedded logical packages are installed and upgraded by
DreamConsistency.SystemCatalogInstaller.Cnsl.
Validation must complete successfully before publishing a new NuGet version.
| Validation | Result |
|---|---|
| Management Workbench tables detected | 21 |
| Shared system catalog tables represented | 6 |
| Extensible registry tables intentionally excluded | 3 |
| Logical packages | 6 |
| Global package, catalog, and item UUID identities | 54 unique identities |
| JSON documents | 13, all valid |
| Dependency graph | Valid and acyclic |
| Catalog table and column names | Matched to the supplied Management Workbench model |
| Project and solution XML | Well-formed |
| C# namespace and reference scan | Passed |
mcr.microsoft.com/dotnet/sdk:10.0.
| Package | Version | SHA-256 Content Hash |
|---|---|---|
DreamConsistency.Management.Foundation |
1.0.0 |
da885616c015a43a79e3d6ea2a779cf1e8fdb74d6e89dc9869fa24682c6c8342 |
DreamConsistency.Management.Operations |
1.0.0 |
b1245b1ba100e3b9eeefe6d073473171ccaa769126b2aaca9b3a6d64ffd4fbdd |
DreamConsistency.Management.Packages |
1.0.0 |
eeee1cf34ac06aa998265928168b864cd1d102833a170d450577b59bd3ff7ca0 |
DreamConsistency.Management.Usage |
1.0.0 |
129639774cadea4da928d4bab1cfd909dc7b6c1a41bfabadf6ae858bac262d7b |
DreamConsistency.Management.Auditing |
1.0.0 |
ae58f580127b352323db7e2ffbf548b2c2719c5ec538cf796af7ec27ea07a47c |
DreamConsistency.Management.Imports |
1.0.0 |
579d7af67240f679e792c6522bd619203a9f9d56852de3b386b63c573f6fca05 |
These hashes describe the generated initial content. Any approved change before first publication will produce new hashes. After publication, the same package name and version must always retain the same hash.
| Property | Value |
|---|---|
| Recommended Job Name | DreamConsistency.ManagementCatalogs - NuGet Release |
| 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 |
Builds, validates, packages, and optionally publishes the versioned
DreamConsistency.ManagementCatalogs NuGet package to the internal Dream Consistency feed.
| 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 DreamConsistency.ManagementCatalogs library. |
| Logical Package Version | Version of a specific package such as DreamConsistency.Management.Operations. |
| Manifest Format Version | Version of the package.json contract. |
| Management Schema Package Version | Version of the compatible Management database schema contract. |
When any package manifest or catalog JSON resource changes:
DreamConsistency.ManagementCatalogs NuGet version.DreamConsistency.SystemCatalogInstaller.Cnsl.| Shared Management Catalog | Extensible Management Registry |
|---|---|
| Product-neutral lifecycle or storage vocabulary. | Definitions registered by Hestino, Legislator, or another product. |
Stored in DreamConsistency.ManagementCatalogs. |
Stored in PKG_Packages, USG_MetricTypes, or IMP_ImportTypes. |
Installed by SystemCatalogInstaller.Cnsl. |
Created by a product package, metric, or import capability registration workflow. |
| Same semantic identity across products. | Can differ between products and evolve on a product release cadence. |
| Shared Management System Catalogs | Management Runtime Data |
|---|---|
| Status, operation-type, value-type, action-type, and import-status definitions. | Actual operations, steps, attempts, package state, snapshots, audit entries, notes, and imports. |
Stored in DreamConsistency.ManagementCatalogs. |
Stored in Management runtime tables. |
Installed by SystemCatalogInstaller.Cnsl. |
Created and updated by product Management APIs and workers. |
| Versioned platform vocabulary. | Environment-, product-, tenant-, and operation-specific history. |
Catalog item removal, deprecation, soft-deleted-row recovery, replacement of an incorrect UUID, and downgrade behavior are installer responsibilities and must be explicit.
| Document | Purpose |
|---|---|
docs/source-model.md |
Management Workbench model analysis and included/excluded tables. |
docs/catalog-inventory.md |
Logical package and initial catalog-value inventory. |
docs/initial-values-review.md |
Values and registry ownership classifications to approve before 1.0.0. |
docs/package-format.md |
Management logical package and manifest JSON contract. |
docs/legacy-identities.md |
Initial UUID generation namespace and permanent-identity rules. |
docs/maintenance.md |
Rules for changing published packages, versions, UUIDs, registries, and JSON content. |
docs/static-validation-report.md |
Static validation results and initial logical-package content hashes. |
| Date | Change | Author |
|---|---|---|
| 2026-09-01 | Added `ManagementCatalogIdentities` as the product-neutral public UUID surface for finite canonical Management vocabularies used explicitly by runtime code. Added validation that every published identity constant is covered and matches exactly one embedded catalog item by catalog, name and UUID. Kept embedded catalog JSON and logical catalog package versions unchanged; this release adds a NuGet API surface without changing installed catalog content. | Branko Corilic |
| 2026-08-02 | Initial Wiki documentation for DreamConsistency.ManagementCatalogs. |
Branko Corilic |