# danieltf21/pulsepass architecture

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

- Interactive diagram: https://gitdiagram.com/danieltf21/pulsepass
- Repository: https://github.com/danieltf21/pulsepass

## Overview

PulsePass is a live-event discovery and ticketing REST platform. The main user flow is HTTP event discovery followed by ticket purchase, where services enforce business rules and persist ticket state; authentication and authorization support protected operations. The README documents broader event, venue, artist, user, and ticket capabilities. Source excerpts show selected controller, authentication, and ticket-service calls; other links reflect the documented layered architecture, so unsampled implementation details are not asserted.

Main entry points: [`src/main/java/com/pulsepass/repository`](https://github.com/danieltf21/pulsepass/tree/main/src/main/java/com/pulsepass/repository) (JPA Repositories), [`src/main/java/com/pulsepass/controller/TicketController.java`](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/controller/TicketController.java) (Ticket API), [`src/main/java/com/pulsepass/services/impl/AuthServiceImpl.java`](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/services/impl/AuthServiceImpl.java) (Authentication), [`src/main/java/com/pulsepass/controller/EventController.java`](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/controller/EventController.java) (Event API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_event_api["Event API"]
  node_artist_api["Artist API"]
  node_venue_api["Venue API"]
  node_user_api["User API"]
  node_auth_api["Auth API"]
  node_ticket_api["Ticket API"]
  node_errors["REST Error Handler"]
end

subgraph group_events["Event Catalog"]
  node_event_service["Event Rules"]
  node_artist_service["Artist Catalog"]
  node_venue_service["Venue Catalog"]
end

subgraph group_commerce["Ticketing"]
  node_ticket_service["Ticket Rules"]
end

subgraph group_identity["Identity and Security"]
  node_user_service["User Accounts"]
  node_auth_service["Authentication"]
  node_authorization["Access Checks"]
  node_security_loader["Principal Loader"]
  node_jwt["JWT Service<br/>[JwtService.java]"]
end

subgraph group_data["Persistence and Domain"]
  node_domain["Event and User Model"]
  node_mappers["DTO Mappers"]
  node_repositories["JPA Repositories"]
end

node_client(("HTTP Client"))
node_postgres[("PostgreSQL")]

node_client -->|"requests events"| node_event_api
node_client -->|"purchases tickets"| node_ticket_api
node_client -->|"authenticates"| node_auth_api
node_event_api -->|"delegates to"| node_event_service
node_artist_api -->|"delegates to"| node_artist_service
node_venue_api -->|"delegates to"| node_venue_service
node_user_api -->|"delegates to"| node_user_service
node_user_api -->|"registers through"| node_auth_service
node_auth_api -->|"delegates to"| node_auth_service
node_ticket_api -->|"delegates to"| node_ticket_service
node_ticket_api -->|"resolves owner"| node_user_service
node_ticket_api -->|"checks access"| node_authorization
node_event_api -->|"checks access"| node_authorization
node_auth_service -->|"registers user"| node_user_service
node_auth_service -->|"issues token"| node_jwt
node_security_loader -->|"loads identity data"| node_repositories
node_auth_service -->|"reads and writes"| node_repositories
node_ticket_service -->|"reads and writes"| node_repositories
node_event_service -->|"accesses data"| node_repositories
node_artist_service -->|"accesses data"| node_repositories
node_venue_service -->|"accesses data"| node_repositories
node_user_service -->|"accesses data"| node_repositories
node_ticket_service -->|"maps responses"| node_mappers
node_event_service -->|"maps responses"| node_mappers
node_repositories -->|"persists entities"| node_domain
node_repositories -->|"reads and writes"| node_postgres
node_client -->|"browses artists"| node_artist_api
node_client -->|"browses venues"| node_venue_api
node_event_api -->|"errors handled by"| node_errors
node_ticket_api -->|"errors handled by"| node_errors

click node_event_api "https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/controller/EventController.java"
click node_artist_api "https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/controller/ArtistController.java"
click node_venue_api "https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/controller/VenueController.java"
click node_user_api "https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/controller/UserController.java"
click node_auth_api "https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/controller/AuthController.java"
click node_ticket_api "https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/controller/TicketController.java"
click node_event_service "https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/services/impl/EventServiceImpl.java"
click node_artist_service "https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/services/impl/ArtistServiceImpl.java"
click node_venue_service "https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/services/impl/VenueServiceImpl.java"
click node_ticket_service "https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/services/impl/TicketServiceImpl.java"
click node_user_service "https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/services/impl/UserServiceImpl.java"
click node_auth_service "https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/services/impl/AuthServiceImpl.java"
click node_authorization "https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/services/impl/AuthorizationServiceImpl.java"
click node_security_loader "https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/security/CustomUserDetailsService.java"
click node_jwt "https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/security/JwtService.java"
click node_domain "https://github.com/danieltf21/pulsepass/tree/main/src/main/java/com/pulsepass/domain"
click node_mappers "https://github.com/danieltf21/pulsepass/tree/main/src/main/java/com/pulsepass/mapper"
click node_repositories "https://github.com/danieltf21/pulsepass/tree/main/src/main/java/com/pulsepass/repository"
click node_errors "https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/exception/GlobalExceptionHandler.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_api,node_artist_api,node_venue_api,node_user_api,node_auth_api,node_ticket_api,node_errors,node_client toneBlue
class node_event_service,node_artist_service,node_venue_service,node_postgres toneAmber
class node_ticket_service toneMint
class node_user_service,node_auth_service,node_authorization,node_security_loader,node_jwt toneRose
class node_domain,node_mappers,node_repositories toneIndigo
```

## Components

### REST API

- [Event API](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/controller/EventController.java): `src/main/java/com/pulsepass/controller/EventController.java`
- [Artist API](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/controller/ArtistController.java): `src/main/java/com/pulsepass/controller/ArtistController.java`
- [Venue API](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/controller/VenueController.java): `src/main/java/com/pulsepass/controller/VenueController.java`
- [User API](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/controller/UserController.java): `src/main/java/com/pulsepass/controller/UserController.java`
- [Auth API](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/controller/AuthController.java): `src/main/java/com/pulsepass/controller/AuthController.java`
- [Ticket API](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/controller/TicketController.java): `src/main/java/com/pulsepass/controller/TicketController.java`
- [REST Error Handler](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/exception/GlobalExceptionHandler.java): `src/main/java/com/pulsepass/exception/GlobalExceptionHandler.java`

### Event Catalog

- [Event Rules](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/services/impl/EventServiceImpl.java): `src/main/java/com/pulsepass/services/impl/EventServiceImpl.java`
- [Artist Catalog](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/services/impl/ArtistServiceImpl.java): `src/main/java/com/pulsepass/services/impl/ArtistServiceImpl.java`
- [Venue Catalog](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/services/impl/VenueServiceImpl.java): `src/main/java/com/pulsepass/services/impl/VenueServiceImpl.java`

### Ticketing

- [Ticket Rules](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/services/impl/TicketServiceImpl.java): `src/main/java/com/pulsepass/services/impl/TicketServiceImpl.java`

### Identity and Security

- [User Accounts](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/services/impl/UserServiceImpl.java): `src/main/java/com/pulsepass/services/impl/UserServiceImpl.java`
- [Authentication](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/services/impl/AuthServiceImpl.java): `src/main/java/com/pulsepass/services/impl/AuthServiceImpl.java`
- [Access Checks](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/services/impl/AuthorizationServiceImpl.java): `src/main/java/com/pulsepass/services/impl/AuthorizationServiceImpl.java`
- [Principal Loader](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/security/CustomUserDetailsService.java): `src/main/java/com/pulsepass/security/CustomUserDetailsService.java`
- [JWT Service](https://github.com/danieltf21/pulsepass/blob/main/src/main/java/com/pulsepass/security/JwtService.java): `src/main/java/com/pulsepass/security/JwtService.java`

### Persistence and Domain

- [Event and User Model](https://github.com/danieltf21/pulsepass/tree/main/src/main/java/com/pulsepass/domain): `src/main/java/com/pulsepass/domain`
- [DTO Mappers](https://github.com/danieltf21/pulsepass/tree/main/src/main/java/com/pulsepass/mapper): `src/main/java/com/pulsepass/mapper`
- [JPA Repositories](https://github.com/danieltf21/pulsepass/tree/main/src/main/java/com/pulsepass/repository): `src/main/java/com/pulsepass/repository`

### Other components

- **HTTP Client**
- **PostgreSQL**

## Connections

- HTTP Client → Event API: requests events
- HTTP Client → Ticket API: purchases tickets
- HTTP Client → Auth API: authenticates
- Event API → Event Rules: delegates to (evidence: `src/main/java/com/pulsepass/controller/EventController.java`)
- Artist API → Artist Catalog: delegates to (evidence: `src/main/java/com/pulsepass/controller/ArtistController.java`)
- Venue API → Venue Catalog: delegates to
- User API → User Accounts: delegates to (evidence: `src/main/java/com/pulsepass/controller/UserController.java`)
- User API → Authentication: registers through (evidence: `src/main/java/com/pulsepass/controller/UserController.java`)
- Auth API → Authentication: delegates to (evidence: `src/main/java/com/pulsepass/controller/AuthController.java`)
- Ticket API → Ticket Rules: delegates to (evidence: `src/main/java/com/pulsepass/controller/TicketController.java`)
- Ticket API → User Accounts: resolves owner (evidence: `src/main/java/com/pulsepass/controller/TicketController.java`)
- Ticket API → Access Checks: checks access (evidence: `src/main/java/com/pulsepass/controller/TicketController.java`)
- Event API → Access Checks: checks access (evidence: `src/main/java/com/pulsepass/controller/EventController.java`)
- Authentication → User Accounts: registers user (evidence: `src/main/java/com/pulsepass/services/impl/AuthServiceImpl.java`)
- Authentication → JWT Service: issues token (evidence: `src/main/java/com/pulsepass/services/impl/AuthServiceImpl.java`)
- Principal Loader → JPA Repositories: loads identity data (evidence: `src/main/java/com/pulsepass/security/CustomUserDetailsService.java`)
- Authentication → JPA Repositories: reads and writes (evidence: `src/main/java/com/pulsepass/services/impl/AuthServiceImpl.java`)
- Ticket Rules → JPA Repositories: reads and writes (evidence: `src/main/java/com/pulsepass/services/impl/TicketServiceImpl.java`)
- Event Rules → JPA Repositories: accesses data (evidence: `src/main/java/com/pulsepass/services/impl/EventServiceImpl.java`)
- Artist Catalog → JPA Repositories: accesses data
- Venue Catalog → JPA Repositories: accesses data
- User Accounts → JPA Repositories: accesses data
- Ticket Rules → DTO Mappers: maps responses (evidence: `src/main/java/com/pulsepass/services/impl/TicketServiceImpl.java`)
- Event Rules → DTO Mappers: maps responses (evidence: `src/main/java/com/pulsepass/services/impl/EventServiceImpl.java`)
- JPA Repositories → Event and User Model: persists entities (evidence: `src/main/java/com/pulsepass/repository/EventRepository.java`)
- JPA Repositories → PostgreSQL: reads and writes
- HTTP Client → Artist API: browses artists
- HTTP Client → Venue API: browses venues
- Event API → REST Error Handler: errors handled by
- Ticket API → REST Error Handler: errors handled by
