# danieleteti/delphimvcframework architecture

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

- Interactive diagram: https://gitdiagram.com/danieleteti/delphimvcframework
- Repository: https://github.com/danieleteti/delphimvcframework

## Overview

DelphiMVCFramework is a Delphi framework for REST services, JSON-RPC APIs, and web applications. The documented request workflow routes HTTP requests to MVC controllers, applies middleware and security, then returns serialized data; ORM and API-documentation support are adjacent capabilities. The supplied tree contains deployment Swagger assets and bundled Firebird headers, but not the framework’s core implementation, so those documented stages are conceptual and their internal links are limited. The headers show a separate UDR/message-metadata layer; this evidence does not establish its connection to framework request handling.

Main entry points: [`unittests/general/TestClient/bin32/firebird/include/firebird/Message.h`](https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin32/firebird/include/firebird/Message.h) (Message metadata), [`unittests/general/TestClient/bin64/firebird/include/firebird/Message.h`](https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin64/firebird/include/firebird/Message.h) (Message metadata 64-bit), [`lib/swagdoc/Deploy/swagger-ui.js`](https://github.com/danieleteti/delphimvcframework/blob/master/lib/swagdoc/Deploy/swagger-ui.js) (Swagger UI), [`unittests/general/TestClient/bin32/firebird/include/firebird/UdrCppEngine.h`](https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin32/firebird/include/firebird/UdrCppEngine.h) (UDR factories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_framework["Request framework"]
  node_routing["MVC routing"]
  node_controller["Controller action"]
  node_middleware["Middleware"]
  node_security["Authentication"]
  node_serialization["JSON serialization"]
end

subgraph group_data["Data access"]
  node_orm["ActiveRecord ORM"]
  node_rql["RQL queries"]
end

subgraph group_web["Web capabilities"]
  node_realtime["Realtime APIs"]
  node_views["Server views"]
  node_swagger["Swagger UI<br/>[swagger-ui.js]"]
  node_swagger2["Swagger 2 UI<br/>[swagger-ui.js]"]
  node_openapi3["OpenAPI 3 setup"]
end

subgraph group_bundled["Bundled dependencies"]
  node_udr["UDR factories<br/>[UdrCppEngine.h]"]
  node_message["Message metadata<br/>[Message.h]"]
  node_firebird["Firebird API<br/>[ibase.h]"]
  node_interface["Firebird interfaces<br/>[Interface.h]"]
  node_udr64["UDR factories 64-bit<br/>[UdrCppEngine.h]"]
  node_message64["Message metadata 64-bit<br/>[Message.h]"]
  node_firebird64["Firebird API 64-bit<br/>[ibase.h]"]
  node_interface64["Interfaces 64-bit<br/>[Interface.h]"]
end

node_client(("API client"))
node_database[("Database")]

node_client -->|"sends request"| node_routing
node_routing -->|"routes to"| node_controller
node_controller -.->|"uses processing"| node_middleware
node_middleware -->|"can apply"| node_security
node_controller -.->|"returns data"| node_serialization
node_controller -.->|"can access"| node_orm
node_orm -->|"supports querying"| node_rql
node_orm -->|"accesses"| node_database
node_client -->|"uses realtime"| node_realtime
node_client -->|"requests views"| node_views
node_swagger -.->|"variant"| node_swagger2
node_swagger -.->|"variant"| node_openapi3
node_udr -->|"uses metadata"| node_message
node_message -->|"uses interfaces"| node_interface
node_message -->|"uses definitions"| node_firebird
node_udr64 -->|"uses metadata"| node_message64
node_message64 -->|"uses interfaces"| node_interface64
node_message64 -.->|"uses definitions"| node_firebird64

click node_swagger "https://github.com/danieleteti/delphimvcframework/blob/master/lib/swagdoc/Deploy/swagger-ui.js"
click node_swagger2 "https://github.com/danieleteti/delphimvcframework/blob/master/lib/swagdoc/Deploy/Swagger2/swagger-ui.js"
click node_openapi3 "https://github.com/danieleteti/delphimvcframework/blob/master/lib/swagdoc/Deploy/OpenApi3/swagger-initializer.js"
click node_udr "https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin32/firebird/include/firebird/UdrCppEngine.h"
click node_message "https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin32/firebird/include/firebird/Message.h"
click node_firebird "https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin32/firebird/include/ibase.h"
click node_interface "https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin32/firebird/include/firebird/Interface.h"
click node_udr64 "https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin64/firebird/include/firebird/UdrCppEngine.h"
click node_message64 "https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin64/firebird/include/firebird/Message.h"
click node_firebird64 "https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin64/firebird/include/ibase.h"
click node_interface64 "https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin64/firebird/include/firebird/Interface.h"

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_routing,node_controller,node_middleware,node_security,node_serialization,node_client toneBlue
class node_orm,node_rql,node_database toneAmber
class node_realtime,node_views,node_swagger,node_swagger2,node_openapi3 toneMint
class node_udr,node_message,node_firebird,node_interface,node_udr64,node_message64,node_firebird64,node_interface64 toneRose
```

## Components

### Request framework

- **MVC routing**
- **Controller action**
- **Middleware**
- **Authentication**
- **JSON serialization**

### Data access

- **ActiveRecord ORM**
- **RQL queries**

### Web capabilities

- **Realtime APIs**
- **Server views**
- [Swagger UI](https://github.com/danieleteti/delphimvcframework/blob/master/lib/swagdoc/Deploy/swagger-ui.js): `lib/swagdoc/Deploy/swagger-ui.js`
- [Swagger 2 UI](https://github.com/danieleteti/delphimvcframework/blob/master/lib/swagdoc/Deploy/Swagger2/swagger-ui.js): `lib/swagdoc/Deploy/Swagger2/swagger-ui.js`
- [OpenAPI 3 setup](https://github.com/danieleteti/delphimvcframework/blob/master/lib/swagdoc/Deploy/OpenApi3/swagger-initializer.js): `lib/swagdoc/Deploy/OpenApi3/swagger-initializer.js`

### Bundled dependencies

- [UDR factories](https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin32/firebird/include/firebird/UdrCppEngine.h): `unittests/general/TestClient/bin32/firebird/include/firebird/UdrCppEngine.h`
- [Message metadata](https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin32/firebird/include/firebird/Message.h): `unittests/general/TestClient/bin32/firebird/include/firebird/Message.h`
- [Firebird API](https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin32/firebird/include/ibase.h): `unittests/general/TestClient/bin32/firebird/include/ibase.h`
- [Firebird interfaces](https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin32/firebird/include/firebird/Interface.h): `unittests/general/TestClient/bin32/firebird/include/firebird/Interface.h`
- [UDR factories 64-bit](https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin64/firebird/include/firebird/UdrCppEngine.h): `unittests/general/TestClient/bin64/firebird/include/firebird/UdrCppEngine.h`
- [Message metadata 64-bit](https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin64/firebird/include/firebird/Message.h): `unittests/general/TestClient/bin64/firebird/include/firebird/Message.h`
- [Firebird API 64-bit](https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin64/firebird/include/ibase.h): `unittests/general/TestClient/bin64/firebird/include/ibase.h`
- [Interfaces 64-bit](https://github.com/danieleteti/delphimvcframework/blob/master/unittests/general/TestClient/bin64/firebird/include/firebird/Interface.h): `unittests/general/TestClient/bin64/firebird/include/firebird/Interface.h`

### Other components

- **API client**
- **Database**

## Connections

- API client → MVC routing: sends request (evidence: `README.md`)
- MVC routing → Controller action: routes to (evidence: `README.md`)
- Controller action → Middleware: uses processing
- Middleware → Authentication: can apply (evidence: `README.md`)
- Controller action → JSON serialization: returns data
- Controller action → ActiveRecord ORM: can access
- ActiveRecord ORM → RQL queries: supports querying (evidence: `README.md`)
- ActiveRecord ORM → Database: accesses (evidence: `README.md`)
- API client → Realtime APIs: uses realtime (evidence: `README.md`)
- API client → Server views: requests views (evidence: `README.md`)
- Swagger UI → Swagger 2 UI: variant
- Swagger UI → OpenAPI 3 setup: variant
- UDR factories → Message metadata: uses metadata (evidence: `unittests/general/TestClient/bin32/firebird/include/firebird/UdrCppEngine.h`)
- Message metadata → Firebird interfaces: uses interfaces (evidence: `unittests/general/TestClient/bin32/firebird/include/firebird/Message.h`)
- Message metadata → Firebird API: uses definitions (evidence: `unittests/general/TestClient/bin32/firebird/include/firebird/Message.h`)
- UDR factories 64-bit → Message metadata 64-bit: uses metadata (evidence: `unittests/general/TestClient/bin64/firebird/include/firebird/UdrCppEngine.h`)
- Message metadata 64-bit → Interfaces 64-bit: uses interfaces (evidence: `unittests/general/TestClient/bin64/firebird/include/firebird/Message.h`)
- Message metadata 64-bit → Firebird API 64-bit: uses definitions
