# luis-mart30/pulsepass architecture

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

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

## Overview

PulsePass is a persistence-only event and ticketing domain, not a complete ticket-purchase application: it has no API, service workflow, authentication, or payments. Its runtime is Spring Data JPA repositories over a PostgreSQL schema managed by Flyway. The graph captures the domain relationships and repository capabilities documented in the README; migrations, configuration, and startup are represented where their paths are known. Source excerpts do not show startup wiring or database configuration, so those runtime links are not asserted.

Main entry points: [`src/main/java/com/pulsepass/domain/Event.java`](https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/Event.java) (Events), [`src/main/java/com/pulsepass/domain/Ticket.java`](https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/Ticket.java) (Tickets), [`src/main/java/com/pulsepass/domain/User.java`](https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/User.java) (Users), [`src/main/java/com/pulsepass/domain/Venue.java`](https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/Venue.java) (Venues)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_domain["Event domain"]
  node_venue["Venues<br/>[Venue.java]"]
  node_event["Events<br/>[Event.java]"]
  node_artist["Artists<br/>[Artist.java]"]
  node_user["Users<br/>[User.java]"]
  node_profile["User profiles<br/>[UserProfile.java]"]
  node_ticket["Tickets<br/>[Ticket.java]"]
  node_event_enums["Event enums<br/>[EventCategory.java]"]
  node_ticket_enums["Ticket enums<br/>[TicketType.java]"]
end

subgraph group_persistence["Persistence access"]
  node_event_repo["Event queries"]
  node_ticket_repo["Ticket queries"]
  node_venue_repo["Venue repository"]
  node_artist_repo["Artist repository"]
  node_user_repo["User repository"]
end

subgraph group_database["Database schema"]
  node_schema["Flyway schema"]
  node_artist_seed["Initial artists"]
  node_streaming_migration["Streaming URL change"]
end

node_app["Spring Boot app"]
node_postgres[("PostgreSQL")]

node_event -->|"references venue"| node_venue
node_event -->|"associates artists"| node_artist
node_event -->|"owns tickets"| node_ticket
node_user -->|"assigns profile"| node_profile
node_user -->|"owns tickets"| node_ticket
node_ticket -->|"references event"| node_event
node_ticket -->|"references user"| node_user
node_event -->|"uses status/category"| node_event_enums
node_ticket -->|"uses type/status"| node_ticket_enums
node_event_repo -->|"queries"| node_event
node_ticket_repo -->|"queries"| node_ticket
node_venue_repo -->|"queries"| node_venue
node_artist_repo -->|"queries"| node_artist
node_user_repo -->|"queries"| node_user
node_schema -->|"defines tables"| node_postgres
node_artist_seed -->|"seeds artists"| node_postgres
node_streaming_migration -->|"adds column"| node_postgres

