# shankar-va/spring_security1 architecture

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

- Interactive diagram: https://gitdiagram.com/shankar-va/spring_security1
- Repository: https://github.com/shankar-va/spring_security1

## Overview

This appears to be a Spring Security application for public endpoints and JWT-based authentication and authorization, with user, role, and privilege data. The likely workflow runs from an HTTP request through the public controller and security components, using user details and repositories to support identity and access checks. The tree also shows request/response DTOs and a user mapper. No README or source excerpts were provided, so the relationships below are unverified; dashed edges mark likely interactions, not inspected calls.

Main entry points: [`src/main/java/com/example/demo/controller/Public.java`](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/controller/Public.java) (Public controller), [`src/main/java/com/example/demo/security/SecurityConfig.java`](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/security/SecurityConfig.java) (Security configuration), [`src/main/java/com/example/demo/security/jwt/JwtFilter.java`](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/security/jwt/JwtFilter.java) (JWT filter), [`src/main/java/com/example/demo/security/CustomUserDetailsService.java`](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/security/CustomUserDetailsService.java) (User details service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_public_controller["Public controller<br/>[Public.java]"]
  node_login_request["Login request<br/>[LoginRequest.java]"]
  node_user_request["User request"]
  node_auth_response["Auth response<br/>[AuthResponse.java]"]
end

subgraph group_security["Security"]
  node_security_config["Security configuration"]
  node_jwt_filter["JWT filter<br/>[JwtFilter.java]"]
  node_jwt_service["JWT service<br/>[JwtService.java]"]
  node_access_denied["Access denied handler"]
  node_auth_entry["Authentication entry point"]
end

subgraph group_identity["Identity and access"]
  node_user_details_service["User details service"]
  node_custom_user_details["Custom user details"]
  node_user_repository["User repository"]
  node_role_repository["Role repository"]
  node_user_entity["User<br/>[User.java]"]
  node_role_entity["Role<br/>[Role.java]"]
  node_privilege_entity["Privilege<br/>[Privilege.java]"]
  node_user_mapper["User mapper<br/>[UserMapper.java]"]
end

node_client(("HTTP client"))

node_client -.->|"sends request"| node_public_controller
node_public_controller -.->|"uses input"| node_login_request
node_public_controller -.->|"uses input"| node_user_request
node_public_controller -.->|"returns response"| node_auth_response
node_security_config -.->|"registers filter"| node_jwt_filter
node_jwt_filter -.->|"uses tokens"| node_jwt_service
node_jwt_filter -.->|"loads identity"| node_user_details_service
node_security_config -.->|"configures handler"| node_access_denied
node_security_config -.->|"configures entry point"| node_auth_entry
node_user_details_service -.->|"loads user"| node_user_repository
node_user_details_service -.->|"creates details"| node_custom_user_details
node_user_repository -.->|"reads users"| node_user_entity
node_role_repository -.->|"reads roles"| node_role_entity
node_user_mapper -.->|"maps user"| node_user_entity
node_user_entity -.->|"has role"| node_role_entity
node_role_entity -.->|"has privilege"| node_privilege_entity

click node_public_controller "https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/controller/Public.java"
click node_login_request "https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/dto/LoginRequest.java"
click node_user_request "https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/dto/UserRequestDTO.java"
click node_auth_response "https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/dto/AuthResponse.java"
click node_security_config "https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/security/SecurityConfig.java"
click node_jwt_filter "https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/security/jwt/JwtFilter.java"
click node_jwt_service "https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/security/jwt/JwtService.java"
click node_access_denied "https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/security/CustomAccessDeniedHandler.java"
click node_auth_entry "https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/security/CustomAuthenticationEntryPoint.java"
click node_user_details_service "https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/security/CustomUserDetailsService.java"
click node_custom_user_details "https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/security/CustomUserDetails.java"
click node_user_repository "https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/repository/UserRepository.java"
click node_role_repository "https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/repository/RoleRepository.java"
click node_user_entity "https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/entity/User.java"
click node_role_entity "https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/entity/Role.java"
click node_privilege_entity "https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/entity/Privilege.java"
click node_user_mapper "https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/mapper/UserMapper.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_public_controller,node_login_request,node_user_request,node_auth_response,node_client toneBlue
class node_security_config,node_jwt_filter,node_jwt_service,node_access_denied,node_auth_entry toneAmber
class node_user_details_service,node_custom_user_details,node_user_repository,node_role_repository,node_user_entity,node_role_entity,node_privilege_entity,node_user_mapper toneMint
```

## Components

### HTTP API

- [Public controller](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/controller/Public.java): `src/main/java/com/example/demo/controller/Public.java`
- [Login request](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/dto/LoginRequest.java): `src/main/java/com/example/demo/dto/LoginRequest.java`
- [User request](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/dto/UserRequestDTO.java): `src/main/java/com/example/demo/dto/UserRequestDTO.java`
- [Auth response](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/dto/AuthResponse.java): `src/main/java/com/example/demo/dto/AuthResponse.java`

### Security

- [Security configuration](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/security/SecurityConfig.java): `src/main/java/com/example/demo/security/SecurityConfig.java`
- [JWT filter](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/security/jwt/JwtFilter.java): `src/main/java/com/example/demo/security/jwt/JwtFilter.java`
- [JWT service](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/security/jwt/JwtService.java): `src/main/java/com/example/demo/security/jwt/JwtService.java`
- [Access denied handler](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/security/CustomAccessDeniedHandler.java): `src/main/java/com/example/demo/security/CustomAccessDeniedHandler.java`
- [Authentication entry point](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/security/CustomAuthenticationEntryPoint.java): `src/main/java/com/example/demo/security/CustomAuthenticationEntryPoint.java`

### Identity and access

- [User details service](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/security/CustomUserDetailsService.java): `src/main/java/com/example/demo/security/CustomUserDetailsService.java`
- [Custom user details](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/security/CustomUserDetails.java): `src/main/java/com/example/demo/security/CustomUserDetails.java`
- [User repository](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/repository/UserRepository.java): `src/main/java/com/example/demo/repository/UserRepository.java`
- [Role repository](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/repository/RoleRepository.java): `src/main/java/com/example/demo/repository/RoleRepository.java`
- [User](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/entity/User.java): `src/main/java/com/example/demo/entity/User.java`
- [Role](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/entity/Role.java): `src/main/java/com/example/demo/entity/Role.java`
- [Privilege](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/entity/Privilege.java): `src/main/java/com/example/demo/entity/Privilege.java`
- [User mapper](https://github.com/shankar-va/spring_security1/blob/master/src/main/java/com/example/demo/mapper/UserMapper.java): `src/main/java/com/example/demo/mapper/UserMapper.java`

### Other components

- **HTTP client**

## Connections

- HTTP client → Public controller: sends request
- Public controller → Login request: uses input
- Public controller → User request: uses input
- Public controller → Auth response: returns response
- Security configuration → JWT filter: registers filter
- JWT filter → JWT service: uses tokens
- JWT filter → User details service: loads identity
- Security configuration → Access denied handler: configures handler
- Security configuration → Authentication entry point: configures entry point
- User details service → User repository: loads user
- User details service → Custom user details: creates details
- User repository → User: reads users
- Role repository → Role: reads roles
- User mapper → User: maps user
- User → Role: has role
- Role → Privilege: has privilege
