# hiepnx03/2025-01-quan-ly-nhan-su architecture

> Architecture diagram of the GitHub repository hiepnx03/2025-01-quan-ly-nhan-su, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-31). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hiepnx03/2025-01-quan-ly-nhan-su
- Repository: https://github.com/hiepnx03/2025-01-quan-ly-nhan-su

## Overview

##### Main System Components

a) Presentation Layer (API Layer)
- REST Controllers grouped by functionality:
- Authentication endpoints
- Admin endpoints
- HR Management endpoints
- Swagger documentation integration

b) Security Layer
- JWT Authentication filter
- Security configuration
- Token management (including blacklist)

c) Business Layer
- Service layer with all business logic
- Converters for DTO transformations
- Utility services

d) Data Access Layer
- Repositories
- Entity models
- Database connection

##### Component Relationships

**[Client Applications] ←→ [API Gateway/Swagger]**
- ↓
**[Security Layer (JWT Filter)]**
- ↓
**[Controllers] → [DTOs]**
- ↓
**[Services] ←→ [Converters]**
- ↓
**[Repositories]**
- ↓
**[Database]**

##### Specific Implementation Details

Key technical aspects:
- Spring Boot 3.4.1 as the main framework
- JWT Authentication flow
- ModelMapper for object mapping
- MySQL database connection
- Email service for password recovery
- Pagination implementation

##### Additional Elements

Supporting components:
- Configuration classes
- Exception handling
- Utility services
- External integrations (email service)

- Client Layer  |

- ↓

- Security Layer |

- ↓

- Service Layer |

- ↓

- Data Layer  |

##### Key Features to Highlight

System capabilities:
- Authentication and authorization flow
- HR management workflows
- Document management
- User management
- Employee records management

Remember to show the relationship between different HR management modules (Canbo, Chucvu, Bacluong, etc.) as they form the core business logic of the system.

This approach will provide a clear visualization of how the system components interact while maintaining the specific context of an HR management application.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Client Layer
    Client[Client Applications]
    
    %% API Gateway/Swagger
    subgraph API_Layer[API Layer]
        Swagger["Swagger Documentation"]:::config
        MainControllers["Main Controllers"]:::controller
        AdminControllers["Admin Controllers"]:::controller
        AuthController["Authentication Controller"]:::controller
    end
    
    %% Security Layer
    subgraph Security_Layer[Security Layer]
        JWTFilter["JWT Filter"]:::security
        SecurityConfig["Security Configuration"]:::security
        JWTUtils["JWT Utils"]:::security
        TokenBlacklist["Token Blacklist"]:::security
    end
    
    %% Business Layer
    subgraph Business_Layer[Business Layer]
        Services["Service Layer"]:::service
        DTOs["DTOs"]:::service
        Converters["Converters"]:::service
    end
    
    %% Data Layer
    subgraph Data_Layer[Data Layer]
        Repositories["Repositories"]:::data
        Entities["Entities"]:::data
        BaseEntity["Base Entity"]:::data
    end
    
    %% Cross-cutting Concerns
    subgraph CrossCutting[Cross-cutting Concerns]
        Config["Configurations"]:::util
        ExceptionHandler["Exception Handler"]:::util
        Constants["Constants"]:::util
        Utils["Utilities"]:::util
    end
    
    %% Core HR Components
    subgraph HR_Core[Core HR Components]
        EmployeeMgmt["Employee Management"]:::hr
        PositionMgmt["Position Management"]:::hr
        ContractMgmt["Contract Management"]:::hr
        SalaryMgmt["Salary Management"]:::hr
    end
    
    %% Relationships
    Client --> API_Layer
    API_Layer --> Security_Layer
    Security_Layer --> Business_Layer
    Business_Layer --> Data_Layer
    HR_Core --> Business_Layer
    
    %% Click Events
    click Swagger "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/blob/main/demo/src/main/java/com/example/demo/config/SwaggerConfig.java"
    click MainControllers "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/tree/main/demo/src/main/java/com/example/demo/controller/"
    click AdminControllers "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/tree/main/demo/src/main/java/com/example/demo/controller/admin/"
    click AuthController "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/blob/main/demo/src/main/java/com/example/demo/controller/AuthenticationController.java"
    click JWTFilter "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/blob/main/demo/src/main/java/com/example/demo/filter/JwtFilter.java"
    click SecurityConfig "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/blob/main/demo/src/main/java/com/example/demo/config/SecurityConfig.java"
    click JWTUtils "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/blob/main/demo/src/main/java/com/example/demo/utils/JwtUtils.java"
    click TokenBlacklist "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/blob/main/demo/src/main/java/com/example/demo/utils/TokenBlacklist.java"
    click Services "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/tree/main/demo/src/main/java/com/example/demo/service/"
    click DTOs "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/tree/main/demo/src/main/java/com/example/demo/dto/"
    click Converters "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/tree/main/demo/src/main/java/com/example/demo/converter/"
    click Repositories "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/tree/main/demo/src/main/java/com/example/demo/repository/"
    click Entities "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/tree/main/demo/src/main/java/com/example/demo/entity/"
    click BaseEntity "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/blob/main/demo/src/main/java/com/example/demo/entity/Base.java"
    click Config "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/tree/main/demo/src/main/java/com/example/demo/config/"
    click ExceptionHandler "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/blob/main/demo/src/main/java/com/example/demo/exception/GlobalExceptionHandler.java"
    click Constants "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/tree/main/demo/src/main/java/com/example/demo/constants/"
    click Utils "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/tree/main/demo/src/main/java/com/example/demo/utils/"
    click EmployeeMgmt "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/blob/main/demo/src/main/java/com/example/demo/controller/CanboController.java"
    click PositionMgmt "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/blob/main/demo/src/main/java/com/example/demo/controller/ChucvuController.java"
    click ContractMgmt "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/blob/main/demo/src/main/java/com/example/demo/controller/HopdongcanboController.java"
    click SalaryMgmt "https://github.com/hiepnx03/2025-01-Quan-Ly-Nhan-Su/blob/main/demo/src/main/java/com/example/demo/controller/QuatrinhluongController.java"
    
    %% Styles
    classDef controller fill:#2196F3,stroke:#000,stroke-width:1px;
    classDef security fill:#FFC107,stroke:#000,stroke-width:1px;
    classDef service fill:#4CAF50,stroke:#000,stroke-width:1px;
    classDef data fill:#FF9800,stroke:#000,stroke-width:1px;
    classDef util fill:#9C27B0,stroke:#000,stroke-width:1px;
    classDef hr fill:#00BCD4,stroke:#000,stroke-width:1px;
    classDef config fill:#607D8B,stroke:#000,stroke-width:1px;
```
