Skip to content

ConnectSoft.AI.SoftwareFactory.Documentation

System Context

ConnectSoft.AI.SoftwareFactory.Documentation

System Context¶

This page sets the outer boundary of the ConnectSoft AI Software Factory: who uses it, what external systems it depends on, and what it produces. It is the level-1 (context) view; the C4 System Context page refines it with C4 notation.

Context diagram¶

flowchart TB
    subgraph actors [Actors]
        Architect["Architect / Builder"]
        ProductOwner["Product Owner"]
        Operator["Platform Operator"]
        Customer["Tenant Customer"]
    end

    Factory["ConnectSoft AI Software Factory<br/>(twelve platforms)"]

    subgraph external [External Systems]
        AzureDevOps["Azure DevOps<br/>Git, Pipelines, Artifacts"]
        LLM["LLM Providers<br/>Azure OpenAI / OpenAI / Ollama"]
        Azure["Azure Cloud<br/>AKS, Service Bus, SQL, Key Vault"]
        Vendors["Vendor APIs<br/>payments, CRM, SMS, support"]
        MCP["MCP Servers / Tools"]
    end

    Architect --> Factory
    ProductOwner --> Factory
    Operator --> Factory
    Factory --> GeneratedSaaS["Generated SaaS Products"]
    Customer --> GeneratedSaaS

    Factory <--> AzureDevOps
    Factory <--> LLM
    Factory <--> Azure
    Factory <--> Vendors
    Factory <--> MCP

Hold "Alt" / "Option" to enable pan & zoom

Actors¶

Actor	Interacts via	Goal
Architect / Builder	Factory Studio, Developer Portal	Define blueprints, review artifacts, extend the factory.
Product Owner	Factory Studio	Express product intent, approve releases.
Platform Operator	Factory Studio Runtime/Cost/Security centers	Operate the factory and generated runtimes.
Tenant Customer	Generated SaaS products	Use the SaaS the factory produced.

External systems¶

System	Used by	Via
Azure DevOps	DevOps / GitOps	Git repos, YAML pipelines, Azure Artifacts.
LLM providers	Agent Mesh	Integration Platform model adapters and `ModelRouterService`.
Azure cloud	Runtime Cloud	AKS, Container Apps, Functions, Service Bus, SQL/PostgreSQL, Cosmos DB, Blob, Key Vault, ACR, App Insights.
Vendor APIs	Integration Platform	Existing API clients (`ConnectSoft.Deputy.ApiClient`, `Braze.ApiClient`, `Sms.Providers.*`, ...).
MCP servers / tools	Agent Mesh	`McpConnectorService` and `ConnectSoft.Extensions.ModelContextProtocol`.

Trust boundary¶

The factory is multi-tenant. The trust boundary is enforced by the Control Plane Identity & Access and Tenant contexts and by the Governance Platform. Secrets never cross the boundary as artifacts — only as Key Vault references. See Multi-Tenancy and Security Architecture.