# titianltl/iso20022 architecture

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

- Interactive diagram: https://gitdiagram.com/titianltl/iso20022
- Repository: https://github.com/titianltl/iso20022

## Overview

This is a local-file Java tool for preparing ISO 20022 pain.001 payment files, with CSV-based creditor data, payment XML generation, signing, and file wrapping represented in the source tree. The principal workflow appears to collect form and payment data, generate a JAXB document, then sign and wrap the output. BuildData and signing internals are excerpted; the UI’s exact call sequence and wrapping behavior are not, so those connections are shown as unverified rather than asserted.

Main entry points: [`src/main/java/generator/BuildData.java`](https://github.com/titianltl/iso20022/blob/main/src/main/java/generator/BuildData.java) (Document generation), [`src/main/java/UI/LocalFileToolUI.java`](https://github.com/titianltl/iso20022/blob/main/src/main/java/UI/LocalFileToolUI.java) (File tool UI), [`src/main/java/sign/XmlSigningBuilder.java`](https://github.com/titianltl/iso20022/blob/main/src/main/java/sign/XmlSigningBuilder.java) (XML signature builder), [`src/main/java/generator/iso/level/AbstractBuilder.java`](https://github.com/titianltl/iso20022/blob/main/src/main/java/generator/iso/level/AbstractBuilder.java) (Builder foundation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_input["Input and UI"]
  node_ui["File tool UI"]
  node_form["Form data<br/>[FormVo.java]"]
  node_csv["CSV reader<br/>[ItemReader.java]"]
  node_payment_data["Payment records<br/>[CreditVo.java]"]
end

subgraph group_payment["Payment Generation"]
  node_build["Document generation<br/>[BuildData.java]"]
  node_header["Group header builder"]
  node_payment_instruction["Payment instruction builder"]
  node_creditor["Creditor builder"]
  node_builder_base["Builder foundation"]
  node_iso_constants["ISO constants<br/>[Iso20022.java]"]
end

subgraph group_schema["ISO XML Model"]
  node_xml_model["pain.001 JAXB model"]
end

subgraph group_output["Signing and Output"]
  node_sign_file["File signing flow<br/>[SignFile.java]"]
  node_xml_signer["XML signature builder"]
  node_sign_data["Signing state<br/>[SignVo.java]"]
  node_wrap["File wrapper"]
  node_settings["Runtime settings<br/>[KeyWordUtil.java]"]
end

node_user(("Local operator"))

node_user -.->|"uses"| node_ui
node_ui -.->|"collects"| node_form
node_ui -.->|"reads input"| node_csv
node_csv -->|"creates records"| node_payment_data
node_ui -.->|"starts generation"| node_build
node_build -->|"builds header"| node_header
node_build -->|"builds instruction"| node_payment_instruction
node_build -->|"builds transfers"| node_creditor
node_build -->|"assembles document"| node_xml_model
node_build -->|"reads fields"| node_form
node_build -->|"reads credits"| node_payment_data
node_header -->|"extends"| node_builder_base
node_payment_instruction -->|"extends"| node_builder_base
node_creditor -.->|"extends"| node_builder_base
node_build -->|"uses codes"| node_iso_constants
node_ui -.->|"starts signing"| node_sign_file
node_sign_file -->|"invokes"| node_xml_signer
node_xml_signer -->|"populates state"| node_sign_data
node_xml_signer -->|"parses document"| node_xml_model
node_ui -.->|"starts wrapping"| node_wrap
node_ui -.->|"uses settings"| node_settings
node_build -.->|"gets output path"| node_settings
node_xml_signer -.->|"gets key settings"| node_settings

click node_ui "https://github.com/titianltl/iso20022/blob/main/src/main/java/UI/LocalFileToolUI.java"
click node_form "https://github.com/titianltl/iso20022/blob/main/src/main/java/vo/FormVo.java"
click node_csv "https://github.com/titianltl/iso20022/blob/main/src/main/java/load/csv/ItemReader.java"
click node_payment_data "https://github.com/titianltl/iso20022/blob/main/src/main/java/vo/CreditVo.java"
click node_build "https://github.com/titianltl/iso20022/blob/main/src/main/java/generator/BuildData.java"
click node_header "https://github.com/titianltl/iso20022/blob/main/src/main/java/generator/iso/level/GroupHeaderBuilder.java"
click node_payment_instruction "https://github.com/titianltl/iso20022/blob/main/src/main/java/generator/iso/level/PaymentInstructionInformationBuilder.java"
click node_creditor "https://github.com/titianltl/iso20022/blob/main/src/main/java/generator/iso/level/PmtInf/CreditorBuilder.java"
click node_builder_base "https://github.com/titianltl/iso20022/blob/main/src/main/java/generator/iso/level/AbstractBuilder.java"
click node_iso_constants "https://github.com/titianltl/iso20022/blob/main/src/main/java/generator/iso/constants/Iso20022.java"
click node_xml_model "https://github.com/titianltl/iso20022/tree/main/src/main/java/iso/std/iso/_20022/tech/xsd/pain_001_001"
click node_sign_file "https://github.com/titianltl/iso20022/blob/main/src/main/java/sign/SignFile.java"
click node_xml_signer "https://github.com/titianltl/iso20022/blob/main/src/main/java/sign/XmlSigningBuilder.java"
click node_sign_data "https://github.com/titianltl/iso20022/blob/main/src/main/java/sign/vo/SignVo.java"
click node_wrap "https://github.com/titianltl/iso20022/blob/main/src/main/java/wrap/WrapFileBuilder.java"
click node_settings "https://github.com/titianltl/iso20022/blob/main/src/main/java/util/KeyWordUtil.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_ui,node_form,node_csv,node_payment_data toneBlue
class node_build,node_header,node_payment_instruction,node_creditor,node_builder_base,node_iso_constants toneAmber
class node_xml_model toneMint
class node_sign_file,node_xml_signer,node_sign_data,node_wrap,node_settings toneRose
class node_user toneIndigo
```

## Components

### Input and UI

- [File tool UI](https://github.com/titianltl/iso20022/blob/main/src/main/java/UI/LocalFileToolUI.java): `src/main/java/UI/LocalFileToolUI.java`
- [Form data](https://github.com/titianltl/iso20022/blob/main/src/main/java/vo/FormVo.java): `src/main/java/vo/FormVo.java`
- [CSV reader](https://github.com/titianltl/iso20022/blob/main/src/main/java/load/csv/ItemReader.java): `src/main/java/load/csv/ItemReader.java`
- [Payment records](https://github.com/titianltl/iso20022/blob/main/src/main/java/vo/CreditVo.java): `src/main/java/vo/CreditVo.java`

### Payment Generation

- [Document generation](https://github.com/titianltl/iso20022/blob/main/src/main/java/generator/BuildData.java): `src/main/java/generator/BuildData.java`
- [Group header builder](https://github.com/titianltl/iso20022/blob/main/src/main/java/generator/iso/level/GroupHeaderBuilder.java): `src/main/java/generator/iso/level/GroupHeaderBuilder.java`
- [Payment instruction builder](https://github.com/titianltl/iso20022/blob/main/src/main/java/generator/iso/level/PaymentInstructionInformationBuilder.java): `src/main/java/generator/iso/level/PaymentInstructionInformationBuilder.java`
- [Creditor builder](https://github.com/titianltl/iso20022/blob/main/src/main/java/generator/iso/level/PmtInf/CreditorBuilder.java): `src/main/java/generator/iso/level/PmtInf/CreditorBuilder.java`
- [Builder foundation](https://github.com/titianltl/iso20022/blob/main/src/main/java/generator/iso/level/AbstractBuilder.java): `src/main/java/generator/iso/level/AbstractBuilder.java`
- [ISO constants](https://github.com/titianltl/iso20022/blob/main/src/main/java/generator/iso/constants/Iso20022.java): `src/main/java/generator/iso/constants/Iso20022.java`

### ISO XML Model

- [pain.001 JAXB model](https://github.com/titianltl/iso20022/tree/main/src/main/java/iso/std/iso/_20022/tech/xsd/pain_001_001): `src/main/java/iso/std/iso/_20022/tech/xsd/pain_001_001`

### Signing and Output

- [File signing flow](https://github.com/titianltl/iso20022/blob/main/src/main/java/sign/SignFile.java): `src/main/java/sign/SignFile.java`
- [XML signature builder](https://github.com/titianltl/iso20022/blob/main/src/main/java/sign/XmlSigningBuilder.java): `src/main/java/sign/XmlSigningBuilder.java`
- [Signing state](https://github.com/titianltl/iso20022/blob/main/src/main/java/sign/vo/SignVo.java): `src/main/java/sign/vo/SignVo.java`
- [File wrapper](https://github.com/titianltl/iso20022/blob/main/src/main/java/wrap/WrapFileBuilder.java): `src/main/java/wrap/WrapFileBuilder.java`
- [Runtime settings](https://github.com/titianltl/iso20022/blob/main/src/main/java/util/KeyWordUtil.java): `src/main/java/util/KeyWordUtil.java`

### Other components

- **Local operator**

## Connections

- Local operator → File tool UI: uses
- File tool UI → Form data: collects (evidence: `src/main/java/UI/LocalFileToolUI.java`)
- File tool UI → CSV reader: reads input (evidence: `src/main/java/UI/LocalFileToolUI.java`)
- CSV reader → Payment records: creates records (evidence: `src/main/java/load/csv/ItemReader.java`)
- File tool UI → Document generation: starts generation (evidence: `src/main/java/UI/LocalFileToolUI.java`)
- Document generation → Group header builder: builds header (evidence: `src/main/java/generator/BuildData.java`)
- Document generation → Payment instruction builder: builds instruction (evidence: `src/main/java/generator/BuildData.java`)
- Document generation → Creditor builder: builds transfers (evidence: `src/main/java/generator/BuildData.java`)
- Document generation → pain.001 JAXB model: assembles document (evidence: `src/main/java/generator/BuildData.java`)
- Document generation → Form data: reads fields (evidence: `src/main/java/generator/BuildData.java`)
- Document generation → Payment records: reads credits (evidence: `src/main/java/generator/BuildData.java`)
- Group header builder → Builder foundation: extends (evidence: `src/main/java/generator/iso/level/GroupHeaderBuilder.java`)
- Payment instruction builder → Builder foundation: extends (evidence: `src/main/java/generator/iso/level/PaymentInstructionInformationBuilder.java`)
- Creditor builder → Builder foundation: extends (evidence: `src/main/java/generator/iso/level/PmtInf/CreditorBuilder.java`)
- Document generation → ISO constants: uses codes (evidence: `src/main/java/generator/BuildData.java`)
- File tool UI → File signing flow: starts signing (evidence: `src/main/java/UI/LocalFileToolUI.java`)
- File signing flow → XML signature builder: invokes (evidence: `src/main/java/sign/SignFile.java`)
- XML signature builder → Signing state: populates state (evidence: `src/main/java/sign/XmlSigningBuilder.java`)
- XML signature builder → pain.001 JAXB model: parses document (evidence: `src/main/java/sign/XmlSigningBuilder.java`)
- File tool UI → File wrapper: starts wrapping (evidence: `src/main/java/UI/LocalFileToolUI.java`)
- File tool UI → Runtime settings: uses settings (evidence: `src/main/java/UI/LocalFileToolUI.java`)
- Document generation → Runtime settings: gets output path
- XML signature builder → Runtime settings: gets key settings
