Template & Library — data model

Generated from the architecture model

This page is rendered from model/**/*.yaml by tools/docs_model during mkdocs build. Edit the YAML, not this page; hand-written design lives on the linked service, platform and plane pages.

BlueprintService

erDiagram
    BlueprintVersion {
        string blueprintId PK
        string version
        string tenantId
        string projectId
        enum_BlueprintKind kind
        string schemaVersion
        string documentRef
        string documentHash
        enum_BlueprintState state
        string validationReportRef
        string contextMapRef
        string domainModelRef
        string releaseId
        string authoredBy
        datetime createdAt
    }
    ContextMap {
        guid contextMapId PK
        string tenantId
        string projectId
        string blueprintId
        string blueprintVersion
        json contexts
        json relationships
        json publishedEvents
        datetime derivedAt
    }
    DomainModel {
        guid domainModelId PK
        string tenantId
        string projectId
        string blueprintId
        string blueprintVersion
        string contextId
        json aggregates
        json events
        datetime derivedAt
    }
    ValidationFinding {
        string ruleId

        string severity

        string path

        string message

    }
    BlueprintVersion ||--o{ ValidationFinding : contains

Hold "Alt" / "Option" to enable pan & zoom

ValidationFinding (entity)

One validation finding with rule id and severity.

Field	Type	Required	Description
ruleId	string	yes
severity	string	yes	error
path	string	yes
message	string	yes

Tables: dbo.BlueprintVersions, dbo.ValidationFindings, dbo.ContextMaps, dbo.DomainModels — see the DDL appendix.

GenerationRecipeService

erDiagram
    GenerationRecipe {
        guid recipeId PK
        string tenantId
        string projectId
        int version
        string blueprintId
        string blueprintVersion
        json modules
        json libraries
        json repositoryLayout
        json compatibilityEvidence
        enum_RecipeState state
        string approvedBy
        datetime createdAt
    }
    GeneratedOutput {
        guid outputId PK
        string tenantId
        string projectId
        guid recipeId
        int recipeVersion
        string moduleName
        guid runId
        guid attemptId
        string agentReleaseId
        string templateId
        string templateVersion
        string manifestHash
        json generatedFiles
        json preservedFiles
        guid proposalId
        string commit
        datetime generatedAt
    }
    ModulePlanEntry {
        string name

        enum_ModuleKind kind

        string contextId

        string templateId

        string templateVersion

        json switches

        json parameters

        string path

    }
    GenerationRecipe ||--o{ ModulePlanEntry : contains

Hold "Alt" / "Option" to enable pan & zoom

ModulePlanEntry (entity)

One module to generate.

Field	Type	Required	Description
name	string	yes
kind	enum:ModuleKind	yes
contextId	string	no
templateId	string	yes
templateVersion	string	yes
switches	json	yes
parameters	json	yes
path	string	yes

Tables: dbo.GenerationRecipes, dbo.ModulePlanEntries, dbo.GeneratedOutputs — see the DDL appendix.

TemplateRegistryService

erDiagram
    TemplateVersion {
        string templateId PK
        string version
        string tenantId
        enum_TemplateLayer layer
        string repository
        string commit
        json manifest
        string manifestHash
        enum_CatalogState state
        string releaseId
        datetime discoveredAt
    }
    LibraryVersion {
        string libraryId PK
        string version
        string tenantId
        enum_TemplateLayer layer
        string area
        json packages
        json optionsSections
        list_string consumers
        enum_CatalogState state
        datetime discoveredAt
    }
    CompatibilityEntry {
        guid entryId PK
        string tenantId
        string subjectKind
        string subjectId
        string subjectVersion
        string withKind
        string withId
        string withVersion
        enum_Compatibility result
        string evidenceRef
        datetime checkedAt
    }

Hold "Alt" / "Option" to enable pan & zoom

Tables: dbo.TemplateVersions, dbo.LibraryVersions, dbo.CompatibilityEntries — see the DDL appendix.