# white-spring/devtools architecture

> Architecture diagram of the GitHub repository white-spring/devtools, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/white-spring/devtools
- Repository: https://github.com/white-spring/devtools

## Overview

##### Project type and purpose
- This is a Spring Boot–based backend microservice (no frontend) called “devtools.”
- Its purpose is to expose REST endpoints for AES encryption/decryption and JSON formatting utilities.

##### File structure
- Top-level:
- pom.xml (build/dependencies)
- src/main/java/com/white/dvt – the main application package
- src/main/resources/application.yml (configuration)
- Within com.white.dvt:
- DevToolsApplication.java – Spring Boot entry point
- controller/v1 – REST controllers (AesController, JsonController)
- core/exception – centralized exception handling (ErrorException, ExceptionHandler, ExceptionResponse)
- domain/service – business logic services (AesService, JSONService)
- utils – low-level helper classes (EncryptionUtil, JsonUtils)

##### README
- Minimal README (“# devtools”) confirms project name and that it’s a developer tools API.
- No additional architectural notes, so rely on file structure to infer layers.

## Diagram (Mermaid)

```mermaid
flowchart TD
    Client["API Client (e.g., Postman)"]:::external
    Config["application.yml"]:::config
    pom["pom.xml"]:::config
    DevApp["DevToolsApplication"]:::framework
    Dispatcher["DispatcherServlet"]:::framework

    subgraph "Controller Layer"
      AesController["AesController"]:::controller
      JsonController["JsonController"]:::controller
    end

    subgraph "Service Layer"
      AesService["AesService"]:::service
      JSONService["JSONService"]:::service
    end

    subgraph "Utility Layer"
      EncryptionUtil["EncryptionUtil"]:::util
      JsonUtils["JsonUtils"]:::util
    end

    subgraph "Exception Handling"
      ErrorException["ErrorException"]:::exception
      ExceptionHandler["ExceptionHandler"]:::exception
      ExceptionResponse["ExceptionResponse"]:::exception
    end

    Client -->|"HTTP Request"| DevApp
    Config --> DevApp
    pom --> DevApp
    DevApp --> Dispatcher

    Dispatcher --> AesController
    Dispatcher --> JsonController

    AesController -->|"calls"| AesService
    JsonController -->|"calls"| JSONService

    AesService --> EncryptionUtil
    JSONService --> JsonUtils

    EncryptionUtil --> AesService
    JsonUtils --> JSONService

    AesController -->|"HTTP Response"| Client
    JsonController -->|"HTTP Response"| Client

    ErrorException --> ExceptionHandler
    ExceptionHandler --> ExceptionResponse
    ExceptionResponse -->|"Error Response"| Client

    classDef external fill:#EDEDED,stroke:#bbb
    classDef config fill:#CCCCCC,stroke:#888
    classDef framework fill:#D0E6A5,stroke:#7AA945
    classDef controller fill:#A5D8FF,stroke:#1A73E8
    classDef service fill:#B8FFA5,stroke:#57A900
    classDef util fill:#FFD8A5,stroke:#FFA600
    classDef exception fill:#FFAAAA,stroke:#D80000

    click DevApp "https://github.com/white-spring/devtools/blob/main/src/main/java/com/white/dvt/DevToolsApplication.java"
    click Config "https://github.com/white-spring/devtools/blob/main/src/main/resources/application.yml"
    click pom "https://github.com/white-spring/devtools/blob/main/pom.xml"
    click AesController "https://github.com/white-spring/devtools/blob/main/src/main/java/com/white/dvt/controller/v1/AesController.java"
    click JsonController "https://github.com/white-spring/devtools/blob/main/src/main/java/com/white/dvt/controller/v1/JsonController.java"
    click AesService "https://github.com/white-spring/devtools/blob/main/src/main/java/com/white/dvt/domain/service/AesService.java"
    click JSONService "https://github.com/white-spring/devtools/blob/main/src/main/java/com/white/dvt/domain/service/JSONService.java"
    click EncryptionUtil "https://github.com/white-spring/devtools/blob/main/src/main/java/com/white/dvt/utils/EncryptionUtil.java"
    click JsonUtils "https://github.com/white-spring/devtools/blob/main/src/main/java/com/white/dvt/utils/JsonUtils.java"
    click ErrorException "https://github.com/white-spring/devtools/blob/main/src/main/java/com/white/dvt/core/exception/ErrorException.java"
    click ExceptionHandler "https://github.com/white-spring/devtools/blob/main/src/main/java/com/white/dvt/core/exception/ExceptionHandler.java"
    click ExceptionResponse "https://github.com/white-spring/devtools/blob/main/src/main/java/com/white/dvt/core/exception/ExceptionResponse.java"
```
