SaaS Solution Platform — Overview¶
Purpose¶
The SaaS Solution Platform is ConnectSoft’s product-line for building multi-tenant SaaS applications from reusable templates, shared NuGet libraries, and versioned API contracts. It packages the core path from tenant onboarding through catalog and entitlements to billing and metering—the contexts required for monetized B2B SaaS—without collapsing the wider factory vision (AI, compliance, notifications, global config) into a single monolith.
This overview complements the hub page with architectural positioning and canonical references.
Problem Context¶
Without a standard platform line, teams reinvent:
- Per-service folder layouts and pipeline shapes
- Inconsistent HTTP and gRPC contracts between gateway, BFF, and UIs
- Ad hoc tenant resolution and edition policy in each service
- Fragmented Blazor portals and MFE loading
The SaaS Solution Platform addresses this by standardizing backend template repos, ServiceModel packaging, ConnectSoft.Blazor.Shell.Saas, and ConnectSoft.Extensions.Saas.*—aligned with Domain-Driven Design and the DDD entities specification.
In-Scope Bounded Contexts¶
| Context | Template repository (example) | Notes |
|---|---|---|
| Tenants | ConnectSoft.Saas.TenantsTemplate |
Directories, isolation, lifecycle |
| Product catalog | ConnectSoft.Saas.ProductsCatalogTemplate |
Products, editions, features |
| Entitlements | ConnectSoft.Saas.EntitlementsTemplate |
Entitlement assignments |
| Billing | ConnectSoft.Saas.BillingTemplate |
Subscriptions, invoices |
| Metering | ConnectSoft.Saas.MeteringTemplate |
Usage events, quotas |
Each repository embeds ConnectSoft.BaseTemplate as a Git submodule and ships dotnet new output with ServiceModel projects.
Front-End Layer¶
ConnectSoft.Blazor.Shell.Saas— Portal host: navigation, MFE registry, tenant/edition alignment, BFF integration.- MFE templates — Per-context admin or self-service modules; consume ServiceModel packages only; OIDC via Authorization Server.
Canonical Documentation Map¶
| Concern | Where it lives |
|---|---|
| Full domain model (aggregates, relationships) | SaaS DDD entities |
| HLD (logical architecture) | SaaS platform HLD |
| Template program mapping | Template program implementation mapping |
| Solution plan (repos, templates, ServiceModel) | ConnectSoft Documentation — Docs/starters/saas-platform-solution-plan.md |
| Bounded-context matrix | ConnectSoft Documentation — Docs/starters/saas-bounded-contexts-and-templates.md |
| Extensions.Saas packages | ConnectSoft Documentation — Docs/starters/saas-extensions-saas-libraries.md |
| Epics / backlog IDs | ConnectSoft Documentation — Docs/starters/saas-extensions-and-templates-epics.md |
Out of Scope (Separate Platforms)¶
- Audit Platform — Tamper-evident audit logging
- Notifications Platform — Notifications and webhooks
- Config Platform — Centralized configuration and feature flags
Integrate via events and IDs only—no cross-context domain leakage.