# pedrotimotheogit/task-manager-api architecture

> Architecture diagram of the GitHub repository pedrotimotheogit/task-manager-api, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pedrotimotheogit/task-manager-api
- Repository: https://github.com/pedrotimotheogit/task-manager-api

## Overview

This is a Spring-based task-management REST API. Its main workflow is HTTP requests through the task controller into create, read, update, or delete use cases, which use a repository port; responses are mapped to HTTP output. The domain represents tasks, IDs, and statuses, and the tree includes an in-memory repository adapter. The README is empty, and wiring between that adapter and the repository port is not shown in the excerpts, so that relationship is left unverified.

Main entry points: [`src/main/java/taskmanager/infrastructure/http/TaskController.java`](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/infrastructure/http/TaskController.java) (Task Controller), [`src/main/java/taskmanager/domain/TaskRepository.java`](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/domain/TaskRepository.java) (Task Repository Port), [`src/main/java/taskmanager/application/UpdateTaskUseCase.java`](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/application/UpdateTaskUseCase.java) (Update Task), [`src/main/java/taskmanager/application/CreateTaskUseCase.java`](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/application/CreateTaskUseCase.java) (Create Task)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["HTTP API"]
  node_controller["Task Controller"]
  node_create_request["Create Request"]
  node_update_request["Update Request"]
  node_response["Task Response<br/>[TaskResponse.java]"]
  node_exception_handler["Exception Handler"]
end

subgraph group_app["Application Use Cases"]
  node_create["Create Task"]
  node_get_all["List Tasks"]
  node_get_one["Get Task"]
  node_update["Update Task"]
  node_delete["Delete Task"]
  node_create_input["Create Input"]
  node_update_input["Update Input"]
  node_task_output["Task Output<br/>[TaskOutput.java]"]
end

subgraph group_domain["Task Domain"]
  node_task["Task Entity<br/>[Task.java]"]
  node_task_id["Task ID<br/>[TaskId.java]"]
  node_task_status["Task Status<br/>[TaskStatus.java]"]
  node_not_found["Not Found Error"]
  node_repo_port["Task Repository Port"]
end

subgraph group_storage["Repository"]
  node_memory_repo[("In-Memory Store")]
end

node_caller(("HTTP Client"))

node_caller -->|"sends requests"| node_controller
node_controller -->|"accepts body"| node_create_request
node_controller -->|"accepts body"| node_update_request
node_controller -->|"executes"| node_create
node_controller -->|"executes"| node_get_all
node_controller -->|"executes"| node_get_one
node_controller -->|"executes"| node_update
node_controller -->|"executes"| node_delete
node_controller -->|"maps output"| node_response
node_create_request -->|"converts to"| node_create_input
node_update_request -->|"converts to"| node_update_input
node_response -->|"maps from"| node_task_output
node_create -->|"accepts"| node_create_input
node_update -->|"accepts"| node_update_input
node_create -->|"saves task"| node_repo_port
node_update -->|"reads and saves"| node_repo_port
node_get_all -->|"lists tasks"| node_repo_port
node_get_one -->|"finds task"| node_repo_port
node_delete -->|"checks and deletes"| node_repo_port
node_delete -->|"throws when absent"| node_not_found
node_update -->|"throws when absent"| node_not_found
node_create -->|"returns mapping"| node_task_output
node_update -->|"returns mapping"| node_task_output
node_task_output -->|"maps entity"| node_task
node_exception_handler -->|"handles exception"| node_not_found
node_repo_port -.->|"implemented by"| node_memory_repo

