# sonalisahu728/bugtracker-fullstack architecture

> Architecture diagram of the GitHub repository sonalisahu728/bugtracker-fullstack, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sonalisahu728/bugtracker-fullstack
- Repository: https://github.com/sonalisahu728/bugtracker-fullstack

## Overview

Bugtracker is a project-based issue-tracking backend, with a small JavaScript API client. Users authenticate, work within projects and memberships, create and progress assigned issues, and discuss them through comments. The backend separates HTTP controllers, domain services, persistence repositories, entities/DTOs, and JWT-based identity loading. Service excerpts show the issue, project, and comment operations and their repository calls; the README is empty, and the frontend client’s relationship to the backend is not established by the sampled evidence.

Main entry points: [`backend/src/main/java/com/bugtracker/repository`](https://github.com/sonalisahu728/bugtracker-fullstack/tree/main/backend/src/main/java/com/bugtracker/repository) (JPA Repositories), [`backend/src/main/java/com/bugtracker/service/AuthService.java`](https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/service/AuthService.java) (Authentication), [`backend/src/main/java/com/bugtracker/service/ProjectService.java`](https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/service/ProjectService.java) (Project Management), [`backend/src/main/java/com/bugtracker/service/IssueService.java`](https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/service/IssueService.java) (Issue Workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_auth_controller["Auth Controller"]
  node_project_controller["Project Controller"]
  node_issue_controller["Issue Controller"]
  node_comment_controller["Comment Controller"]
  node_api_client["API Client<br/>[api.js]"]
end

subgraph group_auth["Identity and Security"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_user_details["User Details Loader"]
  node_jwt["JWT Utility<br/>[JwtUtil.java]"]
  node_jwt_filter["JWT Filter<br/>[JwtAuthFilter.java]"]
end

subgraph group_work["Project and Issue Work"]
  node_project_service["Project Management"]
  node_issue_service["Issue Workflow<br/>[IssueService.java]"]
  node_comment_service["Issue Comments"]
end

subgraph group_data["Domain and Persistence"]
  node_entities["Domain Entities"]
  node_dtos["Request and Response DTOs"]
  node_repositories["JPA Repositories"]
end

node_user(("User"))

node_user -->|"authenticates"| node_auth_controller
node_auth_controller -->|"delegates"| node_auth_service
node_auth_service -->|"loads identity"| node_user_details
node_auth_service -->|"creates token"| node_jwt
node_jwt_filter -->|"validates token"| node_jwt
node_jwt_filter -->|"loads identity"| node_user_details
node_auth_service -->|"reads and saves users"| node_repositories
node_user_details -->|"finds user"| node_repositories
node_project_controller -->|"delegates"| node_project_service
node_issue_controller -->|"delegates"| node_issue_service
node_comment_controller -->|"delegates"| node_comment_service
node_project_service -->|"reads and writes"| node_repositories
node_issue_service -->|"reads and writes"| node_repositories
node_comment_service -->|"reads and writes"| node_repositories
node_issue_service -->|"uses issue domain"| node_entities
node_project_service -->|"uses project domain"| node_entities
node_comment_service -->|"uses comment domain"| node_entities
node_issue_service -->|"builds responses"| node_dtos
node_project_service -->|"builds responses"| node_dtos
node_comment_service -->|"builds responses"| node_dtos
node_api_client -.-> node_user

click node_auth_controller "https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/controller/AuthController.java"
click node_project_controller "https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/controller/ProjectController.java"
click node_issue_controller "https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/controller/IssueController.java"
click node_comment_controller "https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/controller/CommentController.java"
click node_api_client "https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/frontend/js/api.js"
click node_auth_service "https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/service/AuthService.java"
click node_user_details "https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/security/CustomUserDetailsService.java"
click node_jwt "https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/security/JwtUtil.java"
click node_jwt_filter "https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/security/JwtAuthFilter.java"
click node_project_service "https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/service/ProjectService.java"
click node_issue_service "https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/service/IssueService.java"
click node_comment_service "https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/service/CommentService.java"
click node_entities "https://github.com/sonalisahu728/bugtracker-fullstack/tree/main/backend/src/main/java/com/bugtracker/entity"
click node_dtos "https://github.com/sonalisahu728/bugtracker-fullstack/tree/main/backend/src/main/java/com/bugtracker/dto"
click node_repositories "https://github.com/sonalisahu728/bugtracker-fullstack/tree/main/backend/src/main/java/com/bugtracker/repository"

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_auth_controller,node_project_controller,node_issue_controller,node_comment_controller,node_api_client,node_user toneBlue
class node_auth_service,node_user_details,node_jwt,node_jwt_filter toneAmber
class node_project_service,node_issue_service,node_comment_service toneMint
class node_entities,node_dtos,node_repositories toneRose
```

## Components

### HTTP API

- [Auth Controller](https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/controller/AuthController.java): `backend/src/main/java/com/bugtracker/controller/AuthController.java`
- [Project Controller](https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/controller/ProjectController.java): `backend/src/main/java/com/bugtracker/controller/ProjectController.java`
- [Issue Controller](https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/controller/IssueController.java): `backend/src/main/java/com/bugtracker/controller/IssueController.java`
- [Comment Controller](https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/controller/CommentController.java): `backend/src/main/java/com/bugtracker/controller/CommentController.java`
- [API Client](https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/frontend/js/api.js): `frontend/js/api.js`

### Identity and Security

- [Authentication](https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/service/AuthService.java): `backend/src/main/java/com/bugtracker/service/AuthService.java`
- [User Details Loader](https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/security/CustomUserDetailsService.java): `backend/src/main/java/com/bugtracker/security/CustomUserDetailsService.java`
- [JWT Utility](https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/security/JwtUtil.java): `backend/src/main/java/com/bugtracker/security/JwtUtil.java`
- [JWT Filter](https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/security/JwtAuthFilter.java): `backend/src/main/java/com/bugtracker/security/JwtAuthFilter.java`

### Project and Issue Work

- [Project Management](https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/service/ProjectService.java): `backend/src/main/java/com/bugtracker/service/ProjectService.java`
- [Issue Workflow](https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/service/IssueService.java): `backend/src/main/java/com/bugtracker/service/IssueService.java`
- [Issue Comments](https://github.com/sonalisahu728/bugtracker-fullstack/blob/main/backend/src/main/java/com/bugtracker/service/CommentService.java): `backend/src/main/java/com/bugtracker/service/CommentService.java`

### Domain and Persistence

- [Domain Entities](https://github.com/sonalisahu728/bugtracker-fullstack/tree/main/backend/src/main/java/com/bugtracker/entity): `backend/src/main/java/com/bugtracker/entity`
- [Request and Response DTOs](https://github.com/sonalisahu728/bugtracker-fullstack/tree/main/backend/src/main/java/com/bugtracker/dto): `backend/src/main/java/com/bugtracker/dto`
- [JPA Repositories](https://github.com/sonalisahu728/bugtracker-fullstack/tree/main/backend/src/main/java/com/bugtracker/repository): `backend/src/main/java/com/bugtracker/repository`

### Other components

- **User**

## Connections

- User → Auth Controller: authenticates (evidence: `backend/src/main/java/com/bugtracker/controller/AuthController.java`)
- Auth Controller → Authentication: delegates (evidence: `backend/src/main/java/com/bugtracker/controller/AuthController.java`)
- Authentication → User Details Loader: loads identity (evidence: `backend/src/main/java/com/bugtracker/service/AuthService.java`)
- Authentication → JWT Utility: creates token (evidence: `backend/src/main/java/com/bugtracker/service/AuthService.java`)
- JWT Filter → JWT Utility: validates token (evidence: `backend/src/main/java/com/bugtracker/security/JwtAuthFilter.java`)
- JWT Filter → User Details Loader: loads identity (evidence: `backend/src/main/java/com/bugtracker/security/JwtAuthFilter.java`)
- Authentication → JPA Repositories: reads and saves users (evidence: `backend/src/main/java/com/bugtracker/service/AuthService.java`)
- User Details Loader → JPA Repositories: finds user (evidence: `backend/src/main/java/com/bugtracker/security/CustomUserDetailsService.java`)
- Project Controller → Project Management: delegates (evidence: `backend/src/main/java/com/bugtracker/controller/ProjectController.java`)
- Issue Controller → Issue Workflow: delegates (evidence: `backend/src/main/java/com/bugtracker/controller/IssueController.java`)
- Comment Controller → Issue Comments: delegates (evidence: `backend/src/main/java/com/bugtracker/controller/CommentController.java`)
- Project Management → JPA Repositories: reads and writes (evidence: `backend/src/main/java/com/bugtracker/service/ProjectService.java`)
- Issue Workflow → JPA Repositories: reads and writes (evidence: `backend/src/main/java/com/bugtracker/service/IssueService.java`)
- Issue Comments → JPA Repositories: reads and writes (evidence: `backend/src/main/java/com/bugtracker/service/CommentService.java`)
- Issue Workflow → Domain Entities: uses issue domain (evidence: `backend/src/main/java/com/bugtracker/service/IssueService.java`)
- Project Management → Domain Entities: uses project domain (evidence: `backend/src/main/java/com/bugtracker/service/ProjectService.java`)
- Issue Comments → Domain Entities: uses comment domain (evidence: `backend/src/main/java/com/bugtracker/service/CommentService.java`)
- Issue Workflow → Request and Response DTOs: builds responses (evidence: `backend/src/main/java/com/bugtracker/service/IssueService.java`)
- Project Management → Request and Response DTOs: builds responses (evidence: `backend/src/main/java/com/bugtracker/service/ProjectService.java`)
- Issue Comments → Request and Response DTOs: builds responses (evidence: `backend/src/main/java/com/bugtracker/service/CommentService.java`)
- API Client → User
