# perrelet/digitalis-framework architecture

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

- Interactive diagram: https://gitdiagram.com/perrelet/digitalis-framework
- Repository: https://github.com/perrelet/digitalis-framework

## Overview

LatticeWP is a structuring framework for WordPress plugins. A plugin extends App; its boot process loads project classes and selects shared, CLI, REST, admin, or front-end behavior. On the front end, request context resolves a page view and layout for rendering. Other major capabilities provide typed WordPress/WooCommerce entities, hook-based features and endpoints, query composition, editor integrations, admin tooling, and schema migrations. Relationships below follow explicit README statements and shown code; unsampled subsystems are included where documented, but their internal wiring is not inferred.

Main entry points: [`include/objects/app.abstract.php`](https://github.com/perrelet/digitalis-framework/blob/main/include/objects/app.abstract.php) (Plugin App), [`include/objects/request-resolver.singleton.php`](https://github.com/perrelet/digitalis-framework/blob/main/include/objects/request-resolver.singleton.php) (Request resolver), [`include/views/layout.view.php`](https://github.com/perrelet/digitalis-framework/blob/main/include/views/layout.view.php) (Layout), [`include/wordpress/wp-model.model.php`](https://github.com/perrelet/digitalis-framework/blob/main/include/wordpress/wp-model.model.php) (Entity models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lifecycle["Plugin lifecycle"]
  node_plugin["Plugin App<br/>[app.abstract.php]"]
  node_loader["Autoloader"]
end

subgraph group_domain["Entities and data"]
  node_model["Entity models<br/>[wp-model.model.php]"]
  node_post["Post model<br/>[post.model.php]"]
  node_posttype["Post types"]
  node_woo["WooCommerce models<br/>[order.abstract.php]"]
  node_acf["ACF fields"]
end

subgraph group_presentation["Views and editors"]
  node_resolver["Request resolver"]
  node_pageview["Page view<br/>[page-view.view.php]"]
  node_layout["Layout<br/>[layout.view.php]"]
  node_view["View system<br/>[view.abstract.php]"]
  node_editor["Editor integrations"]
end

subgraph group_behavior["Hooks and queries"]
  node_feature["Hook features"]
  node_route["REST routes<br/>[route.factory.php]"]
  node_shortcode["Shortcodes"]
  node_acfblock["ACF blocks"]
  node_queryvars["Query variables"]
  node_querymanager["Query manager"]
  node_queryprofile["Query profiles"]
  node_queryfilters["Query filters"]
  node_queryjs["Query browser module<br/>[query.js]"]
end

subgraph group_operations["Admin and persistence"]
  node_admin["Admin pages and tables"]
  node_iterator["Batch iterators"]
  node_schema["Schema and migrations"]
end

node_wordpress(("WordPress"))
node_request(("Request context"))
node_database[("WordPress database")]

node_wordpress -->|"loads plugin"| node_plugin
node_plugin -->|"loads classes"| node_loader
node_plugin -->|"registers boot hooks"| node_wordpress
node_request -.->|"provides context"| node_resolver
node_resolver -->|"resolves page"| node_pageview
node_resolver -->|"resolves layout"| node_layout
node_plugin -->|"renders app layout"| node_layout
node_layout -->|"renders body"| node_pageview
node_view -->|"renders markup"| node_wordpress
node_model -->|"wraps entities"| node_wordpress
node_post -->|"extends model"| node_model
node_posttype -->|"registers post types"| node_wordpress
node_woo -->|"extends post"| node_post
node_acf -.->|"exposes ACF fields"| node_wordpress
node_feature -->|"registers hooks"| node_wordpress
node_route -->|"registers REST route"| node_wordpress
node_shortcode -->|"registers shortcode"| node_wordpress
node_acfblock -->|"creates block"| node_wordpress
node_queryvars -.->|"builds query vars"| node_querymanager
node_querymanager -->|"applies profiles"| node_queryprofile
node_queryfilters -->|"boots module"| node_queryjs
node_queryjs -->|"sends AJAX query"| node_wordpress
node_editor -->|"generates editor elements"| node_view
node_admin -->|"provides admin UI"| node_wordpress
node_iterator -->|"batch processes entities"| node_wordpress
node_schema -->|"migrates tables"| node_database

click node_plugin "https://github.com/perrelet/digitalis-framework/blob/main/include/objects/app.abstract.php"
click node_loader "https://github.com/perrelet/digitalis-framework/blob/main/include/traits/autoloader.trait.php"
click node_model "https://github.com/perrelet/digitalis-framework/blob/main/include/wordpress/wp-model.model.php"
click node_post "https://github.com/perrelet/digitalis-framework/blob/main/include/wordpress/post.model.php"
click node_posttype "https://github.com/perrelet/digitalis-framework/blob/main/include/wordpress/post-type.abstract.php"
click node_woo "https://github.com/perrelet/digitalis-framework/blob/main/include/woocommerce/order.abstract.php"
click node_acf "https://github.com/perrelet/digitalis-framework/blob/main/include/acf/has-acf-fields.trait.php"
click node_resolver "https://github.com/perrelet/digitalis-framework/blob/main/include/objects/request-resolver.singleton.php"
click node_pageview "https://github.com/perrelet/digitalis-framework/blob/main/include/views/page-view.view.php"
click node_layout "https://github.com/perrelet/digitalis-framework/blob/main/include/views/layout.view.php"
click node_view "https://github.com/perrelet/digitalis-framework/blob/main/include/objects/view.abstract.php"
click node_editor "https://github.com/perrelet/digitalis-framework/blob/main/include/editors/editor-manager.singleton.php"
click node_feature "https://github.com/perrelet/digitalis-framework/blob/main/include/objects/feature.abstract.php"
click node_route "https://github.com/perrelet/digitalis-framework/blob/main/include/objects/route.factory.php"
click node_shortcode "https://github.com/perrelet/digitalis-framework/blob/main/include/objects/shortcode.abstract.php"
click node_acfblock "https://github.com/perrelet/digitalis-framework/blob/main/include/objects/acf-block.factory.php"
click node_queryvars "https://github.com/perrelet/digitalis-framework/blob/main/include/objects/query-vars.class.php"
click node_querymanager "https://github.com/perrelet/digitalis-framework/blob/main/include/objects/query-manager.singleton.php"
click node_queryprofile "https://github.com/perrelet/digitalis-framework/blob/main/include/objects/query-profile.factory.php"
click node_queryfilters "https://github.com/perrelet/digitalis-framework/blob/main/include/views/query-filters.view.php"
click node_queryjs "https://github.com/perrelet/digitalis-framework/blob/main/modules/query.js"
click node_admin "https://github.com/perrelet/digitalis-framework/blob/main/include/admin/admin-table.abstract.php"
click node_iterator "https://github.com/perrelet/digitalis-framework/blob/main/include/iterators/iterator.singleton.php"
click node_schema "https://github.com/perrelet/digitalis-framework/blob/main/include/db/schema.abstract.php"

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_plugin,node_loader toneBlue
class node_model,node_post,node_posttype,node_woo,node_acf,node_database toneAmber
class node_resolver,node_pageview,node_layout,node_view,node_editor,node_request toneMint
class node_feature,node_route,node_shortcode,node_acfblock,node_queryvars,node_querymanager,node_queryprofile,node_queryfilters,node_queryjs toneRose
class node_admin,node_iterator,node_schema,node_wordpress toneIndigo
```

## Components

### Plugin lifecycle

- [Plugin App](https://github.com/perrelet/digitalis-framework/blob/main/include/objects/app.abstract.php): `include/objects/app.abstract.php`
- [Autoloader](https://github.com/perrelet/digitalis-framework/blob/main/include/traits/autoloader.trait.php): `include/traits/autoloader.trait.php`

### Entities and data

- [Entity models](https://github.com/perrelet/digitalis-framework/blob/main/include/wordpress/wp-model.model.php): `include/wordpress/wp-model.model.php`
- [Post model](https://github.com/perrelet/digitalis-framework/blob/main/include/wordpress/post.model.php): `include/wordpress/post.model.php`
- [Post types](https://github.com/perrelet/digitalis-framework/blob/main/include/wordpress/post-type.abstract.php): `include/wordpress/post-type.abstract.php`
- [WooCommerce models](https://github.com/perrelet/digitalis-framework/blob/main/include/woocommerce/order.abstract.php): `include/woocommerce/order.abstract.php`
- [ACF fields](https://github.com/perrelet/digitalis-framework/blob/main/include/acf/has-acf-fields.trait.php): `include/acf/has-acf-fields.trait.php`

### Views and editors

- [Request resolver](https://github.com/perrelet/digitalis-framework/blob/main/include/objects/request-resolver.singleton.php): `include/objects/request-resolver.singleton.php`
- [Page view](https://github.com/perrelet/digitalis-framework/blob/main/include/views/page-view.view.php): `include/views/page-view.view.php`
- [Layout](https://github.com/perrelet/digitalis-framework/blob/main/include/views/layout.view.php): `include/views/layout.view.php`
- [View system](https://github.com/perrelet/digitalis-framework/blob/main/include/objects/view.abstract.php): `include/objects/view.abstract.php`
- [Editor integrations](https://github.com/perrelet/digitalis-framework/blob/main/include/editors/editor-manager.singleton.php): `include/editors/editor-manager.singleton.php`

### Hooks and queries

- [Hook features](https://github.com/perrelet/digitalis-framework/blob/main/include/objects/feature.abstract.php): `include/objects/feature.abstract.php`
- [REST routes](https://github.com/perrelet/digitalis-framework/blob/main/include/objects/route.factory.php): `include/objects/route.factory.php`
- [Shortcodes](https://github.com/perrelet/digitalis-framework/blob/main/include/objects/shortcode.abstract.php): `include/objects/shortcode.abstract.php`
- [ACF blocks](https://github.com/perrelet/digitalis-framework/blob/main/include/objects/acf-block.factory.php): `include/objects/acf-block.factory.php`
- [Query variables](https://github.com/perrelet/digitalis-framework/blob/main/include/objects/query-vars.class.php): `include/objects/query-vars.class.php`
- [Query manager](https://github.com/perrelet/digitalis-framework/blob/main/include/objects/query-manager.singleton.php): `include/objects/query-manager.singleton.php`
- [Query profiles](https://github.com/perrelet/digitalis-framework/blob/main/include/objects/query-profile.factory.php): `include/objects/query-profile.factory.php`
- [Query filters](https://github.com/perrelet/digitalis-framework/blob/main/include/views/query-filters.view.php): `include/views/query-filters.view.php`
- [Query browser module](https://github.com/perrelet/digitalis-framework/blob/main/modules/query.js): `modules/query.js`

### Admin and persistence

- [Admin pages and tables](https://github.com/perrelet/digitalis-framework/blob/main/include/admin/admin-table.abstract.php): `include/admin/admin-table.abstract.php`
- [Batch iterators](https://github.com/perrelet/digitalis-framework/blob/main/include/iterators/iterator.singleton.php): `include/iterators/iterator.singleton.php`
- [Schema and migrations](https://github.com/perrelet/digitalis-framework/blob/main/include/db/schema.abstract.php): `include/db/schema.abstract.php`

### Other components

- **WordPress**
- **Request context**
- **WordPress database**

## Connections

- WordPress → Plugin App: loads plugin (evidence: `README.md`)
- Plugin App → Autoloader: loads classes (evidence: `include/objects/app.abstract.php`)
- Plugin App → WordPress: registers boot hooks (evidence: `include/objects/app.abstract.php`)
- Request context → Request resolver: provides context (evidence: `README.md`)
- Request resolver → Page view: resolves page
- Request resolver → Layout: resolves layout
- Plugin App → Layout: renders app layout (evidence: `include/objects/app.abstract.php`)
- Layout → Page view: renders body
- View system → WordPress: renders markup (evidence: `README.md`)
- Entity models → WordPress: wraps entities (evidence: `README.md`)
- Post model → Entity models: extends model (evidence: `README.md`)
- Post types → WordPress: registers post types (evidence: `README.md`)
- WooCommerce models → Post model: extends post (evidence: `README.md`)
- ACF fields → WordPress: exposes ACF fields (evidence: `README.md`)
- Hook features → WordPress: registers hooks (evidence: `README.md`)
- REST routes → WordPress: registers REST route (evidence: `README.md`)
- Shortcodes → WordPress: registers shortcode (evidence: `README.md`)
- ACF blocks → WordPress: creates block (evidence: `README.md`)
- Query variables → Query manager: builds query vars
- Query manager → Query profiles: applies profiles (evidence: `include/objects/query-manager.singleton.php`)
- Query filters → Query browser module: boots module (evidence: `include/views/query-filters.view.php`)
- Query browser module → WordPress: sends AJAX query (evidence: `modules/query.js`)
- Editor integrations → View system: generates editor elements (evidence: `include/editors/editor-manager.singleton.php`)
- Admin pages and tables → WordPress: provides admin UI (evidence: `README.md`)
- Batch iterators → WordPress: batch processes entities (evidence: `README.md`)
- Schema and migrations → WordPress database: migrates tables (evidence: `README.md`)
