# simonraje/todo- architecture

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

- Interactive diagram: https://gitdiagram.com/simonraje/todo-
- Repository: https://github.com/simonraje/todo-

## Overview

This Spring Boot application exposes a REST API for creating, viewing, updating, deleting, and changing the completion status of todos. Requests enter through the controller, which delegates to the service contract; its implementation maps DTOs to entities, performs repository operations, and maps results back. The repository uses Spring Data JPA for persistence, while missing records raise a not-found exception. The sampled files show this main request path; database configuration and runtime wiring beyond the application’s ModelMapper bean were not inspected.

Main entry points: [`src/main/java/Project2/ToDoApplication/service/Implementation/ServiceImplementation.java`](https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/service/Implementation/ServiceImplementation.java) (Service implementation), [`src/main/java/Project2/ToDoApplication/repository/TodoRepository.java`](https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/repository/TodoRepository.java) (Todo repository), [`src/main/java/Project2/ToDoApplication/controller/TodoController.java`](https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/controller/TodoController.java) (Todo controller), [`src/main/java/Project2/ToDoApplication/service/TodoService.java`](https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/service/TodoService.java) (Todo service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_controller["Todo controller"]
  node_dto["Todo DTO<br/>[TodoDto.java]"]
end

subgraph group_logic["Todo Logic"]
  node_service["Todo service<br/>[TodoService.java]"]
  node_implementation["Service implementation"]
  node_mapper["ModelMapper"]
  node_application["Application bootstrap"]
  node_notfound["Not-found exception"]
end

subgraph group_data["Domain and Persistence"]
  node_repository["Todo repository"]
  node_entity["Todo entity<br/>[Todo.java]"]
end

node_user(("API client"))
node_database[("Relational database")]

node_user -->|"sends requests"| node_controller
node_controller -->|"delegates operations"| node_service
node_implementation -->|"implements"| node_service
node_implementation -->|"reads and writes"| node_repository
node_implementation -->|"maps objects"| node_mapper
node_application -->|"provides bean"| node_mapper
node_implementation -->|"maps to and from"| node_dto
node_implementation -->|"maps and updates"| node_entity
node_implementation -->|"throws when absent"| node_notfound
node_repository -->|"persists"| node_entity
node_repository -->|"performs persistence"| node_database

click node_controller "https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/controller/TodoController.java"
click node_service "https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/service/TodoService.java"
click node_implementation "https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/service/Implementation/ServiceImplementation.java"
click node_application "https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/ToDoApplication.java"
click node_dto "https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/dto/TodoDto.java"
click node_repository "https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/repository/TodoRepository.java"
click node_entity "https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/entity/Todo.java"
click node_notfound "https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/exception/ResourceNotFoundException.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_dto,node_user toneBlue
class node_service,node_implementation,node_mapper,node_application,node_notfound,node_database toneAmber
class node_repository,node_entity toneMint
```

## Components

### REST API

- [Todo controller](https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/controller/TodoController.java): `src/main/java/Project2/ToDoApplication/controller/TodoController.java`
- [Todo DTO](https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/dto/TodoDto.java): `src/main/java/Project2/ToDoApplication/dto/TodoDto.java`

### Todo Logic

- [Todo service](https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/service/TodoService.java): `src/main/java/Project2/ToDoApplication/service/TodoService.java`
- [Service implementation](https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/service/Implementation/ServiceImplementation.java): `src/main/java/Project2/ToDoApplication/service/Implementation/ServiceImplementation.java`
- **ModelMapper**
- [Application bootstrap](https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/ToDoApplication.java): `src/main/java/Project2/ToDoApplication/ToDoApplication.java`
- [Not-found exception](https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/exception/ResourceNotFoundException.java): `src/main/java/Project2/ToDoApplication/exception/ResourceNotFoundException.java`

### Domain and Persistence

- [Todo repository](https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/repository/TodoRepository.java): `src/main/java/Project2/ToDoApplication/repository/TodoRepository.java`
- [Todo entity](https://github.com/simonraje/todo-/blob/main/src/main/java/Project2/ToDoApplication/entity/Todo.java): `src/main/java/Project2/ToDoApplication/entity/Todo.java`

### Other components

- **API client**
- **Relational database**

## Connections

- API client → Todo controller: sends requests (evidence: `src/main/java/Project2/ToDoApplication/controller/TodoController.java`)
- Todo controller → Todo service: delegates operations (evidence: `src/main/java/Project2/ToDoApplication/controller/TodoController.java`)
- Service implementation → Todo service: implements (evidence: `src/main/java/Project2/ToDoApplication/service/Implementation/ServiceImplementation.java`)
- Service implementation → Todo repository: reads and writes (evidence: `src/main/java/Project2/ToDoApplication/service/Implementation/ServiceImplementation.java`)
- Service implementation → ModelMapper: maps objects (evidence: `src/main/java/Project2/ToDoApplication/service/Implementation/ServiceImplementation.java`)
- Application bootstrap → ModelMapper: provides bean (evidence: `src/main/java/Project2/ToDoApplication/ToDoApplication.java`)
- Service implementation → Todo DTO: maps to and from (evidence: `src/main/java/Project2/ToDoApplication/service/Implementation/ServiceImplementation.java`)
- Service implementation → Todo entity: maps and updates (evidence: `src/main/java/Project2/ToDoApplication/service/Implementation/ServiceImplementation.java`)
- Service implementation → Not-found exception: throws when absent (evidence: `src/main/java/Project2/ToDoApplication/service/Implementation/ServiceImplementation.java`)
- Todo repository → Todo entity: persists (evidence: `src/main/java/Project2/ToDoApplication/repository/TodoRepository.java`)
- Todo repository → Relational database: performs persistence (evidence: `src/main/java/Project2/ToDoApplication/repository/TodoRepository.java`)
