# openpeppol/vida-pilot-testing architecture

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

- Interactive diagram: https://gitdiagram.com/openpeppol/vida-pilot-testing
- Repository: https://github.com/openpeppol/vida-pilot-testing

## Overview

This is a curated Peppol ViDA pilot test-data repository, not an application runtime. Participants select a scenario invoice for a seller/receiver jurisdiction pair, adapt it for their environment, and use it to test their systems. The repository also supplies human-readable and alternate-format artifacts, non-normative sample TDD results, and validation reports; participants can contribute test packages and share run results under their participant directories. Relationships reflect the README’s documented artifact roles; no processing or upload implementation is present in the supplied tree.

Main entry points: [`NW-EP-001`](https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-EP-001) (EP-001 invoices), [`NW-HP-001`](https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-HP-001) (HP scenarios), [`NW-HP-002`](https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-HP-002) (Other HP scenarios), [`NW-EP-001/sample-results`](https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-EP-001/sample-results) (Sample TDD results)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scenarios["Test scenarios"]
  node_scenario_ep001["EP-001 invoices"]
  node_scenario_hp["HP scenarios"]
  node_scenario_hp_other["Other HP scenarios"]
  node_jurisdiction_data["Jurisdiction data"]
end

subgraph group_artifacts["Test artifacts"]
  node_invoice_pdf["Review PDFs"]
  node_alternate_formats["Alternate XML"]
  node_sample_results["Sample TDD results"]
  node_validation["Validation reports"]
  node_visualization["Invoice visualizations"]
end

subgraph group_sharing["Participant sharing"]
  node_participant_packages["Contributed packages"]
  node_shared_results["Shared test results"]
end

node_participant(("Pilot participant"))
node_pilot["Pilot test environment"]

node_participant -->|"selects invoice"| node_scenario_ep001
node_participant -->|"selects scenario"| node_scenario_hp
node_participant -->|"selects scenario"| node_scenario_hp_other
node_participant -->|"runs tests"| node_pilot
node_scenario_ep001 -->|"supplies invoice"| node_pilot
node_scenario_hp -->|"supplies invoice"| node_pilot
node_scenario_hp_other -->|"supplies invoice"| node_pilot
node_scenario_ep001 -->|"human-readable form"| node_invoice_pdf
node_scenario_hp -->|"alternate syntax"| node_alternate_formats
node_scenario_ep001 -->|"corresponding examples"| node_sample_results
node_scenario_ep001 -->|"validation report"| node_validation
node_sample_results -->|"validation report"| node_validation
node_scenario_ep001 -->|"visualized as"| node_visualization
node_participant -->|"consults jurisdictions"| node_jurisdiction_data
node_participant -->|"contributes package"| node_participant_packages
node_participant -->|"shares run results"| node_shared_results

click node_scenario_ep001 "https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-EP-001"
click node_scenario_hp "https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-HP-001"
click node_scenario_hp_other "https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-HP-002"
click node_jurisdiction_data "https://github.com/openpeppol/vida-pilot-testing/tree/main/tax_jurisdictions"
click node_invoice_pdf "https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-EP-001/supporting-files"
click node_alternate_formats "https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-HP-001/other-formats"
click node_sample_results "https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-EP-001/sample-results"
click node_validation "https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-EP-001/supporting-files"
click node_visualization "https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-EP-001/supporting-files"
click node_participant_packages "https://github.com/openpeppol/vida-pilot-testing/tree/main/participants"
click node_shared_results "https://github.com/openpeppol/vida-pilot-testing/tree/main/participants/000778-Arratech/NW-HP-001/results"

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_scenario_ep001,node_scenario_hp,node_scenario_hp_other,node_jurisdiction_data toneBlue
class node_invoice_pdf,node_alternate_formats,node_sample_results,node_validation,node_visualization toneAmber
class node_participant_packages,node_shared_results toneMint
class node_participant,node_pilot toneIndigo
```

## Components

### Test scenarios

- [EP-001 invoices](https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-EP-001): `NW-EP-001`
- [HP scenarios](https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-HP-001): `NW-HP-001`
- [Other HP scenarios](https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-HP-002): `NW-HP-002`
- [Jurisdiction data](https://github.com/openpeppol/vida-pilot-testing/tree/main/tax_jurisdictions): `tax_jurisdictions`

### Test artifacts

- [Review PDFs](https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-EP-001/supporting-files): `NW-EP-001/supporting-files`
- [Alternate XML](https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-HP-001/other-formats): `NW-HP-001/other-formats`
- [Sample TDD results](https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-EP-001/sample-results): `NW-EP-001/sample-results`
- [Validation reports](https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-EP-001/supporting-files): `NW-EP-001/supporting-files`
- [Invoice visualizations](https://github.com/openpeppol/vida-pilot-testing/tree/main/NW-EP-001/supporting-files): `NW-EP-001/supporting-files`

### Participant sharing

- [Contributed packages](https://github.com/openpeppol/vida-pilot-testing/tree/main/participants): `participants`
- [Shared test results](https://github.com/openpeppol/vida-pilot-testing/tree/main/participants/000778-Arratech/NW-HP-001/results): `participants/000778-Arratech/NW-HP-001/results`

### Other components

- **Pilot participant**
- **Pilot test environment**

## Connections

- Pilot participant → EP-001 invoices: selects invoice
- Pilot participant → HP scenarios: selects scenario
- Pilot participant → Other HP scenarios: selects scenario
- Pilot participant → Pilot test environment: runs tests
- EP-001 invoices → Pilot test environment: supplies invoice
- HP scenarios → Pilot test environment: supplies invoice
- Other HP scenarios → Pilot test environment: supplies invoice
- EP-001 invoices → Review PDFs: human-readable form
- HP scenarios → Alternate XML: alternate syntax
- EP-001 invoices → Sample TDD results: corresponding examples
- EP-001 invoices → Validation reports: validation report
- Sample TDD results → Validation reports: validation report
- EP-001 invoices → Invoice visualizations: visualized as
- Pilot participant → Jurisdiction data: consults jurisdictions
- Pilot participant → Contributed packages: contributes package
- Pilot participant → Shared test results: shares run results