# juliepatrize-sudo/cloud architecture

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

- Interactive diagram: https://gitdiagram.com/juliepatrize-sudo/cloud
- Repository: https://github.com/juliepatrize-sudo/cloud

## Overview

WordPress is a semantic publishing platform: site administrators install and sign in, then manage publishing and site features through the administration area; visitors consume the resulting site. The tree also contains a PHP AI client for text, image, speech, and video generation, exposed through a WordPress prompt-builder wrapper. The README explicitly documents installation, importing, and updating. Many WordPress routes and subsystems are represented by the tree but were not sampled, so their internal calls are not asserted here.

Main entry points: [`wp-includes/php-ai-client/src/Builders/PromptBuilder.php`](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/php-ai-client/src/Builders/PromptBuilder.php) (Prompt builder), [`wp-admin`](https://github.com/juliepatrize-sudo/cloud/tree/main/wp-admin) (Admin routes), [`index.php`](https://github.com/juliepatrize-sudo/cloud/blob/main/index.php) (Site entry), [`wp-admin/install.php`](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-admin/install.php) (Site installer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["WordPress site"]
  node_database[("Site database")]
  node_site_front["Site entry<br/>[index.php]"]
  node_rest_posts["Posts REST API"]
  node_rest_media["Attachments REST API"]
  node_query["Content queries<br/>[class-wp-query.php]"]
  node_themes["Block themes"]
end

subgraph group_admin["Administration"]
  node_installer["Site installer<br/>[install.php]"]
  node_login["Login<br/>[wp-login.php]"]
  node_admin_routes["Admin routes"]
  node_posts["Post management<br/>[edit.php]"]
  node_media["Media management<br/>[media.php]"]
  node_site_customization["Site customization"]
  node_network_admin["Network admin"]
  node_importer["Import tools<br/>[import.php]"]
  node_updater["Automatic updater<br/>[update-core.php]"]
end

subgraph group_ai["AI generation"]
  node_wp_ai["WP AI wrapper"]
end

subgraph group_sdk["AI client internals"]
  node_sdk_client["AI client API<br/>[AiClient.php]"]
  node_prompt_builder["Prompt builder<br/>[PromptBuilder.php]"]
  node_provider_registry["Provider registry"]
  node_model_config["Model configuration<br/>[ModelConfig.php]"]
  node_model_interface["Model interface<br/>[ModelInterface.php]"]
  node_ai_result["Generation result"]
end

node_admin_actor(("Administrator"))
node_visitor(("Site visitor"))

node_admin_actor -->|"opens install"| node_installer
node_installer -->|"creates tables"| node_database
node_installer -->|"sends to"| node_login
node_admin_actor -->|"signs in"| node_login
node_admin_actor -->|"imports content"| node_importer
node_admin_actor -->|"starts update"| node_updater
node_visitor -.->|"requests site"| node_site_front
node_site_front -.->|"queries content"| node_query
node_query -.->|"reads content"| node_database
node_site_front -.->|"renders theme"| node_themes
node_admin_actor -.->|"manages site"| node_admin_routes
node_admin_routes -.->|"routes publishing"| node_posts
node_admin_routes -.->|"routes media"| node_media
node_admin_routes -.->|"configures site"| node_site_customization
node_admin_routes -.->|"routes network"| node_network_admin
node_rest_posts -.->|"accesses content"| node_database
node_rest_media -.->|"accesses media"| node_database
node_wp_ai -->|"constructs builder"| node_prompt_builder
node_wp_ai -->|"accepts registry"| node_provider_registry
node_admin_actor -.->|"requests generation"| node_wp_ai
node_sdk_client -->|"delegates generation"| node_prompt_builder
node_sdk_client -->|"creates default"| node_provider_registry
node_prompt_builder -->|"selects provider"| node_provider_registry
node_prompt_builder -->|"sets options"| node_model_config
node_prompt_builder -->|"executes model"| node_model_interface
node_prompt_builder -->|"returns result"| node_ai_result

click node_installer "https://github.com/juliepatrize-sudo/cloud/blob/main/wp-admin/install.php"
click node_login "https://github.com/juliepatrize-sudo/cloud/blob/main/wp-login.php"
click node_admin_routes "https://github.com/juliepatrize-sudo/cloud/tree/main/wp-admin"
click node_posts "https://github.com/juliepatrize-sudo/cloud/blob/main/wp-admin/edit.php"
click node_media "https://github.com/juliepatrize-sudo/cloud/blob/main/wp-admin/media.php"
click node_site_customization "https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/class-wp-customize-manager.php"
click node_network_admin "https://github.com/juliepatrize-sudo/cloud/tree/main/wp-admin/network"
click node_importer "https://github.com/juliepatrize-sudo/cloud/blob/main/wp-admin/import.php"
click node_updater "https://github.com/juliepatrize-sudo/cloud/blob/main/wp-admin/update-core.php"
click node_site_front "https://github.com/juliepatrize-sudo/cloud/blob/main/index.php"
click node_rest_posts "https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php"
click node_rest_media "https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php"
click node_query "https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/class-wp-query.php"
click node_themes "https://github.com/juliepatrize-sudo/cloud/blob/main/wp-content/themes/twentytwentyfive/patterns/template-query-loop.php"
click node_wp_ai "https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/ai-client/class-wp-ai-client-prompt-builder.php"
click node_sdk_client "https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/php-ai-client/src/AiClient.php"
click node_prompt_builder "https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/php-ai-client/src/Builders/PromptBuilder.php"
click node_provider_registry "https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/php-ai-client/src/Providers/ProviderRegistry.php"
click node_model_config "https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/php-ai-client/src/Providers/Models/DTO/ModelConfig.php"
click node_model_interface "https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/php-ai-client/src/Providers/Models/Contracts/ModelInterface.php"
click node_ai_result "https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/php-ai-client/src/Results/DTO/GenerativeAiResult.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_database,node_site_front,node_rest_posts,node_rest_media,node_query,node_themes toneBlue
class node_installer,node_login,node_admin_routes,node_posts,node_media,node_site_customization,node_network_admin,node_importer,node_updater toneAmber
class node_wp_ai toneMint
class node_sdk_client,node_prompt_builder,node_provider_registry,node_model_config,node_model_interface,node_ai_result toneRose
class node_admin_actor,node_visitor toneIndigo
```

## Components

### WordPress site

- **Site database**
- [Site entry](https://github.com/juliepatrize-sudo/cloud/blob/main/index.php): `index.php`
- [Posts REST API](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php): `wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php`
- [Attachments REST API](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php): `wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php`
- [Content queries](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/class-wp-query.php): `wp-includes/class-wp-query.php`
- [Block themes](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-content/themes/twentytwentyfive/patterns/template-query-loop.php): `wp-content/themes/twentytwentyfive/patterns/template-query-loop.php`

### Administration

- [Site installer](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-admin/install.php): `wp-admin/install.php`
- [Login](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-login.php): `wp-login.php`
- [Admin routes](https://github.com/juliepatrize-sudo/cloud/tree/main/wp-admin): `wp-admin`
- [Post management](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-admin/edit.php): `wp-admin/edit.php`
- [Media management](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-admin/media.php): `wp-admin/media.php`
- [Site customization](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/class-wp-customize-manager.php): `wp-includes/class-wp-customize-manager.php`
- [Network admin](https://github.com/juliepatrize-sudo/cloud/tree/main/wp-admin/network): `wp-admin/network`
- [Import tools](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-admin/import.php): `wp-admin/import.php`
- [Automatic updater](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-admin/update-core.php): `wp-admin/update-core.php`

### AI generation

- [WP AI wrapper](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/ai-client/class-wp-ai-client-prompt-builder.php): `wp-includes/ai-client/class-wp-ai-client-prompt-builder.php`

### AI client internals

- [AI client API](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/php-ai-client/src/AiClient.php): `wp-includes/php-ai-client/src/AiClient.php`
- [Prompt builder](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/php-ai-client/src/Builders/PromptBuilder.php): `wp-includes/php-ai-client/src/Builders/PromptBuilder.php`
- [Provider registry](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/php-ai-client/src/Providers/ProviderRegistry.php): `wp-includes/php-ai-client/src/Providers/ProviderRegistry.php`
- [Model configuration](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/php-ai-client/src/Providers/Models/DTO/ModelConfig.php): `wp-includes/php-ai-client/src/Providers/Models/DTO/ModelConfig.php`
- [Model interface](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/php-ai-client/src/Providers/Models/Contracts/ModelInterface.php): `wp-includes/php-ai-client/src/Providers/Models/Contracts/ModelInterface.php`
- [Generation result](https://github.com/juliepatrize-sudo/cloud/blob/main/wp-includes/php-ai-client/src/Results/DTO/GenerativeAiResult.php): `wp-includes/php-ai-client/src/Results/DTO/GenerativeAiResult.php`

### Other components

- **Administrator**
- **Site visitor**

## Connections

- Administrator → Site installer: opens install
- Site installer → Site database: creates tables
- Site installer → Login: sends to
- Administrator → Login: signs in
- Administrator → Import tools: imports content
- Administrator → Automatic updater: starts update
- Site visitor → Site entry: requests site
- Site entry → Content queries: queries content
- Content queries → Site database: reads content
- Site entry → Block themes: renders theme
- Administrator → Admin routes: manages site
- Admin routes → Post management: routes publishing
- Admin routes → Media management: routes media
- Admin routes → Site customization: configures site
- Admin routes → Network admin: routes network (evidence: `wp-admin/network/index.php`)
- Posts REST API → Site database: accesses content
- Attachments REST API → Site database: accesses media
- WP AI wrapper → Prompt builder: constructs builder (evidence: `wp-includes/ai-client/class-wp-ai-client-prompt-builder.php`)
- WP AI wrapper → Provider registry: accepts registry (evidence: `wp-includes/ai-client/class-wp-ai-client-prompt-builder.php`)
- Administrator → WP AI wrapper: requests generation
- AI client API → Prompt builder: delegates generation (evidence: `wp-includes/php-ai-client/src/AiClient.php`)
- AI client API → Provider registry: creates default (evidence: `wp-includes/php-ai-client/src/AiClient.php`)
- Prompt builder → Provider registry: selects provider (evidence: `wp-includes/php-ai-client/src/Builders/PromptBuilder.php`)
- Prompt builder → Model configuration: sets options (evidence: `wp-includes/php-ai-client/src/Builders/PromptBuilder.php`)
- Prompt builder → Model interface: executes model (evidence: `wp-includes/php-ai-client/src/Builders/PromptBuilder.php`)
- Prompt builder → Generation result: returns result (evidence: `wp-includes/php-ai-client/src/Builders/PromptBuilder.php`)
