# eu-digital-identity-wallet/eudi-doc-testing-application architecture

> Architecture diagram of the GitHub repository eu-digital-identity-wallet/eudi-doc-testing-application, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/eu-digital-identity-wallet/eudi-doc-testing-application
- Repository: https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application

## Overview

This repository is a functional E2E test suite for the EUDI Wallet, not the wallet implementation itself. Its principal workflow is selecting manual or automated Gherkin scenarios, executing them against an Android or iOS wallet on a local device or BrowserStack, and reviewing results. The feature corpus covers credential issuance and presentation, wallet/document flows, revocation, and business scenarios. Internal Java wiring was not excerpted, so those control-flow links are shown as unverified; the README documents the execution options and feature location.

Main entry points: [`src/test/resources/features`](https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/resources/features) (Gherkin scenarios), [`src/test/java/runners/TestRunner.java`](https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/blob/main/src/test/java/runners/TestRunner.java) (Cucumber runners), [`src/test/java/eu/europa/eudi/utils/factory`](https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/java/eu/europa/eudi/utils/factory) (Driver factories), [`src/test/java/eu/europa/eudi/stepdefs`](https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/java/eu/europa/eudi/stepdefs) (Step definitions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scenario["Test scenarios"]
  node_feature_suite["Gherkin scenarios"]
  node_issuance["Credential issuance"]
  node_presentation["Credential presentation"]
  node_wallet_flows["Wallet flows"]
  node_revocation["Revocation checks"]
  node_business_flows["Business scenarios"]
end

subgraph group_automation["Test automation"]
  node_test_runner["Cucumber runners<br/>[TestRunner.java]"]
  node_stepdefs["Step definitions"]
  node_page_objects["Wallet pages"]
  node_platform_elements["Platform elements"]
end

subgraph group_execution["Execution targets"]
  node_device_factory["Driver factories"]
  node_local_devices["Local devices"]
  node_browserstack["BrowserStack"]
  node_wallet_app["Wallet application"]
end

subgraph group_results["Result handling"]
  node_report_merge["Result merger"]
  node_serenity_results["Serenity reports"]
end

node_engineer(("Test operator"))

node_engineer -.->|"selects tests"| node_feature_suite
node_feature_suite -.->|"runs scenarios"| node_test_runner
node_issuance -.->|"scenario set"| node_feature_suite
node_presentation -.->|"scenario set"| node_feature_suite
node_wallet_flows -.->|"scenario set"| node_feature_suite
node_revocation -.->|"scenario set"| node_feature_suite
node_business_flows -.->|"scenario set"| node_feature_suite
node_test_runner -.->|"dispatches steps"| node_stepdefs
node_stepdefs -.->|"uses pages"| node_page_objects
node_page_objects -.->|"uses elements"| node_platform_elements
node_device_factory -.->|"connects locally"| node_local_devices
node_device_factory -.->|"connects remotely"| node_browserstack
node_test_runner -.->|"executes on"| node_device_factory
node_wallet_app -.->|"installed on"| node_local_devices
node_report_merge -->|"updates reports"| node_serenity_results

click node_feature_suite "https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/resources/features"
click node_issuance "https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/resources/features"
click node_presentation "https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/resources/features"
click node_wallet_flows "https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/resources/features"
click node_revocation "https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/resources/features"
click node_business_flows "https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/resources/features"
click node_test_runner "https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/blob/main/src/test/java/runners/TestRunner.java"
click node_stepdefs "https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/java/eu/europa/eudi/stepdefs"
click node_page_objects "https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/java/eu/europa/eudi/pages"
click node_platform_elements "https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/java/eu/europa/eudi/elements"
click node_device_factory "https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/java/eu/europa/eudi/utils/factory"
click node_wallet_app "https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/resources/app"
click node_report_merge "https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/blob/main/merge_serenity_results.py"

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_feature_suite,node_issuance,node_presentation,node_wallet_flows,node_revocation,node_business_flows toneBlue
class node_test_runner,node_stepdefs,node_page_objects,node_platform_elements toneAmber
class node_device_factory,node_local_devices,node_browserstack,node_wallet_app toneMint
class node_report_merge,node_serenity_results toneRose
class node_engineer toneIndigo
```

## Components

### Test scenarios

- [Gherkin scenarios](https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/resources/features): `src/test/resources/features`
- [Credential issuance](https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/resources/features): `src/test/resources/features`
- [Credential presentation](https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/resources/features): `src/test/resources/features`
- [Wallet flows](https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/resources/features): `src/test/resources/features`
- [Revocation checks](https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/resources/features): `src/test/resources/features`
- [Business scenarios](https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/resources/features): `src/test/resources/features`

### Test automation

- [Cucumber runners](https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/blob/main/src/test/java/runners/TestRunner.java): `src/test/java/runners/TestRunner.java`
- [Step definitions](https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/java/eu/europa/eudi/stepdefs): `src/test/java/eu/europa/eudi/stepdefs`
- [Wallet pages](https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/java/eu/europa/eudi/pages): `src/test/java/eu/europa/eudi/pages`
- [Platform elements](https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/java/eu/europa/eudi/elements): `src/test/java/eu/europa/eudi/elements`

### Execution targets

- [Driver factories](https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/java/eu/europa/eudi/utils/factory): `src/test/java/eu/europa/eudi/utils/factory`
- **Local devices**
- **BrowserStack**
- [Wallet application](https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/tree/main/src/test/resources/app): `src/test/resources/app`

### Result handling

- [Result merger](https://github.com/eu-digital-identity-wallet/eudi-doc-testing-application/blob/main/merge_serenity_results.py): `merge_serenity_results.py`
- **Serenity reports**

### Other components

- **Test operator**

## Connections

- Test operator → Gherkin scenarios: selects tests (evidence: `README.md`)
- Gherkin scenarios → Cucumber runners: runs scenarios (evidence: `README.md`)
- Credential issuance → Gherkin scenarios: scenario set
- Credential presentation → Gherkin scenarios: scenario set
- Wallet flows → Gherkin scenarios: scenario set
- Revocation checks → Gherkin scenarios: scenario set
- Business scenarios → Gherkin scenarios: scenario set
- Cucumber runners → Step definitions: dispatches steps
- Step definitions → Wallet pages: uses pages
- Wallet pages → Platform elements: uses elements
- Driver factories → Local devices: connects locally (evidence: `README.md`)
- Driver factories → BrowserStack: connects remotely (evidence: `README.md`)
- Cucumber runners → Driver factories: executes on
- Wallet application → Local devices: installed on (evidence: `README.md`)
- Result merger → Serenity reports: updates reports (evidence: `merge_serenity_results.py`)
