Template & Library — microservices¶
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.
Every logical service keeps its own design page and model entry; deployment granularity says how it is shipped at first (decision D23). Modules of a host are deployed inside that host until an extraction decision is recorded.
flowchart TB
subgraph TemplateCatalogHost["TemplateCatalogHost (host)"]
ApiClientCatalogService["ApiClientCatalogService"]
BlueprintParserService["BlueprintParserService"]
BlueprintService["BlueprintService"]
BlueprintValidatorService["BlueprintValidatorService"]
CompatibilityMatrixService["CompatibilityMatrixService"]
ContextMapService["ContextMapService"]
DependencyAnalyzerService["DependencyAnalyzerService"]
DomainModelService["DomainModelService"]
LibraryRegistryService["LibraryRegistryService"]
LibraryVersionService["LibraryVersionService"]
PipelineGeneratorService["PipelineGeneratorService"]
GenerationRecipeService["GenerationRecipeService"]
TemplateCompatibilityService["TemplateCompatibilityService"]
TemplateParameterService["TemplateParameterService"]
TemplateRegistryService["TemplateRegistryService"]
TemplateValidationService["TemplateValidationService"]
TemplateVersionService["TemplateVersionService"]
end
PackageUpgradeAdvisorService["PackageUpgradeAdvisorService (later)"]:::later
ScaffoldEngineService["ScaffoldEngineService (later)"]:::later
TemplateUpgradeService["TemplateUpgradeService (later)"]:::later
classDef later stroke-dasharray: 4 4;| Service | Context | Granularity | Host | Status | Page |
|---|---|---|---|---|---|
| ApiClientCatalogService | BC-14 | module of host | TemplateCatalogHost | unmodelled | — |
| BlueprintParserService | BC-02 | module of host | TemplateCatalogHost | unmodelled | — |
| BlueprintService | BC-02 | module of host | TemplateCatalogHost | target | design |
| BlueprintValidatorService | BC-02 | module of host | TemplateCatalogHost | unmodelled | — |
| CompatibilityMatrixService | BC-14 | module of host | TemplateCatalogHost | unmodelled | — |
| ContextMapService | BC-02 | module of host | TemplateCatalogHost | unmodelled | — |
| DependencyAnalyzerService | BC-14 | module of host | TemplateCatalogHost | unmodelled | — |
| DomainModelService | BC-02 | module of host | TemplateCatalogHost | unmodelled | — |
| LibraryRegistryService | BC-14 | module of host | TemplateCatalogHost | unmodelled | — |
| LibraryVersionService | BC-14 | module of host | TemplateCatalogHost | unmodelled | — |
| PackageUpgradeAdvisorService | BC-14 | later stage | — | unmodelled | — |
| PipelineGeneratorService | BC-15 | module of host | TemplateCatalogHost | unmodelled | — |
| ScaffoldEngineService | BC-15 | later stage | — | unmodelled | — |
| TemplateCatalogHost | BC-14 | standalone host | — | target | design |
| GenerationRecipeService | BC-15 | module of host | TemplateCatalogHost | target | design |
| TemplateCompatibilityService | BC-14 | module of host | TemplateCatalogHost | unmodelled | — |
| TemplateParameterService | BC-14 | module of host | TemplateCatalogHost | unmodelled | — |
| TemplateRegistryService | BC-14 | module of host | TemplateCatalogHost | target | design |
| TemplateUpgradeService | BC-14 | later stage | — | unmodelled | — |
| TemplateValidationService | BC-15 | module of host | TemplateCatalogHost | unmodelled | — |
| TemplateVersionService | BC-14 | module of host | TemplateCatalogHost | unmodelled | — |
ApiClientCatalogService¶
ApiClientCatalogService (Template & Library group of the June-2026 catalog).
| Bounded context | BC-14 Template Catalog |
| Granularity | module of host · host TemplateCatalogHost |
| Former catalog group | Template & Library (merge) |
| Status | unmodelled |
| Design page | not written yet |
BlueprintParserService¶
Capability of the blueprint module
| Bounded context | BC-02 Blueprint |
| Granularity | module of host · host TemplateCatalogHost |
| Former catalog group | Control Plane (merge) |
| Status | unmodelled |
| Design page | not written yet |
BlueprintService¶
Blueprint versions validated against their schemas and rules, derived context maps and domain models, submission to Asset Publication (BC-02).
| Bounded context | BC-02 Blueprint |
| Granularity | module of host · host TemplateCatalogHost |
| Former catalog group | Control Plane (module) |
| Status | target |
| Modelled | 3 aggregates · 5 REST + 1 gRPC · 5 events · 1 workers · 4 tables |
| Design page | solution-packs/software-factory/templates/services/blueprint-service/index.md |
BlueprintValidatorService¶
Capability of the blueprint module
| Bounded context | BC-02 Blueprint |
| Granularity | module of host · host TemplateCatalogHost |
| Former catalog group | Control Plane (merge) |
| Status | unmodelled |
| Design page | not written yet |
CompatibilityMatrixService¶
CompatibilityMatrixService (Template & Library group of the June-2026 catalog).
| Bounded context | BC-14 Template Catalog |
| Granularity | module of host · host TemplateCatalogHost |
| Former catalog group | Template & Library (merge) |
| Status | unmodelled |
| Design page | not written yet |
ContextMapService¶
ContextMapService (Control Plane group of the June-2026 catalog).
| Bounded context | BC-02 Blueprint |
| Granularity | module of host · host TemplateCatalogHost |
| Former catalog group | Control Plane (merge) |
| Status | unmodelled |
| Design page | not written yet |
DependencyAnalyzerService¶
DependencyAnalyzerService (Template & Library group of the June-2026 catalog).
| Bounded context | BC-14 Template Catalog |
| Granularity | module of host · host TemplateCatalogHost |
| Former catalog group | Template & Library (merge) |
| Status | unmodelled |
| Design page | not written yet |
DomainModelService¶
DomainModelService (Control Plane group of the June-2026 catalog).
| Bounded context | BC-02 Blueprint |
| Granularity | module of host · host TemplateCatalogHost |
| Former catalog group | Control Plane (merge) |
| Status | unmodelled |
| Design page | not written yet |
LibraryRegistryService¶
LibraryRegistryService (Template & Library group of the June-2026 catalog).
| Bounded context | BC-14 Template Catalog |
| Granularity | module of host · host TemplateCatalogHost |
| Former catalog group | Template & Library (merge) |
| Status | unmodelled |
| Design page | not written yet |
LibraryVersionService¶
LibraryVersionService (Template & Library group of the June-2026 catalog).
| Bounded context | BC-14 Template Catalog |
| Granularity | module of host · host TemplateCatalogHost |
| Former catalog group | Template & Library (merge) |
| Status | unmodelled |
| Design page | not written yet |
PackageUpgradeAdvisorService¶
PackageUpgradeAdvisorService (Template & Library group of the June-2026 catalog).
| Bounded context | BC-14 Template Catalog |
| Granularity | later stage |
| Former catalog group | Template & Library (defer) |
| Status | unmodelled |
| Design page | not written yet |
PipelineGeneratorService¶
Pipeline generation; merged into GenerationRecipeService (pipeline definitions are generated outputs).
| Bounded context | BC-15 Generation Recipe |
| Granularity | module of host · host TemplateCatalogHost |
| Former catalog group | DevOps / GitOps (merge) |
| Status | unmodelled |
| Design page | not written yet |
ScaffoldEngineService¶
Optional after ADR-0025; the recipe path scaffolds with dotnet new in the sandbox
| Bounded context | BC-15 Generation Recipe |
| Granularity | later stage |
| Former catalog group | Template & Library (defer) |
| Status | unmodelled |
| Design page | not written yet |
TemplateCatalogHost¶
Template and library catalog host.
| Bounded context | BC-14 Template Catalog |
| Granularity | standalone host |
| Former catalog group | (host added 2026-10-09) (module) |
| Status | target |
| Modelled | 0 aggregates · 2 REST + 0 gRPC · 0 events · 0 workers · 0 tables |
| Design page | solution-packs/software-factory/templates/services/template-catalog-host/index.md |
GenerationRecipeService¶
Generation recipes binding blueprint versions to template and library versions with module plans, validated against the compatibility matrix; generated-output provenance (BC-15).
| Bounded context | BC-15 Generation Recipe |
| Granularity | module of host · host TemplateCatalogHost |
| Former catalog group | (added 2026-10-09, design plan P15) (module) |
| Status | target |
| Modelled | 2 aggregates · 6 REST + 2 gRPC · 4 events · 2 workers · 3 tables |
| Design page | solution-packs/software-factory/templates/services/generation-recipe-service/index.md |
TemplateCompatibilityService¶
TemplateCompatibilityService (Template & Library group of the June-2026 catalog).
| Bounded context | BC-14 Template Catalog |
| Granularity | module of host · host TemplateCatalogHost |
| Former catalog group | Template & Library (merge) |
| Status | unmodelled |
| Design page | not written yet |
TemplateParameterService¶
TemplateParameterService (Template & Library group of the June-2026 catalog).
| Bounded context | BC-14 Template Catalog |
| Granularity | module of host · host TemplateCatalogHost |
| Former catalog group | Template & Library (merge) |
| Status | unmodelled |
| Design page | not written yet |
TemplateRegistryService¶
Pinned template manifests, library versions from feeds, API client catalog, dependency analysis and the compatibility matrix with evidence (BC-14).
| Bounded context | BC-14 Template Catalog |
| Granularity | module of host · host TemplateCatalogHost |
| Former catalog group | Template & Library (module) |
| Status | target |
| Modelled | 3 aggregates · 6 REST + 1 gRPC · 4 events · 2 workers · 3 tables |
| Design page | solution-packs/software-factory/templates/services/template-registry-service/index.md |
TemplateUpgradeService¶
TemplateUpgradeService (Template & Library group of the June-2026 catalog).
| Bounded context | BC-14 Template Catalog |
| Granularity | later stage |
| Former catalog group | Template & Library (defer) |
| Status | unmodelled |
| Design page | not written yet |
TemplateValidationService¶
Template validation; merged into GenerationRecipeService recipe validation.
| Bounded context | BC-15 Generation Recipe |
| Granularity | module of host · host TemplateCatalogHost |
| Former catalog group | Template & Library (merge) |
| Status | unmodelled |
| Design page | not written yet |
TemplateVersionService¶
TemplateVersionService (Template & Library group of the June-2026 catalog).
| Bounded context | BC-14 Template Catalog |
| Granularity | module of host · host TemplateCatalogHost |
| Former catalog group | Template & Library (merge) |
| Status | unmodelled |
| Design page | not written yet |