# jesusgonzalez4114/pulsepass architecture

> Architecture diagram of the GitHub repository jesusgonzalez4114/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/jesusgonzalez4114/pulsepass
- Repository: https://github.com/jesusgonzalez4114/pulsepass

## Overview

PulsePass is a REST platform for discovering events and managing ticket purchases. Its main flow is a client request through JWT security and REST controllers into services that enforce business rules, then through repositories to PostgreSQL; responses are DTOs. Separate branches cover account registration and login, event publication and artist association, event discovery, and ticket lifecycle operations. The README documents the layer boundaries and business capabilities; unsampled service and controller links are shown only where documented or referenced in the source index.

Main entry points: [`src/main/java/com/pulsepass/platform/repository`](https://github.com/jesusgonzalez4114/pulsepass/tree/main/src/main/java/com/pulsepass/platform/repository) (JPA repositories), [`src/main/java/com/pulsepass/platform/service/impl/TicketServiceImpl.java`](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/service/impl/TicketServiceImpl.java) (Ticket lifecycle), [`src/main/java/com/pulsepass/platform/service/impl/AuthServiceImpl.java`](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/service/impl/AuthServiceImpl.java) (Authentication), [`src/main/java/com/pulsepass/platform/service/impl/EventServiceImpl.java`](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/service/impl/EventServiceImpl.java) (Event rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and API"]
  node_jwt["JWT security"]
  node_auth_api["Authentication API"]
  node_event_api["Event API"]
  node_ticket_api["Ticket API"]
  node_user_api["User API"]
  node_dto_mapper["DTO mapping"]
end

subgraph group_events["Event Catalog"]
  node_event_service["Event rules"]
  node_event_search["Event queries"]
  node_artist_service["Artist catalog"]
  node_venue_service["Venue catalog"]
  node_event_data["Event records<br/>[Event.java]"]
end

subgraph group_tickets["Ticketing"]
  node_ticket_service["Ticket lifecycle"]
  node_ticket_data["Ticket records<br/>[Ticket.java]"]
end

subgraph group_accounts["Accounts"]
  node_auth_service["Authentication"]
  node_identity_lookup["Identity lookup"]
  node_authorization["Ownership rules"]
  node_user_service["User management"]
  node_user_data["User records<br/>[User.java]"]
end

subgraph group_persistence["Persistence"]
  node_repositories["JPA repositories"]
  node_postgres[("PostgreSQL")]
end

node_client(("Platform users"))

node_client -->|"sends requests"| node_jwt
node_jwt -.->|"protects routes"| node_auth_api
node_client -->|"requests events"| node_event_api
node_client -->|"requests tickets"| node_ticket_api
node_client -->|"authenticates"| node_auth_api
node_client -->|"manages account"| node_user_api
node_auth_api -->|"calls"| node_auth_service
node_event_api -->|"calls"| node_event_service
node_event_api -->|"checks access"| node_authorization
node_ticket_api -->|"calls"| node_ticket_service
node_user_api -->|"registers users"| node_auth_service
node_auth_service -->|"creates users"| node_user_service
node_auth_service -.->|"authenticates via"| node_identity_lookup
node_auth_service -->|"creates credentials"| node_user_data
node_event_service -.->|"queries events"| node_event_search
node_ticket_service -->|"reads and writes"| node_repositories
node_ticket_service -->|"manages lifecycle"| node_ticket_data
node_ticket_service -->|"checks event rules"| node_event_data
node_ticket_service -->|"maps responses"| node_dto_mapper
node_event_service -->|"maps responses"| node_dto_mapper
node_user_service -->|"maps responses"| node_dto_mapper
node_event_service -->|"accesses data"| node_repositories
node_user_service -->|"accesses data"| node_repositories
node_repositories -->|"persists records"| node_postgres
node_artist_service -->|"accesses data"| node_repositories
node_venue_service -->|"accesses data"| node_repositories
node_event_search -->|"queries"| node_event_data
node_authorization -->|"checks ownership"| node_ticket_data

click node_jwt "https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/security/JwtAuthenticationFilter.java"
click node_auth_api "https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/controller/AuthController.java"
click node_event_api "https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/controller/EventController.java"
click node_ticket_api "https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/controller/TicketController.java"
click node_user_api "https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/controller/UserController.java"
click node_auth_service "https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/service/impl/AuthServiceImpl.java"
click node_identity_lookup "https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/security/CustomUserDetailsService.java"
click node_authorization "https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/service/impl/AuthorizationServiceImpl.java"
click node_user_service "https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/service/impl/UserServiceImpl.java"
click node_event_service "https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/service/impl/EventServiceImpl.java"
click node_event_search "https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/repository/EventRepository.java"
click node_artist_service "https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/service/impl/ArtistServiceImpl.java"
click node_venue_service "https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/service/impl/VenueServiceImpl.java"
click node_ticket_service "https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/service/impl/TicketServiceImpl.java"
click node_ticket_data "https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/domain/Ticket.java"
click node_event_data "https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/domain/Event.java"
click node_user_data "https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/domain/User.java"
click node_dto_mapper "https://github.com/jesusgonzalez4114/pulsepass/tree/main/src/main/java/com/pulsepass/platform/mapper"
click node_repositories "https://github.com/jesusgonzalez4114/pulsepass/tree/main/src/main/java/com/pulsepass/platform/repository"

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_jwt,node_auth_api,node_event_api,node_ticket_api,node_user_api,node_dto_mapper,node_client toneBlue
class node_event_service,node_event_search,node_artist_service,node_venue_service,node_event_data toneAmber
class node_ticket_service,node_ticket_data toneMint
class node_auth_service,node_identity_lookup,node_authorization,node_user_service,node_user_data toneRose
class node_repositories,node_postgres toneIndigo
```

## Components

### Access and API

- [JWT security](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/security/JwtAuthenticationFilter.java): `src/main/java/com/pulsepass/platform/security/JwtAuthenticationFilter.java`
- [Authentication API](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/controller/AuthController.java): `src/main/java/com/pulsepass/platform/controller/AuthController.java`
- [Event API](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/controller/EventController.java): `src/main/java/com/pulsepass/platform/controller/EventController.java`
- [Ticket API](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/controller/TicketController.java): `src/main/java/com/pulsepass/platform/controller/TicketController.java`
- [User API](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/controller/UserController.java): `src/main/java/com/pulsepass/platform/controller/UserController.java`
- [DTO mapping](https://github.com/jesusgonzalez4114/pulsepass/tree/main/src/main/java/com/pulsepass/platform/mapper): `src/main/java/com/pulsepass/platform/mapper`

### Event Catalog

- [Event rules](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/service/impl/EventServiceImpl.java): `src/main/java/com/pulsepass/platform/service/impl/EventServiceImpl.java`
- [Event queries](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/repository/EventRepository.java): `src/main/java/com/pulsepass/platform/repository/EventRepository.java`
- [Artist catalog](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/service/impl/ArtistServiceImpl.java): `src/main/java/com/pulsepass/platform/service/impl/ArtistServiceImpl.java`
- [Venue catalog](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/service/impl/VenueServiceImpl.java): `src/main/java/com/pulsepass/platform/service/impl/VenueServiceImpl.java`
- [Event records](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/domain/Event.java): `src/main/java/com/pulsepass/platform/domain/Event.java`

### Ticketing

- [Ticket lifecycle](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/service/impl/TicketServiceImpl.java): `src/main/java/com/pulsepass/platform/service/impl/TicketServiceImpl.java`
- [Ticket records](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/domain/Ticket.java): `src/main/java/com/pulsepass/platform/domain/Ticket.java`

### Accounts

- [Authentication](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/service/impl/AuthServiceImpl.java): `src/main/java/com/pulsepass/platform/service/impl/AuthServiceImpl.java`
- [Identity lookup](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/security/CustomUserDetailsService.java): `src/main/java/com/pulsepass/platform/security/CustomUserDetailsService.java`
- [Ownership rules](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/service/impl/AuthorizationServiceImpl.java): `src/main/java/com/pulsepass/platform/service/impl/AuthorizationServiceImpl.java`
- [User management](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/service/impl/UserServiceImpl.java): `src/main/java/com/pulsepass/platform/service/impl/UserServiceImpl.java`
- [User records](https://github.com/jesusgonzalez4114/pulsepass/blob/main/src/main/java/com/pulsepass/platform/domain/User.java): `src/main/java/com/pulsepass/platform/domain/User.java`

### Persistence

- [JPA repositories](https://github.com/jesusgonzalez4114/pulsepass/tree/main/src/main/java/com/pulsepass/platform/repository): `src/main/java/com/pulsepass/platform/repository`
- **PostgreSQL**

### Other components

- **Platform users**

## Connections

- Platform users → JWT security: sends requests
- JWT security → Authentication API: protects routes
- Platform users → Event API: requests events
- Platform users → Ticket API: requests tickets
- Platform users → Authentication API: authenticates
- Platform users → User API: manages account
- Authentication API → Authentication: calls (evidence: `src/main/java/com/pulsepass/platform/controller/AuthController.java`)
- Event API → Event rules: calls (evidence: `src/main/java/com/pulsepass/platform/controller/EventController.java`)
- Event API → Ownership rules: checks access (evidence: `src/main/java/com/pulsepass/platform/controller/EventController.java`)
- Ticket API → Ticket lifecycle: calls (evidence: `src/main/java/com/pulsepass/platform/controller/TicketController.java`)
- User API → Authentication: registers users (evidence: `src/main/java/com/pulsepass/platform/controller/UserController.java`)
- Authentication → User management: creates users (evidence: `src/main/java/com/pulsepass/platform/service/impl/AuthServiceImpl.java`)
- Authentication → Identity lookup: authenticates via
- Authentication → User records: creates credentials (evidence: `src/main/java/com/pulsepass/platform/service/impl/AuthServiceImpl.java`)
- Event rules → Event queries: queries events (evidence: `src/main/java/com/pulsepass/platform/service/impl/EventServiceImpl.java`)
- Ticket lifecycle → JPA repositories: reads and writes (evidence: `src/main/java/com/pulsepass/platform/service/impl/TicketServiceImpl.java`)
- Ticket lifecycle → Ticket records: manages lifecycle (evidence: `src/main/java/com/pulsepass/platform/service/impl/TicketServiceImpl.java`)
- Ticket lifecycle → Event records: checks event rules (evidence: `src/main/java/com/pulsepass/platform/service/impl/TicketServiceImpl.java`)
- Ticket lifecycle → DTO mapping: maps responses (evidence: `src/main/java/com/pulsepass/platform/service/impl/TicketServiceImpl.java`)
- Event rules → DTO mapping: maps responses (evidence: `src/main/java/com/pulsepass/platform/service/impl/EventServiceImpl.java`)
- User management → DTO mapping: maps responses
- Event rules → JPA repositories: accesses data (evidence: `src/main/java/com/pulsepass/platform/service/impl/EventServiceImpl.java`)
- User management → JPA repositories: accesses data
- JPA repositories → PostgreSQL: persists records
- Artist catalog → JPA repositories: accesses data
- Venue catalog → JPA repositories: accesses data
- Event queries → Event records: queries (evidence: `src/main/java/com/pulsepass/platform/repository/EventRepository.java`)
- Ownership rules → Ticket records: checks ownership (evidence: `src/main/java/com/pulsepass/platform/service/impl/AuthorizationServiceImpl.java`)
