How jnobr3c/helpdesk-api works
Helpdesk API is a Spring Boot REST service for managing customers, technicians, and support tickets. A client request reaches the REST resources, whose services apply CRUD and ticket-assignment rules before using JPA repositories and the configured database. Authentication is a separate path: Spring Security uses JWT filters and user lookup to authenticate requests and enforce role-based access. The README documents H2/MySQL support and the principal capabilities; some resource and security wiring is unsampled, so only documented or indexed relationships are shown.
Main entry points: ChamadoService.java Ticket Service · JWTAuthenticationFilter.java JWT Authentication · ClienteService.java Customer Service · TecnicoService.java Technician Service
Components 21
REST API
- Customer Endpoints
src/main/java/com/nobre/helpdesk/resources/ClienteResource.java - Technician Endpoints
src/main/java/com/nobre/helpdesk/resources/TecnicoResource.java - Ticket Endpoints
src/main/java/com/nobre/helpdesk/resources/ChamadoResource.java - API Error Mapping
src/main/java/com/nobre/helpdesk/resources/exceptions/ResourceExceptionHandler.java
Helpdesk Domain
- Customer Service
src/main/java/com/nobre/helpdesk/services/ClienteService.java - Technician Service
src/main/java/com/nobre/helpdesk/services/TecnicoService.java - Ticket Service
src/main/java/com/nobre/helpdesk/services/ChamadoService.java - Entities, DTOs & Enums
src/main/java/com/nobre/helpdesk/domain
JWT Security
- Security Configuration
src/main/java/com/nobre/helpdesk/config/SecurityConfig.java - JWT Authentication
src/main/java/com/nobre/helpdesk/security/JWTAuthenticationFilter.java - JWT Authorization
src/main/java/com/nobre/helpdesk/security/JWTAuthorizationFilter.java - JWT Utilities
src/main/java/com/nobre/helpdesk/security/JWTUtil.java - User Lookup
src/main/java/com/nobre/helpdesk/services/UserDetailsServiceImpl.java - Security Principal
src/main/java/com/nobre/helpdesk/security/UserSS.java
Persistence
- Customer Repository
src/main/java/com/nobre/helpdesk/repositories/ClienteRepository.java - Technician Repository
src/main/java/com/nobre/helpdesk/repositories/TecnicoRepository.java - Ticket Repository
src/main/java/com/nobre/helpdesk/repositories/ChamadoRepository.java - Person Repository
src/main/java/com/nobre/helpdesk/repositories/PessoaRepository.java - Relational Database
- Sample Data Setup
src/main/java/com/nobre/helpdesk/services/DBService.java
Other components
- API Client
Connections 28
- API Client → Customer Endpoints: manages customers
README.md - API Client → Technician Endpoints: manages technicians
README.md - API Client → Ticket Endpoints: manages tickets
README.md - Customer Endpoints → Customer Service: delegates to
src/main/java/com/nobre/helpdesk/resources/ClienteResource.java - Technician Endpoints → Technician Service: delegates to
src/main/java/com/nobre/helpdesk/resources/TecnicoResource.java - Ticket Endpoints → Ticket Service: delegates to
README.md - Customer Service → Customer Repository: reads and writes
src/main/java/com/nobre/helpdesk/services/ClienteService.java - Customer Service → Person Repository: checks identity
src/main/java/com/nobre/helpdesk/services/ClienteService.java - Technician Service → Technician Repository: reads and writes
src/main/java/com/nobre/helpdesk/services/TecnicoService.java - Technician Service → Person Repository: checks identity
src/main/java/com/nobre/helpdesk/services/TecnicoService.java - Ticket Service → Ticket Repository: reads and writes
src/main/java/com/nobre/helpdesk/services/ChamadoService.java - Ticket Service → Technician Service: looks up technician
src/main/java/com/nobre/helpdesk/services/ChamadoService.java - Ticket Service → Customer Service: looks up customer
src/main/java/com/nobre/helpdesk/services/ChamadoService.java - Customer Repository → Relational Database: persists entities
README.md - Technician Repository → Relational Database: persists entities
README.md - Ticket Repository → Relational Database: persists entities
README.md - Person Repository → Relational Database: persists entities
README.md - Sample Data Setup → Technician Repository: saves sample data
src/main/java/com/nobre/helpdesk/services/DBService.java - Sample Data Setup → Customer Repository: saves sample data
src/main/java/com/nobre/helpdesk/services/DBService.java - Sample Data Setup → Ticket Repository: saves sample data
src/main/java/com/nobre/helpdesk/services/DBService.java - Security Configuration → JWT Authentication: configures filter
src/main/java/com/nobre/helpdesk/config/SecurityConfig.java - Security Configuration → JWT Authorization: configures filter
src/main/java/com/nobre/helpdesk/config/SecurityConfig.java - JWT Authentication → JWT Utilities: creates tokens
src/main/java/com/nobre/helpdesk/security/JWTAuthenticationFilter.java - JWT Authorization → JWT Utilities: validates tokens
src/main/java/com/nobre/helpdesk/security/JWTAuthorizationFilter.java - JWT Authentication → User Lookup: loads identity
- User Lookup → Person Repository: finds user
src/main/java/com/nobre/helpdesk/services/UserDetailsServiceImpl.java - User Lookup → Security Principal: builds principal
src/main/java/com/nobre/helpdesk/services/UserDetailsServiceImpl.java - JWT Authentication → Security Principal: uses principal
src/main/java/com/nobre/helpdesk/security/JWTAuthenticationFilter.java