# anteman-swe/java_backend_uppgift_2 architecture

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

- Interactive diagram: https://gitdiagram.com/anteman-swe/java_backend_uppgift_2
- Repository: https://github.com/anteman-swe/java_backend_uppgift_2

## Overview

This is a Spring Boot helpdesk application for users, support agents, and administrators. The main workflow starts with a browser request, passes through role-protected web pages and ticket handling, and presents ticket or comment results in server-rendered views; agents can manage assignments and status, while admins manage users. The README documents Spring Security, JPA, and PostgreSQL, but no application source was excerpted. Thus, documented relationships are shown with README evidence; unverified internal calls between controllers, services, and repositories are omitted.

Main entry points: [`src/main/java/com/example/helpdesk/controller/TicketController.java`](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/controller/TicketController.java) (Ticket Routes), [`src/main/java/com/example/helpdesk/controller/AgentController.java`](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/controller/AgentController.java) (Agent Routes), [`src/main/java/com/example/helpdesk/controller/AdminController.java`](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/controller/AdminController.java) (Admin Routes), [`src/main/java/com/example/helpdesk/security/SecurityConfig.java`](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/security/SecurityConfig.java) (Security Rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web Interface"]
  node_home["Home Routes"]
  node_ticket_web["Ticket Routes"]
  node_agent_web["Agent Routes"]
  node_admin_web["Admin Routes"]
  node_ticket_views["Ticket Views"]
  node_agent_views["Agent Views"]
  node_admin_views["Admin Views"]
end

subgraph group_workflow["Helpdesk Workflows"]
  node_ticket_service["Ticket Logic<br/>[TicketService.java]"]
  node_comment_service["Comment Logic"]
  node_user_service["User Management<br/>[UserService.java]"]
end

subgraph group_security["Access Control"]
  node_security_config["Security Rules"]
  node_identity["User Identity"]
end

subgraph group_data["Persistence"]
  node_ticket_repo["Ticket Store Access"]
  node_comment_repo["Comment Store Access"]
  node_user_repo["User Store Access"]
  node_ticket_entity["Ticket Records<br/>[Ticket.java]"]
  node_comment_entity["Comment Records<br/>[Comment.java]"]
  node_user_entity["User Records<br/>[User.java]"]
  node_postgres[("PostgreSQL")]
end

node_browser(("User Browser"))

node_browser -->|"opens home"| node_home
node_browser -->|"requests tickets"| node_ticket_web
node_browser -->|"requests agent work"| node_agent_web
node_browser -->|"requests administration"| node_admin_web
node_ticket_web -.->|"renders pages"| node_ticket_views
node_agent_web -.->|"renders pages"| node_agent_views
node_admin_web -.->|"renders pages"| node_admin_views
node_ticket_web -.->|"delegates ticket work"| node_ticket_service
node_ticket_web -.->|"delegates comments"| node_comment_service
node_agent_web -.->|"manages tickets"| node_ticket_service
node_admin_web -.->|"manages users"| node_user_service
node_ticket_repo -->|"persists data"| node_postgres
node_comment_repo -->|"persists data"| node_postgres
node_user_repo -->|"persists data"| node_postgres
node_browser -->|"authenticates"| node_security_config
node_security_config -.->|"loads user identity"| node_identity

click node_home "https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/controller/HomeController.java"
click node_ticket_web "https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/controller/TicketController.java"
click node_agent_web "https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/controller/AgentController.java"
click node_admin_web "https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/controller/AdminController.java"
click node_ticket_views "https://github.com/anteman-swe/java_backend_uppgift_2/tree/main/src/main/resources/templates/tickets"
click node_agent_views "https://github.com/anteman-swe/java_backend_uppgift_2/tree/main/src/main/resources/templates/agent"
click node_admin_views "https://github.com/anteman-swe/java_backend_uppgift_2/tree/main/src/main/resources/templates/admin"
click node_ticket_service "https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/service/TicketService.java"
click node_comment_service "https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/service/CommentService.java"
click node_user_service "https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/service/UserService.java"
click node_security_config "https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/security/SecurityConfig.java"
click node_identity "https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/security/CustomUserDetailsService.java"
click node_ticket_repo "https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/repository/TicketRepository.java"
click node_comment_repo "https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/repository/CommentRepository.java"
click node_user_repo "https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/repository/UserRepository.java"
click node_ticket_entity "https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/entity/Ticket.java"
click node_comment_entity "https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/entity/Comment.java"
click node_user_entity "https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/entity/User.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_home,node_ticket_web,node_agent_web,node_admin_web,node_ticket_views,node_agent_views,node_admin_views,node_browser toneBlue
class node_ticket_service,node_comment_service,node_user_service toneAmber
class node_security_config,node_identity toneMint
class node_ticket_repo,node_comment_repo,node_user_repo,node_ticket_entity,node_comment_entity,node_user_entity,node_postgres toneRose
```

## Components

### Web Interface

- [Home Routes](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/controller/HomeController.java): `src/main/java/com/example/helpdesk/controller/HomeController.java`
- [Ticket Routes](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/controller/TicketController.java): `src/main/java/com/example/helpdesk/controller/TicketController.java`
- [Agent Routes](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/controller/AgentController.java): `src/main/java/com/example/helpdesk/controller/AgentController.java`
- [Admin Routes](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/controller/AdminController.java): `src/main/java/com/example/helpdesk/controller/AdminController.java`
- [Ticket Views](https://github.com/anteman-swe/java_backend_uppgift_2/tree/main/src/main/resources/templates/tickets): `src/main/resources/templates/tickets`
- [Agent Views](https://github.com/anteman-swe/java_backend_uppgift_2/tree/main/src/main/resources/templates/agent): `src/main/resources/templates/agent`
- [Admin Views](https://github.com/anteman-swe/java_backend_uppgift_2/tree/main/src/main/resources/templates/admin): `src/main/resources/templates/admin`

### Helpdesk Workflows

- [Ticket Logic](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/service/TicketService.java): `src/main/java/com/example/helpdesk/service/TicketService.java`
- [Comment Logic](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/service/CommentService.java): `src/main/java/com/example/helpdesk/service/CommentService.java`
- [User Management](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/service/UserService.java): `src/main/java/com/example/helpdesk/service/UserService.java`

### Access Control

- [Security Rules](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/security/SecurityConfig.java): `src/main/java/com/example/helpdesk/security/SecurityConfig.java`
- [User Identity](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/security/CustomUserDetailsService.java): `src/main/java/com/example/helpdesk/security/CustomUserDetailsService.java`

### Persistence

- [Ticket Store Access](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/repository/TicketRepository.java): `src/main/java/com/example/helpdesk/repository/TicketRepository.java`
- [Comment Store Access](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/repository/CommentRepository.java): `src/main/java/com/example/helpdesk/repository/CommentRepository.java`
- [User Store Access](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/repository/UserRepository.java): `src/main/java/com/example/helpdesk/repository/UserRepository.java`
- [Ticket Records](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/entity/Ticket.java): `src/main/java/com/example/helpdesk/entity/Ticket.java`
- [Comment Records](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/entity/Comment.java): `src/main/java/com/example/helpdesk/entity/Comment.java`
- [User Records](https://github.com/anteman-swe/java_backend_uppgift_2/blob/main/src/main/java/com/example/helpdesk/entity/User.java): `src/main/java/com/example/helpdesk/entity/User.java`
- **PostgreSQL**

### Other components

- **User Browser**

## Connections

- User Browser → Home Routes: opens home (evidence: `README.md`)
- User Browser → Ticket Routes: requests tickets (evidence: `README.md`)
- User Browser → Agent Routes: requests agent work (evidence: `README.md`)
- User Browser → Admin Routes: requests administration (evidence: `README.md`)
- Ticket Routes → Ticket Views: renders pages
- Agent Routes → Agent Views: renders pages
- Admin Routes → Admin Views: renders pages
- Ticket Routes → Ticket Logic: delegates ticket work
- Ticket Routes → Comment Logic: delegates comments
- Agent Routes → Ticket Logic: manages tickets
- Admin Routes → User Management: manages users
- Ticket Store Access → PostgreSQL: persists data (evidence: `README.md`)
- Comment Store Access → PostgreSQL: persists data (evidence: `README.md`)
- User Store Access → PostgreSQL: persists data (evidence: `README.md`)
- User Browser → Security Rules: authenticates (evidence: `README.md`)
- Security Rules → User Identity: loads user identity
