# digao791/ticket-systems architecture

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

- Interactive diagram: https://gitdiagram.com/digao791/ticket-systems
- Repository: https://github.com/digao791/ticket-systems

## Overview

Tickets is a Spring Boot web application for project-based ticket tracking. A signed-in user views project and ticket pages, creates tickets, and records comments, ownership changes, and status changes; services mediate persistence through Spring Data repositories. The README documents authentication, project organization, activity tracking, and PostgreSQL persistence. Source excerpts show the ticket, project, and activity paths directly; comments and security are represented from the source index and README, so their internal wiring is not expanded beyond supported relationships.

Main entry points: [`src/main/java/com/rodrigo/tickets/controller/web/TicketPageController.java`](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/controller/web/TicketPageController.java) (Page routes), [`src/main/java/com/rodrigo/tickets/service/ProjectService.java`](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/service/ProjectService.java) (Project service), [`src/main/java/com/rodrigo/tickets/repository/TicketRepository.java`](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/repository/TicketRepository.java) (Ticket store access), [`src/main/java/com/rodrigo/tickets/repository/UserRepository.java`](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/repository/UserRepository.java) (User store access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web and Access"]
  node_pages["Page routes"]
  node_home["Project home"]
  node_login["Login routes"]
end

subgraph group_work["Project and Ticket Work"]
  node_projectservice["Project service"]
  node_ticketservice["Ticket service<br/>[TicketService.java]"]
  node_activityservice["Activity service"]
  node_commentservice["Comment service"]
  node_domain["Ticket domain<br/>[Ticket.java]"]
  node_activitydomain["Activity records"]
  node_projectdomain["Project records<br/>[Project.java]"]
end

subgraph group_identity["Identity and Security"]
  node_security["Route security"]
  node_userdetails["User lookup"]
  node_userservice["User service<br/>[UserService.java]"]
end

subgraph group_persistence["Persistence"]
  node_ticketrepo["Ticket store access"]
  node_activityrepo["Activity store access"]
  node_projectrepo["Project store access"]
  node_userrepo["User store access"]
  node_commentrepo["Comment store access"]
  node_dbstatus["Database monitoring"]
end

node_browser(("Web user"))
node_postgres[("PostgreSQL")]

node_browser -->|"requests pages"| node_pages
node_browser -->|"signs in"| node_login
node_pages -->|"loads and creates"| node_ticketservice
node_pages -->|"loads and records"| node_activityservice
node_pages -->|"loads project"| node_projectservice
node_pages -->|"loads users"| node_userservice
node_home -->|"lists projects"| node_projectservice
node_home -->|"loads user"| node_userservice
node_login -.->|"authenticates via"| node_security
node_security -.->|"authenticates through"| node_userdetails
node_userdetails -->|"looks up user"| node_userrepo
node_userservice -->|"reads users"| node_userrepo
node_ticketservice -->|"reads and saves"| node_ticketrepo
node_ticketservice -->|"resolves owner"| node_userrepo
node_ticketservice -->|"resolves project"| node_projectrepo
node_projectservice -->|"loads projects"| node_projectrepo
node_projectservice -->|"counts tickets"| node_ticketrepo
node_projectservice -->|"reads recent activity"| node_activityrepo
node_activityservice -->|"loads ticket"| node_ticketrepo
node_activityservice -->|"resolves owner"| node_userrepo
node_activityservice -->|"reads and saves"| node_activityrepo
node_commentservice -->|"reads and saves"| node_commentrepo
node_commentservice -->|"resolves ticket"| node_ticketrepo
node_ticketrepo -.->|"persists tickets"| node_postgres
node_activityrepo -.->|"persists activities"| node_postgres
node_projectrepo -.->|"persists projects"| node_postgres
node_userrepo -.->|"persists users"| node_postgres
node_commentrepo -.->|"persists comments"| node_postgres
node_dbstatus -->|"checks connection"| node_postgres

click node_pages "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/controller/web/TicketPageController.java"
click node_home "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/controller/web/HomeController.java"
click node_login "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/controller/web/LoginController.java"
click node_security "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/config/SecurityConfig.java"
click node_userdetails "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/security/CustomUserDetailsService.java"
click node_userservice "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/service/UserService.java"
click node_projectservice "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/service/ProjectService.java"
click node_ticketservice "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/service/TicketService.java"
click node_activityservice "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/service/TicketActivityService.java"
click node_commentservice "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/service/CommentService.java"
click node_domain "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/entity/Ticket.java"
click node_activitydomain "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/entity/TicketActivity.java"
click node_projectdomain "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/entity/Project.java"
click node_ticketrepo "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/repository/TicketRepository.java"
click node_activityrepo "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/repository/TicketActivityRepository.java"
click node_projectrepo "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/repository/ProjectRepository.java"
click node_userrepo "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/repository/UserRepository.java"
click node_commentrepo "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/repository/CommentRepository.java"
click node_dbstatus "https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/database/DatabaseStatusService.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_pages,node_home,node_login,node_browser toneBlue
class node_projectservice,node_ticketservice,node_activityservice,node_commentservice,node_domain,node_activitydomain,node_projectdomain,node_postgres toneAmber
class node_security,node_userdetails,node_userservice toneMint
class node_ticketrepo,node_activityrepo,node_projectrepo,node_userrepo,node_commentrepo,node_dbstatus toneRose
```

## Components

### Web and Access

- [Page routes](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/controller/web/TicketPageController.java): `src/main/java/com/rodrigo/tickets/controller/web/TicketPageController.java`
- [Project home](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/controller/web/HomeController.java): `src/main/java/com/rodrigo/tickets/controller/web/HomeController.java`
- [Login routes](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/controller/web/LoginController.java): `src/main/java/com/rodrigo/tickets/controller/web/LoginController.java`

### Project and Ticket Work

- [Project service](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/service/ProjectService.java): `src/main/java/com/rodrigo/tickets/service/ProjectService.java`
- [Ticket service](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/service/TicketService.java): `src/main/java/com/rodrigo/tickets/service/TicketService.java`
- [Activity service](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/service/TicketActivityService.java): `src/main/java/com/rodrigo/tickets/service/TicketActivityService.java`
- [Comment service](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/service/CommentService.java): `src/main/java/com/rodrigo/tickets/service/CommentService.java`
- [Ticket domain](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/entity/Ticket.java): `src/main/java/com/rodrigo/tickets/entity/Ticket.java`
- [Activity records](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/entity/TicketActivity.java): `src/main/java/com/rodrigo/tickets/entity/TicketActivity.java`
- [Project records](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/entity/Project.java): `src/main/java/com/rodrigo/tickets/entity/Project.java`

### Identity and Security

- [Route security](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/config/SecurityConfig.java): `src/main/java/com/rodrigo/tickets/config/SecurityConfig.java`
- [User lookup](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/security/CustomUserDetailsService.java): `src/main/java/com/rodrigo/tickets/security/CustomUserDetailsService.java`
- [User service](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/service/UserService.java): `src/main/java/com/rodrigo/tickets/service/UserService.java`

### Persistence

- [Ticket store access](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/repository/TicketRepository.java): `src/main/java/com/rodrigo/tickets/repository/TicketRepository.java`
- [Activity store access](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/repository/TicketActivityRepository.java): `src/main/java/com/rodrigo/tickets/repository/TicketActivityRepository.java`
- [Project store access](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/repository/ProjectRepository.java): `src/main/java/com/rodrigo/tickets/repository/ProjectRepository.java`
- [User store access](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/repository/UserRepository.java): `src/main/java/com/rodrigo/tickets/repository/UserRepository.java`
- [Comment store access](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/repository/CommentRepository.java): `src/main/java/com/rodrigo/tickets/repository/CommentRepository.java`
- [Database monitoring](https://github.com/digao791/ticket-systems/blob/main/src/main/java/com/rodrigo/tickets/database/DatabaseStatusService.java): `src/main/java/com/rodrigo/tickets/database/DatabaseStatusService.java`

### Other components

- **Web user**
- **PostgreSQL**

## Connections

- Web user → Page routes: requests pages (evidence: `README.md`)
- Web user → Login routes: signs in (evidence: `README.md`)
- Page routes → Ticket service: loads and creates (evidence: `src/main/java/com/rodrigo/tickets/controller/web/TicketPageController.java`)
- Page routes → Activity service: loads and records (evidence: `src/main/java/com/rodrigo/tickets/controller/web/TicketPageController.java`)
- Page routes → Project service: loads project (evidence: `src/main/java/com/rodrigo/tickets/controller/web/TicketPageController.java`)
- Page routes → User service: loads users (evidence: `src/main/java/com/rodrigo/tickets/controller/web/TicketPageController.java`)
- Project home → Project service: lists projects (evidence: `src/main/java/com/rodrigo/tickets/controller/web/HomeController.java`)
- Project home → User service: loads user (evidence: `src/main/java/com/rodrigo/tickets/controller/web/HomeController.java`)
- Login routes → Route security: authenticates via (evidence: `README.md`)
- Route security → User lookup: authenticates through (evidence: `README.md`)
- User lookup → User store access: looks up user (evidence: `src/main/java/com/rodrigo/tickets/security/CustomUserDetailsService.java`)
- User service → User store access: reads users (evidence: `src/main/java/com/rodrigo/tickets/service/UserService.java`)
- Ticket service → Ticket store access: reads and saves (evidence: `src/main/java/com/rodrigo/tickets/service/TicketService.java`)
- Ticket service → User store access: resolves owner (evidence: `src/main/java/com/rodrigo/tickets/service/TicketService.java`)
- Ticket service → Project store access: resolves project (evidence: `src/main/java/com/rodrigo/tickets/service/TicketService.java`)
- Project service → Project store access: loads projects (evidence: `src/main/java/com/rodrigo/tickets/service/ProjectService.java`)
- Project service → Ticket store access: counts tickets (evidence: `src/main/java/com/rodrigo/tickets/service/ProjectService.java`)
- Project service → Activity store access: reads recent activity (evidence: `src/main/java/com/rodrigo/tickets/service/ProjectService.java`)
- Activity service → Ticket store access: loads ticket (evidence: `src/main/java/com/rodrigo/tickets/service/TicketActivityService.java`)
- Activity service → User store access: resolves owner (evidence: `src/main/java/com/rodrigo/tickets/service/TicketActivityService.java`)
- Activity service → Activity store access: reads and saves (evidence: `src/main/java/com/rodrigo/tickets/service/TicketActivityService.java`)
- Comment service → Comment store access: reads and saves (evidence: `src/main/java/com/rodrigo/tickets/service/CommentService.java`)
- Comment service → Ticket store access: resolves ticket (evidence: `src/main/java/com/rodrigo/tickets/service/CommentService.java`)
- Ticket store access → PostgreSQL: persists tickets (evidence: `README.md`)
- Activity store access → PostgreSQL: persists activities (evidence: `README.md`)
- Project store access → PostgreSQL: persists projects (evidence: `README.md`)
- User store access → PostgreSQL: persists users (evidence: `README.md`)
- Comment store access → PostgreSQL: persists comments (evidence: `README.md`)
- Database monitoring → PostgreSQL: checks connection (evidence: `README.md`)
