# i-rzr-i/soapclientcallassist architecture

> Architecture diagram of the GitHub repository i-rzr-i/soapclientcallassist, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/i-rzr-i/soapclientcallassist
- Repository: https://github.com/i-rzr-i/soapclientcallassist

## Overview

SoapClientCallAssist is a .NET library for invoking SOAP services without generated service references or a required WSDL. Callers configure an endpoint and request, choose SOAP 1.1 or 1.2, send over the configured HTTP client, and read the response; optional model mapping and WS-Security add request/response processing. The graph preserves the documented security modes and secure-conversation lifecycle. Relationships not visible in the excerpts or source index are omitted or marked unverified.

Main entry points: [`src/SoapClientCallAssist/Client/BaseEndpointClient.cs`](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Client/BaseEndpointClient.cs) (Request and send), [`src/SoapClientCallAssist/Readers/SoapResponseReader.cs`](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Readers/SoapResponseReader.cs) (Response binding), [`src/SoapClientCallAssist/Security/WsSecurity/WsSecurityResponseSecurity.cs`](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Security/WsSecurity/WsSecurityResponseSecurity.cs) (Response security), [`src/SoapClientCallAssist/Client/Soap11Client.cs`](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Client/Soap11Client.cs) (SOAP 1.1 client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["SOAP invocation"]
  node_endpoint_api["Endpoint contract"]
  node_soap11["SOAP 1.1 client<br/>[Soap11Client.cs]"]
  node_soap12["SOAP 1.2 client<br/>[Soap12Client.cs]"]
  node_base_client["Request and send"]
  node_response_reader["Response binding"]
  node_metadata_reader["Metadata reading"]
end

subgraph group_mapping["Model mapping"]
  node_model_mapper["Model mapper<br/>[SoapModelMapper.cs]"]
  node_model_emitter["Request XML emitter"]
  node_mapping_metadata["Mapping metadata<br/>[SoapMemberMap.cs]"]
end

subgraph group_security["Message security"]
  node_security_options["Security options<br/>[SoapSecurityDto.cs]"]
  node_security_planner["Security planner"]
  node_header_builder["WS-Security header"]
  node_message_signer["Message signing"]
  node_message_verifier["Signature verification"]
  node_response_security["Response security"]
  node_response_decryptor["Response decryptor"]
  node_secure_conversation["Secure conversation"]
end

subgraph group_transport["HTTP transport"]
  node_http_factory["Named HTTP client"]
end

subgraph group_support["Shared processing"]
  node_xml_loader["Bounded XML loading"]
  node_wire_writer["Envelope wire writer"]
  node_status_classifier["HTTP status handling"]
  node_result_messages["Result messages"]
end

node_caller(("Application caller"))
node_http_service(("SOAP service"))

node_caller -->|"uses"| node_endpoint_api
node_caller -->|"selects protocol"| node_soap11
node_caller -->|"selects protocol"| node_soap12
node_soap11 -->|"inherits"| node_base_client
node_soap12 -->|"inherits"| node_base_client
node_base_client -->|"resolves client"| node_http_factory
node_base_client -->|"sends request"| node_http_service
node_http_service -.->|"returns response"| node_base_client
node_base_client -->|"classifies status"| node_status_classifier
node_base_client -->|"writes envelope"| node_wire_writer
node_base_client -.->|"reads response"| node_response_reader
node_base_client -->|"checks when requested"| node_response_security
node_caller -->|"maps models"| node_model_mapper
node_model_mapper -.->|"emits request body"| node_model_emitter
node_model_emitter -->|"uses mapping"| node_mapping_metadata
node_response_reader -->|"binds mapped fields"| node_mapping_metadata
node_caller -->|"configures security"| node_security_options
node_security_options -.->|"selects mode"| node_security_planner
node_security_planner -.->|"plans header"| node_header_builder
node_header_builder -.->|"signs message"| node_message_signer
node_caller -->|"verifies explicitly"| node_message_verifier
node_caller -->|"requests response check"| node_response_security
node_response_security -->|"decrypts response"| node_response_decryptor
node_caller -->|"issues or cancels"| node_secure_conversation
node_secure_conversation -->|"exchanges messages"| node_http_service
node_response_reader -->|"loads XML"| node_xml_loader
node_base_client -->|"formats failures"| node_result_messages

click node_endpoint_api "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Abstractions/ISoapClientEndpoint.cs"
click node_soap11 "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Client/Soap11Client.cs"
click node_soap12 "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Client/Soap12Client.cs"
click node_base_client "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Client/BaseEndpointClient.cs"
click node_response_reader "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Readers/SoapResponseReader.cs"
click node_metadata_reader "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Readers/SoapMetadataReader.cs"
click node_model_mapper "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Mapping/SoapModelMapper.cs"
click node_model_emitter "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Helpers/Map/SoapModelEmitter.cs"
click node_mapping_metadata "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Dto/Map/SoapMemberMap.cs"
click node_security_options "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Dto/Public/SoapSecurityDto.cs"
click node_security_planner "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Security/SoapSecurityPlanner.cs"
click node_header_builder "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Security/WsSecurity/WsSecurityHeaderBuilder.cs"
click node_message_signer "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Security/WsSecurity/WsSecurityMessageSigner.cs"
click node_message_verifier "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Security/WsSecurity/WsSecurityMessageVerifier.cs"
click node_response_security "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Security/WsSecurity/WsSecurityResponseSecurity.cs"
click node_response_decryptor "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Security/WsSecurity/WsSecurityResponseDecryptor.cs"
click node_secure_conversation "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Security/SoapSecureConversationClient.cs"
click node_http_factory "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Helpers/SoapHttpClientRegistration.cs"
click node_xml_loader "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Helpers/SoapXmlDocumentLoader.cs"
click node_wire_writer "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Helpers/SoapEnvelopeWireWriter.cs"
click node_status_classifier "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Helpers/SoapHttpStatusClassifier.cs"
click node_result_messages "https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Helpers/DefaultResultMessageHelper.cs"

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_endpoint_api,node_soap11,node_soap12,node_base_client,node_response_reader,node_metadata_reader toneBlue
class node_model_mapper,node_model_emitter,node_mapping_metadata toneAmber
class node_security_options,node_security_planner,node_header_builder,node_message_signer,node_message_verifier,node_response_security,node_response_decryptor,node_secure_conversation toneMint
class node_http_factory toneRose
class node_xml_loader,node_wire_writer,node_status_classifier,node_result_messages,node_caller,node_http_service toneIndigo
```

## Components

### SOAP invocation

- [Endpoint contract](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Abstractions/ISoapClientEndpoint.cs): `src/SoapClientCallAssist/Abstractions/ISoapClientEndpoint.cs`
- [SOAP 1.1 client](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Client/Soap11Client.cs): `src/SoapClientCallAssist/Client/Soap11Client.cs`
- [SOAP 1.2 client](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Client/Soap12Client.cs): `src/SoapClientCallAssist/Client/Soap12Client.cs`
- [Request and send](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Client/BaseEndpointClient.cs): `src/SoapClientCallAssist/Client/BaseEndpointClient.cs`
- [Response binding](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Readers/SoapResponseReader.cs): `src/SoapClientCallAssist/Readers/SoapResponseReader.cs`
- [Metadata reading](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Readers/SoapMetadataReader.cs): `src/SoapClientCallAssist/Readers/SoapMetadataReader.cs`

### Model mapping

- [Model mapper](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Mapping/SoapModelMapper.cs): `src/SoapClientCallAssist/Mapping/SoapModelMapper.cs`
- [Request XML emitter](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Helpers/Map/SoapModelEmitter.cs): `src/SoapClientCallAssist/Helpers/Map/SoapModelEmitter.cs`
- [Mapping metadata](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Dto/Map/SoapMemberMap.cs): `src/SoapClientCallAssist/Dto/Map/SoapMemberMap.cs`

### Message security

- [Security options](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Dto/Public/SoapSecurityDto.cs): `src/SoapClientCallAssist/Dto/Public/SoapSecurityDto.cs`
- [Security planner](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Security/SoapSecurityPlanner.cs): `src/SoapClientCallAssist/Security/SoapSecurityPlanner.cs`
- [WS-Security header](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Security/WsSecurity/WsSecurityHeaderBuilder.cs): `src/SoapClientCallAssist/Security/WsSecurity/WsSecurityHeaderBuilder.cs`
- [Message signing](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Security/WsSecurity/WsSecurityMessageSigner.cs): `src/SoapClientCallAssist/Security/WsSecurity/WsSecurityMessageSigner.cs`
- [Signature verification](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Security/WsSecurity/WsSecurityMessageVerifier.cs): `src/SoapClientCallAssist/Security/WsSecurity/WsSecurityMessageVerifier.cs`
- [Response security](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Security/WsSecurity/WsSecurityResponseSecurity.cs): `src/SoapClientCallAssist/Security/WsSecurity/WsSecurityResponseSecurity.cs`
- [Response decryptor](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Security/WsSecurity/WsSecurityResponseDecryptor.cs): `src/SoapClientCallAssist/Security/WsSecurity/WsSecurityResponseDecryptor.cs`
- [Secure conversation](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Security/SoapSecureConversationClient.cs): `src/SoapClientCallAssist/Security/SoapSecureConversationClient.cs`

### HTTP transport

- [Named HTTP client](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Helpers/SoapHttpClientRegistration.cs): `src/SoapClientCallAssist/Helpers/SoapHttpClientRegistration.cs`

### Shared processing

- [Bounded XML loading](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Helpers/SoapXmlDocumentLoader.cs): `src/SoapClientCallAssist/Helpers/SoapXmlDocumentLoader.cs`
- [Envelope wire writer](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Helpers/SoapEnvelopeWireWriter.cs): `src/SoapClientCallAssist/Helpers/SoapEnvelopeWireWriter.cs`
- [HTTP status handling](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Helpers/SoapHttpStatusClassifier.cs): `src/SoapClientCallAssist/Helpers/SoapHttpStatusClassifier.cs`
- [Result messages](https://github.com/i-rzr-i/soapclientcallassist/blob/main/src/SoapClientCallAssist/Helpers/DefaultResultMessageHelper.cs): `src/SoapClientCallAssist/Helpers/DefaultResultMessageHelper.cs`

### Other components

- **Application caller**
- **SOAP service**

## Connections

- Application caller → Endpoint contract: uses (evidence: `src/SoapClientCallAssist/Abstractions/ISoapClientEndpoint.cs`)
- Application caller → SOAP 1.1 client: selects protocol (evidence: `src/SoapClientCallAssist/Client/Soap11Client.cs`)
- Application caller → SOAP 1.2 client: selects protocol (evidence: `src/SoapClientCallAssist/Client/Soap12Client.cs`)
- SOAP 1.1 client → Request and send: inherits (evidence: `src/SoapClientCallAssist/Client/Soap11Client.cs`)
- SOAP 1.2 client → Request and send: inherits (evidence: `src/SoapClientCallAssist/Client/Soap12Client.cs`)
- Request and send → Named HTTP client: resolves client (evidence: `src/SoapClientCallAssist/Client/BaseEndpointClient.cs`)
- Request and send → SOAP service: sends request (evidence: `src/SoapClientCallAssist/Client/BaseEndpointClient.cs`)
- SOAP service → Request and send: returns response (evidence: `README.md`)
- Request and send → HTTP status handling: classifies status (evidence: `src/SoapClientCallAssist/Client/BaseEndpointClient.cs`)
- Request and send → Envelope wire writer: writes envelope (evidence: `src/SoapClientCallAssist/Client/BaseEndpointClient.cs`)
- Request and send → Response binding: reads response
- Request and send → Response security: checks when requested (evidence: `src/SoapClientCallAssist/Client/BaseEndpointClient.cs`)
- Application caller → Model mapper: maps models (evidence: `README.md`)
- Model mapper → Request XML emitter: emits request body (evidence: `src/SoapClientCallAssist/Mapping/SoapModelMapper.cs`)
- Request XML emitter → Mapping metadata: uses mapping (evidence: `src/SoapClientCallAssist/Helpers/Map/SoapModelEmitter.cs`)
- Response binding → Mapping metadata: binds mapped fields (evidence: `src/SoapClientCallAssist/Readers/SoapResponseReader.cs`)
- Application caller → Security options: configures security (evidence: `README.md`)
- Security options → Security planner: selects mode (evidence: `src/SoapClientCallAssist/Security/SoapSecurityPlanner.cs`)
- Security planner → WS-Security header: plans header
- WS-Security header → Message signing: signs message
- Application caller → Signature verification: verifies explicitly (evidence: `README.md`)
- Application caller → Response security: requests response check (evidence: `README.md`)
- Response security → Response decryptor: decrypts response (evidence: `src/SoapClientCallAssist/Security/WsSecurity/WsSecurityResponseDecryptor.cs`)
- Application caller → Secure conversation: issues or cancels (evidence: `README.md`)
- Secure conversation → SOAP service: exchanges messages (evidence: `src/SoapClientCallAssist/Security/SoapSecureConversationClient.cs`)
- Response binding → Bounded XML loading: loads XML (evidence: `src/SoapClientCallAssist/Readers/SoapResponseReader.cs`)
- Request and send → Result messages: formats failures (evidence: `src/SoapClientCallAssist/Client/BaseEndpointClient.cs`)
