# izab2500/wp-bucketlist architecture

> Architecture diagram of the GitHub repository izab2500/wp-bucketlist, 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/izab2500/wp-bucketlist
- Repository: https://github.com/izab2500/wp-bucketlist

## Overview

This is a PHP/MySQL personal bucket-list website. The main user workflow is to open the bucket-list page, submit validated create/update/delete requests, have the controller and service coordinate collection and repository operations, and persist or retrieve items through MySQL. The site also has Home, About, and AI & Development content pages. Edges follow shown construction, calls, and documented page capabilities; some page rendering and database configuration details were not sampled, so those connections are omitted.

Main entry points: [`bucketlist.php`](https://github.com/izab2500/wp-bucketlist/blob/main/bucketlist.php) (Bucket-list page), [`classes/BucketListService.php`](https://github.com/izab2500/wp-bucketlist/blob/main/classes/BucketListService.php) (Bucket-list service), [`index.php`](https://github.com/izab2500/wp-bucketlist/blob/main/index.php) (Home page), [`classes/BucketListController.php`](https://github.com/izab2500/wp-bucketlist/blob/main/classes/BucketListController.php) (Request controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pages["Website pages"]
  node_home["Home page<br/>[index.php]"]
  node_about["About page<br/>[about.php]"]
  node_ai["AI development page<br/>[ai.php]"]
  node_bucket_page["Bucket-list page<br/>[bucketlist.php]"]
end

subgraph group_shared["Shared presentation"]
  node_header["Navigation header<br/>[header.php]"]
  node_footer["Shared footer<br/>[footer.php]"]
end

subgraph group_workflow["Bucket-list workflow"]
  node_controller["Request controller"]
  node_service["Bucket-list service"]
  node_collection["Item collection<br/>[BucketList.php]"]
  node_item["Bucket-list item<br/>[BucketItem.php]"]
end

subgraph group_persistence["Persistence"]
  node_repository["SQL repository"]
  node_database["MySQL connection<br/>[Database.php]"]
  node_mysql[("MySQL bucket data<br/>[bucketlist.sql]")]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_home
node_visitor -->|"manages items"| node_bucket_page
node_home -->|"links to"| node_bucket_page
node_home -->|"includes"| node_header
node_home -->|"includes"| node_footer
node_about -->|"includes"| node_header
node_about -->|"includes"| node_footer
node_ai -->|"includes"| node_header
node_ai -->|"includes"| node_footer
node_bucket_page -->|"includes"| node_header
node_bucket_page -->|"includes"| node_footer
node_bucket_page -->|"creates"| node_database
node_bucket_page -->|"constructs"| node_repository
node_bucket_page -->|"constructs"| node_collection
node_bucket_page -->|"constructs"| node_service
node_bucket_page -->|"dispatches requests"| node_controller
node_controller -->|"calls"| node_service
node_controller -->|"creates and updates"| node_item
node_controller -->|"looks up items"| node_collection
node_service -->|"loads and mutates"| node_repository
node_service -->|"updates collection"| node_collection
node_service -->|"handles items"| node_item
node_repository -->|"hydrates and saves"| node_item
node_repository -->|"queries"| node_mysql
node_database -->|"connects to"| node_mysql

click node_home "https://github.com/izab2500/wp-bucketlist/blob/main/index.php"
click node_about "https://github.com/izab2500/wp-bucketlist/blob/main/about.php"
click node_ai "https://github.com/izab2500/wp-bucketlist/blob/main/ai.php"
click node_bucket_page "https://github.com/izab2500/wp-bucketlist/blob/main/bucketlist.php"
click node_header "https://github.com/izab2500/wp-bucketlist/blob/main/includes/header.php"
click node_footer "https://github.com/izab2500/wp-bucketlist/blob/main/includes/footer.php"
click node_controller "https://github.com/izab2500/wp-bucketlist/blob/main/classes/BucketListController.php"
click node_service "https://github.com/izab2500/wp-bucketlist/blob/main/classes/BucketListService.php"
click node_collection "https://github.com/izab2500/wp-bucketlist/blob/main/classes/BucketList.php"
click node_item "https://github.com/izab2500/wp-bucketlist/blob/main/classes/BucketItem.php"
click node_repository "https://github.com/izab2500/wp-bucketlist/blob/main/classes/BucketListRepository.php"
click node_database "https://github.com/izab2500/wp-bucketlist/blob/main/classes/Database.php"
click node_mysql "https://github.com/izab2500/wp-bucketlist/blob/main/database/bucketlist.sql"

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_home,node_about,node_ai,node_bucket_page toneBlue
class node_header,node_footer toneAmber
class node_controller,node_service,node_collection,node_item toneMint
class node_repository,node_database,node_mysql toneRose
class node_visitor toneIndigo
```

## Components

### Website pages

- [Home page](https://github.com/izab2500/wp-bucketlist/blob/main/index.php): `index.php`
- [About page](https://github.com/izab2500/wp-bucketlist/blob/main/about.php): `about.php`
- [AI development page](https://github.com/izab2500/wp-bucketlist/blob/main/ai.php): `ai.php`
- [Bucket-list page](https://github.com/izab2500/wp-bucketlist/blob/main/bucketlist.php): `bucketlist.php`

### Shared presentation

- [Navigation header](https://github.com/izab2500/wp-bucketlist/blob/main/includes/header.php): `includes/header.php`
- [Shared footer](https://github.com/izab2500/wp-bucketlist/blob/main/includes/footer.php): `includes/footer.php`

### Bucket-list workflow

- [Request controller](https://github.com/izab2500/wp-bucketlist/blob/main/classes/BucketListController.php): `classes/BucketListController.php`
- [Bucket-list service](https://github.com/izab2500/wp-bucketlist/blob/main/classes/BucketListService.php): `classes/BucketListService.php`
- [Item collection](https://github.com/izab2500/wp-bucketlist/blob/main/classes/BucketList.php): `classes/BucketList.php`
- [Bucket-list item](https://github.com/izab2500/wp-bucketlist/blob/main/classes/BucketItem.php): `classes/BucketItem.php`

### Persistence

- [SQL repository](https://github.com/izab2500/wp-bucketlist/blob/main/classes/BucketListRepository.php): `classes/BucketListRepository.php`
- [MySQL connection](https://github.com/izab2500/wp-bucketlist/blob/main/classes/Database.php): `classes/Database.php`
- [MySQL bucket data](https://github.com/izab2500/wp-bucketlist/blob/main/database/bucketlist.sql): `database/bucketlist.sql`

### Other components

- **Visitor**

## Connections

- Visitor → Home page: opens
- Visitor → Bucket-list page: manages items (evidence: `README.md`)
- Home page → Bucket-list page: links to (evidence: `index.php`)
- Home page → Navigation header: includes (evidence: `index.php`)
- Home page → Shared footer: includes (evidence: `index.php`)
- About page → Navigation header: includes (evidence: `about.php`)
- About page → Shared footer: includes (evidence: `about.php`)
- AI development page → Navigation header: includes (evidence: `ai.php`)
- AI development page → Shared footer: includes (evidence: `ai.php`)
- Bucket-list page → Navigation header: includes (evidence: `bucketlist.php`)
- Bucket-list page → Shared footer: includes (evidence: `bucketlist.php`)
- Bucket-list page → MySQL connection: creates (evidence: `bucketlist.php`)
- Bucket-list page → SQL repository: constructs (evidence: `bucketlist.php`)
- Bucket-list page → Item collection: constructs (evidence: `bucketlist.php`)
- Bucket-list page → Bucket-list service: constructs (evidence: `bucketlist.php`)
- Bucket-list page → Request controller: dispatches requests (evidence: `bucketlist.php`)
- Request controller → Bucket-list service: calls (evidence: `classes/BucketListController.php`)
- Request controller → Bucket-list item: creates and updates (evidence: `classes/BucketListController.php`)
- Request controller → Item collection: looks up items (evidence: `classes/BucketListController.php`)
- Bucket-list service → SQL repository: loads and mutates (evidence: `classes/BucketListService.php`)
- Bucket-list service → Item collection: updates collection (evidence: `classes/BucketListService.php`)
- Bucket-list service → Bucket-list item: handles items (evidence: `classes/BucketListService.php`)
- SQL repository → Bucket-list item: hydrates and saves (evidence: `classes/BucketListRepository.php`)
- SQL repository → MySQL bucket data: queries (evidence: `classes/BucketListRepository.php`)
- MySQL connection → MySQL bucket data: connects to (evidence: `classes/Database.php`)
