# yusufkarakehya/icodebetter architecture

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

- Interactive diagram: https://gitdiagram.com/yusufkarakehya/icodebetter
- Repository: https://github.com/yusufkarakehya/icodebetter

## Overview

iCodeBetter is an open-source low-code platform for building business applications. Its principal workflow is a user request entering the Spring application, resolving configured metadata, executing a query or form action against PostgreSQL, and returning a UI-oriented result through a client adapter. The broader runtime also includes workflow, scripting, REST, import/export, and version-control capabilities. Several links below are dashed because the supplied excerpts and source index identify dependencies but do not show the call sites; unsampled implementation details are not inferred as confirmed calls.

Main entry points: [`src/main/java/iwb/service/FrameworkService.java`](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/service/FrameworkService.java) (Framework service), [`src/main/java/iwb/engine/QueryEngine.java`](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/engine/QueryEngine.java) (Query engine), [`src/main/java/iwb/controller`](https://github.com/yusufkarakehya/icodebetter/tree/master/src/main/java/iwb/controller) (HTTP controllers), [`src/main/java/iwb/engine/CRUDEngine.java`](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/engine/CRUDEngine.java) (CRUD engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Request and UI"]
  node_controllers["HTTP controllers"]
  node_appservice["Framework service"]
  node_uiadapter["UI adapters"]
end

subgraph group_domain["Application runtime"]
  node_appmodels["Forms and tables"]
  node_results["Action results"]
  node_crud["CRUD engine<br/>[CRUDEngine.java]"]
  node_query["Query engine<br/>[QueryEngine.java]"]
  node_workflow["Workflow engine"]
  node_auth["Access control"]
  node_userutil["User utilities<br/>[UserUtil.java]"]
end

subgraph group_metadata["Metadata and persistence"]
  node_metadata["Metadata loader"]
  node_cache[("Metadata cache")]
  node_postgres["PostgreSQL DAO<br/>[PostgreSQL.java]"]
  node_dbutil["Database utilities<br/>[DBUtil.java]"]
  node_genericutil["Common utilities<br/>[GenericUtil.java]"]
end

subgraph group_extensions["Platform capabilities"]
  node_globalfunc["Global scripting"]
  node_rest["REST engine<br/>[RESTEngine.java]"]
  node_conversion["Conversion engine"]
  node_notification["Notifications"]
  node_imports["Import service<br/>[ImportService.java]"]
  node_vcs["Version control<br/>[VcsService.java]"]
end

node_user(("Application user"))
node_database[("PostgreSQL database")]

node_user -->|"submits requests"| node_controllers
node_controllers -.->|"dispatches"| node_appservice
node_controllers -.->|"renders through"| node_uiadapter
node_appservice -.->|"loads metadata"| node_metadata
node_appservice -.->|"delegates CRUD"| node_crud
node_appservice -.->|"delegates queries"| node_query
node_appservice -.->|"delegates workflow"| node_workflow
node_appservice -.->|"runs scripts"| node_globalfunc
node_appservice -.->|"invokes REST"| node_rest
node_appservice -.->|"converts data"| node_conversion
node_appservice -.->|"sends notifications"| node_notification
node_appservice -.->|"supports versioning"| node_vcs
node_appservice -.->|"imports records"| node_imports
node_metadata -.->|"populates cache"| node_cache
node_crud -.->|"persists changes"| node_postgres
node_query -.->|"queries data"| node_postgres
node_postgres -.->|"reads and writes"| node_database
node_query -->|"calls REST"| node_rest
node_query -->|"executes scripts"| node_globalfunc
node_appservice -.->|"returns results"| node_results
node_uiadapter -.->|"presents output"| node_user
node_query -.->|"uses query metadata"| node_appmodels
node_crud -.->|"uses form metadata"| node_appmodels
node_auth -.->|"checks access"| node_appservice

click node_controllers "https://github.com/yusufkarakehya/icodebetter/tree/master/src/main/java/iwb/controller"
click node_appservice "https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/service/FrameworkService.java"
click node_uiadapter "https://github.com/yusufkarakehya/icodebetter/tree/master/src/main/java/iwb/adapter/ui"
click node_appmodels "https://github.com/yusufkarakehya/icodebetter/tree/master/src/main/java/iwb/model/db"
click node_results "https://github.com/yusufkarakehya/icodebetter/tree/master/src/main/java/iwb/model/result"
click node_crud "https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/engine/CRUDEngine.java"
click node_query "https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/engine/QueryEngine.java"
click node_workflow "https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/engine/WorkflowEngine.java"
click node_auth "https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/engine/AccessControlEngine.java"
click node_metadata "https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/dao/metadata/MetadataLoader.java"
click node_cache "https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/cache/FrameworkCache.java"
click node_postgres "https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/dao/rdbms_impl/PostgreSQL.java"
click node_globalfunc "https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/engine/GlobalScriptEngine.java"
click node_rest "https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/engine/RESTEngine.java"
click node_conversion "https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/engine/ConversionEngine.java"
click node_notification "https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/engine/NotificationEngine.java"
click node_imports "https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/service/ImportService.java"
click node_vcs "https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/service/VcsService.java"
click node_dbutil "https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/util/DBUtil.java"
click node_genericutil "https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/util/GenericUtil.java"
click node_userutil "https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/util/UserUtil.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_controllers,node_appservice,node_uiadapter,node_user toneBlue
class node_appmodels,node_results,node_crud,node_query,node_workflow,node_auth,node_userutil,node_database toneAmber
class node_metadata,node_cache,node_postgres,node_dbutil,node_genericutil toneMint
class node_globalfunc,node_rest,node_conversion,node_notification,node_imports,node_vcs toneRose
```

## Components

### Request and UI

- [HTTP controllers](https://github.com/yusufkarakehya/icodebetter/tree/master/src/main/java/iwb/controller): `src/main/java/iwb/controller`
- [Framework service](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/service/FrameworkService.java): `src/main/java/iwb/service/FrameworkService.java`
- [UI adapters](https://github.com/yusufkarakehya/icodebetter/tree/master/src/main/java/iwb/adapter/ui): `src/main/java/iwb/adapter/ui`

### Application runtime

- [Forms and tables](https://github.com/yusufkarakehya/icodebetter/tree/master/src/main/java/iwb/model/db): `src/main/java/iwb/model/db`
- [Action results](https://github.com/yusufkarakehya/icodebetter/tree/master/src/main/java/iwb/model/result): `src/main/java/iwb/model/result`
- [CRUD engine](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/engine/CRUDEngine.java): `src/main/java/iwb/engine/CRUDEngine.java`
- [Query engine](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/engine/QueryEngine.java): `src/main/java/iwb/engine/QueryEngine.java`
- [Workflow engine](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/engine/WorkflowEngine.java): `src/main/java/iwb/engine/WorkflowEngine.java`
- [Access control](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/engine/AccessControlEngine.java): `src/main/java/iwb/engine/AccessControlEngine.java`
- [User utilities](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/util/UserUtil.java): `src/main/java/iwb/util/UserUtil.java`

### Metadata and persistence

- [Metadata loader](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/dao/metadata/MetadataLoader.java): `src/main/java/iwb/dao/metadata/MetadataLoader.java`
- [Metadata cache](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/cache/FrameworkCache.java): `src/main/java/iwb/cache/FrameworkCache.java`
- [PostgreSQL DAO](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/dao/rdbms_impl/PostgreSQL.java): `src/main/java/iwb/dao/rdbms_impl/PostgreSQL.java`
- [Database utilities](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/util/DBUtil.java): `src/main/java/iwb/util/DBUtil.java`
- [Common utilities](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/util/GenericUtil.java): `src/main/java/iwb/util/GenericUtil.java`

### Platform capabilities

- [Global scripting](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/engine/GlobalScriptEngine.java): `src/main/java/iwb/engine/GlobalScriptEngine.java`
- [REST engine](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/engine/RESTEngine.java): `src/main/java/iwb/engine/RESTEngine.java`
- [Conversion engine](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/engine/ConversionEngine.java): `src/main/java/iwb/engine/ConversionEngine.java`
- [Notifications](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/engine/NotificationEngine.java): `src/main/java/iwb/engine/NotificationEngine.java`
- [Import service](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/service/ImportService.java): `src/main/java/iwb/service/ImportService.java`
- [Version control](https://github.com/yusufkarakehya/icodebetter/blob/master/src/main/java/iwb/service/VcsService.java): `src/main/java/iwb/service/VcsService.java`

### Other components

- **Application user**
- **PostgreSQL database**

## Connections

- Application user → HTTP controllers: submits requests
- HTTP controllers → Framework service: dispatches (evidence: `src/main/java/iwb/controller/PreviewController.java`)
- HTTP controllers → UI adapters: renders through (evidence: `src/main/java/iwb/controller/PreviewController.java`)
- Framework service → Metadata loader: loads metadata (evidence: `src/main/java/iwb/service/FrameworkService.java`)
- Framework service → CRUD engine: delegates CRUD (evidence: `src/main/java/iwb/service/FrameworkService.java`)
- Framework service → Query engine: delegates queries (evidence: `src/main/java/iwb/service/FrameworkService.java`)
- Framework service → Workflow engine: delegates workflow (evidence: `src/main/java/iwb/service/FrameworkService.java`)
- Framework service → Global scripting: runs scripts (evidence: `src/main/java/iwb/service/FrameworkService.java`)
- Framework service → REST engine: invokes REST (evidence: `src/main/java/iwb/service/FrameworkService.java`)
- Framework service → Conversion engine: converts data (evidence: `src/main/java/iwb/service/FrameworkService.java`)
- Framework service → Notifications: sends notifications (evidence: `src/main/java/iwb/service/FrameworkService.java`)
- Framework service → Version control: supports versioning
- Framework service → Import service: imports records
- Metadata loader → Metadata cache: populates cache
- CRUD engine → PostgreSQL DAO: persists changes (evidence: `src/main/java/iwb/engine/CRUDEngine.java`)
- Query engine → PostgreSQL DAO: queries data (evidence: `src/main/java/iwb/engine/QueryEngine.java`)
- PostgreSQL DAO → PostgreSQL database: reads and writes
- Query engine → REST engine: calls REST (evidence: `src/main/java/iwb/engine/QueryEngine.java`)
- Query engine → Global scripting: executes scripts (evidence: `src/main/java/iwb/engine/QueryEngine.java`)
- Framework service → Action results: returns results (evidence: `src/main/java/iwb/service/FrameworkService.java`)
- UI adapters → Application user: presents output
- Query engine → Forms and tables: uses query metadata (evidence: `src/main/java/iwb/engine/QueryEngine.java`)
- CRUD engine → Forms and tables: uses form metadata (evidence: `src/main/java/iwb/engine/CRUDEngine.java`)
- Access control → Framework service: checks access (evidence: `src/main/java/iwb/service/FrameworkService.java`)
