# asmaa-03/todolist-springboot architecture

> Architecture diagram of the GitHub repository asmaa-03/todolist-springboot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/asmaa-03/todolist-springboot
- Repository: https://github.com/asmaa-03/todolist-springboot

## Overview

This is a React and Spring Boot todo application. A user reaches the task dashboard, where the main task panel loads, creates, edits, and deletes dated, colored tasks; a separate daily-task panel loads, adds, and deletes habits. Frontend service modules call two REST resource controllers, which use Spring Data repositories and JPA entities for persistence. The calendar is a distinct dashboard capability, but its excerpt does not show a connection to task data. Backend database configuration and storage details are not sampled, so those links are omitted.

Main entry points: [`Frontend/src/Pages/Home.jsx`](https://github.com/asmaa-03/todolist-springboot/blob/main/Frontend/src/Pages/Home.jsx) (Home dashboard), [`Frontend/src/App.jsx`](https://github.com/asmaa-03/todolist-springboot/blob/main/Frontend/src/App.jsx) (App shell), [`Frontend/src/components/TaskBox.jsx`](https://github.com/asmaa-03/todolist-springboot/blob/main/Frontend/src/components/TaskBox.jsx) (Task manager), [`Frontend/src/components/DailyTasks.jsx`](https://github.com/asmaa-03/todolist-springboot/blob/main/Frontend/src/components/DailyTasks.jsx) (Daily tasks UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Frontend dashboard"]
  node_app["App shell<br/>[App.jsx]"]
  node_home["Home dashboard<br/>[Home.jsx]"]
  node_taskbox["Task manager<br/>[TaskBox.jsx]"]
  node_calendar["Calendar<br/>[Calender.jsx]"]
  node_dailyui["Daily tasks UI<br/>[DailyTasks.jsx]"]
  node_todoservice["Todo API client<br/>[todoservice.js]"]
  node_dailyservice["Daily API client"]
end

subgraph group_api["REST API"]
  node_server["Spring REST API"]
  node_todocontroller["Todo controller"]
  node_dailycontroller["Daily controller"]
end

subgraph group_data["Persistence"]
  node_todorepo["Todo repository"]
  node_dailyrepo["Daily repository"]
  node_todoentity[("Todo records<br/>[Todo.java]")]
  node_dailyentity[("Daily task records")]
end

node_user(("User"))

node_user -.->|"uses"| node_app
node_app -->|"renders"| node_home
node_home -->|"renders"| node_taskbox
node_home -->|"renders"| node_calendar
node_home -->|"renders"| node_dailyui
node_taskbox -->|"calls"| node_todoservice
node_dailyui -->|"calls"| node_dailyservice
node_todoservice -.->|"HTTP requests"| node_todocontroller
node_dailyservice -.->|"HTTP requests"| node_dailycontroller
node_todocontroller -->|"queries and saves"| node_todorepo
node_dailycontroller -->|"queries and saves"| node_dailyrepo
node_todorepo -->|"manages"| node_todoentity
node_dailyrepo -->|"manages"| node_dailyentity

click node_app "https://github.com/asmaa-03/todolist-springboot/blob/main/Frontend/src/App.jsx"
click node_home "https://github.com/asmaa-03/todolist-springboot/blob/main/Frontend/src/Pages/Home.jsx"
click node_taskbox "https://github.com/asmaa-03/todolist-springboot/blob/main/Frontend/src/components/TaskBox.jsx"
click node_calendar "https://github.com/asmaa-03/todolist-springboot/blob/main/Frontend/src/components/Calender.jsx"
click node_dailyui "https://github.com/asmaa-03/todolist-springboot/blob/main/Frontend/src/components/DailyTasks.jsx"
click node_todoservice "https://github.com/asmaa-03/todolist-springboot/blob/main/Frontend/src/services/todoservice.js"
click node_dailyservice "https://github.com/asmaa-03/todolist-springboot/blob/main/Frontend/src/services/dailytaskservice.js"
click node_server "https://github.com/asmaa-03/todolist-springboot/blob/main/Backend/src/main/java/com/todo/todolist/TodolistApplication.java"
click node_todocontroller "https://github.com/asmaa-03/todolist-springboot/blob/main/Backend/src/main/java/com/todo/todolist/controller/TodoController.java"
click node_dailycontroller "https://github.com/asmaa-03/todolist-springboot/blob/main/Backend/src/main/java/com/todo/todolist/controller/DailyTasksController.java"
click node_todorepo "https://github.com/asmaa-03/todolist-springboot/blob/main/Backend/src/main/java/com/todo/todolist/repository/TodoRepository.java"
click node_dailyrepo "https://github.com/asmaa-03/todolist-springboot/blob/main/Backend/src/main/java/com/todo/todolist/repository/DailyTasksRepository.java"
click node_todoentity "https://github.com/asmaa-03/todolist-springboot/blob/main/Backend/src/main/java/com/todo/todolist/entity/Todo.java"
click node_dailyentity "https://github.com/asmaa-03/todolist-springboot/blob/main/Backend/src/main/java/com/todo/todolist/entity/DailyTasksEntity.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_home,node_taskbox,node_calendar,node_dailyui,node_todoservice,node_dailyservice,node_user toneBlue
class node_server,node_todocontroller,node_dailycontroller toneAmber
class node_todorepo,node_dailyrepo,node_todoentity,node_dailyentity toneMint
```

## Components

### Frontend dashboard

- [App shell](https://github.com/asmaa-03/todolist-springboot/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [Home dashboard](https://github.com/asmaa-03/todolist-springboot/blob/main/Frontend/src/Pages/Home.jsx): `Frontend/src/Pages/Home.jsx`
- [Task manager](https://github.com/asmaa-03/todolist-springboot/blob/main/Frontend/src/components/TaskBox.jsx): `Frontend/src/components/TaskBox.jsx`
- [Calendar](https://github.com/asmaa-03/todolist-springboot/blob/main/Frontend/src/components/Calender.jsx): `Frontend/src/components/Calender.jsx`
- [Daily tasks UI](https://github.com/asmaa-03/todolist-springboot/blob/main/Frontend/src/components/DailyTasks.jsx): `Frontend/src/components/DailyTasks.jsx`
- [Todo API client](https://github.com/asmaa-03/todolist-springboot/blob/main/Frontend/src/services/todoservice.js): `Frontend/src/services/todoservice.js`
- [Daily API client](https://github.com/asmaa-03/todolist-springboot/blob/main/Frontend/src/services/dailytaskservice.js): `Frontend/src/services/dailytaskservice.js`

### REST API

- [Spring REST API](https://github.com/asmaa-03/todolist-springboot/blob/main/Backend/src/main/java/com/todo/todolist/TodolistApplication.java): `Backend/src/main/java/com/todo/todolist/TodolistApplication.java`
- [Todo controller](https://github.com/asmaa-03/todolist-springboot/blob/main/Backend/src/main/java/com/todo/todolist/controller/TodoController.java): `Backend/src/main/java/com/todo/todolist/controller/TodoController.java`
- [Daily controller](https://github.com/asmaa-03/todolist-springboot/blob/main/Backend/src/main/java/com/todo/todolist/controller/DailyTasksController.java): `Backend/src/main/java/com/todo/todolist/controller/DailyTasksController.java`

### Persistence

- [Todo repository](https://github.com/asmaa-03/todolist-springboot/blob/main/Backend/src/main/java/com/todo/todolist/repository/TodoRepository.java): `Backend/src/main/java/com/todo/todolist/repository/TodoRepository.java`
- [Daily repository](https://github.com/asmaa-03/todolist-springboot/blob/main/Backend/src/main/java/com/todo/todolist/repository/DailyTasksRepository.java): `Backend/src/main/java/com/todo/todolist/repository/DailyTasksRepository.java`
- [Todo records](https://github.com/asmaa-03/todolist-springboot/blob/main/Backend/src/main/java/com/todo/todolist/entity/Todo.java): `Backend/src/main/java/com/todo/todolist/entity/Todo.java`
- [Daily task records](https://github.com/asmaa-03/todolist-springboot/blob/main/Backend/src/main/java/com/todo/todolist/entity/DailyTasksEntity.java): `Backend/src/main/java/com/todo/todolist/entity/DailyTasksEntity.java`

### Other components

- **User**

## Connections

- User → App shell: uses
- App shell → Home dashboard: renders (evidence: `Frontend/src/App.jsx`)
- Home dashboard → Task manager: renders (evidence: `Frontend/src/Pages/Home.jsx`)
- Home dashboard → Calendar: renders (evidence: `Frontend/src/Pages/Home.jsx`)
- Home dashboard → Daily tasks UI: renders (evidence: `Frontend/src/Pages/Home.jsx`)
- Task manager → Todo API client: calls (evidence: `Frontend/src/components/TaskBox.jsx`)
- Daily tasks UI → Daily API client: calls (evidence: `Frontend/src/components/DailyTasks.jsx`)
- Todo API client → Todo controller: HTTP requests
- Daily API client → Daily controller: HTTP requests
- Todo controller → Todo repository: queries and saves (evidence: `Backend/src/main/java/com/todo/todolist/controller/TodoController.java`)
- Daily controller → Daily repository: queries and saves (evidence: `Backend/src/main/java/com/todo/todolist/controller/DailyTasksController.java`)
- Todo repository → Todo records: manages (evidence: `Backend/src/main/java/com/todo/todolist/repository/TodoRepository.java`)
- Daily repository → Daily task records: manages (evidence: `Backend/src/main/java/com/todo/todolist/repository/DailyTasksRepository.java`)
