# ctt-gob-es/validador-oaw architecture

> Architecture diagram of the GitHub repository ctt-gob-es/validador-oaw, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ctt-gob-es/validador-oaw
- Repository: https://github.com/ctt-gob-es/validador-oaw

## Overview

OAW is a web accessibility validator. Its principal workflow accepts a URL or supplied content, evaluates it against a selected guideline, and returns structured problems; the API also documents PDF validation. The repository includes a JavaScript-rendering proxy/browser service and Tracker SOAP integration. The graph follows calls visible in the sampled Java sources and documented integrations; connections to unsampled analysis modules are omitted where their wiring cannot be established.

Main entry points: [`src/main/java/es/gob/ad/oaw/validador/service/impl/ValidatorServiceImpl.java`](https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/service/impl/ValidatorServiceImpl.java) (Validation service), [`src/main/java/es/gob/ad/oaw/validador/controller/ValidationRequestController.java`](https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/controller/ValidationRequestController.java) (Request controller), [`src/main/java/es/gob/ad/oaw/validador/util/SOAPConnector.java`](https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/util/SOAPConnector.java) (SOAP connector), [`docker/motor-js/renderer/prerender/lib/server.js`](https://github.com/ctt-gob-es/validador-oaw/blob/main/docker/motor-js/renderer/prerender/lib/server.js) (Prerender server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Validation API"]
  node_controller["Request controller"]
  node_request["Validation request"]
  node_response["Problem response"]
end

subgraph group_analysis["Analysis"]
  node_service["Validation service"]
  node_evaluation["Evaluation<br/>[Evaluation.java]"]
  node_evalutils["Evaluation utilities"]
  node_engine["Accessibility checks<br/>[AllChecks.java]"]
  node_css["CSS analysis<br/>[CSSAnalyzer.java]"]
  node_language["Language analysis"]
  node_w3c["W3C validation"]
  node_pdf["PDF validation"]
end

subgraph group_integrations["Integrations"]
  node_tracker["Tracker connector"]
  node_soap["SOAP connector<br/>[SOAPConnector.java]"]
  node_trackerdb(("Tracker service"))
end

subgraph group_rendering["JavaScript rendering"]
  node_renderer["Prerender server<br/>[server.js]"]
  node_browser["Chrome browser<br/>[chrome.js]"]
  node_proxy["Render proxy<br/>[index.js]"]
end

node_client(("API client"))

node_client -->|"submits request"| node_controller
node_controller -->|"binds input"| node_request
node_controller -->|"calls validation"| node_service
node_service -->|"evaluates URL"| node_evalutils
node_service -->|"reads results"| node_evaluation
node_service -->|"initializes checks"| node_engine
node_service -->|"builds problems"| node_response
node_controller -->|"returns JSON"| node_response
node_service -->|"offers PDF validation"| node_pdf
node_renderer -->|"drives browser"| node_browser
node_proxy -.->|"forwards render requests"| node_renderer
node_tracker -->|"calls SOAP"| node_soap
node_soap -->|"sends operations"| node_trackerdb

click node_controller "https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/controller/ValidationRequestController.java"
click node_request "https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/dto/ValidationRequestDTO.java"
click node_service "https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/service/impl/ValidatorServiceImpl.java"
click node_evaluation "https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/accessibilitychecker/Evaluation.java"
click node_evalutils "https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/inteco/inteco/intav/utils/EvaluatorUtils.java"
click node_engine "https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/accessibilitychecker/AllChecks.java"
click node_css "https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/inteco/gob/oaw/css/CSSAnalyzer.java"
click node_language "https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/inteco/gob/oaw/language/LanguageChecker.java"
click node_w3c "https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/inteco/gob/oaw/w3cvalidator/W3CValidatorProxy.java"
click node_pdf "https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/service/ValidatorService.java"
click node_response "https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/common/ValidationResponse.java"
click node_renderer "https://github.com/ctt-gob-es/validador-oaw/blob/main/docker/motor-js/renderer/prerender/lib/server.js"
click node_browser "https://github.com/ctt-gob-es/validador-oaw/blob/main/docker/motor-js/renderer/prerender/lib/browsers/chrome.js"
click node_proxy "https://github.com/ctt-gob-es/validador-oaw/blob/main/docker/motor-js/proxy/index.js"
click node_tracker "https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/common/TrackerDatabaseConnector.java"
click node_soap "https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/util/SOAPConnector.java"

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_controller,node_request,node_response,node_client toneBlue
class node_service,node_evaluation,node_evalutils,node_engine,node_css,node_language,node_w3c,node_pdf toneAmber
class node_tracker,node_soap,node_trackerdb toneMint
class node_renderer,node_browser,node_proxy toneRose
```

## Components

### Validation API

- [Request controller](https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/controller/ValidationRequestController.java): `src/main/java/es/gob/ad/oaw/validador/controller/ValidationRequestController.java`
- [Validation request](https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/dto/ValidationRequestDTO.java): `src/main/java/es/gob/ad/oaw/validador/dto/ValidationRequestDTO.java`
- [Problem response](https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/common/ValidationResponse.java): `src/main/java/es/gob/ad/oaw/validador/common/ValidationResponse.java`

### Analysis

- [Validation service](https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/service/impl/ValidatorServiceImpl.java): `src/main/java/es/gob/ad/oaw/validador/service/impl/ValidatorServiceImpl.java`
- [Evaluation](https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/accessibilitychecker/Evaluation.java): `src/main/java/es/gob/ad/oaw/validador/accessibilitychecker/Evaluation.java`
- [Evaluation utilities](https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/inteco/inteco/intav/utils/EvaluatorUtils.java): `src/main/java/es/gob/ad/oaw/validador/inteco/inteco/intav/utils/EvaluatorUtils.java`
- [Accessibility checks](https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/accessibilitychecker/AllChecks.java): `src/main/java/es/gob/ad/oaw/validador/accessibilitychecker/AllChecks.java`
- [CSS analysis](https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/inteco/gob/oaw/css/CSSAnalyzer.java): `src/main/java/es/gob/ad/oaw/validador/inteco/gob/oaw/css/CSSAnalyzer.java`
- [Language analysis](https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/inteco/gob/oaw/language/LanguageChecker.java): `src/main/java/es/gob/ad/oaw/validador/inteco/gob/oaw/language/LanguageChecker.java`
- [W3C validation](https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/inteco/gob/oaw/w3cvalidator/W3CValidatorProxy.java): `src/main/java/es/gob/ad/oaw/validador/inteco/gob/oaw/w3cvalidator/W3CValidatorProxy.java`
- [PDF validation](https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/service/ValidatorService.java): `src/main/java/es/gob/ad/oaw/validador/service/ValidatorService.java`

### Integrations

- [Tracker connector](https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/common/TrackerDatabaseConnector.java): `src/main/java/es/gob/ad/oaw/validador/common/TrackerDatabaseConnector.java`
- [SOAP connector](https://github.com/ctt-gob-es/validador-oaw/blob/main/src/main/java/es/gob/ad/oaw/validador/util/SOAPConnector.java): `src/main/java/es/gob/ad/oaw/validador/util/SOAPConnector.java`
- **Tracker service**

### JavaScript rendering

- [Prerender server](https://github.com/ctt-gob-es/validador-oaw/blob/main/docker/motor-js/renderer/prerender/lib/server.js): `docker/motor-js/renderer/prerender/lib/server.js`
- [Chrome browser](https://github.com/ctt-gob-es/validador-oaw/blob/main/docker/motor-js/renderer/prerender/lib/browsers/chrome.js): `docker/motor-js/renderer/prerender/lib/browsers/chrome.js`
- [Render proxy](https://github.com/ctt-gob-es/validador-oaw/blob/main/docker/motor-js/proxy/index.js): `docker/motor-js/proxy/index.js`

### Other components

- **API client**

## Connections

- API client → Request controller: submits request
- Request controller → Validation request: binds input
- Request controller → Validation service: calls validation
- Validation service → Evaluation utilities: evaluates URL
- Validation service → Evaluation: reads results
- Validation service → Accessibility checks: initializes checks
- Validation service → Problem response: builds problems
- Request controller → Problem response: returns JSON
- Validation service → PDF validation: offers PDF validation
- Prerender server → Chrome browser: drives browser
- Render proxy → Prerender server: forwards render requests
- Tracker connector → SOAP connector: calls SOAP
- SOAP connector → Tracker service: sends operations
