# clasei/flowx-server architecture

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

- Interactive diagram: https://gitdiagram.com/clasei/flowx-server
- Repository: https://github.com/clasei/flowx-server

## Overview

##### Project type and purpose
- This is a standalone backend service (“flowx-server”), implemented in Spring Boot, exposing a REST API for task management.
- It persists data in PostgreSQL and secures endpoints using JWT-based authentication.

##### File structure
- src/main/java/com/flowx/FlowxServerApplication.java – the Spring Boot entry point
- controllers/ – REST controllers (AuthController, TaskController, plus a global exception handler)
- services/ – business logic (TaskService)
- repositories/ – Spring Data JPA repositories (UserRepository, TaskRepository)
- models/ – domain entities (User, Task, TaskPriority)
- security/ – JWT filter, token utilities, authentication token, Spring Security configuration
- pom.xml, .mvn, mvnw etc. – Maven build system
- Dockerfile – containerization instructions
- src/test – unit/integration tests

##### README
- Confirms this is a “Spring Boot API with PostgreSQL for handling tasks smoothly.”

##### Detail without over‐splitting
– Highlight cross‐cutting concerns (exception handling, security).
– Include build/deploy artifacts (Docker container, Maven) as peripheral elements.

## Diagram (Mermaid)

```mermaid
flowchart TD
    Client["Client\n(Web/Mobile/cURL)"]:::external

    subgraph "flowx-server (Spring Boot App)"
        direction TB
        SB1["JwtFilter"]:::security
        SB2["JwtUtil"]:::security
        SB3["JwtAuthenticationToken"]:::security
        SB4["SecurityConfig"]:::security

        subgraph "Controllers"
            direction TB
            C1["AuthController"]:::controller
            C2["TaskController"]:::controller
            C3["GlobalExceptionHandler"]:::controller
        end

        subgraph "Services"
            direction TB
            S1["TaskService"]:::service
        end

        subgraph "Repositories"
            direction TB
            R1["UserRepository"]:::repository
            R2["TaskRepository"]:::repository
        end

        subgraph "Models"
            direction TB
            M1["User"]:::model
            M2["Task"]:::model
            M3["TaskPriority"]:::model
        end
    end

    DB["PostgreSQL Database"]:::db
    Infra1["Docker Container"]:::infra
    Infra2["Maven (pom.xml)"]:::infra

    %% Flows
    Client -->|"HTTP Request"| SB1
    SB1 -->|"Validate JWT"| SB2
    SB2 -->|"Parse/Generate Token"| SB3
    SB4 -->|"Configure Filter"| SB1

    SB1 --> C1
    SB1 --> C2

    C1 -->|"login request"| SB2
    C2 -->|"task operations"| S1
    C3 -->|"handles exceptions"| C1
    C3 -->|"handles exceptions"| C2

    S1 -->|"business logic"| R1
    S1 -->|"business logic"| R2

    R1 -->|"JPA CRUD"| DB
    R2 -->|"JPA CRUD"| DB

    Infra1 -.->|"Containerizes"| flowx-server
    Infra2 -.->|"Builds"| flowx-server

    %% Click Events
    click SB1 "https://github.com/clasei/flowx-server/blob/main/src/main/java/com/flowx/security/JwtFilter.java"
    click SB2 "https://github.com/clasei/flowx-server/blob/main/src/main/java/com/flowx/security/JwtUtil.java"
    click SB3 "https://github.com/clasei/flowx-server/blob/main/src/main/java/com/flowx/security/JwtAuthenticationToken.java"
    click SB4 "https://github.com/clasei/flowx-server/blob/main/src/main/java/com/flowx/security/SecurityConfig.java"
    click C1 "https://github.com/clasei/flowx-server/blob/main/src/main/java/com/flowx/controllers/AuthController.java"
    click C2 "https://github.com/clasei/flowx-server/blob/main/src/main/java/com/flowx/controllers/TaskController.java"
    click C3 "https://github.com/clasei/flowx-server/blob/main/src/main/java/com/flowx/controllers/GlobalExceptionHandler.java"
    click S1 "https://github.com/clasei/flowx-server/blob/main/src/main/java/com/flowx/services/TaskService.java"
    click R1 "https://github.com/clasei/flowx-server/blob/main/src/main/java/com/flowx/repositories/UserRepository.java"
    click R2 "https://github.com/clasei/flowx-server/blob/main/src/main/java/com/flowx/repositories/TaskRepository.java"
    click M1 "https://github.com/clasei/flowx-server/blob/main/src/main/java/com/flowx/models/User.java"
    click M2 "https://github.com/clasei/flowx-server/blob/main/src/main/java/com/flowx/models/Task.java"
    click M3 "https://github.com/clasei/flowx-server/blob/main/src/main/java/com/flowx/models/TaskPriority.java"
    click Infra1 "https://github.com/clasei/flowx-server/tree/main/Dockerfile"
    click Infra2 "https://github.com/clasei/flowx-server/blob/main/pom.xml"

    %% Styles
    classDef external fill:#E8F1FB,stroke:#6C8EBF,stroke-width:2px;
    classDef security fill:#FDECEF,stroke:#D9534F,stroke-width:2px;
    classDef controller fill:#E8F8F5,stroke:#20A8D8,stroke-width:2px;
    classDef service fill:#FFF4E5,stroke:#FFB822,stroke-width:2px;
    classDef repository fill:#EBF5FB,stroke:#5BC0DE,stroke-width:2px;
    classDef model fill:#F0F3F5,stroke:#63717E,stroke-width:2px;
    classDef db fill:#E8F5E9,stroke:#4CAF50,stroke-width:2px,stroke-dasharray: 5 5;
    classDef infra fill:#F5F5F5,stroke:#AAA,stroke-width:2px,stroke-dasharray: 2 2;
```
