Integration Platform — 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 IntegrationHost["IntegrationHost (host)"]
AzureDevOpsIntegrationService["AzureDevOpsIntegrationService"]
CloudProviderAdapterService["CloudProviderAdapterService"]
GitHubIntegrationService["GitHubIntegrationService"]
ConnectorRegistryService["ConnectorRegistryService"]
IntegrationService["IntegrationService"]
SecretBindingService["SecretBindingService"]
SecretGovernanceService["SecretGovernanceService"]
VendorApiClientRegistryService["VendorApiClientRegistryService"]
end
subgraph WebhookGatewayService["WebhookGatewayService (host)"]
end
CrmIntegrationService[("CrmIntegrationService<br/>external")]
EmailIntegrationService[("EmailIntegrationService<br/>external")]
PaymentIntegrationService[("PaymentIntegrationService<br/>external")]
SmsIntegrationService[("SmsIntegrationService<br/>external")]
SupportIntegrationService[("SupportIntegrationService<br/>external")]
classDef later stroke-dasharray: 4 4;| Service | Context | Granularity | Host | Status | Page |
|---|---|---|---|---|---|
| AzureDevOpsIntegrationService | BC-17 | module of host | IntegrationHost | unmodelled | — |
| CloudProviderAdapterService | BC-17 | module of host | IntegrationHost | unmodelled | — |
| CrmIntegrationService | BC-17 | external / canonical | — | unmodelled | — |
| EmailIntegrationService | BC-17 | external / canonical | — | unmodelled | — |
| GitHubIntegrationService | BC-17 | module of host | IntegrationHost | unmodelled | — |
| ConnectorRegistryService | BC-17 | module of host | IntegrationHost | target | design |
| IntegrationHost | BC-16 | standalone host | — | target | design |
| IntegrationService | BC-16 | module of host | IntegrationHost | target | design |
| PaymentIntegrationService | BC-17 | external / canonical | — | unmodelled | — |
| SecretBindingService | BC-16 | module of host | IntegrationHost | unmodelled | — |
| SecretGovernanceService | BC-16 | module of host | IntegrationHost | unmodelled | — |
| SmsIntegrationService | BC-17 | external / canonical | — | unmodelled | — |
| SupportIntegrationService | BC-17 | external / canonical | — | unmodelled | — |
| VendorApiClientRegistryService | BC-17 | module of host | IntegrationHost | unmodelled | — |
| WebhookGatewayService | BC-17 | standalone host | — | target | design |
AzureDevOpsIntegrationService¶
Azure DevOps connector adapter behind a descriptor; merged into ConnectorRegistryService.
| Bounded context | BC-17 Connectors & Webhooks |
| Granularity | module of host · host IntegrationHost |
| Former catalog group | Integration Platform (merge) |
| Status | unmodelled |
| Design page | not written yet |
CloudProviderAdapterService¶
Cloud provider adapters are connector descriptors; merged into ConnectorRegistryService.
| Bounded context | BC-17 Connectors & Webhooks |
| Granularity | module of host · host IntegrationHost |
| Former catalog group | Integration Platform (merge) |
| Status | unmodelled |
| Design page | not written yet |
CrmIntegrationService¶
Existing client libraries (ConnectSoft.Sms.*, ConnectSoft.*.ApiClient) behind connector descriptors
| Bounded context | BC-17 Connectors & Webhooks |
| Granularity | external / canonical · ref ext-client-libraries |
| Former catalog group | Integration Platform (external) |
| Status | unmodelled |
| Design page | not written yet |
EmailIntegrationService¶
Existing client libraries (ConnectSoft.Sms.*, ConnectSoft.*.ApiClient) behind connector descriptors
| Bounded context | BC-17 Connectors & Webhooks |
| Granularity | external / canonical · ref ext-client-libraries |
| Former catalog group | Integration Platform (external) |
| Status | unmodelled |
| Design page | not written yet |
GitHubIntegrationService¶
GitHub connector adapter behind a descriptor; merged into ConnectorRegistryService.
| Bounded context | BC-17 Connectors & Webhooks |
| Granularity | module of host · host IntegrationHost |
| Former catalog group | Integration Platform (merge) |
| Status | unmodelled |
| Design page | not written yet |
ConnectorRegistryService¶
Connector descriptors with certification, subscriptions, inbound and outbound deliveries with receipts (BC-17).
| Bounded context | BC-17 Connectors & Webhooks |
| Granularity | module of host · host IntegrationHost |
| Former catalog group | (added 2026-10-09; BC-17 had no module row) (module) |
| Status | target |
| Modelled | 3 aggregates · 5 REST + 2 gRPC · 7 events · 3 workers · 3 tables |
| Design page | planes/capability-tools/connectors/services/connector-registry-service/index.md |
IntegrationHost¶
Connections, connectors and webhook ingress host.
| Bounded context | BC-16 Connections |
| 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 | planes/capability-tools/connectors/services/integration-host/index.md |
IntegrationService¶
Tenant-scoped connections with credential references, grants, rotation and health; every use brokered as a short-lived credential (BC-16).
| Bounded context | BC-16 Connections |
| Granularity | module of host · host IntegrationHost |
| Former catalog group | Control Plane (module) |
| Status | target |
| Modelled | 1 aggregates · 6 REST + 1 gRPC · 4 events · 2 workers · 2 tables |
| Design page | planes/capability-tools/connectors/services/integration-service/index.md |
PaymentIntegrationService¶
Existing client libraries (ConnectSoft.Sms.*, ConnectSoft.*.ApiClient) behind connector descriptors
| Bounded context | BC-17 Connectors & Webhooks |
| Granularity | external / canonical · ref ext-client-libraries |
| Former catalog group | Integration Platform (external) |
| Status | unmodelled |
| Design page | not written yet |
SecretBindingService¶
Binding a credential reference to a connection; merged into IntegrationService.
| Bounded context | BC-16 Connections |
| Granularity | module of host · host IntegrationHost |
| Former catalog group | Runtime Cloud (merge) |
| Status | unmodelled |
| Design page | not written yet |
SecretGovernanceService¶
Secret governance belongs to the Secret Broker (BC-40); merged into SecretBrokerService.
| Bounded context | BC-16 Connections |
| Granularity | module of host · host IntegrationHost |
| Former catalog group | Governance / Security / Compliance (merge) |
| Status | unmodelled |
| Design page | not written yet |
SmsIntegrationService¶
Existing client libraries (ConnectSoft.Sms.*, ConnectSoft.*.ApiClient) behind connector descriptors
| Bounded context | BC-17 Connectors & Webhooks |
| Granularity | external / canonical · ref ext-client-libraries |
| Former catalog group | Integration Platform (external) |
| Status | unmodelled |
| Design page | not written yet |
SupportIntegrationService¶
Existing client libraries (ConnectSoft.Sms.*, ConnectSoft.*.ApiClient) behind connector descriptors
| Bounded context | BC-17 Connectors & Webhooks |
| Granularity | external / canonical · ref ext-client-libraries |
| Former catalog group | Integration Platform (external) |
| Status | unmodelled |
| Design page | not written yet |
VendorApiClientRegistryService¶
Vendor client registry is the connector descriptor catalog; merged into ConnectorRegistryService.
| Bounded context | BC-17 Connectors & Webhooks |
| Granularity | module of host · host IntegrationHost |
| Former catalog group | Integration Platform (merge) |
| Status | unmodelled |
| Design page | not written yet |
WebhookGatewayService¶
Conditional inbound webhook ingress (GW-06): signature, replay window, deduplication, payload capture; emits verified deliveries.
| Bounded context | BC-17 Connectors & Webhooks |
| Granularity | standalone host |
| Former catalog group | Integration Platform (conditional) |
| Status | target |
| Modelled | 1 aggregates · 2 REST + 0 gRPC · 2 events · 0 workers · 1 tables |
| Design page | planes/capability-tools/connectors/services/webhook-gateway-service/index.md |