Task Manager API

A RESTful API for managing tasks built with Java 21 and Spring Boot.

---

Tech Stack

Layer	Technology
Language	Java 21
Framework	Spring Boot 4.1.0-M2
Persistence	H2 (file-based)
ORM	Spring Data JPA
Validation	Spring Boot Validation
Error Handling	@ControllerAdvice
Eventing	Spring ApplicationEventPublisher
Monitoring	Spring Actuator
Containerisation	Docker
Build Tool	Maven
CI/CD	GitHub Actions

---

Getting Started

Prerequisites: Java 21+ (Maven wrapper included)

git clone https://github.com/ColtonRandall/task-manager-api.git
cd task-manager-api
./mvnw spring-boot:run

The API starts on http://localhost:8080. To build a JAR:

./mvnw -B package
java -jar target/task-manager-api-0.0.1-SNAPSHOT.jar

Or run with Docker:

docker build -t task-manager-api .
docker run -p 8080:8080 task-manager-api

---

Profiles

Profile	Usage
dev	Default. H2 database, console enabled, DDL auto-update
prod	H2 console disabled, DDL validate only

The active profile is set in application.properties. In a real deployment, override it via environment variable:

SPRING_PROFILES_ACTIVE=prod

---

Database

This project uses an H2 file-based database, stored at ./data/taskdb. Data persists between restarts.

The H2 console is available in the dev profile at http://localhost:8080/h2-console with the following settings:

Field	Value
JDBC URL	jdbc:h2:file:./data/taskdb
Username	sa
Password	(leave blank)

---

Endpoints

Method	Path	Description	Status
POST	/tasks	Create a task	201
GET	/tasks	Fetch all tasks	200
GET	/tasks/{id}	Fetch a task by ID	200
GET	/tasks/search/{name}	Fetch a task by name	200
GET	/tasks/search/status/{status}	Fetch tasks by status	200
PATCH	/tasks/{id}/complete	Mark a task as complete	200
DELETE	/tasks/{id}	Soft delete a task	200
PATCH	/tasks/{id}	Undo a delete	200

Examples

Create a task

curl -s -X POST http://localhost:8080/tasks \
  -H "Content-Type: application/json" \
  -d '{"name":"Buy groceries","description":"Milk, eggs, bread"}'

Get all tasks

curl -s http://localhost:8080/tasks

Complete a task

curl -s -X PATCH http://localhost:8080/tasks/{id}/complete

Delete a task (soft delete)

curl -s -X DELETE http://localhost:8080/tasks/{id}

Undo a deleted task

curl -s -X PATCH http://localhost:8080/tasks/{id}

---

Error Handling

All errors return a consistent JSON response:

{
  "error": "Task not found: abc-123",
  "status": 404,
  "timestamp": "2026-03-15T10:00:00"
}

Scenario	Status
Task not found	404
Invalid request body	400
Invalid status value	400
Unexpected server error	500

---

Eventing

The following events are published when task state changes:

Event	Trigger
TaskCreatedEvent	Task created
TaskCompletedEvent	Task marked complete
TaskDeletedEvent	Task soft deleted

Events are handled by TaskEventListener which logs each state change. The listener is decoupled from the service — additional listeners (e.g. a Kinesis producer) can be added without modifying TaskService.

---

Health Check

Spring Actuator exposes a health endpoint at http://localhost:8080/actuator/health:

{
  "status": "UP"
}

---

Tests

./mvnw test

---

Project Structure

src/
├── main/
│   ├── java/com/taskmanagerapi/
│   │   ├── controller/
│   │   │   └── TaskController.java
│   │   ├── dto/
│   │   │   ├── TaskRequest.java
│   │   │   └── TaskResponse.java
│   │   ├── exception/
│   │   │   ├── GlobalExceptionHandler.java
│   │   │   └── TaskNotFoundException.java
│   │   ├── model/
│   │   │   ├── Task.java
│   │   │   └── TaskStatus.java
│   │   ├── repository/
│   │   │   └── TaskRepository.java
│   │   ├── event/
│   │   │   ├── TaskCreatedEvent.java
│   │   │   ├── TaskCompletedEvent.java
│   │   │   └── TaskDeletedEvent.java
│   │   ├── listener/
│   │   │   └── TaskEventListener.java
│   │   ├── service/
│   │   │   └── TaskService.java
│   │   └── TaskManagerApiApplication.java
│   └── resources/
│       ├── application.properties
│       ├── application-dev.properties
│       └── application-prod.properties
└── test/
    └── java/com/taskmanagerapi/
        ├── TaskManagerApiApplicationTests.java
        ├── TaskServiceTest.java
        └── TaskTests.java