# kaninpan/ticket-project architecture

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

- Interactive diagram: https://gitdiagram.com/kaninpan/ticket-project
- Repository: https://github.com/kaninpan/ticket-project

## Overview

Ticket Project is a Spring MVC IT-helpdesk application. Users register or sign in, submit issues with optional image attachments, and track or cancel eligible reports; administrators review and update reports, manage users, view status totals, and export Excel files. The graph separates web flows, account/security, issue handling, and persistence. The README documents capabilities beyond the excerpts; those appear as subsystem nodes, while edges are limited to relationships shown in excerpts or the README.

Main entry points: [`src/main/java/ticket/backend/controller/ProblemController.java`](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/controller/ProblemController.java) (Issue submission and tracking), [`src/main/java/ticket/backend/service/UserService.java`](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/service/UserService.java) (Account service), [`src/main/java/ticket/backend/repository`](https://github.com/kaninpan/ticket-project/tree/main/src/main/java/ticket/backend/repository) (User repositories), [`src/main/resources/templates/home`](https://github.com/kaninpan/ticket-project/tree/main/src/main/resources/templates/home) (Admin pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_user_pages["User pages"]
  node_admin_pages["Admin pages"]
  node_site_assets["Browser assets"]
end

subgraph group_accounts["Accounts and access"]
  node_registration_profile["Registration and profile"]
  node_user_service["Account service<br/>[UserService.java]"]
  node_auth_details["Principal details"]
  node_security["Security configuration"]
  node_custom_auth["Authentication lookup<br/>[CustomAuthen.java]"]
  node_account_admin["Admin user management"]
  node_account_admin_service["User administration service"]
  node_add_user["Back-office user creation"]
  node_add_user_service["User creation service"]
end

subgraph group_issues["Issue workflow"]
  node_issue_entry["Issue submission and tracking"]
  node_issue_service["Issue service"]
  node_issue_admin["Admin issue reports"]
  node_issue_report_service["Report and export service"]
  node_dashboard["Status dashboard"]
  node_uploads["Issue attachments"]
end

subgraph group_data["Persistence"]
  node_user_entity["User record<br/>[UserEntity.java]"]
  node_problem_entity["Issue record<br/>[ProblemEntity.java]"]
  node_user_repos[("User repositories")]
  node_problem_repos[("Issue repositories")]
  node_sql_examples["SQL examples"]
end

node_user(("User"))
node_admin(("Administrator"))

node_user -->|"uses"| node_user_pages
node_admin -->|"uses"| node_admin_pages
node_user_pages -.->|"submits requests"| node_registration_profile
node_admin_pages -.->|"submits requests"| node_account_admin
node_admin_pages -.->|"submits requests"| node_issue_admin
node_registration_profile -->|"calls"| node_user_service
node_user_service -->|"queries and saves"| node_user_repos
node_user_repos -->|"maps"| node_user_entity
node_security -->|"configures"| node_custom_auth
node_user_service -->|"creates"| node_auth_details
node_account_admin -->|"calls"| node_account_admin_service
node_account_admin_service -.->|"uses"| node_user_repos
node_add_user -->|"calls"| node_add_user_service
node_add_user_service -.->|"persists users"| node_user_repos
node_issue_entry -->|"saves reports"| node_issue_service
node_issue_service -->|"saves and counts"| node_problem_repos
node_issue_entry -->|"lists and cancels"| node_problem_repos
node_problem_repos -->|"maps"| node_problem_entity
node_issue_admin -.->|"calls"| node_issue_report_service
node_issue_report_service -->|"reads and saves"| node_problem_repos
node_dashboard -->|"counts statuses"| node_user_service
node_issue_entry -->|"stores attachments"| node_uploads
node_user -->|"reports and tracks"| node_issue_entry
node_admin -->|"views totals"| node_dashboard
node_admin -->|"manages reports"| node_issue_admin
node_admin -->|"manages users"| node_account_admin
node_user -.->|"loads"| node_site_assets
node_sql_examples -.->|"schema example"| node_user_entity
node_sql_examples -.->|"schema example"| node_problem_entity

click node_user_pages "https://github.com/kaninpan/ticket-project/tree/main/src/main/resources/templates/home"
click node_admin_pages "https://github.com/kaninpan/ticket-project/tree/main/src/main/resources/templates/home"
click node_site_assets "https://github.com/kaninpan/ticket-project/tree/main/src/main/resources/static"
click node_registration_profile "https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/controller/UserController.java"
click node_user_service "https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/service/UserService.java"
click node_auth_details "https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/service/UserDetailsImpl.java"
click node_security "https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/config/SecurityConfig.java"
click node_custom_auth "https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/config/CustomAuthen.java"
click node_account_admin "https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/controller/UserinfoController.java"
click node_account_admin_service "https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/service/UserinfoService.java"
click node_add_user "https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/controller/AdduserController.java"
click node_add_user_service "https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/service/AddusersService.java"
click node_issue_entry "https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/controller/ProblemController.java"
click node_issue_service "https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/service/ProblemService.java"
click node_issue_admin "https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/controller/ProblemReportController.java"
click node_issue_report_service "https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/service/ProblemReportService.java"
click node_dashboard "https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/controller/UserController.java"
click node_uploads "https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/controller/ProblemController.java"
click node_user_entity "https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/entity/UserEntity.java"
click node_problem_entity "https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/entity/ProblemEntity.java"
click node_user_repos "https://github.com/kaninpan/ticket-project/tree/main/src/main/java/ticket/backend/repository"
click node_problem_repos "https://github.com/kaninpan/ticket-project/tree/main/src/main/java/ticket/backend/repository"
click node_sql_examples "https://github.com/kaninpan/ticket-project/tree/main/filedb/dbname%20-%20ticket_project_db"

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_user_pages,node_admin_pages,node_site_assets,node_user toneBlue
class node_registration_profile,node_user_service,node_auth_details,node_security,node_custom_auth,node_account_admin,node_account_admin_service,node_add_user,node_add_user_service toneAmber
class node_issue_entry,node_issue_service,node_issue_admin,node_issue_report_service,node_dashboard,node_uploads toneMint
class node_user_entity,node_problem_entity,node_user_repos,node_problem_repos,node_sql_examples toneRose
class node_admin toneIndigo
```

## Components

### Web interface

- [User pages](https://github.com/kaninpan/ticket-project/tree/main/src/main/resources/templates/home): `src/main/resources/templates/home`
- [Admin pages](https://github.com/kaninpan/ticket-project/tree/main/src/main/resources/templates/home): `src/main/resources/templates/home`
- [Browser assets](https://github.com/kaninpan/ticket-project/tree/main/src/main/resources/static): `src/main/resources/static`

### Accounts and access

- [Registration and profile](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/controller/UserController.java): `src/main/java/ticket/backend/controller/UserController.java`
- [Account service](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/service/UserService.java): `src/main/java/ticket/backend/service/UserService.java`
- [Principal details](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/service/UserDetailsImpl.java): `src/main/java/ticket/backend/service/UserDetailsImpl.java`
- [Security configuration](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/config/SecurityConfig.java): `src/main/java/ticket/backend/config/SecurityConfig.java`
- [Authentication lookup](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/config/CustomAuthen.java): `src/main/java/ticket/backend/config/CustomAuthen.java`
- [Admin user management](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/controller/UserinfoController.java): `src/main/java/ticket/backend/controller/UserinfoController.java`
- [User administration service](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/service/UserinfoService.java): `src/main/java/ticket/backend/service/UserinfoService.java`
- [Back-office user creation](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/controller/AdduserController.java): `src/main/java/ticket/backend/controller/AdduserController.java`
- [User creation service](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/service/AddusersService.java): `src/main/java/ticket/backend/service/AddusersService.java`

### Issue workflow

- [Issue submission and tracking](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/controller/ProblemController.java): `src/main/java/ticket/backend/controller/ProblemController.java`
- [Issue service](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/service/ProblemService.java): `src/main/java/ticket/backend/service/ProblemService.java`
- [Admin issue reports](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/controller/ProblemReportController.java): `src/main/java/ticket/backend/controller/ProblemReportController.java`
- [Report and export service](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/service/ProblemReportService.java): `src/main/java/ticket/backend/service/ProblemReportService.java`
- [Status dashboard](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/controller/UserController.java): `src/main/java/ticket/backend/controller/UserController.java`
- [Issue attachments](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/controller/ProblemController.java): `src/main/java/ticket/backend/controller/ProblemController.java`

### Persistence

- [User record](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/entity/UserEntity.java): `src/main/java/ticket/backend/entity/UserEntity.java`
- [Issue record](https://github.com/kaninpan/ticket-project/blob/main/src/main/java/ticket/backend/entity/ProblemEntity.java): `src/main/java/ticket/backend/entity/ProblemEntity.java`
- [User repositories](https://github.com/kaninpan/ticket-project/tree/main/src/main/java/ticket/backend/repository): `src/main/java/ticket/backend/repository`
- [Issue repositories](https://github.com/kaninpan/ticket-project/tree/main/src/main/java/ticket/backend/repository): `src/main/java/ticket/backend/repository`
- [SQL examples](https://github.com/kaninpan/ticket-project/tree/main/filedb/dbname%20-%20ticket_project_db): `filedb/dbname - ticket_project_db`

### Other components

- **User**
- **Administrator**

## Connections

- User → User pages: uses (evidence: `README.md`)
- Administrator → Admin pages: uses (evidence: `README.md`)
- User pages → Registration and profile: submits requests
- Admin pages → Admin user management: submits requests
- Admin pages → Admin issue reports: submits requests
- Registration and profile → Account service: calls (evidence: `src/main/java/ticket/backend/controller/UserController.java`)
- Account service → User repositories: queries and saves (evidence: `src/main/java/ticket/backend/service/UserService.java`)
- User repositories → User record: maps (evidence: `src/main/java/ticket/backend/repository/UserRepository.java`)
- Security configuration → Authentication lookup: configures (evidence: `src/main/java/ticket/backend/config/SecurityConfig.java`)
- Account service → Principal details: creates (evidence: `src/main/java/ticket/backend/service/UserService.java`)
- Admin user management → User administration service: calls (evidence: `src/main/java/ticket/backend/controller/UserinfoController.java`)
- User administration service → User repositories: uses (evidence: `src/main/java/ticket/backend/service/UserinfoService.java`)
- Back-office user creation → User creation service: calls (evidence: `src/main/java/ticket/backend/controller/AdduserController.java`)
- User creation service → User repositories: persists users (evidence: `src/main/java/ticket/backend/service/AddusersService.java`)
- Issue submission and tracking → Issue service: saves reports (evidence: `src/main/java/ticket/backend/controller/ProblemController.java`)
- Issue service → Issue repositories: saves and counts (evidence: `src/main/java/ticket/backend/service/ProblemService.java`)
- Issue submission and tracking → Issue repositories: lists and cancels (evidence: `src/main/java/ticket/backend/controller/ProblemController.java`)
- Issue repositories → Issue record: maps (evidence: `src/main/java/ticket/backend/repository/ProblemRepository.java`)
- Admin issue reports → Report and export service: calls (evidence: `src/main/java/ticket/backend/controller/ProblemReportController.java`)
- Report and export service → Issue repositories: reads and saves (evidence: `src/main/java/ticket/backend/service/ProblemReportService.java`)
- Status dashboard → Account service: counts statuses (evidence: `src/main/java/ticket/backend/controller/UserController.java`)
- Issue submission and tracking → Issue attachments: stores attachments (evidence: `src/main/java/ticket/backend/controller/ProblemController.java`)
- User → Issue submission and tracking: reports and tracks (evidence: `README.md`)
- Administrator → Status dashboard: views totals (evidence: `README.md`)
- Administrator → Admin issue reports: manages reports (evidence: `README.md`)
- Administrator → Admin user management: manages users (evidence: `README.md`)
- User → Browser assets: loads
- SQL examples → User record: schema example
- SQL examples → Issue record: schema example
