# ouerhani-syrine/to-do-list architecture

> Architecture diagram of the GitHub repository ouerhani-syrine/to-do-list, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ouerhani-syrine/to-do-list
- Repository: https://github.com/ouerhani-syrine/to-do-list

## Overview

This is a task-list web app: users browse tasks, add them, filter by title/date/priority, mark completion, and delete entries. The React ToDo screen owns UI state and invokes a fetch-based service; a Spring controller routes those HTTP requests into task validation, mapping, and persistence. The graph covers the sampled runtime paths and indexed core modules. Storage is represented by the JPA repository rather than a claimed specific database; no README capability description was provided.

Main entry points: [`Frontend/src/Component/ToDo/ToDo.jsx`](https://github.com/ouerhani-syrine/to-do-list/blob/main/Frontend/src/Component/ToDo/ToDo.jsx) (Task workspace), [`backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/service/TaskService.java`](https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/service/TaskService.java) (Task service), [`backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/mapper/TaskMapper.java`](https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/mapper/TaskMapper.java) (Task mapper), [`backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/GlobalExceptionHandler.java`](https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/GlobalExceptionHandler.java) (Error handling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["App routing<br/>[App.jsx]"]
  node_todo["Task workspace<br/>[ToDo.jsx]"]
  node_form["Task form<br/>[Form.jsx]"]
  node_search["Task filters<br/>[SearchBar.jsx]"]
  node_row["Task rows<br/>[TacheRow.jsx]"]
  node_summary["Task counters<br/>[nbCard.jsx]"]
  node_nav["Workspace header<br/>[nav.jsx]"]
  node_service["HTTP task client<br/>[taskService.js]"]
end

subgraph group_api["Task API"]
  node_controller["Task controller"]
  node_errors["Error handling"]
end

subgraph group_domain["Task domain"]
  node_servicejava["Task service<br/>[TaskService.java]"]
  node_mapper["Task mapper<br/>[TaskMapper.java]"]
  node_create["Create DTO<br/>[CreateTaskDTO.java]"]
  node_update["Update DTO<br/>[UpdateTaskDTO.java]"]
  node_response["Response DTO"]
  node_entity["Task entity<br/>[TaskEntity.java]"]
  node_duplicate["Duplicate error<br/>[DuplicateTask.java]"]
  node_notfound["Missing ID error<br/>[IdNotFound.java]"]
  node_invaliddate["Invalid date error<br/>[InvalidDate.java]"]
  node_invalidtitle["Invalid title error<br/>[InvalidTitle.java]"]
end

subgraph group_data["Persistence"]
  node_repository[("Task repository")]
end

node_user(("User"))
node_http{{"Task HTTP API"}}

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_todo
node_todo -->|"renders"| node_form
node_todo -->|"renders"| node_search
node_todo -->|"renders"| node_row
node_todo -->|"renders"| node_summary
node_todo -->|"renders"| node_nav
node_todo -->|"calls"| node_service
node_service -->|"fetches"| node_http
node_http -.->|"routes requests"| node_controller
node_controller -->|"delegates"| node_servicejava
node_servicejava -->|"queries and saves"| node_repository
node_servicejava -->|"maps tasks"| node_mapper
node_mapper -->|"maps to/from"| node_entity
node_mapper -->|"reads"| node_create
node_mapper -->|"reads"| node_update
node_mapper -->|"builds"| node_response
node_repository -->|"persists"| node_entity
node_servicejava -->|"throws"| node_duplicate
node_servicejava -->|"throws"| node_notfound
node_servicejava -->|"throws"| node_invaliddate
node_servicejava -->|"throws"| node_invalidtitle
node_errors -->|"handles"| node_duplicate
node_errors -->|"handles"| node_notfound
node_errors -->|"handles"| node_invaliddate
node_errors -->|"handles"| node_invalidtitle

click node_app "https://github.com/ouerhani-syrine/to-do-list/blob/main/Frontend/src/App.jsx"
click node_todo "https://github.com/ouerhani-syrine/to-do-list/blob/main/Frontend/src/Component/ToDo/ToDo.jsx"
click node_form "https://github.com/ouerhani-syrine/to-do-list/blob/main/Frontend/src/Component/Form/Form.jsx"
click node_search "https://github.com/ouerhani-syrine/to-do-list/blob/main/Frontend/src/Component/SearchBar/SearchBar.jsx"
click node_row "https://github.com/ouerhani-syrine/to-do-list/blob/main/Frontend/src/Component/TacheRow/TacheRow.jsx"
click node_summary "https://github.com/ouerhani-syrine/to-do-list/blob/main/Frontend/src/Component/main/nbCard.jsx"
click node_nav "https://github.com/ouerhani-syrine/to-do-list/blob/main/Frontend/src/Component/nav.jsx"
click node_service "https://github.com/ouerhani-syrine/to-do-list/blob/main/Frontend/src/Service/taskService.js"
click node_controller "https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/controller/TaskController.java"
click node_servicejava "https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/service/TaskService.java"
click node_mapper "https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/mapper/TaskMapper.java"
click node_create "https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/dto/CreateTaskDTO.java"
click node_update "https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/dto/UpdateTaskDTO.java"
click node_response "https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/dto/TaskResponseDTO.java"
click node_entity "https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/entity/TaskEntity.java"
click node_repository "https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/repository/TaskRepository.java"
click node_errors "https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/GlobalExceptionHandler.java"
click node_duplicate "https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/DuplicateTask.java"
click node_notfound "https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/IdNotFound.java"
click node_invaliddate "https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/InvalidDate.java"
click node_invalidtitle "https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/InvalidTitle.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_app,node_todo,node_form,node_search,node_row,node_summary,node_nav,node_service,node_user toneBlue
class node_controller,node_errors toneAmber
class node_servicejava,node_mapper,node_create,node_update,node_response,node_entity,node_duplicate,node_notfound,node_invaliddate,node_invalidtitle toneMint
class node_repository,node_http toneRose
```

## Components

### Web application

- [App routing](https://github.com/ouerhani-syrine/to-do-list/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [Task workspace](https://github.com/ouerhani-syrine/to-do-list/blob/main/Frontend/src/Component/ToDo/ToDo.jsx): `Frontend/src/Component/ToDo/ToDo.jsx`
- [Task form](https://github.com/ouerhani-syrine/to-do-list/blob/main/Frontend/src/Component/Form/Form.jsx): `Frontend/src/Component/Form/Form.jsx`
- [Task filters](https://github.com/ouerhani-syrine/to-do-list/blob/main/Frontend/src/Component/SearchBar/SearchBar.jsx): `Frontend/src/Component/SearchBar/SearchBar.jsx`
- [Task rows](https://github.com/ouerhani-syrine/to-do-list/blob/main/Frontend/src/Component/TacheRow/TacheRow.jsx): `Frontend/src/Component/TacheRow/TacheRow.jsx`
- [Task counters](https://github.com/ouerhani-syrine/to-do-list/blob/main/Frontend/src/Component/main/nbCard.jsx): `Frontend/src/Component/main/nbCard.jsx`
- [Workspace header](https://github.com/ouerhani-syrine/to-do-list/blob/main/Frontend/src/Component/nav.jsx): `Frontend/src/Component/nav.jsx`
- [HTTP task client](https://github.com/ouerhani-syrine/to-do-list/blob/main/Frontend/src/Service/taskService.js): `Frontend/src/Service/taskService.js`

### Task API

- [Task controller](https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/controller/TaskController.java): `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/controller/TaskController.java`
- [Error handling](https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/GlobalExceptionHandler.java): `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/GlobalExceptionHandler.java`

### Task domain

- [Task service](https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/service/TaskService.java): `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/service/TaskService.java`
- [Task mapper](https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/mapper/TaskMapper.java): `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/mapper/TaskMapper.java`
- [Create DTO](https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/dto/CreateTaskDTO.java): `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/dto/CreateTaskDTO.java`
- [Update DTO](https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/dto/UpdateTaskDTO.java): `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/dto/UpdateTaskDTO.java`
- [Response DTO](https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/dto/TaskResponseDTO.java): `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/dto/TaskResponseDTO.java`
- [Task entity](https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/entity/TaskEntity.java): `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/entity/TaskEntity.java`
- [Duplicate error](https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/DuplicateTask.java): `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/DuplicateTask.java`
- [Missing ID error](https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/IdNotFound.java): `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/IdNotFound.java`
- [Invalid date error](https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/InvalidDate.java): `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/InvalidDate.java`
- [Invalid title error](https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/InvalidTitle.java): `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/InvalidTitle.java`

### Persistence

- [Task repository](https://github.com/ouerhani-syrine/to-do-list/blob/main/backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/repository/TaskRepository.java): `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/repository/TaskRepository.java`

### Other components

- **User**
- **Task HTTP API**

## Connections

- User → App routing: opens (evidence: `Frontend/src/App.jsx`)
- App routing → Task workspace: routes to (evidence: `Frontend/src/App.jsx`)
- Task workspace → Task form: renders (evidence: `Frontend/src/Component/ToDo/ToDo.jsx`)
- Task workspace → Task filters: renders (evidence: `Frontend/src/Component/ToDo/ToDo.jsx`)
- Task workspace → Task rows: renders (evidence: `Frontend/src/Component/ToDo/ToDo.jsx`)
- Task workspace → Task counters: renders (evidence: `Frontend/src/Component/ToDo/ToDo.jsx`)
- Task workspace → Workspace header: renders (evidence: `Frontend/src/Component/ToDo/ToDo.jsx`)
- Task workspace → HTTP task client: calls (evidence: `Frontend/src/Component/ToDo/ToDo.jsx`)
- HTTP task client → Task HTTP API: fetches (evidence: `Frontend/src/Service/taskService.js`)
- Task HTTP API → Task controller: routes requests
- Task controller → Task service: delegates (evidence: `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/controller/TaskController.java`)
- Task service → Task repository: queries and saves (evidence: `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/service/TaskService.java`)
- Task service → Task mapper: maps tasks (evidence: `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/service/TaskService.java`)
- Task mapper → Task entity: maps to/from (evidence: `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/mapper/TaskMapper.java`)
- Task mapper → Create DTO: reads (evidence: `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/mapper/TaskMapper.java`)
- Task mapper → Update DTO: reads (evidence: `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/mapper/TaskMapper.java`)
- Task mapper → Response DTO: builds (evidence: `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/mapper/TaskMapper.java`)
- Task repository → Task entity: persists (evidence: `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/repository/TaskRepository.java`)
- Task service → Duplicate error: throws (evidence: `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/service/TaskService.java`)
- Task service → Missing ID error: throws (evidence: `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/service/TaskService.java`)
- Task service → Invalid date error: throws (evidence: `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/service/TaskService.java`)
- Task service → Invalid title error: throws (evidence: `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/service/TaskService.java`)
- Error handling → Duplicate error: handles (evidence: `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/GlobalExceptionHandler.java`)
- Error handling → Missing ID error: handles (evidence: `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/GlobalExceptionHandler.java`)
- Error handling → Invalid date error: handles (evidence: `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/GlobalExceptionHandler.java`)
- Error handling → Invalid title error: handles (evidence: `backend/to-do-list-backend/to-do-list-backend/src/main/java/com/syrine/to_do_list_backend/exception/GlobalExceptionHandler.java`)
