# adyandreea/ticket-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/adyandreea/ticket-tracker
- Repository: https://github.com/adyandreea/ticket-tracker

## Overview

TicketTracker is a React and Spring Boot Kanban task-management application. Users sign in, browse assigned projects and boards, and create, update, search, and view tickets; administrators also manage users and project membership. The backend excerpts show service-owned persistence and project access checks, while the router and README establish frontend views and major capabilities. Several frontend/API and controller implementations were not sampled, so their detailed call relationships are not asserted.

Main entry points: [`frontend/src/routes/AppRouter.js`](https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/routes/AppRouter.js) (Protected routes), [`backend/src/main/java/com/andreea/ticket_tracker/services/ProjectService.java`](https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/services/ProjectService.java) (Project management), [`backend/src/main/java/com/andreea/ticket_tracker/services/BoardService.java`](https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/services/BoardService.java) (Board management), [`backend/src/main/java/com/andreea/ticket_tracker/services/TicketService.java`](https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/services/TicketService.java) (Ticket management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["App shell<br/>[App.js]"]
  node_router["Protected routes<br/>[AppRouter.js]"]
  node_dashboard["Dashboard<br/>[DashboardPage.js]"]
  node_project_ui["Project views<br/>[ProjectPage.js]"]
  node_board_ui["Board views<br/>[BoardPage.js]"]
  node_ticket_ui["Ticket details<br/>[TicketPage.js]"]
  node_admin_ui["Admin and profile<br/>[PermissionsPage.js]"]
  node_i18n["Translations<br/>[LanguageContext.js]"]
  node_auth_api["Authentication client<br/>[authApi.js]"]
  node_ticket_api["Ticket client<br/>[ticketApi.js]"]
  node_project_api["Project client<br/>[projectApi.js]"]
  node_board_api["Board client<br/>[boardApi.js]"]
end

subgraph group_backend["Backend API"]
  node_auth_controller["Authentication endpoints"]
  node_project_controller["Project endpoints"]
  node_board_controller["Board endpoints"]
  node_ticket_controller["Ticket endpoints"]
end

subgraph group_security["Identity and access"]
  node_authentication["Authentication service"]
  node_jwt["JWT security<br/>[JwtProvider.java]"]
  node_access["Project access checks"]
  node_users["User accounts<br/>[User.java]"]
end

subgraph group_domain["Kanban domain"]
  node_project_service["Project management"]
  node_board_service["Board management<br/>[BoardService.java]"]
  node_ticket_service["Ticket management<br/>[TicketService.java]"]
  node_projects[("Project records<br/>[Project.java]")]
  node_boards[("Board records<br/>[Board.java]")]
  node_tickets[("Ticket records<br/>[Ticket.java]")]
  node_email["Email delivery<br/>[EmailService.java]"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_router
node_router -->|"routes"| node_dashboard
node_router -->|"routes"| node_project_ui
node_router -->|"routes"| node_board_ui
node_router -->|"routes"| node_ticket_ui
node_router -->|"routes"| node_admin_ui
node_app -->|"provides"| node_i18n
node_user -.->|"submits credentials"| node_auth_api
node_auth_api -.->|"HTTP requests"| node_auth_controller
node_auth_controller -.->|"delegates"| node_authentication
node_authentication -->|"generates tokens"| node_jwt
node_authentication -->|"registers accounts"| node_users
node_project_ui -.->|"uses"| node_project_api
node_board_ui -.->|"uses"| node_board_api
node_ticket_ui -.->|"uses"| node_ticket_api
node_project_api -.->|"HTTP requests"| node_project_controller
node_board_api -.->|"HTTP requests"| node_board_controller
node_ticket_api -.->|"HTTP requests"| node_ticket_controller
node_project_controller -->|"delegates"| node_project_service
node_project_service -->|"reads and saves"| node_projects
node_project_service -->|"checks access"| node_access
node_project_service -->|"notifies members"| node_email
node_board_service -->|"reads and saves"| node_boards
node_board_service -->|"loads project"| node_projects
node_board_service -->|"checks access"| node_access
node_ticket_service -->|"reads and saves"| node_tickets
node_ticket_service -->|"checks access"| node_access
node_ticket_service -->|"notifies assignee"| node_email

click node_app "https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/App.js"
click node_router "https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/routes/AppRouter.js"
click node_dashboard "https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/features/dashboard/DashboardPage.js"
click node_project_ui "https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/features/pages/ProjectPage.js"
click node_board_ui "https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/features/pages/BoardPage.js"
click node_ticket_ui "https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/features/pages/TicketPage.js"
click node_admin_ui "https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/features/pages/PermissionsPage.js"
click node_i18n "https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/i18n/LanguageContext.js"
click node_auth_api "https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/api/authApi.js"
click node_ticket_api "https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/api/ticketApi.js"
click node_project_api "https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/api/projectApi.js"
click node_board_api "https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/api/boardApi.js"
click node_auth_controller "https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/auth/AuthenticationController.java"
click node_project_controller "https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/controllers/ProjectController.java"
click node_board_controller "https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/controllers/BoardController.java"
click node_ticket_controller "https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/controllers/TicketController.java"
click node_authentication "https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/auth/AuthenticationService.java"
click node_jwt "https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/security/config/JwtProvider.java"
click node_access "https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/security/config/ProjectSecurityEvaluator.java"
click node_users "https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/entity/User.java"
click node_project_service "https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/services/ProjectService.java"
click node_board_service "https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/services/BoardService.java"
click node_ticket_service "https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/services/TicketService.java"
click node_projects "https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/entity/Project.java"
click node_boards "https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/entity/Board.java"
click node_tickets "https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/entity/Ticket.java"
click node_email "https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/services/EmailService.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_app,node_router,node_dashboard,node_project_ui,node_board_ui,node_ticket_ui,node_admin_ui,node_i18n,node_auth_api,node_ticket_api,node_project_api,node_board_api,node_user toneBlue
class node_auth_controller,node_project_controller,node_board_controller,node_ticket_controller toneAmber
class node_authentication,node_jwt,node_access,node_users toneMint
class node_project_service,node_board_service,node_ticket_service,node_projects,node_boards,node_tickets,node_email toneRose
```

## Components

### Web application

- [App shell](https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Protected routes](https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/routes/AppRouter.js): `frontend/src/routes/AppRouter.js`
- [Dashboard](https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/features/dashboard/DashboardPage.js): `frontend/src/features/dashboard/DashboardPage.js`
- [Project views](https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/features/pages/ProjectPage.js): `frontend/src/features/pages/ProjectPage.js`
- [Board views](https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/features/pages/BoardPage.js): `frontend/src/features/pages/BoardPage.js`
- [Ticket details](https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/features/pages/TicketPage.js): `frontend/src/features/pages/TicketPage.js`
- [Admin and profile](https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/features/pages/PermissionsPage.js): `frontend/src/features/pages/PermissionsPage.js`
- [Translations](https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/i18n/LanguageContext.js): `frontend/src/i18n/LanguageContext.js`
- [Authentication client](https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/api/authApi.js): `frontend/src/api/authApi.js`
- [Ticket client](https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/api/ticketApi.js): `frontend/src/api/ticketApi.js`
- [Project client](https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/api/projectApi.js): `frontend/src/api/projectApi.js`
- [Board client](https://github.com/adyandreea/ticket-tracker/blob/main/frontend/src/api/boardApi.js): `frontend/src/api/boardApi.js`

### Backend API

- [Authentication endpoints](https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/auth/AuthenticationController.java): `backend/src/main/java/com/andreea/ticket_tracker/auth/AuthenticationController.java`
- [Project endpoints](https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/controllers/ProjectController.java): `backend/src/main/java/com/andreea/ticket_tracker/controllers/ProjectController.java`
- [Board endpoints](https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/controllers/BoardController.java): `backend/src/main/java/com/andreea/ticket_tracker/controllers/BoardController.java`
- [Ticket endpoints](https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/controllers/TicketController.java): `backend/src/main/java/com/andreea/ticket_tracker/controllers/TicketController.java`

### Identity and access

- [Authentication service](https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/auth/AuthenticationService.java): `backend/src/main/java/com/andreea/ticket_tracker/auth/AuthenticationService.java`
- [JWT security](https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/security/config/JwtProvider.java): `backend/src/main/java/com/andreea/ticket_tracker/security/config/JwtProvider.java`
- [Project access checks](https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/security/config/ProjectSecurityEvaluator.java): `backend/src/main/java/com/andreea/ticket_tracker/security/config/ProjectSecurityEvaluator.java`
- [User accounts](https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/entity/User.java): `backend/src/main/java/com/andreea/ticket_tracker/entity/User.java`

### Kanban domain

- [Project management](https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/services/ProjectService.java): `backend/src/main/java/com/andreea/ticket_tracker/services/ProjectService.java`
- [Board management](https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/services/BoardService.java): `backend/src/main/java/com/andreea/ticket_tracker/services/BoardService.java`
- [Ticket management](https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/services/TicketService.java): `backend/src/main/java/com/andreea/ticket_tracker/services/TicketService.java`
- [Project records](https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/entity/Project.java): `backend/src/main/java/com/andreea/ticket_tracker/entity/Project.java`
- [Board records](https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/entity/Board.java): `backend/src/main/java/com/andreea/ticket_tracker/entity/Board.java`
- [Ticket records](https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/entity/Ticket.java): `backend/src/main/java/com/andreea/ticket_tracker/entity/Ticket.java`
- [Email delivery](https://github.com/adyandreea/ticket-tracker/blob/main/backend/src/main/java/com/andreea/ticket_tracker/services/EmailService.java): `backend/src/main/java/com/andreea/ticket_tracker/services/EmailService.java`

### Other components

- **User**

## Connections

- User → App shell: uses
- App shell → Protected routes: renders (evidence: `frontend/src/App.js`)
- Protected routes → Dashboard: routes (evidence: `frontend/src/routes/AppRouter.js`)
- Protected routes → Project views: routes (evidence: `frontend/src/routes/AppRouter.js`)
- Protected routes → Board views: routes (evidence: `frontend/src/routes/AppRouter.js`)
- Protected routes → Ticket details: routes (evidence: `frontend/src/routes/AppRouter.js`)
- Protected routes → Admin and profile: routes (evidence: `frontend/src/routes/AppRouter.js`)
- App shell → Translations: provides (evidence: `frontend/src/App.js`)
- User → Authentication client: submits credentials
- Authentication client → Authentication endpoints: HTTP requests
- Authentication endpoints → Authentication service: delegates (evidence: `backend/src/main/java/com/andreea/ticket_tracker/auth/AuthenticationController.java`)
- Authentication service → JWT security: generates tokens (evidence: `backend/src/main/java/com/andreea/ticket_tracker/auth/AuthenticationService.java`)
- Authentication service → User accounts: registers accounts (evidence: `backend/src/main/java/com/andreea/ticket_tracker/auth/AuthenticationService.java`)
- Project views → Project client: uses
- Board views → Board client: uses
- Ticket details → Ticket client: uses (evidence: `frontend/src/features/pages/TicketPage.js`)
- Project client → Project endpoints: HTTP requests
- Board client → Board endpoints: HTTP requests
- Ticket client → Ticket endpoints: HTTP requests
- Project endpoints → Project management: delegates (evidence: `backend/src/main/java/com/andreea/ticket_tracker/controllers/ProjectController.java`)
- Project management → Project records: reads and saves (evidence: `backend/src/main/java/com/andreea/ticket_tracker/services/ProjectService.java`)
- Project management → Project access checks: checks access (evidence: `backend/src/main/java/com/andreea/ticket_tracker/services/ProjectService.java`)
- Project management → Email delivery: notifies members (evidence: `backend/src/main/java/com/andreea/ticket_tracker/services/ProjectService.java`)
- Board management → Board records: reads and saves (evidence: `backend/src/main/java/com/andreea/ticket_tracker/services/BoardService.java`)
- Board management → Project records: loads project (evidence: `backend/src/main/java/com/andreea/ticket_tracker/services/BoardService.java`)
- Board management → Project access checks: checks access (evidence: `backend/src/main/java/com/andreea/ticket_tracker/services/BoardService.java`)
- Ticket management → Ticket records: reads and saves (evidence: `backend/src/main/java/com/andreea/ticket_tracker/services/TicketService.java`)
- Ticket management → Project access checks: checks access (evidence: `backend/src/main/java/com/andreea/ticket_tracker/services/TicketService.java`)
- Ticket management → Email delivery: notifies assignee (evidence: `backend/src/main/java/com/andreea/ticket_tracker/services/TicketService.java`)
