# ibrahimasiridev/abappdf-cloud architecture

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

- Interactive diagram: https://gitdiagram.com/ibrahimasiridev/abappdf-cloud
- Repository: https://github.com/ibrahimasiridev/abappdf-cloud

## Overview

abapPDF Cloud is an ABAP Cloud form designer and PDF-generation product. Users open the system-hosted designer to manage versioned forms, bind data, and render PDFs; application code can also call the render API, and the RAP travel demo stores generated PDFs. The README documents native rendering, template features, live data sources, Arabic support, and optional Gotenberg. Relationships below are limited to those stated in the README; source excerpts were not provided, so internal calls and storage wiring are not inferred.

Main entry points: [`src/zcl_abappdf_api.clas.abap`](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_api.clas.abap) (Render API), [`src/zcl_abappdf_rap.clas.abap`](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_rap.clas.abap) (Travel RAP App), [`src/zcl_abappdf_http.clas.abap`](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_http.clas.abap) (Form HTTP API), [`web/designer.html`](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/web/designer.html) (Web Designer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["HTTP and Designer"]
  node_http_service["ABAP HTTP Service"]
  node_http_handler["HTTP Handler"]
  node_designer["Web Designer<br/>[designer.html]"]
  node_ui_page["Embedded UI Page"]
end

subgraph group_forms["Forms and Binding"]
  node_form_api["Form HTTP API"]
  node_form_versions[("Form Versions")]
  node_form_binding["Template Binding"]
end

subgraph group_render["PDF Rendering"]
  node_render_api["Render API"]
  node_native_engine["Native PDF Engine"]
  node_arabic_fonts["Arabic Fonts"]
  node_engine_config[("Engine Settings")]
  node_gotenberg["Gotenberg Engine"]
end

subgraph group_data["Data Sources"]
  node_travel_source["Travel Data Source"]
  node_invoice_source["Invoice Data Source"]
  node_data_contract["Data Source Contract"]
end

subgraph group_demo["RAP Travel Demo"]
  node_travel_app["Travel RAP App"]
  node_travel_behavior["Travel Behavior"]
  node_travel_pdf[("Stored Travel PDF")]
end

node_user(("Designer User"))
node_client(("API Client"))

node_user -->|"opens"| node_http_service
node_http_service -->|"handled by"| node_http_handler
node_http_handler -->|"serves"| node_designer
node_designer -->|"calls"| node_form_api
node_client -->|"calls"| node_form_api
node_form_api -.->|"manages versions"| node_form_versions
node_form_api -.->|"renders form"| node_render_api
node_client -->|"calls"| node_render_api
node_render_api -.->|"binds template"| node_form_binding
node_render_api -.->|"renders PDF"| node_native_engine
node_native_engine -.->|"uses"| node_arabic_fonts
node_engine_config -.->|"configures"| node_gotenberg
node_render_api -.->|"optionally uses"| node_gotenberg
node_travel_source -->|"implements"| node_data_contract
node_invoice_source -->|"implements"| node_data_contract
node_user -->|"prints travel"| node_travel_app
node_travel_app -->|"stores PDF"| node_travel_pdf
node_travel_app -.->|"uses"| node_render_api
node_travel_app -.->|"reads travel data"| node_travel_source

click node_http_handler "https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_http.clas.abap"
click node_designer "https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/web/designer.html"
click node_ui_page "https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_ui.clas.abap"
click node_form_api "https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_http.clas.abap"
click node_form_versions "https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zabappdf_forms.tabl.xml"
click node_form_binding "https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_binder.clas.abap"
click node_render_api "https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_api.clas.abap"
click node_native_engine "https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_renderer.clas.abap"
click node_arabic_fonts "https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_font.clas.abap"
click node_engine_config "https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zabappdf_conf.tabl.xml"
click node_gotenberg "https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_gotenberg.clas.abap"
click node_travel_source "https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_travel.clas.abap"
click node_invoice_source "https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_invoice.clas.abap"
click node_data_contract "https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zif_abappdf_data.intf.abap"
click node_travel_app "https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_rap.clas.abap"
click node_travel_behavior "https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zbp_i_abappdf_travel.clas.abap"
click node_travel_pdf "https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zabappdf_tpdf.tabl.xml"

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_http_service,node_http_handler,node_designer,node_ui_page,node_user,node_client toneBlue
class node_form_api,node_form_versions,node_form_binding toneAmber
class node_render_api,node_native_engine,node_arabic_fonts,node_engine_config,node_gotenberg toneMint
class node_travel_source,node_invoice_source,node_data_contract toneRose
class node_travel_app,node_travel_behavior,node_travel_pdf toneIndigo
```

## Components

### HTTP and Designer

- **ABAP HTTP Service**
- [HTTP Handler](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_http.clas.abap): `src/zcl_abappdf_http.clas.abap`
- [Web Designer](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/web/designer.html): `web/designer.html`
- [Embedded UI Page](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_ui.clas.abap): `src/zcl_abappdf_ui.clas.abap`

### Forms and Binding

- [Form HTTP API](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_http.clas.abap): `src/zcl_abappdf_http.clas.abap`
- [Form Versions](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zabappdf_forms.tabl.xml): `src/zabappdf_forms.tabl.xml`
- [Template Binding](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_binder.clas.abap): `src/zcl_abappdf_binder.clas.abap`

### PDF Rendering

- [Render API](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_api.clas.abap): `src/zcl_abappdf_api.clas.abap`
- [Native PDF Engine](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_renderer.clas.abap): `src/zcl_abappdf_renderer.clas.abap`
- [Arabic Fonts](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_font.clas.abap): `src/zcl_abappdf_font.clas.abap`
- [Engine Settings](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zabappdf_conf.tabl.xml): `src/zabappdf_conf.tabl.xml`
- [Gotenberg Engine](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_gotenberg.clas.abap): `src/zcl_abappdf_gotenberg.clas.abap`

### Data Sources

- [Travel Data Source](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_travel.clas.abap): `src/zcl_abappdf_travel.clas.abap`
- [Invoice Data Source](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_invoice.clas.abap): `src/zcl_abappdf_invoice.clas.abap`
- [Data Source Contract](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zif_abappdf_data.intf.abap): `src/zif_abappdf_data.intf.abap`

### RAP Travel Demo

- [Travel RAP App](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zcl_abappdf_rap.clas.abap): `src/zcl_abappdf_rap.clas.abap`
- [Travel Behavior](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zbp_i_abappdf_travel.clas.abap): `src/zbp_i_abappdf_travel.clas.abap`
- [Stored Travel PDF](https://github.com/ibrahimasiridev/abappdf-cloud/blob/main/src/zabappdf_tpdf.tabl.xml): `src/zabappdf_tpdf.tabl.xml`

### Other components

- **Designer User**
- **API Client**

## Connections

- Designer User → ABAP HTTP Service: opens (evidence: `README.md`)
- ABAP HTTP Service → HTTP Handler: handled by (evidence: `README.md`)
- HTTP Handler → Web Designer: serves (evidence: `README.md`)
- Web Designer → Form HTTP API: calls (evidence: `README.md`)
- API Client → Form HTTP API: calls (evidence: `README.md`)
- Form HTTP API → Form Versions: manages versions
- Form HTTP API → Render API: renders form
- API Client → Render API: calls (evidence: `README.md`)
- Render API → Template Binding: binds template
- Render API → Native PDF Engine: renders PDF
- Native PDF Engine → Arabic Fonts: uses
- Engine Settings → Gotenberg Engine: configures
- Render API → Gotenberg Engine: optionally uses
- Travel Data Source → Data Source Contract: implements (evidence: `README.md`)
- Invoice Data Source → Data Source Contract: implements (evidence: `README.md`)
- Designer User → Travel RAP App: prints travel (evidence: `README.md`)
- Travel RAP App → Stored Travel PDF: stores PDF (evidence: `README.md`)
- Travel RAP App → Render API: uses
- Travel RAP App → Travel Data Source: reads travel data