click node_app "https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/PulsepassApplication.java"
click node_venue "https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/Venue.java"
click node_event "https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/Event.java"
click node_artist "https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/Artist.java"
click node_user "https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/User.java"
click node_profile "https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/UserProfile.java"
click node_ticket "https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/Ticket.java"
click node_event_enums "https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/EventCategory.java"
click node_ticket_enums "https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/TicketType.java"
click node_event_repo "https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/repository/EventRepository.java"
click node_ticket_repo "https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/repository/TicketRepository.java"
click node_venue_repo "https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/repository/VenueRepository.java"
click node_artist_repo "https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/repository/ArtistRepository.java"
click node_user_repo "https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/repository/UserRepository.java"
click node_schema "https://github.com/luis-mart30/pulsepass/blob/main/src/main/resources/db/migration/V1__create_schema.sql"
click node_artist_seed "https://github.com/luis-mart30/pulsepass/blob/main/src/main/resources/db/migration/V2__insert_initial_artists.sql"
click node_streaming_migration "https://github.com/luis-mart30/pulsepass/blob/main/src/main/resources/db/migration/V3__add_streaming_url_to_event.sql"

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_venue,node_event,node_artist,node_user,node_profile,node_ticket,node_event_enums,node_ticket_enums toneBlue
class node_event_repo,node_ticket_repo,node_venue_repo,node_artist_repo,node_user_repo,node_postgres toneAmber
class node_schema,node_artist_seed,node_streaming_migration toneMint
class node_app toneTeal
```

## Components

### Event domain

- [Venues](https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/Venue.java): `src/main/java/com/pulsepass/domain/Venue.java`
- [Events](https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/Event.java): `src/main/java/com/pulsepass/domain/Event.java`
- [Artists](https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/Artist.java): `src/main/java/com/pulsepass/domain/Artist.java`
- [Users](https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/User.java): `src/main/java/com/pulsepass/domain/User.java`
- [User profiles](https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/UserProfile.java): `src/main/java/com/pulsepass/domain/UserProfile.java`
- [Tickets](https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/Ticket.java): `src/main/java/com/pulsepass/domain/Ticket.java`
- [Event enums](https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/EventCategory.java): `src/main/java/com/pulsepass/domain/EventCategory.java`
- [Ticket enums](https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/domain/TicketType.java): `src/main/java/com/pulsepass/domain/TicketType.java`

### Persistence access

- [Event queries](https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/repository/EventRepository.java): `src/main/java/com/pulsepass/repository/EventRepository.java`
- [Ticket queries](https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/repository/TicketRepository.java): `src/main/java/com/pulsepass/repository/TicketRepository.java`
- [Venue repository](https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/repository/VenueRepository.java): `src/main/java/com/pulsepass/repository/VenueRepository.java`
- [Artist repository](https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/repository/ArtistRepository.java): `src/main/java/com/pulsepass/repository/ArtistRepository.java`
- [User repository](https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/repository/UserRepository.java): `src/main/java/com/pulsepass/repository/UserRepository.java`

### Database schema

- [Flyway schema](https://github.com/luis-mart30/pulsepass/blob/main/src/main/resources/db/migration/V1__create_schema.sql): `src/main/resources/db/migration/V1__create_schema.sql`
- [Initial artists](https://github.com/luis-mart30/pulsepass/blob/main/src/main/resources/db/migration/V2__insert_initial_artists.sql): `src/main/resources/db/migration/V2__insert_initial_artists.sql`
- [Streaming URL change](https://github.com/luis-mart30/pulsepass/blob/main/src/main/resources/db/migration/V3__add_streaming_url_to_event.sql): `src/main/resources/db/migration/V3__add_streaming_url_to_event.sql`

### Other components

- [Spring Boot app](https://github.com/luis-mart30/pulsepass/blob/main/src/main/java/com/pulsepass/PulsepassApplication.java): `src/main/java/com/pulsepass/PulsepassApplication.java`
- **PostgreSQL**

## Connections

- Events → Venues: references venue (evidence: `src/main/java/com/pulsepass/domain/Event.java`)
- Events → Artists: associates artists (evidence: `src/main/java/com/pulsepass/domain/Event.java`)
- Events → Tickets: owns tickets (evidence: `src/main/java/com/pulsepass/domain/Event.java`)
- Users → User profiles: assigns profile (evidence: `src/main/java/com/pulsepass/domain/User.java`)
- Users → Tickets: owns tickets (evidence: `src/main/java/com/pulsepass/domain/User.java`)
- Tickets → Events: references event (evidence: `src/main/java/com/pulsepass/domain/Ticket.java`)
- Tickets → Users: references user (evidence: `src/main/java/com/pulsepass/domain/Ticket.java`)
- Events → Event enums: uses status/category (evidence: `src/main/java/com/pulsepass/domain/Event.java`)
- Tickets → Ticket enums: uses type/status (evidence: `src/main/java/com/pulsepass/domain/Ticket.java`)
- Event queries → Events: queries (evidence: `src/main/java/com/pulsepass/repository/EventRepository.java`)
- Ticket queries → Tickets: queries (evidence: `src/main/java/com/pulsepass/repository/TicketRepository.java`)
- Venue repository → Venues: queries (evidence: `src/main/java/com/pulsepass/repository/VenueRepository.java`)
- Artist repository → Artists: queries (evidence: `src/main/java/com/pulsepass/repository/ArtistRepository.java`)
- User repository → Users: queries (evidence: `src/main/java/com/pulsepass/repository/UserRepository.java`)
- Flyway schema → PostgreSQL: defines tables (evidence: `README.md`)
- Initial artists → PostgreSQL: seeds artists (evidence: `README.md`)
- Streaming URL change → PostgreSQL: adds column (evidence: `README.md`)
