# seamusdarcy/event-ticketing-api architecture

> Architecture diagram of the GitHub repository seamusdarcy/event-ticketing-api, 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/seamusdarcy/event-ticketing-api
- Repository: https://github.com/seamusdarcy/event-ticketing-api

## Overview

This is a Spring Boot event-ticketing API. Its main workflow accepts event CRUD requests, validates request fields, delegates event operations to a service, stores event objects in an in-memory repository, and returns event response records; failures are translated into problem details. The tree and excerpts show no persistence beyond process memory and no booking or payment workflow. The source index confirms several service relationships, while startup wiring and framework dispatch are not directly evidenced, so those links are omitted.

Main entry points: [`src/main/java/com/seamus/eventticketingapi/event/EventService.java`](https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/event/EventService.java) (Event Service), [`src/main/java/com/seamus/eventticketingapi/event/EventController.java`](https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/event/EventController.java) (Event Controller), [`src/main/java/com/seamus/eventticketingapi/common/ApiExceptionHandler.java`](https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/common/ApiExceptionHandler.java) (Exception Handler), [`src/main/java/com/seamus/eventticketingapi/event/InMemoryEventRepository.java`](https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/event/InMemoryEventRepository.java) (Memory Repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_event_controller["Event Controller"]
  node_create_request["Create Request"]
  node_event_response["Event Response<br/>[EventResponse.java]"]
  node_hello_controller["Hello Endpoint"]
  node_application["Application Startup"]
end

subgraph group_domain["Event Domain"]
  node_event_service["Event Service<br/>[EventService.java]"]
  node_event["Event Model<br/>[Event.java]"]
  node_event_repository[("Memory Repository")]
end

subgraph group_support["API Support"]
  node_not_found["Not Found Error"]
  node_exception_handler["Exception Handler"]
  node_field_error["Field Error"]
end

node_client(("API Client"))

node_client -->|"sends CRUD requests"| node_event_controller
node_client -->|"requests greeting"| node_hello_controller
node_event_controller -->|"accepts request"| node_create_request
node_event_controller -->|"delegates operations"| node_event_service
node_event_controller -->|"returns response"| node_event_response
node_event_service -->|"maps request fields"| node_create_request
node_event_service -->|"reads and writes"| node_event_repository
node_event_service -->|"creates domain object"| node_event
node_event_service -->|"maps result"| node_event_response
node_event_service -->|"throws when absent"| node_not_found
node_event_repository -->|"stores events"| node_event
node_exception_handler -->|"handles not found"| node_not_found
node_exception_handler -->|"creates field errors"| node_field_error

click node_event_controller "https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/event/EventController.java"
click node_create_request "https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/event/dto/CreateEventRequest.java"
click node_event_response "https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/event/dto/EventResponse.java"
click node_hello_controller "https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/HelloController.java"
click node_event_service "https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/event/EventService.java"
click node_event "https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/event/Event.java"
click node_event_repository "https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/event/InMemoryEventRepository.java"
click node_not_found "https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/event/EventNotFoundException.java"
click node_exception_handler "https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/common/ApiExceptionHandler.java"
click node_field_error "https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/common/FieldValidationError.java"
click node_application "https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/EventTicketingApiApplication.java"

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_event_controller,node_create_request,node_event_response,node_hello_controller,node_application,node_client toneBlue
class node_event_service,node_event,node_event_repository toneAmber
class node_not_found,node_exception_handler,node_field_error toneMint
```

## Components

### HTTP API

- [Event Controller](https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/event/EventController.java): `src/main/java/com/seamus/eventticketingapi/event/EventController.java`
- [Create Request](https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/event/dto/CreateEventRequest.java): `src/main/java/com/seamus/eventticketingapi/event/dto/CreateEventRequest.java`
- [Event Response](https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/event/dto/EventResponse.java): `src/main/java/com/seamus/eventticketingapi/event/dto/EventResponse.java`
- [Hello Endpoint](https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/HelloController.java): `src/main/java/com/seamus/eventticketingapi/HelloController.java`
- [Application Startup](https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/EventTicketingApiApplication.java): `src/main/java/com/seamus/eventticketingapi/EventTicketingApiApplication.java`

### Event Domain

- [Event Service](https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/event/EventService.java): `src/main/java/com/seamus/eventticketingapi/event/EventService.java`
- [Event Model](https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/event/Event.java): `src/main/java/com/seamus/eventticketingapi/event/Event.java`
- [Memory Repository](https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/event/InMemoryEventRepository.java): `src/main/java/com/seamus/eventticketingapi/event/InMemoryEventRepository.java`

### API Support

- [Not Found Error](https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/event/EventNotFoundException.java): `src/main/java/com/seamus/eventticketingapi/event/EventNotFoundException.java`
- [Exception Handler](https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/common/ApiExceptionHandler.java): `src/main/java/com/seamus/eventticketingapi/common/ApiExceptionHandler.java`
- [Field Error](https://github.com/seamusdarcy/event-ticketing-api/blob/main/src/main/java/com/seamus/eventticketingapi/common/FieldValidationError.java): `src/main/java/com/seamus/eventticketingapi/common/FieldValidationError.java`

### Other components

- **API Client**

## Connections

- API Client → Event Controller: sends CRUD requests (evidence: `src/main/java/com/seamus/eventticketingapi/event/EventController.java`)
- API Client → Hello Endpoint: requests greeting (evidence: `src/main/java/com/seamus/eventticketingapi/HelloController.java`)
- Event Controller → Create Request: accepts request (evidence: `src/main/java/com/seamus/eventticketingapi/event/EventController.java`)
- Event Controller → Event Service: delegates operations (evidence: `src/main/java/com/seamus/eventticketingapi/event/EventController.java`)
- Event Controller → Event Response: returns response (evidence: `src/main/java/com/seamus/eventticketingapi/event/EventController.java`)
- Event Service → Create Request: maps request fields (evidence: `src/main/java/com/seamus/eventticketingapi/event/EventService.java`)
- Event Service → Memory Repository: reads and writes (evidence: `src/main/java/com/seamus/eventticketingapi/event/EventService.java`)
- Event Service → Event Model: creates domain object (evidence: `src/main/java/com/seamus/eventticketingapi/event/EventService.java`)
- Event Service → Event Response: maps result (evidence: `src/main/java/com/seamus/eventticketingapi/event/EventService.java`)
- Event Service → Not Found Error: throws when absent (evidence: `src/main/java/com/seamus/eventticketingapi/event/EventService.java`)
- Memory Repository → Event Model: stores events (evidence: `src/main/java/com/seamus/eventticketingapi/event/InMemoryEventRepository.java`)
- Exception Handler → Not Found Error: handles not found (evidence: `src/main/java/com/seamus/eventticketingapi/common/ApiExceptionHandler.java`)
- Exception Handler → Field Error: creates field errors (evidence: `src/main/java/com/seamus/eventticketingapi/common/ApiExceptionHandler.java`)
