# rajeshponna/camunda-jev-ai-decision-connector architecture

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

- Interactive diagram: https://gitdiagram.com/rajeshponna/camunda-jev-ai-decision-connector
- Repository: https://github.com/rajeshponna/camunda-jev-ai-decision-connector

## Overview

This repository is a Camunda 8 outbound connector for Jev, a model that returns typed decisions. A process supplies state and either custom questions, a catalog to select from, or a catalog to filter; the connector dispatches the operation, calls Jev, and returns structured answers, rankings, or matches for BPMN use. The graph distinguishes connector dispatch, catalog algorithms, and request/response contracts. Source excerpts show HTTP retries and catalog batching; other README capabilities are retained where documented, without inferring unsampled implementation links.

Main entry points: [`src/main/java/io/github/rajeshponna/jev/JevConnectorFunction.java`](https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/JevConnectorFunction.java) (Outbound connector), [`src/main/java/io/github/rajeshponna/jev/JevClient.java`](https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/JevClient.java) (Jev HTTP client), [`src/main/java/io/github/rajeshponna/jev/JevResponse.java`](https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/JevResponse.java) (Typed result), [`src/main/java/io/github/rajeshponna/jev/CatalogSelector.java`](https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/CatalogSelector.java) (Catalog selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_integration["Camunda integration"]
  node_connector["Outbound connector"]
  node_application["Connector application"]
  node_client["Jev HTTP client<br/>[JevClient.java]"]
end

subgraph group_operations["Decision operations"]
  node_questions["Custom questions"]
  node_selection["Catalog selection"]
  node_filter["Catalog filtering<br/>[CatalogFilter.java]"]
end

subgraph group_contracts["Request and response"]
  node_request["Request binding<br/>[JevRequest.java]"]
  node_response["Typed result<br/>[JevResponse.java]"]
end

node_process(("BPMN process"))
node_jev{{"Jev API"}}

node_process -->|"invokes"| node_connector
node_connector -->|"binds"| node_request
node_connector -->|"dispatches"| node_questions
node_connector -->|"dispatches"| node_selection
node_connector -->|"dispatches"| node_filter
node_connector -->|"creates"| node_client
node_selection -->|"sends calls"| node_client
node_filter -->|"sends calls"| node_client
node_client -->|"posts requests"| node_jev
node_connector -->|"builds result"| node_response
node_selection -->|"builds rankings"| node_response
node_filter -->|"builds matches"| node_response
node_response -->|"returns decisions"| node_process

click node_connector "https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/JevConnectorFunction.java"
click node_application "https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/JevConnectorApplication.java"
click node_request "https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/JevRequest.java"
click node_questions "https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/JevConnectorFunction.java"
click node_selection "https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/CatalogSelector.java"
click node_filter "https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/CatalogFilter.java"
click node_client "https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/JevClient.java"
click node_response "https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/JevResponse.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_connector,node_application,node_client toneBlue
class node_questions,node_selection,node_filter toneAmber
class node_request,node_response,node_jev toneMint
class node_process toneIndigo
```

## Components

### Camunda integration

- [Outbound connector](https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/JevConnectorFunction.java): `src/main/java/io/github/rajeshponna/jev/JevConnectorFunction.java`
- [Connector application](https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/JevConnectorApplication.java): `src/main/java/io/github/rajeshponna/jev/JevConnectorApplication.java`
- [Jev HTTP client](https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/JevClient.java): `src/main/java/io/github/rajeshponna/jev/JevClient.java`

### Decision operations

- [Custom questions](https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/JevConnectorFunction.java): `src/main/java/io/github/rajeshponna/jev/JevConnectorFunction.java`
- [Catalog selection](https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/CatalogSelector.java): `src/main/java/io/github/rajeshponna/jev/CatalogSelector.java`
- [Catalog filtering](https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/CatalogFilter.java): `src/main/java/io/github/rajeshponna/jev/CatalogFilter.java`

### Request and response

- [Request binding](https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/JevRequest.java): `src/main/java/io/github/rajeshponna/jev/JevRequest.java`
- [Typed result](https://github.com/rajeshponna/camunda-jev-ai-decision-connector/blob/main/src/main/java/io/github/rajeshponna/jev/JevResponse.java): `src/main/java/io/github/rajeshponna/jev/JevResponse.java`

### Other components

- **BPMN process**
- **Jev API**

## Connections

- BPMN process → Outbound connector: invokes (evidence: `README.md`)
- Outbound connector → Request binding: binds (evidence: `src/main/java/io/github/rajeshponna/jev/JevConnectorFunction.java`)
- Outbound connector → Custom questions: dispatches (evidence: `src/main/java/io/github/rajeshponna/jev/JevConnectorFunction.java`)
- Outbound connector → Catalog selection: dispatches (evidence: `src/main/java/io/github/rajeshponna/jev/JevConnectorFunction.java`)
- Outbound connector → Catalog filtering: dispatches (evidence: `src/main/java/io/github/rajeshponna/jev/JevConnectorFunction.java`)
- Outbound connector → Jev HTTP client: creates (evidence: `src/main/java/io/github/rajeshponna/jev/JevConnectorFunction.java`)
- Catalog selection → Jev HTTP client: sends calls (evidence: `src/main/java/io/github/rajeshponna/jev/CatalogSelector.java`)
- Catalog filtering → Jev HTTP client: sends calls (evidence: `src/main/java/io/github/rajeshponna/jev/CatalogFilter.java`)
- Jev HTTP client → Jev API: posts requests (evidence: `src/main/java/io/github/rajeshponna/jev/JevClient.java`)
- Outbound connector → Typed result: builds result (evidence: `src/main/java/io/github/rajeshponna/jev/JevConnectorFunction.java`)
- Catalog selection → Typed result: builds rankings (evidence: `src/main/java/io/github/rajeshponna/jev/CatalogSelector.java`)
- Catalog filtering → Typed result: builds matches (evidence: `src/main/java/io/github/rajeshponna/jev/CatalogFilter.java`)
- Typed result → BPMN process: returns decisions (evidence: `README.md`)
