bunnycoder1999/tasks-be

Purpose and Runtime

Task Tracker is a Spring Boot REST backend for CRUD management of task lists and their tasks. The README describes a React/Vite client, but no frontend source exists in this repository. The application runs on Java/Spring Boot, exposes REST endpoints, and persists through Spring Data JPA to PostgreSQL; Docker Compose provisions the database.

• src/main/java/com/springbunny/tasks/TasksApplication.java

• pom.xml

• docker-compose.yml

Application Entry and HTTP Boundary

TasksApplication is the Spring Boot bootstrap entry point. REST controllers form the external API boundary, with task-list routes prefixed by /api/task-lists; task operations are likely nested under or coordinated with list operations.

• src/main/java/com/springbunny/tasks/controllers/TaskListController.java

• src/main/java/com/springbunny/tasks/controllers/TaskController.java

• src/main/java/com/springbunny/tasks/TasksApplication.java

Task-List Domain Stage

Task lists are a primary aggregate for organizing tasks. The controller delegates list CRUD to a service, which persists through a repository and presents DTOs rather than exposing entities directly.

• src/main/java/com/springbunny/tasks/domain/entities/TaskList.java

• src/main/java/com/springbunny/tasks/services/impl/TaskListServiceImpl.java

• src/main/java/com/springbunny/tasks/repositories/TaskListRepository.java

Task Domain Stage

Tasks belong to the task-management model and carry status and priority domain values. Task service logic is the principal place for operations such as creation, updates to title/description/status, deletion, and association with a task list.

• src/main/java/com/springbunny/tasks/domain/entities/Task.java

• src/main/java/com/springbunny/tasks/domain/entities/TaskStatus.java

• src/main/java/com/springbunny/tasks/services/impl/TaskServiceImpl.java

API Contract and Mapping Boundary

Controllers exchange TaskDto and TaskListDto contracts. Dedicated mappers isolate entity-to-DTO conversion, allowing JPA relationships and persistence details to remain behind the service/API boundary.

• src/main/java/com/springbunny/tasks/domain/dto/TaskDto.java

• src/main/java/com/springbunny/tasks/mappers/impl/TaskMapperImpl.java

• src/main/java/com/springbunny/tasks/mappers/impl/TaskListMapperImpl.java

Persistence and Infrastructure

Repository interfaces provide the data-access boundary over JPA entities. PostgreSQL is the material external dependency, expected to run via Docker Compose; runtime database settings are supplied through Spring application properties.

• src/main/java/com/springbunny/tasks/repositories/TaskRepository.java

• src/main/java/com/springbunny/tasks/repositories/TaskListRepository.java

• src/main/resources/application.properties

Error Flow

Request validation or service failures are centrally translated into API error responses by controller advice. This prevents persistence/domain exceptions from leaking directly through REST endpoints.

• src/main/java/com/springbunny/tasks/controllers/GlobalExceptionHandler.java

• src/main/java/com/springbunny/tasks/domain/dto/ErrorResponse.java