# sundharml07/sapi-salesforce-implementation architecture

> Architecture diagram of the GitHub repository sundharml07/sapi-salesforce-implementation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sundharml07/sapi-salesforce-implementation
- Repository: https://github.com/sundharml07/sapi-salesforce-implementation

## Overview

This Mule 4 project exposes Salesforce query, create, update, and upsert operations through APIKit HTTP routes, and also offers those operations as MCP tools. The documented HTTP route mapping dispatches to separate operation flows, which use the Salesforce connector. API Manager autodiscovery and environment-specific configuration support the deployed API. No source excerpts were provided, so internal calls beyond the documented route mapping and connector use are not asserted.

Main entry points: [`src/main/mule/sapi-salesforce.xml`](https://github.com/sundharml07/sapi-salesforce-implementation/blob/main/src/main/mule/sapi-salesforce.xml) (APIKit Routes), [`src/main/mule/mcp-tools.xml`](https://github.com/sundharml07/sapi-salesforce-implementation/blob/main/src/main/mule/mcp-tools.xml) (MCP Tools), [`src/main/mule/implementation/query.xml`](https://github.com/sundharml07/sapi-salesforce-implementation/blob/main/src/main/mule/implementation/query.xml) (Query Flow), [`src/main/mule/implementation/create.xml`](https://github.com/sundharml07/sapi-salesforce-implementation/blob/main/src/main/mule/implementation/create.xml) (Create Flow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["HTTP API"]
  node_apikit["APIKit Routes"]
end

subgraph group_operations["Salesforce Operations"]
  node_query["Query Flow<br/>[query.xml]"]
  node_create["Create Flow<br/>[create.xml]"]
  node_update["Update Flow<br/>[update.xml]"]
  node_salesforce["Salesforce"]
end

subgraph group_mcp["MCP Interface"]
  node_mcp_tools["MCP Tools<br/>[mcp-tools.xml]"]
end

subgraph group_configuration["API Configuration"]
  node_global_config["Global Config<br/>[global.xml]"]
  node_environment_config["Environment Properties"]
  node_api_manager["API Manager"]
end

node_http_clients(("HTTP Clients"))
node_mcp_clients(("MCP Clients"))

node_http_clients -->|"sends requests"| node_apikit
node_apikit -->|"routes query"| node_query
node_apikit -->|"routes create"| node_create
node_apikit -->|"routes update"| node_update
node_query -->|"queries records"| node_salesforce
node_create -->|"creates records"| node_salesforce
node_update -->|"updates or upserts"| node_salesforce
node_mcp_clients -->|"uses tools"| node_mcp_tools
node_mcp_tools -.->|"offers operation"| node_query
node_mcp_tools -.->|"offers operation"| node_create
node_mcp_tools -.->|"offers operation"| node_update
node_global_config -->|"enables discovery"| node_api_manager
node_global_config -->|"loads environment"| node_environment_config

click node_apikit "https://github.com/sundharml07/sapi-salesforce-implementation/blob/main/src/main/mule/sapi-salesforce.xml"
click node_query "https://github.com/sundharml07/sapi-salesforce-implementation/blob/main/src/main/mule/implementation/query.xml"
click node_create "https://github.com/sundharml07/sapi-salesforce-implementation/blob/main/src/main/mule/implementation/create.xml"
click node_update "https://github.com/sundharml07/sapi-salesforce-implementation/blob/main/src/main/mule/implementation/update.xml"
click node_mcp_tools "https://github.com/sundharml07/sapi-salesforce-implementation/blob/main/src/main/mule/mcp-tools.xml"
click node_global_config "https://github.com/sundharml07/sapi-salesforce-implementation/blob/main/src/main/mule/global.xml"
click node_environment_config "https://github.com/sundharml07/sapi-salesforce-implementation/tree/main/src/main/resources/properties"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_apikit,node_http_clients,node_mcp_clients toneBlue
class node_query,node_create,node_update,node_salesforce toneAmber
class node_mcp_tools toneMint
class node_global_config,node_environment_config,node_api_manager toneRose
```

## Components

### HTTP API

- [APIKit Routes](https://github.com/sundharml07/sapi-salesforce-implementation/blob/main/src/main/mule/sapi-salesforce.xml): `src/main/mule/sapi-salesforce.xml`

### Salesforce Operations

- [Query Flow](https://github.com/sundharml07/sapi-salesforce-implementation/blob/main/src/main/mule/implementation/query.xml): `src/main/mule/implementation/query.xml`
- [Create Flow](https://github.com/sundharml07/sapi-salesforce-implementation/blob/main/src/main/mule/implementation/create.xml): `src/main/mule/implementation/create.xml`
- [Update Flow](https://github.com/sundharml07/sapi-salesforce-implementation/blob/main/src/main/mule/implementation/update.xml): `src/main/mule/implementation/update.xml`
- **Salesforce**

### MCP Interface

- [MCP Tools](https://github.com/sundharml07/sapi-salesforce-implementation/blob/main/src/main/mule/mcp-tools.xml): `src/main/mule/mcp-tools.xml`

### API Configuration

- [Global Config](https://github.com/sundharml07/sapi-salesforce-implementation/blob/main/src/main/mule/global.xml): `src/main/mule/global.xml`
- [Environment Properties](https://github.com/sundharml07/sapi-salesforce-implementation/tree/main/src/main/resources/properties): `src/main/resources/properties`
- **API Manager**

### Other components

- **HTTP Clients**
- **MCP Clients**

## Connections

- HTTP Clients → APIKit Routes: sends requests (evidence: `README.md`)
- APIKit Routes → Query Flow: routes query (evidence: `README.md`)
- APIKit Routes → Create Flow: routes create (evidence: `README.md`)
- APIKit Routes → Update Flow: routes update (evidence: `README.md`)
- Query Flow → Salesforce: queries records (evidence: `README.md`)
- Create Flow → Salesforce: creates records (evidence: `README.md`)
- Update Flow → Salesforce: updates or upserts (evidence: `README.md`)
- MCP Clients → MCP Tools: uses tools (evidence: `README.md`)
- MCP Tools → Query Flow: offers operation
- MCP Tools → Create Flow: offers operation
- MCP Tools → Update Flow: offers operation
- Global Config → API Manager: enables discovery (evidence: `README.md`)
- Global Config → Environment Properties: loads environment (evidence: `README.md`)
