# selimhorri/tesseract architecture

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

- Interactive diagram: https://gitdiagram.com/selimhorri/tesseract
- Repository: https://github.com/selimhorri/tesseract

## Overview

Tesseract is a set of Spring Boot libraries that provides configured synchronous and reactive HTTP clients, declarative proxy factories, and system-specific starter clients. An application adds a transport module, then may add a starter such as JPS: shared properties configure the default client; the starter derives a base-URL-specific client and proxy factory. The sampled code shows those construction and delegation paths. README-documented application usage and the JPS external API are included; other starter behavior is omitted because it is not present in the tree.

Main entry points: [`tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/SyncHttpClientsAutoConfig.java`](https://github.com/selimhorri/tesseract/blob/master/tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/SyncHttpClientsAutoConfig.java) (JPS sync setup), [`tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/AsyncHttpClientsAutoConfig.java`](https://github.com/selimhorri/tesseract/blob/master/tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/AsyncHttpClientsAutoConfig.java) (JPS async setup), [`tesseract-parent/tesseract-sync/src/main/java/io/github/selimhorri/tesseract/sync/HttpClientsAutoConfig.java`](https://github.com/selimhorri/tesseract/blob/master/tesseract-parent/tesseract-sync/src/main/java/io/github/selimhorri/tesseract/sync/HttpClientsAutoConfig.java) (Sync client setup), [`tesseract-parent/tesseract-async/src/main/java/io/github/selimhorri/tesseract/async/HttpClientsAutoConfig.java`](https://github.com/selimhorri/tesseract/blob/master/tesseract-parent/tesseract-async/src/main/java/io/github/selimhorri/tesseract/async/HttpClientsAutoConfig.java) (Async client setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shared["Shared client settings"]
  node_http_props["Client properties"]
  node_default_props["Default settings"]
  node_core_enable["Properties binding"]
end

subgraph group_transports["HTTP transports"]
  node_sync_config["Sync client setup"]
  node_async_config["Async client setup"]
end

subgraph group_jps["JPS starter"]
  node_jps_props["JPS settings"]
  node_jps_enable["JPS binding"]
  node_jps_sync["JPS sync setup"]
  node_jps_sync_customizers["Sync customizers"]
  node_jps_async["JPS async setup"]
  node_jps_async_customizers["Async customizers"]
end

node_application(("Application"))
node_jps_api{{"JSONPlaceholder"}}

node_core_enable -->|"binds"| node_default_props
node_default_props -->|"implements"| node_http_props
node_sync_config -->|"reads settings"| node_http_props
node_async_config -->|"reads settings"| node_http_props
node_application -->|"uses sync client"| node_sync_config
node_application -->|"uses async client"| node_async_config
node_jps_enable -->|"binds"| node_jps_props
node_jps_sync -->|"reads base URL"| node_jps_props
node_jps_sync -->|"applies"| node_jps_sync_customizers
node_jps_async -->|"reads base URL"| node_jps_props
node_jps_async -->|"applies"| node_jps_async_customizers
node_sync_config -->|"provides default"| node_jps_sync
node_async_config -->|"provides default"| node_jps_async
node_jps_sync -->|"targets"| node_jps_api
node_jps_async -->|"targets"| node_jps_api
node_application -->|"uses sync starter"| node_jps_sync
node_application -->|"uses async starter"| node_jps_async

click node_http_props "https://github.com/selimhorri/tesseract/blob/master/tesseract-parent/tesseract-core/src/main/java/io/github/selimhorri/tesseract/core/HttpClientProps.java"
click node_default_props "https://github.com/selimhorri/tesseract/blob/master/tesseract-parent/tesseract-core/src/main/java/io/github/selimhorri/tesseract/core/DefaultHttpClientProps.java"
click node_core_enable "https://github.com/selimhorri/tesseract/blob/master/tesseract-parent/tesseract-core/src/main/java/io/github/selimhorri/tesseract/core/HttpClientEnablingConfig.java"
click node_sync_config "https://github.com/selimhorri/tesseract/blob/master/tesseract-parent/tesseract-sync/src/main/java/io/github/selimhorri/tesseract/sync/HttpClientsAutoConfig.java"
click node_async_config "https://github.com/selimhorri/tesseract/blob/master/tesseract-parent/tesseract-async/src/main/java/io/github/selimhorri/tesseract/async/HttpClientsAutoConfig.java"
click node_jps_props "https://github.com/selimhorri/tesseract/blob/master/tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/JpsClientProps.java"
click node_jps_enable "https://github.com/selimhorri/tesseract/blob/master/tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/JpsEnablingConfig.java"
click node_jps_sync "https://github.com/selimhorri/tesseract/blob/master/tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/SyncHttpClientsAutoConfig.java"
click node_jps_sync_customizers "https://github.com/selimhorri/tesseract/blob/master/tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/JpsRestClientCustomizer.java"
click node_jps_async "https://github.com/selimhorri/tesseract/blob/master/tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/AsyncHttpClientsAutoConfig.java"
click node_jps_async_customizers "https://github.com/selimhorri/tesseract/blob/master/tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/JpsWebClientCustomizer.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_http_props,node_default_props,node_core_enable toneBlue
class node_sync_config,node_async_config toneAmber
class node_jps_props,node_jps_enable,node_jps_sync,node_jps_sync_customizers,node_jps_async,node_jps_async_customizers toneMint
class node_application,node_jps_api toneIndigo
```

## Components

### Shared client settings

- [Client properties](https://github.com/selimhorri/tesseract/blob/master/tesseract-parent/tesseract-core/src/main/java/io/github/selimhorri/tesseract/core/HttpClientProps.java): `tesseract-parent/tesseract-core/src/main/java/io/github/selimhorri/tesseract/core/HttpClientProps.java`
- [Default settings](https://github.com/selimhorri/tesseract/blob/master/tesseract-parent/tesseract-core/src/main/java/io/github/selimhorri/tesseract/core/DefaultHttpClientProps.java): `tesseract-parent/tesseract-core/src/main/java/io/github/selimhorri/tesseract/core/DefaultHttpClientProps.java`
- [Properties binding](https://github.com/selimhorri/tesseract/blob/master/tesseract-parent/tesseract-core/src/main/java/io/github/selimhorri/tesseract/core/HttpClientEnablingConfig.java): `tesseract-parent/tesseract-core/src/main/java/io/github/selimhorri/tesseract/core/HttpClientEnablingConfig.java`

### HTTP transports

- [Sync client setup](https://github.com/selimhorri/tesseract/blob/master/tesseract-parent/tesseract-sync/src/main/java/io/github/selimhorri/tesseract/sync/HttpClientsAutoConfig.java): `tesseract-parent/tesseract-sync/src/main/java/io/github/selimhorri/tesseract/sync/HttpClientsAutoConfig.java`
- [Async client setup](https://github.com/selimhorri/tesseract/blob/master/tesseract-parent/tesseract-async/src/main/java/io/github/selimhorri/tesseract/async/HttpClientsAutoConfig.java): `tesseract-parent/tesseract-async/src/main/java/io/github/selimhorri/tesseract/async/HttpClientsAutoConfig.java`

### JPS starter

- [JPS settings](https://github.com/selimhorri/tesseract/blob/master/tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/JpsClientProps.java): `tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/JpsClientProps.java`
- [JPS binding](https://github.com/selimhorri/tesseract/blob/master/tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/JpsEnablingConfig.java): `tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/JpsEnablingConfig.java`
- [JPS sync setup](https://github.com/selimhorri/tesseract/blob/master/tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/SyncHttpClientsAutoConfig.java): `tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/SyncHttpClientsAutoConfig.java`
- [Sync customizers](https://github.com/selimhorri/tesseract/blob/master/tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/JpsRestClientCustomizer.java): `tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/JpsRestClientCustomizer.java`
- [JPS async setup](https://github.com/selimhorri/tesseract/blob/master/tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/AsyncHttpClientsAutoConfig.java): `tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/AsyncHttpClientsAutoConfig.java`
- [Async customizers](https://github.com/selimhorri/tesseract/blob/master/tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/JpsWebClientCustomizer.java): `tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/JpsWebClientCustomizer.java`

### Other components

- **Application**
- **JSONPlaceholder**

## Connections

- Properties binding → Default settings: binds (evidence: `tesseract-parent/tesseract-core/src/main/java/io/github/selimhorri/tesseract/core/HttpClientEnablingConfig.java`)
- Default settings → Client properties: implements (evidence: `tesseract-parent/tesseract-core/src/main/java/io/github/selimhorri/tesseract/core/DefaultHttpClientProps.java`)
- Sync client setup → Client properties: reads settings (evidence: `tesseract-parent/tesseract-sync/src/main/java/io/github/selimhorri/tesseract/sync/HttpClientsAutoConfig.java`)
- Async client setup → Client properties: reads settings (evidence: `tesseract-parent/tesseract-async/src/main/java/io/github/selimhorri/tesseract/async/HttpClientsAutoConfig.java`)
- Application → Sync client setup: uses sync client (evidence: `README.md`)
- Application → Async client setup: uses async client (evidence: `README.md`)
- JPS binding → JPS settings: binds (evidence: `tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/JpsEnablingConfig.java`)
- JPS sync setup → JPS settings: reads base URL (evidence: `tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/SyncHttpClientsAutoConfig.java`)
- JPS sync setup → Sync customizers: applies (evidence: `tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/SyncHttpClientsAutoConfig.java`)
- JPS async setup → JPS settings: reads base URL (evidence: `tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/AsyncHttpClientsAutoConfig.java`)
- JPS async setup → Async customizers: applies (evidence: `tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/AsyncHttpClientsAutoConfig.java`)
- Sync client setup → JPS sync setup: provides default (evidence: `tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/SyncHttpClientsAutoConfig.java`)
- Async client setup → JPS async setup: provides default (evidence: `tesseract-starter-jps/src/main/java/io/github/selimhorri/tesseract/jps/AsyncHttpClientsAutoConfig.java`)
- JPS sync setup → JSONPlaceholder: targets (evidence: `README.md`)
- JPS async setup → JSONPlaceholder: targets (evidence: `README.md`)
- Application → JPS sync setup: uses sync starter (evidence: `README.md`)
- Application → JPS async setup: uses async starter (evidence: `README.md`)
