# ing-bank/ingenious architecture

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

- Interactive diagram: https://gitdiagram.com/ing-bank/ingenious
- Repository: https://github.com/ing-bank/ingenious

## Overview

INGenious is a Java test-automation framework with a desktop IDE and CLI. The main workflow is to author project test assets, invoke a run, execute automation steps against supported targets, and inspect reports. The README documents browser, mobile, API, messaging, database, SAP, synthetic-data, plugin, BDD, and Azure Test Plan capabilities. The graph preserves these branches, but source evidence is limited to the supplied excerpts and SOURCE INDEX; uncertain runtime wiring is omitted or marked dashed.

Main entry points: [`Engine/src/main/java/com/ing/engine/core/CommandControl.java`](https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/core/CommandControl.java) (Step Control), [`IDE/src/main/java/com/ing/ide/main/Main.java`](https://github.com/ing-bank/ingenious/blob/main/IDE/src/main/java/com/ing/ide/main/Main.java) (Desktop IDE), [`Datalib/src/main/java/com/ing/datalib/component/Project.java`](https://github.com/ing-bank/ingenious/blob/main/Datalib/src/main/java/com/ing/datalib/component/Project.java) (Project Assets), [`Engine/src/main/java/com/ing/engine/core/RunManager.java`](https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/core/RunManager.java) (Run Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Test Authoring"]
  node_project["Project Assets<br/>[Project.java]"]
  node_testcases["Test Cases<br/>[TestCase.java]"]
  node_objectrepo["Object Repository"]
  node_apiimport["API Import"]
  node_bdd["BDD Authoring<br/>[StoryParser.java]"]
end

subgraph group_execution["Execution"]
  node_runner["Run Manager<br/>[RunManager.java]"]
  node_commandcontrol["Step Control"]
  node_aiagent["AI Agent<br/>[AgentLoop.java]"]
  node_planexec["Plan Execution"]
  node_tools["Tool Registry<br/>[ToolRegistry.java]"]
  node_reports["Test Reporting<br/>[RunManager.java]"]
end

subgraph group_integrations["Automation Targets"]
  node_browser["Browser Tests<br/>[Command.java]"]
  node_mobile["Mobile Tests<br/>[Basic.java]"]
  node_api["API Tests<br/>[Webservice.java]"]
  node_database["Database Tests<br/>[Database.java]"]
  node_messaging["Messaging Tests"]
  node_sap["SAP Tests<br/>[SAPActions.java]"]
  node_synthetic["Synthetic Data"]
  node_plugins["Custom Plugins"]
  node_azure["Azure Test Plans"]
end

subgraph group_experience["User Interfaces"]
  node_ide["Desktop IDE<br/>[Main.java]"]
  node_cli["CLI Commands<br/>[RunCommand.java]"]
end

node_engineer(("Test Author"))

node_engineer -->|"authors in"| node_ide
node_engineer -->|"runs tests"| node_cli
node_ide -.->|"edits assets"| node_project
node_cli -.->|"starts run"| node_runner
node_project -.->|"organizes"| node_testcases
node_ide -->|"imports collections"| node_apiimport
node_apiimport -->|"creates assets"| node_project
node_project -.->|"uses objects"| node_objectrepo
node_ide -.->|"authors features"| node_bdd
node_runner -.->|"dispatches steps"| node_commandcontrol
node_runner -.->|"produces results"| node_reports
node_aiagent -.->|"executes plans"| node_planexec
node_planexec -->|"uses registry"| node_tools
node_planexec -->|"dispatches tools"| node_tools
node_commandcontrol -.->|"routes actions"| node_browser
node_commandcontrol -.->|"routes actions"| node_mobile
node_commandcontrol -.->|"routes actions"| node_api
node_commandcontrol -.->|"routes actions"| node_database
node_commandcontrol -.->|"routes actions"| node_messaging
node_commandcontrol -.->|"routes actions"| node_sap
node_commandcontrol -.->|"routes actions"| node_synthetic
node_commandcontrol -.->|"supports extensions"| node_plugins
node_reports -.->|"syncs results"| node_azure

click node_ide "https://github.com/ing-bank/ingenious/blob/main/IDE/src/main/java/com/ing/ide/main/Main.java"
click node_cli "https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/cli/commands/RunCommand.java"
click node_project "https://github.com/ing-bank/ingenious/blob/main/Datalib/src/main/java/com/ing/datalib/component/Project.java"
click node_testcases "https://github.com/ing-bank/ingenious/blob/main/Datalib/src/main/java/com/ing/datalib/component/TestCase.java"
click node_objectrepo "https://github.com/ing-bank/ingenious/blob/main/Datalib/src/main/java/com/ing/datalib/or/ObjectRepository.java"
click node_apiimport "https://github.com/ing-bank/ingenious/blob/main/IDE/src/main/java/com/ing/ide/main/mainui/components/apitester/importing/ReusableImportEngine.java"
click node_bdd "https://github.com/ing-bank/ingenious/blob/main/StoryWriter/src/main/java/com/ing/storywriter/bdd/data/StoryParser.java"
click node_runner "https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/core/RunManager.java"
click node_commandcontrol "https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/core/CommandControl.java"
click node_aiagent "https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/aicli/agent/AgentLoop.java"
click node_planexec "https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/aicli/execution/ExecutionEngine.java"
click node_tools "https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/aicli/tools/ToolRegistry.java"
click node_reports "https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/core/RunManager.java"
click node_browser "https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/commands/browser/Command.java"
click node_mobile "https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/commands/mobile/Basic.java"
click node_api "https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/commands/webservice/Webservice.java"
click node_database "https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/commands/database/Database.java"
click node_messaging "https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/commands/queue/QueueOperations.java"
click node_sap "https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/commands/SAP/SAPActions.java"
click node_synthetic "https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/commands/syntheticData/SyntheticDataGenerator.java"
click node_plugins "https://github.com/ing-bank/ingenious/blob/main/ingenious-api/src/main/java/com/ing/ingenious/api/contract/WebservicePluginApi.java"
click node_azure "https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/reporting/sync/testmanager/TestManagerSync.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_project,node_testcases,node_objectrepo,node_apiimport,node_bdd toneBlue
class node_runner,node_commandcontrol,node_aiagent,node_planexec,node_tools,node_reports toneAmber
class node_browser,node_mobile,node_api,node_database,node_messaging,node_sap,node_synthetic,node_plugins,node_azure toneMint
class node_ide,node_cli toneRose
class node_engineer toneIndigo
```

## Components

### Test Authoring

- [Project Assets](https://github.com/ing-bank/ingenious/blob/main/Datalib/src/main/java/com/ing/datalib/component/Project.java): `Datalib/src/main/java/com/ing/datalib/component/Project.java`
- [Test Cases](https://github.com/ing-bank/ingenious/blob/main/Datalib/src/main/java/com/ing/datalib/component/TestCase.java): `Datalib/src/main/java/com/ing/datalib/component/TestCase.java`
- [Object Repository](https://github.com/ing-bank/ingenious/blob/main/Datalib/src/main/java/com/ing/datalib/or/ObjectRepository.java): `Datalib/src/main/java/com/ing/datalib/or/ObjectRepository.java`
- [API Import](https://github.com/ing-bank/ingenious/blob/main/IDE/src/main/java/com/ing/ide/main/mainui/components/apitester/importing/ReusableImportEngine.java): `IDE/src/main/java/com/ing/ide/main/mainui/components/apitester/importing/ReusableImportEngine.java`
- [BDD Authoring](https://github.com/ing-bank/ingenious/blob/main/StoryWriter/src/main/java/com/ing/storywriter/bdd/data/StoryParser.java): `StoryWriter/src/main/java/com/ing/storywriter/bdd/data/StoryParser.java`

### Execution

- [Run Manager](https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/core/RunManager.java): `Engine/src/main/java/com/ing/engine/core/RunManager.java`
- [Step Control](https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/core/CommandControl.java): `Engine/src/main/java/com/ing/engine/core/CommandControl.java`
- [AI Agent](https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/aicli/agent/AgentLoop.java): `Engine/src/main/java/com/ing/engine/aicli/agent/AgentLoop.java`
- [Plan Execution](https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/aicli/execution/ExecutionEngine.java): `Engine/src/main/java/com/ing/engine/aicli/execution/ExecutionEngine.java`
- [Tool Registry](https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/aicli/tools/ToolRegistry.java): `Engine/src/main/java/com/ing/engine/aicli/tools/ToolRegistry.java`
- [Test Reporting](https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/core/RunManager.java): `Engine/src/main/java/com/ing/engine/core/RunManager.java`

### Automation Targets

- [Browser Tests](https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/commands/browser/Command.java): `Engine/src/main/java/com/ing/engine/commands/browser/Command.java`
- [Mobile Tests](https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/commands/mobile/Basic.java): `Engine/src/main/java/com/ing/engine/commands/mobile/Basic.java`
- [API Tests](https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/commands/webservice/Webservice.java): `Engine/src/main/java/com/ing/engine/commands/webservice/Webservice.java`
- [Database Tests](https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/commands/database/Database.java): `Engine/src/main/java/com/ing/engine/commands/database/Database.java`
- [Messaging Tests](https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/commands/queue/QueueOperations.java): `Engine/src/main/java/com/ing/engine/commands/queue/QueueOperations.java`
- [SAP Tests](https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/commands/SAP/SAPActions.java): `Engine/src/main/java/com/ing/engine/commands/SAP/SAPActions.java`
- [Synthetic Data](https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/commands/syntheticData/SyntheticDataGenerator.java): `Engine/src/main/java/com/ing/engine/commands/syntheticData/SyntheticDataGenerator.java`
- [Custom Plugins](https://github.com/ing-bank/ingenious/blob/main/ingenious-api/src/main/java/com/ing/ingenious/api/contract/WebservicePluginApi.java): `ingenious-api/src/main/java/com/ing/ingenious/api/contract/WebservicePluginApi.java`
- [Azure Test Plans](https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/reporting/sync/testmanager/TestManagerSync.java): `Engine/src/main/java/com/ing/engine/reporting/sync/testmanager/TestManagerSync.java`

### User Interfaces

- [Desktop IDE](https://github.com/ing-bank/ingenious/blob/main/IDE/src/main/java/com/ing/ide/main/Main.java): `IDE/src/main/java/com/ing/ide/main/Main.java`
- [CLI Commands](https://github.com/ing-bank/ingenious/blob/main/Engine/src/main/java/com/ing/engine/cli/commands/RunCommand.java): `Engine/src/main/java/com/ing/engine/cli/commands/RunCommand.java`

### Other components

- **Test Author**

## Connections

- Test Author → Desktop IDE: authors in (evidence: `README.md`)
- Test Author → CLI Commands: runs tests (evidence: `README.md`)
- Desktop IDE → Project Assets: edits assets
- CLI Commands → Run Manager: starts run
- Project Assets → Test Cases: organizes
- Desktop IDE → API Import: imports collections (evidence: `IDE/src/main/java/com/ing/ide/main/mainui/components/apitester/importing/ReusableImportEngine.java`)
- API Import → Project Assets: creates assets (evidence: `IDE/src/main/java/com/ing/ide/main/mainui/components/apitester/importing/ReusableImportEngine.java`)
- Project Assets → Object Repository: uses objects (evidence: `Datalib/src/main/java/com/ing/datalib/or/ObjectRepository.java`)
- Desktop IDE → BDD Authoring: authors features
- Run Manager → Step Control: dispatches steps
- Run Manager → Test Reporting: produces results
- AI Agent → Plan Execution: executes plans
- Plan Execution → Tool Registry: uses registry (evidence: `Engine/src/main/java/com/ing/engine/aicli/execution/ExecutionEngine.java`)
- Plan Execution → Tool Registry: dispatches tools (evidence: `Engine/src/main/java/com/ing/engine/aicli/execution/ExecutionEngine.java`)
- Step Control → Browser Tests: routes actions (evidence: `Engine/src/main/java/com/ing/engine/commands/browser/Command.java`)
- Step Control → Mobile Tests: routes actions
- Step Control → API Tests: routes actions (evidence: `Engine/src/main/java/com/ing/engine/commands/webservice/Webservice.java`)
- Step Control → Database Tests: routes actions
- Step Control → Messaging Tests: routes actions
- Step Control → SAP Tests: routes actions
- Step Control → Synthetic Data: routes actions
- Step Control → Custom Plugins: supports extensions
- Test Reporting → Azure Test Plans: syncs results