click node_controller "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/infrastructure/http/TaskController.java"
click node_create_request "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/infrastructure/http/request/CreateTaskRequest.java"
click node_update_request "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/infrastructure/http/request/UpdateTaskRequest.java"
click node_response "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/infrastructure/http/response/TaskResponse.java"
click node_exception_handler "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/infrastructure/http/GlobalExecptionHandler.java"
click node_create "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/application/CreateTaskUseCase.java"
click node_get_all "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/application/GetTaskCaseUse.java"
click node_get_one "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/application/GetTaskByIdUseCase.java"
click node_update "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/application/UpdateTaskUseCase.java"
click node_delete "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/application/DeleteTaskCaseUse.java"
click node_create_input "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/application/input/CreateTaskInput.java"
click node_update_input "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/application/input/UpdateTaskInput.java"
click node_task_output "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/application/output/TaskOutput.java"
click node_task "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/domain/Task.java"
click node_task_id "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/domain/TaskId.java"
click node_task_status "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/domain/TaskStatus.java"
click node_not_found "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/domain/TaskNotFoundExecption.java"
click node_repo_port "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/domain/TaskRepository.java"
click node_memory_repo "https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/infrastructure/InMemoryTaskRepository.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_controller,node_create_request,node_update_request,node_response,node_exception_handler,node_caller toneBlue
class node_create,node_get_all,node_get_one,node_update,node_delete,node_create_input,node_update_input,node_task_output toneAmber
class node_task,node_task_id,node_task_status,node_not_found,node_repo_port toneMint
class node_memory_repo toneRose
```

## Components

### HTTP API

- [Task Controller](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/infrastructure/http/TaskController.java): `src/main/java/taskmanager/infrastructure/http/TaskController.java`
- [Create Request](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/infrastructure/http/request/CreateTaskRequest.java): `src/main/java/taskmanager/infrastructure/http/request/CreateTaskRequest.java`
- [Update Request](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/infrastructure/http/request/UpdateTaskRequest.java): `src/main/java/taskmanager/infrastructure/http/request/UpdateTaskRequest.java`
- [Task Response](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/infrastructure/http/response/TaskResponse.java): `src/main/java/taskmanager/infrastructure/http/response/TaskResponse.java`
- [Exception Handler](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/infrastructure/http/GlobalExecptionHandler.java): `src/main/java/taskmanager/infrastructure/http/GlobalExecptionHandler.java`

### Application Use Cases

- [Create Task](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/application/CreateTaskUseCase.java): `src/main/java/taskmanager/application/CreateTaskUseCase.java`
- [List Tasks](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/application/GetTaskCaseUse.java): `src/main/java/taskmanager/application/GetTaskCaseUse.java`
- [Get Task](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/application/GetTaskByIdUseCase.java): `src/main/java/taskmanager/application/GetTaskByIdUseCase.java`
- [Update Task](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/application/UpdateTaskUseCase.java): `src/main/java/taskmanager/application/UpdateTaskUseCase.java`
- [Delete Task](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/application/DeleteTaskCaseUse.java): `src/main/java/taskmanager/application/DeleteTaskCaseUse.java`
- [Create Input](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/application/input/CreateTaskInput.java): `src/main/java/taskmanager/application/input/CreateTaskInput.java`
- [Update Input](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/application/input/UpdateTaskInput.java): `src/main/java/taskmanager/application/input/UpdateTaskInput.java`
- [Task Output](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/application/output/TaskOutput.java): `src/main/java/taskmanager/application/output/TaskOutput.java`

### Task Domain

- [Task Entity](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/domain/Task.java): `src/main/java/taskmanager/domain/Task.java`
- [Task ID](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/domain/TaskId.java): `src/main/java/taskmanager/domain/TaskId.java`
- [Task Status](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/domain/TaskStatus.java): `src/main/java/taskmanager/domain/TaskStatus.java`
- [Not Found Error](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/domain/TaskNotFoundExecption.java): `src/main/java/taskmanager/domain/TaskNotFoundExecption.java`
- [Task Repository Port](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/domain/TaskRepository.java): `src/main/java/taskmanager/domain/TaskRepository.java`

### Repository

- [In-Memory Store](https://github.com/pedrotimotheogit/task-manager-api/blob/master/src/main/java/taskmanager/infrastructure/InMemoryTaskRepository.java): `src/main/java/taskmanager/infrastructure/InMemoryTaskRepository.java`

### Other components

- **HTTP Client**

## Connections

- HTTP Client → Task Controller: sends requests (evidence: `src/main/java/taskmanager/infrastructure/http/TaskController.java`)
- Task Controller → Create Request: accepts body (evidence: `src/main/java/taskmanager/infrastructure/http/TaskController.java`)
- Task Controller → Update Request: accepts body (evidence: `src/main/java/taskmanager/infrastructure/http/TaskController.java`)
- Task Controller → Create Task: executes (evidence: `src/main/java/taskmanager/infrastructure/http/TaskController.java`)
- Task Controller → List Tasks: executes (evidence: `src/main/java/taskmanager/infrastructure/http/TaskController.java`)
- Task Controller → Get Task: executes (evidence: `src/main/java/taskmanager/infrastructure/http/TaskController.java`)
- Task Controller → Update Task: executes (evidence: `src/main/java/taskmanager/infrastructure/http/TaskController.java`)
- Task Controller → Delete Task: executes (evidence: `src/main/java/taskmanager/infrastructure/http/TaskController.java`)
- Task Controller → Task Response: maps output (evidence: `src/main/java/taskmanager/infrastructure/http/TaskController.java`)
- Create Request → Create Input: converts to (evidence: `src/main/java/taskmanager/infrastructure/http/request/CreateTaskRequest.java`)
- Update Request → Update Input: converts to (evidence: `src/main/java/taskmanager/infrastructure/http/request/UpdateTaskRequest.java`)
- Task Response → Task Output: maps from (evidence: `src/main/java/taskmanager/infrastructure/http/response/TaskResponse.java`)
- Create Task → Create Input: accepts (evidence: `src/main/java/taskmanager/application/CreateTaskUseCase.java`)
- Update Task → Update Input: accepts (evidence: `src/main/java/taskmanager/application/UpdateTaskUseCase.java`)
- Create Task → Task Repository Port: saves task (evidence: `src/main/java/taskmanager/application/CreateTaskUseCase.java`)
- Update Task → Task Repository Port: reads and saves (evidence: `src/main/java/taskmanager/application/UpdateTaskUseCase.java`)
- List Tasks → Task Repository Port: lists tasks (evidence: `src/main/java/taskmanager/application/GetTaskCaseUse.java`)
- Get Task → Task Repository Port: finds task (evidence: `src/main/java/taskmanager/application/GetTaskByIdUseCase.java`)
- Delete Task → Task Repository Port: checks and deletes (evidence: `src/main/java/taskmanager/application/DeleteTaskCaseUse.java`)
- Delete Task → Not Found Error: throws when absent (evidence: `src/main/java/taskmanager/application/DeleteTaskCaseUse.java`)
- Update Task → Not Found Error: throws when absent (evidence: `src/main/java/taskmanager/application/UpdateTaskUseCase.java`)
- Create Task → Task Output: returns mapping (evidence: `src/main/java/taskmanager/application/CreateTaskUseCase.java`)
- Update Task → Task Output: returns mapping (evidence: `src/main/java/taskmanager/application/UpdateTaskUseCase.java`)
- Task Output → Task Entity: maps entity (evidence: `src/main/java/taskmanager/application/output/TaskOutput.java`)
- Exception Handler → Not Found Error: handles exception (evidence: `src/main/java/taskmanager/infrastructure/http/GlobalExecptionHandler.java`)
- Task Repository Port → In-Memory Store: implemented by (evidence: `src/main/java/taskmanager/infrastructure/InMemoryTaskRepository.java`)
