Runbook
Operational fundamentals are inherited from the Base Template. Catalog specifics:
Common tasks
| Task |
Command |
| Build |
dotnet build ConnectSoft.Saas.ProductsCatalogTemplate.slnx |
| Run host |
dotnet run --project src/ConnectSoft.Saas.ProductsCatalog.Application |
| Test |
dotnet test |
| Migrations |
MicroserviceMigration (10-table catalog schema) |
Troubleshooting
| Symptom |
Likely cause |
Action |
| Duplicate slug error |
UQ_Products_TenantId_Slug |
Slug must be unique within the tenant; slugs are immutable |
| Cannot activate product |
No published edition |
Publish an edition first (ProductActivationRequiresPublishedEditionException) |
| Edition code conflict |
UQ_Editions_ProductId_Code |
Use a unique edition code per product |
| Downstream not reacting to retirement |
Events not delivered |
Configure durable MassTransit transport/persistence |
See also