# abpframework/eventhub architecture

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

- Interactive diagram: https://gitdiagram.com/abpframework/eventhub
- Repository: https://github.com/abpframework/eventhub

## Overview

EventHub is an ABP reference application for managing events and organizations, with separate public and administrative experiences and a reusable PayPal payment module. The principal workflow is event creation and publication: an organizer uses the public web experience, which exposes event operations through the public API; event rules are represented in the domain. Admins manage events, organizations, memberships, registrations, and users through a separate Blazor/API surface. Payment and scheduled background work are additional product capabilities. Some links are documented at solution level rather than demonstrated in sampled callers, so those are marked unverified.

Main entry points: [`src/EventHub.Web`](https://github.com/abpframework/eventhub/tree/main/src/EventHub.Web) (Public web), [`src/EventHub.HttpApi/Controllers/Events/EventController.cs`](https://github.com/abpframework/eventhub/blob/main/src/EventHub.HttpApi/Controllers/Events/EventController.cs) (Event API), [`src/EventHub.Admin.Web.Client/Pages/EventManagement.razor.cs`](https://github.com/abpframework/eventhub/blob/main/src/EventHub.Admin.Web.Client/Pages/EventManagement.razor.cs) (Admin Blazor), [`src/EventHub.Admin.HttpApi.Host/Controllers/Events/EventController.cs`](https://github.com/abpframework/eventhub/blob/main/src/EventHub.Admin.HttpApi.Host/Controllers/Events/EventController.cs) (Admin API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public events"]
  node_publicweb["Public web<br/>[EventHub.Web]"]
  node_eventapi["Event API<br/>[EventController.cs]"]
  node_eventcontract["Event service contract"]
  node_eventapp["Event application<br/>[EventAppService.cs]"]
  node_orgapp["Organization application"]
end

subgraph group_admin["Administration"]
  node_adminweb["Admin Blazor"]
  node_adminapi["Admin API<br/>[EventController.cs]"]
  node_adminservices["Admin services<br/>[EventAppService.cs]"]
  node_adminareas["Admin domains"]
end

subgraph group_payment["Payments"]
  node_paymentweb["Payment pages"]
  node_paymentapi["Payment API"]
  node_paymentcontract["Payment contract"]
  node_paymentapp["Payment service"]
end

subgraph group_platform["Domain and operations"]
  node_eventmanager["Event rules<br/>[EventManager.cs]"]
  node_eventmodel["Event aggregate<br/>[Event.cs]"]
  node_orgmodel["Organization aggregate<br/>[Organization.cs]"]
  node_eventdb[("Event database<br/>[EventRepository.cs]")]
  node_workers["Background workers"]
  node_identity["Identity host<br/>[Program.cs]"]
end

node_organizer(("Organizer"))
node_adminuser(("Admin user"))
node_paypal["PayPal"]

node_organizer -->|"creates events"| node_publicweb
node_publicweb -.->|"submits operations"| node_eventapi
node_eventapi -->|"delegates calls"| node_eventcontract
node_adminuser -.->|"manages events"| node_adminweb
node_adminweb -.->|"uses admin API"| node_adminapi
node_adminapi -.->|"routes requests"| node_adminservices
node_paymentweb -.->|"starts checkout"| node_paymentapi
node_paymentapi -->|"delegates calls"| node_paymentcontract
node_paymentapp -.->|"processes payments"| node_paypal
node_workers -.->|"updates organizations"| node_eventdb

click node_publicweb "https://github.com/abpframework/eventhub/tree/main/src/EventHub.Web"
click node_eventapi "https://github.com/abpframework/eventhub/blob/main/src/EventHub.HttpApi/Controllers/Events/EventController.cs"
click node_eventcontract "https://github.com/abpframework/eventhub/blob/main/src/EventHub.Application.Contracts/Events/IEventAppService.cs"
click node_eventapp "https://github.com/abpframework/eventhub/blob/main/src/EventHub.Application/Events/EventAppService.cs"
click node_eventmanager "https://github.com/abpframework/eventhub/blob/main/src/EventHub.Domain/Events/EventManager.cs"
click node_eventmodel "https://github.com/abpframework/eventhub/blob/main/src/EventHub.Domain/Events/Event.cs"
click node_orgapp "https://github.com/abpframework/eventhub/blob/main/src/EventHub.Application/Organizations/OrganizationAppService.cs"
click node_orgmodel "https://github.com/abpframework/eventhub/blob/main/src/EventHub.Domain/Organizations/Organization.cs"
click node_adminweb "https://github.com/abpframework/eventhub/blob/main/src/EventHub.Admin.Web.Client/Pages/EventManagement.razor.cs"
click node_adminapi "https://github.com/abpframework/eventhub/blob/main/src/EventHub.Admin.HttpApi.Host/Controllers/Events/EventController.cs"
click node_adminservices "https://github.com/abpframework/eventhub/blob/main/src/EventHub.Admin.Application/Events/EventAppService.cs"
click node_adminareas "https://github.com/abpframework/eventhub/tree/main/src/EventHub.Admin.Application"
click node_paymentweb "https://github.com/abpframework/eventhub/blob/main/modules/payment/src/Payment.Web/Pages/Payment/PreCheckout.cshtml.cs"
click node_paymentapi "https://github.com/abpframework/eventhub/blob/main/modules/payment/src/Payment.HttpApi/PaymentRequests/PaymentRequestController.cs"
click node_paymentcontract "https://github.com/abpframework/eventhub/blob/main/modules/payment/src/Payment.Application.Contracts/PaymentRequests/IPaymentRequestAppService.cs"
click node_paymentapp "https://github.com/abpframework/eventhub/blob/main/modules/payment/src/Payment.Application/PaymentRequests/PaymentRequestAppService.cs"
click node_eventdb "https://github.com/abpframework/eventhub/blob/main/src/EventHub.EntityFrameworkCore/EntityFrameworkCore/Events/EventRepository.cs"
click node_workers "https://github.com/abpframework/eventhub/tree/main/src/EventHub.BackgroundServices"
click node_identity "https://github.com/abpframework/eventhub/blob/main/src/EventHub.IdentityServer/Program.cs"

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_publicweb,node_eventapi,node_eventcontract,node_eventapp,node_orgapp,node_adminuser toneBlue
class node_adminweb,node_adminapi,node_adminservices,node_adminareas toneAmber
class node_paymentweb,node_paymentapi,node_paymentcontract,node_paymentapp toneMint
class node_eventmanager,node_eventmodel,node_orgmodel,node_eventdb,node_workers,node_identity toneRose
class node_organizer,node_paypal toneIndigo
```

## Components

### Public events

- [Public web](https://github.com/abpframework/eventhub/tree/main/src/EventHub.Web): `src/EventHub.Web`
- [Event API](https://github.com/abpframework/eventhub/blob/main/src/EventHub.HttpApi/Controllers/Events/EventController.cs): `src/EventHub.HttpApi/Controllers/Events/EventController.cs`
- [Event service contract](https://github.com/abpframework/eventhub/blob/main/src/EventHub.Application.Contracts/Events/IEventAppService.cs): `src/EventHub.Application.Contracts/Events/IEventAppService.cs`
- [Event application](https://github.com/abpframework/eventhub/blob/main/src/EventHub.Application/Events/EventAppService.cs): `src/EventHub.Application/Events/EventAppService.cs`
- [Organization application](https://github.com/abpframework/eventhub/blob/main/src/EventHub.Application/Organizations/OrganizationAppService.cs): `src/EventHub.Application/Organizations/OrganizationAppService.cs`

### Administration

- [Admin Blazor](https://github.com/abpframework/eventhub/blob/main/src/EventHub.Admin.Web.Client/Pages/EventManagement.razor.cs): `src/EventHub.Admin.Web.Client/Pages/EventManagement.razor.cs`
- [Admin API](https://github.com/abpframework/eventhub/blob/main/src/EventHub.Admin.HttpApi.Host/Controllers/Events/EventController.cs): `src/EventHub.Admin.HttpApi.Host/Controllers/Events/EventController.cs`
- [Admin services](https://github.com/abpframework/eventhub/blob/main/src/EventHub.Admin.Application/Events/EventAppService.cs): `src/EventHub.Admin.Application/Events/EventAppService.cs`
- [Admin domains](https://github.com/abpframework/eventhub/tree/main/src/EventHub.Admin.Application): `src/EventHub.Admin.Application`

### Payments

- [Payment pages](https://github.com/abpframework/eventhub/blob/main/modules/payment/src/Payment.Web/Pages/Payment/PreCheckout.cshtml.cs): `modules/payment/src/Payment.Web/Pages/Payment/PreCheckout.cshtml.cs`
- [Payment API](https://github.com/abpframework/eventhub/blob/main/modules/payment/src/Payment.HttpApi/PaymentRequests/PaymentRequestController.cs): `modules/payment/src/Payment.HttpApi/PaymentRequests/PaymentRequestController.cs`
- [Payment contract](https://github.com/abpframework/eventhub/blob/main/modules/payment/src/Payment.Application.Contracts/PaymentRequests/IPaymentRequestAppService.cs): `modules/payment/src/Payment.Application.Contracts/PaymentRequests/IPaymentRequestAppService.cs`
- [Payment service](https://github.com/abpframework/eventhub/blob/main/modules/payment/src/Payment.Application/PaymentRequests/PaymentRequestAppService.cs): `modules/payment/src/Payment.Application/PaymentRequests/PaymentRequestAppService.cs`

### Domain and operations

- [Event rules](https://github.com/abpframework/eventhub/blob/main/src/EventHub.Domain/Events/EventManager.cs): `src/EventHub.Domain/Events/EventManager.cs`
- [Event aggregate](https://github.com/abpframework/eventhub/blob/main/src/EventHub.Domain/Events/Event.cs): `src/EventHub.Domain/Events/Event.cs`
- [Organization aggregate](https://github.com/abpframework/eventhub/blob/main/src/EventHub.Domain/Organizations/Organization.cs): `src/EventHub.Domain/Organizations/Organization.cs`
- [Event database](https://github.com/abpframework/eventhub/blob/main/src/EventHub.EntityFrameworkCore/EntityFrameworkCore/Events/EventRepository.cs): `src/EventHub.EntityFrameworkCore/EntityFrameworkCore/Events/EventRepository.cs`
- [Background workers](https://github.com/abpframework/eventhub/tree/main/src/EventHub.BackgroundServices): `src/EventHub.BackgroundServices`
- [Identity host](https://github.com/abpframework/eventhub/blob/main/src/EventHub.IdentityServer/Program.cs): `src/EventHub.IdentityServer/Program.cs`

### Other components

- **Organizer**
- **Admin user**
- **PayPal**

## Connections

- Organizer → Public web: creates events (evidence: `README.md`)
- Public web → Event API: submits operations
- Event API → Event service contract: delegates calls (evidence: `src/EventHub.HttpApi/Controllers/Events/EventController.cs`)
- Admin user → Admin Blazor: manages events
- Admin Blazor → Admin API: uses admin API
- Admin API → Admin services: routes requests
- Payment pages → Payment API: starts checkout
- Payment API → Payment contract: delegates calls (evidence: `modules/payment/src/Payment.HttpApi/PaymentRequests/PaymentRequestController.cs`)
- Payment service → PayPal: processes payments
- Background workers → Event database: updates organizations
