# viniaguiar1/spring-todo-list architecture

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

- Interactive diagram: https://gitdiagram.com/viniaguiar1/spring-todo-list
- Repository: https://github.com/viniaguiar1/spring-todo-list

## Overview

##### Project type and purpose
- This is a backend REST‐API service (no UI code here) implementing a To-Do List using Spring Boot (Java 17).
- It follows an MVC-style, layered approach: Controllers expose HTTP endpoints, Spring Data JPA repositories handle persistence to an in-memory H2 database, and a Servlet Filter enforces request-level authentication (password hashing with Bcrypt is set up for future user auth).

##### File structure
- Top-level artifacts:
- DockerFile, pom.xml, Maven wrapper (.mvn, mvnw) – build and containerization
- src/main/java/br/com/viniciusaguiar/todolist – code for controllers, filters, models, repos, exception handler, utils
- src/main/resources/application.properties – Spring/H2 config
- src/test – Spring Boot integration/test classes
- Key directories:
- filter – implements authentication filter (FilterTaskAuth)
- task & user – each with Model, Repository interface, Controller
- errors – centralized exception handler (ExceptionHandlerController)
- utils – helper code

##### README insights
- Confirms Spring Boot 3.3.3, Spring Data JPA, H2 in-memory, Lombok, Bcrypt.
- Endpoints: /tasks (GET, POST), /tasks/{id} (PUT, DELETE).
- H2 console endpoint and credentials.

## Diagram (Mermaid)

```mermaid
flowchart TB
    client["Client (Postman/Browser)"]:::client
    api["TodolistApplication\n(Spring Boot HTTP Layer)"]:::web
    filter["FilterTaskAuth\n(Authentication Filter)"]:::crosscut
    exception["ExceptionHandlerController"]:::crosscut

    subgraph Controllers
        taskCtrl["TaskController"]:::web
        userCtrl["UserController"]:::web
    end

    subgraph Repositories
        taskRepo["ITaskRepository"]:::db
        userRepo["IUserRepository"]:::db
    end

    subgraph Models
        taskModel["TaskModel"]:::model
        userModel["UserModel"]:::model
    end

    db["H2 Database\n(in-memory)"]:::dbstore
    config["application.properties\n(H2 Config)"]:::infra
    utils["Utils"]:::util

    subgraph Infra
        build["pom.xml\n(Maven Build)"]:::infra
        docker["DockerFile"]:::infra
        mavenw["Maven Wrapper"]:::infra
    end

    tests["TodolistApplicationTests"]:::test

    client -->|"HTTP Request"| api
    api -->|"filterChain"| filter
    filter -->|"valid request"| taskCtrl
    filter -->|"valid request"| userCtrl
    filter -->|"uses hashing"| utils

    taskCtrl -->|"save()/find()/delete()"| taskRepo
    userCtrl -->|"save()/find()"| userRepo

    taskRepo -->|"CRUD"| db
    userRepo -->|"CRUD"| db

    taskCtrl -->|"returns response"| client
    userCtrl -->|"returns response"| client

    taskCtrl -.->|"errors"| exception
    userCtrl -.->|"errors"| exception
    filter -.->|"auth errors"| exception
    exception -->|"error response"| client

    config --> db

    build --> docker
    build --> mavenw

    tests -->|"integration tests"| taskCtrl
    tests -->|"integration tests"| userCtrl

    click api "https://github.com/viniaguiar1/spring-todo-list/blob/main/src/main/java/br/com/viniciusaguiar/todolist/TodolistApplication.java"
    click filter "https://github.com/viniaguiar1/spring-todo-list/blob/main/src/main/java/br/com/viniciusaguiar/todolist/filter/FilterTaskAuth.java"
    click taskCtrl "https://github.com/viniaguiar1/spring-todo-list/blob/main/src/main/java/br/com/viniciusaguiar/todolist/task/TaskController.java"
    click userCtrl "https://github.com/viniaguiar1/spring-todo-list/blob/main/src/main/java/br/com/viniciusaguiar/todolist/user/UserController.java"
    click exception "https://github.com/viniaguiar1/spring-todo-list/blob/main/src/main/java/br/com/viniciusaguiar/todolist/errors/ExceptionHandlerController.java"
    click taskRepo "https://github.com/viniaguiar1/spring-todo-list/blob/main/src/main/java/br/com/viniciusaguiar/todolist/task/ITaskRepository.java"
    click userRepo "https://github.com/viniaguiar1/spring-todo-list/blob/main/src/main/java/br/com/viniciusaguiar/todolist/user/IUserRepository.java"
    click taskModel "https://github.com/viniaguiar1/spring-todo-list/blob/main/src/main/java/br/com/viniciusaguiar/todolist/task/TaskModel.java"
    click userModel "https://github.com/viniaguiar1/spring-todo-list/blob/main/src/main/java/br/com/viniciusaguiar/todolist/user/UserModel.java"
    click utils "https://github.com/viniaguiar1/spring-todo-list/blob/main/src/main/java/br/com/viniciusaguiar/todolist/utils/Utils.java"
    click config "https://github.com/viniaguiar1/spring-todo-list/blob/main/src/main/resources/application.properties"
    click build "https://github.com/viniaguiar1/spring-todo-list/blob/main/pom.xml"
    click docker "https://github.com/viniaguiar1/spring-todo-list/tree/main/DockerFile"
    click mavenw "https://github.com/viniaguiar1/spring-todo-list/tree/main/mvnw"
    click tests "https://github.com/viniaguiar1/spring-todo-list/blob/main/src/test/java/br/com/viniciusaguiar/todolist/TodolistApplicationTests.java"

    classDef client fill:#E8F1FA,stroke:#1E73BE,color:#1E73BE;
    classDef web fill:#D1E8FF,stroke:#389EE0,color:#389EE0;
    classDef crosscut fill:#FFE8B3,stroke:#E09B00,color:#E09B00;
    classDef db fill:#E2F0D9,stroke:#66A345,color:#66A345;
    classDef dbstore fill:#E2F0D9,stroke:#66A345,color:#66A345,stroke-dasharray: 5 5;
    classDef model fill:#F2F2F2,stroke:#737373,color:#737373;
    classDef util fill:#F7E8FF,stroke:#A64DA0,color:#A64DA0;
    classDef infra fill:#F0F0F0,stroke:#636363,color:#636363;
    classDef test fill:#FFF2F2,stroke:#D93025,color:#D93025;
```
