SaaS Solution Platform — Service Integration Blueprint¶
Consumer types¶
| Consumer | Integration mechanism |
|---|---|
| API Gateway | Routes, auth, ServiceModel-compatible clients |
| Blazor shell / MFE | HTTP clients from ServiceModel; OIDC |
| Peer microservice | ServiceModel + optional gRPC; integration events |
| Batch / workers | Events or approved APIs; no shared DB |
BFF pattern¶
- Shell or dedicated BFF may aggregate API calls for page composition.
- BFF must not bypass gateway policy when gateway is the standard edge.
Headers and correlation¶
- Trace —
traceparent/ W3C trace context. - Tenant — Propagate per tenant resolution standard (claims-derived or header policy—document in Extensions.Saas when published).
Resilience¶
- Retries — Idempotent operations only; timeouts and circuit breakers on gateway and clients.
- Idempotency keys — For billing and metering ingestion APIs where required.