# limegreentangerine/eventbritekit architecture

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

- Interactive diagram: https://gitdiagram.com/limegreentangerine/eventbritekit
- Repository: https://github.com/limegreentangerine/eventbritekit

## Overview

This Concrete CMS Eventbrite package imports live events into its local event store and exposes them through dashboard search and a public listing block. The main workflow is a dashboard task queuing an import command; its handler fetches events, maps them to entities, persists them and removes expired records. The API client also supports account and organization lookups, while dashboard and search components provide management and discovery. Some dashboard wiring is only identified by the source index, so uncertain framework dispatch is marked unverified or omitted.

Main entry points: [`src/Command/GetEventsCommandHandler.php`](https://github.com/limegreentangerine/eventbritekit/blob/main/src/Command/GetEventsCommandHandler.php) (Import handler), [`src/Api/Eventbrite.php`](https://github.com/limegreentangerine/eventbritekit/blob/main/src/Api/Eventbrite.php) (Eventbrite API client), [`src/Search/ItemList/Event.php`](https://github.com/limegreentangerine/eventbritekit/blob/main/src/Search/ItemList/Event.php) (Event search list), [`controllers/search/events.php`](https://github.com/limegreentangerine/eventbritekit/blob/main/controllers/search/events.php) (Search controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_import["Event Import"]
  node_task["Import task"]
  node_command["Import command"]
  node_handler["Import handler"]
  node_api["Eventbrite API client<br/>[Eventbrite.php]"]
  node_logger["Event logger"]
end

subgraph group_data["Event Data"]
  node_event["Event entity<br/>[Event.php]"]
  node_store[("Event table")]
end

subgraph group_admin["Dashboard"]
  node_dashboard["Dashboard events<br/>[events.php]"]
  node_settings["Dashboard settings<br/>[settings.php]"]
  node_details["Event details view<br/>[details.php]"]
end

subgraph group_discovery["Event Discovery"]
  node_search_controller["Search controller<br/>[events.php]"]
  node_search_list["Event search list<br/>[Event.php]"]
  node_column_set["Search columns<br/>[Event.php]"]
  node_search_result["Search results<br/>[Event.php]"]
  node_result_item["Result item<br/>[Event.php]"]
  node_list_block["Event listing block<br/>[controller.php]"]
end

node_operator(("CMS operator"))
node_eventbrite{{"Eventbrite service"}}

node_operator -->|"runs"| node_task
node_task -->|"queues"| node_command
node_command -.->|"handled by"| node_handler
node_handler -->|"fetches events"| node_api
node_api -->|"requests events"| node_eventbrite
node_handler -->|"maps and upserts"| node_event
node_handler -->|"persists and prunes"| node_store
node_event -->|"maps to table"| node_store
node_handler -->|"logs import"| node_logger
node_dashboard -.->|"uses client"| node_api
node_dashboard -.->|"uses logger"| node_logger
node_settings -.->|"uses client"| node_api
node_details -.->|"uses client"| node_api
node_search_controller -->|"creates and filters"| node_search_list
node_search_controller -->|"configures columns"| node_column_set
node_search_controller -->|"builds results"| node_search_result
node_search_result -->|"wraps items"| node_result_item
node_search_list -->|"queries"| node_store
node_search_list -->|"loads entities"| node_event
node_list_block -->|"filters active events"| node_search_list

click node_task "https://github.com/limegreentangerine/eventbritekit/blob/main/src/Command/Task/Controller/GetEventsController.php"
click node_command "https://github.com/limegreentangerine/eventbritekit/blob/main/src/Command/GetEventsCommand.php"
click node_handler "https://github.com/limegreentangerine/eventbritekit/blob/main/src/Command/GetEventsCommandHandler.php"
click node_api "https://github.com/limegreentangerine/eventbritekit/blob/main/src/Api/Eventbrite.php"
click node_logger "https://github.com/limegreentangerine/eventbritekit/blob/main/src/Log/EventbriteLogger.php"
click node_event "https://github.com/limegreentangerine/eventbritekit/blob/main/src/Entity/Event.php"
click node_dashboard "https://github.com/limegreentangerine/eventbritekit/blob/main/controllers/single_page/dashboard/eventbrite/events.php"
click node_settings "https://github.com/limegreentangerine/eventbritekit/blob/main/controllers/single_page/dashboard/eventbrite/settings.php"
click node_details "https://github.com/limegreentangerine/eventbritekit/blob/main/elements/dashboard/events/details.php"
click node_search_controller "https://github.com/limegreentangerine/eventbritekit/blob/main/controllers/search/events.php"
click node_search_list "https://github.com/limegreentangerine/eventbritekit/blob/main/src/Search/ItemList/Event.php"
click node_column_set "https://github.com/limegreentangerine/eventbritekit/blob/main/src/Search/Column/Set/Event.php"
click node_search_result "https://github.com/limegreentangerine/eventbritekit/blob/main/src/Search/Result/Event.php"
click node_result_item "https://github.com/limegreentangerine/eventbritekit/blob/main/src/Search/Result/Item/Event.php"
click node_list_block "https://github.com/limegreentangerine/eventbritekit/blob/main/blocks/eventbrite_event_list/controller.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_task,node_command,node_handler,node_api,node_logger toneBlue
class node_event,node_store toneAmber
class node_dashboard,node_settings,node_details toneMint
class node_search_controller,node_search_list,node_column_set,node_search_result,node_result_item,node_list_block toneRose
class node_operator,node_eventbrite toneIndigo
```

## Components

### Event Import

- [Import task](https://github.com/limegreentangerine/eventbritekit/blob/main/src/Command/Task/Controller/GetEventsController.php): `src/Command/Task/Controller/GetEventsController.php`
- [Import command](https://github.com/limegreentangerine/eventbritekit/blob/main/src/Command/GetEventsCommand.php): `src/Command/GetEventsCommand.php`
- [Import handler](https://github.com/limegreentangerine/eventbritekit/blob/main/src/Command/GetEventsCommandHandler.php): `src/Command/GetEventsCommandHandler.php`
- [Eventbrite API client](https://github.com/limegreentangerine/eventbritekit/blob/main/src/Api/Eventbrite.php): `src/Api/Eventbrite.php`
- [Event logger](https://github.com/limegreentangerine/eventbritekit/blob/main/src/Log/EventbriteLogger.php): `src/Log/EventbriteLogger.php`

### Event Data

- [Event entity](https://github.com/limegreentangerine/eventbritekit/blob/main/src/Entity/Event.php): `src/Entity/Event.php`
- **Event table**

### Dashboard

- [Dashboard events](https://github.com/limegreentangerine/eventbritekit/blob/main/controllers/single_page/dashboard/eventbrite/events.php): `controllers/single_page/dashboard/eventbrite/events.php`
- [Dashboard settings](https://github.com/limegreentangerine/eventbritekit/blob/main/controllers/single_page/dashboard/eventbrite/settings.php): `controllers/single_page/dashboard/eventbrite/settings.php`
- [Event details view](https://github.com/limegreentangerine/eventbritekit/blob/main/elements/dashboard/events/details.php): `elements/dashboard/events/details.php`

### Event Discovery

- [Search controller](https://github.com/limegreentangerine/eventbritekit/blob/main/controllers/search/events.php): `controllers/search/events.php`
- [Event search list](https://github.com/limegreentangerine/eventbritekit/blob/main/src/Search/ItemList/Event.php): `src/Search/ItemList/Event.php`
- [Search columns](https://github.com/limegreentangerine/eventbritekit/blob/main/src/Search/Column/Set/Event.php): `src/Search/Column/Set/Event.php`
- [Search results](https://github.com/limegreentangerine/eventbritekit/blob/main/src/Search/Result/Event.php): `src/Search/Result/Event.php`
- [Result item](https://github.com/limegreentangerine/eventbritekit/blob/main/src/Search/Result/Item/Event.php): `src/Search/Result/Item/Event.php`
- [Event listing block](https://github.com/limegreentangerine/eventbritekit/blob/main/blocks/eventbrite_event_list/controller.php): `blocks/eventbrite_event_list/controller.php`

### Other components

- **CMS operator**
- **Eventbrite service**

## Connections

- CMS operator → Import task: runs (evidence: `src/Command/Task/Controller/GetEventsController.php`)
- Import task → Import command: queues (evidence: `src/Command/Task/Controller/GetEventsController.php`)
- Import command → Import handler: handled by (evidence: `src/Command/GetEventsCommandHandler.php`)
- Import handler → Eventbrite API client: fetches events (evidence: `src/Command/GetEventsCommandHandler.php`)
- Eventbrite API client → Eventbrite service: requests events (evidence: `src/Api/Eventbrite.php`)
- Import handler → Event entity: maps and upserts (evidence: `src/Command/GetEventsCommandHandler.php`)
- Import handler → Event table: persists and prunes (evidence: `src/Command/GetEventsCommandHandler.php`)
- Event entity → Event table: maps to table (evidence: `src/Entity/Event.php`)
- Import handler → Event logger: logs import (evidence: `src/Command/GetEventsCommandHandler.php`)
- Dashboard events → Eventbrite API client: uses client (evidence: `controllers/single_page/dashboard/eventbrite/events.php`)
- Dashboard events → Event logger: uses logger (evidence: `controllers/single_page/dashboard/eventbrite/events.php`)
- Dashboard settings → Eventbrite API client: uses client (evidence: `controllers/single_page/dashboard/eventbrite/settings.php`)
- Event details view → Eventbrite API client: uses client (evidence: `elements/dashboard/events/details.php`)
- Search controller → Event search list: creates and filters (evidence: `controllers/search/events.php`)
- Search controller → Search columns: configures columns (evidence: `controllers/search/events.php`)
- Search controller → Search results: builds results (evidence: `controllers/search/events.php`)
- Search results → Result item: wraps items (evidence: `src/Search/Result/Event.php`)
- Event search list → Event table: queries (evidence: `src/Search/ItemList/Event.php`)
- Event search list → Event entity: loads entities (evidence: `src/Search/ItemList/Event.php`)
- Event listing block → Event search list: filters active events (evidence: `blocks/eventbrite_event_list/controller.php`)
