# ifazasalcedo/consultaruc architecture

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

- Interactive diagram: https://gitdiagram.com/ifazasalcedo/consultaruc
- Repository: https://github.com/ifazasalcedo/consultaruc

## Overview

This Spring Boot application exposes a SOAP service for looking up a Paraguayan taxpayer by RUC and returning its registered details. The main flow is SOAP request handling, service-layer lookup through a Spring Data repository, and construction of a JAXB response payload. Web-service configuration registers the SOAP servlet and publishes a WSDL definition from the XSD. The excerpts show the endpoint’s calls and model mapping; persistence to a database is implied by the JPA repository, but its runtime database configuration was not shown.

Main entry points: [`src/main/java/com/wsoap/pwserver/endpoint/ConsultaRucEndpoint.java`](https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/pwserver/endpoint/ConsultaRucEndpoint.java) (Lookup endpoint), [`src/main/java/com/wsoap/data/repository/ContribuyenteRepository.java`](https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/data/repository/ContribuyenteRepository.java) (Taxpayer repository), [`src/main/java/com/wsoap/pwserver/consulta/ConsultaRucResponse.java`](https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/pwserver/consulta/ConsultaRucResponse.java) (SOAP response), [`src/main/java/com/wsoap/data/service/ContribuyenteService.java`](https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/data/service/ContribuyenteService.java) (Lookup service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_soap["SOAP interface"]
  node_request["RUC request"]
  node_endpoint["Lookup endpoint"]
  node_response["SOAP response"]
  node_payload["Taxpayer payload"]
end

subgraph group_lookup["Taxpayer lookup"]
  node_service["Lookup service"]
  node_repository["Taxpayer repository"]
  node_entity["Taxpayer entity<br/>[Contribuyente.java]"]
end

subgraph group_runtime["Application runtime"]
  node_application["Spring Boot app"]
  node_wsconfig["SOAP configuration"]
  node_schema["SOAP schema"]
end

node_client(("SOAP client"))
node_database[("Relational database")]

node_client -->|"sends SOAP"| node_endpoint
node_endpoint -->|"accepts"| node_request
node_endpoint -->|"looks up RUC"| node_service
node_service -->|"queries"| node_repository
node_repository -->|"returns entity"| node_entity
node_repository -.->|"persists via JPA"| node_database
node_endpoint -->|"maps properties"| node_payload
node_endpoint -->|"builds response"| node_response
node_response -->|"contains"| node_payload
node_wsconfig -->|"loads schema"| node_schema
node_application -.->|"starts Spring context"| node_wsconfig

click node_request "https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/pwserver/consulta/ConsultaRucRequest.java"
click node_endpoint "https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/pwserver/endpoint/ConsultaRucEndpoint.java"
click node_response "https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/pwserver/consulta/ConsultaRucResponse.java"
click node_payload "https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/pwserver/consulta/RucContribuyente.java"
click node_service "https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/data/service/ContribuyenteService.java"
click node_repository "https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/data/repository/ContribuyenteRepository.java"
click node_entity "https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/data/entity/Contribuyente.java"
click node_application "https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/ConsultarucApplication.java"
click node_wsconfig "https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/WebServiceConfigure.java"
click node_schema "https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/resources/consulta_ruc_set.xsd"

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_request,node_endpoint,node_response,node_payload,node_client toneBlue
class node_service,node_repository,node_entity,node_database toneAmber
class node_application,node_wsconfig,node_schema toneMint
```

## Components

### SOAP interface

- [RUC request](https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/pwserver/consulta/ConsultaRucRequest.java): `src/main/java/com/wsoap/pwserver/consulta/ConsultaRucRequest.java`
- [Lookup endpoint](https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/pwserver/endpoint/ConsultaRucEndpoint.java): `src/main/java/com/wsoap/pwserver/endpoint/ConsultaRucEndpoint.java`
- [SOAP response](https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/pwserver/consulta/ConsultaRucResponse.java): `src/main/java/com/wsoap/pwserver/consulta/ConsultaRucResponse.java`
- [Taxpayer payload](https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/pwserver/consulta/RucContribuyente.java): `src/main/java/com/wsoap/pwserver/consulta/RucContribuyente.java`

### Taxpayer lookup

- [Lookup service](https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/data/service/ContribuyenteService.java): `src/main/java/com/wsoap/data/service/ContribuyenteService.java`
- [Taxpayer repository](https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/data/repository/ContribuyenteRepository.java): `src/main/java/com/wsoap/data/repository/ContribuyenteRepository.java`
- [Taxpayer entity](https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/data/entity/Contribuyente.java): `src/main/java/com/wsoap/data/entity/Contribuyente.java`

### Application runtime

- [Spring Boot app](https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/ConsultarucApplication.java): `src/main/java/com/wsoap/ConsultarucApplication.java`
- [SOAP configuration](https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/java/com/wsoap/WebServiceConfigure.java): `src/main/java/com/wsoap/WebServiceConfigure.java`
- [SOAP schema](https://github.com/ifazasalcedo/consultaruc/blob/master/src/main/resources/consulta_ruc_set.xsd): `src/main/resources/consulta_ruc_set.xsd`

### Other components

- **SOAP client**
- **Relational database**

## Connections

- SOAP client → Lookup endpoint: sends SOAP (evidence: `src/main/java/com/wsoap/pwserver/endpoint/ConsultaRucEndpoint.java`)
- Lookup endpoint → RUC request: accepts (evidence: `src/main/java/com/wsoap/pwserver/endpoint/ConsultaRucEndpoint.java`)
- Lookup endpoint → Lookup service: looks up RUC (evidence: `src/main/java/com/wsoap/pwserver/endpoint/ConsultaRucEndpoint.java`)
- Lookup service → Taxpayer repository: queries (evidence: `src/main/java/com/wsoap/data/service/ContribuyenteService.java`)
- Taxpayer repository → Taxpayer entity: returns entity (evidence: `src/main/java/com/wsoap/data/repository/ContribuyenteRepository.java`)
- Taxpayer repository → Relational database: persists via JPA
- Lookup endpoint → Taxpayer payload: maps properties (evidence: `src/main/java/com/wsoap/pwserver/endpoint/ConsultaRucEndpoint.java`)
- Lookup endpoint → SOAP response: builds response (evidence: `src/main/java/com/wsoap/pwserver/endpoint/ConsultaRucEndpoint.java`)
- SOAP response → Taxpayer payload: contains (evidence: `src/main/java/com/wsoap/pwserver/consulta/ConsultaRucResponse.java`)
- SOAP configuration → SOAP schema: loads schema (evidence: `src/main/java/com/wsoap/WebServiceConfigure.java`)
- Spring Boot app → SOAP configuration: starts Spring context
