# deadwalker10s/taskmanager architecture

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

- Interactive diagram: https://gitdiagram.com/deadwalker10s/taskmanager
- Repository: https://github.com/deadwalker10s/taskmanager

## Overview

This is a Spring Boot personal task-management application. Its documented workflow exposes task operations through an API, delegates task handling to services and repositories, and can return dashboard metrics as JSON or a JSP view. User management follows the same controller/service/repository structure. Alerts are a documented capability, but the alert controller was not sampled, so its connection to the service is shown as unverified. Source excerpts do not establish database configuration or the full JSP routing.

Main entry points: [`src/main/java/com/ben/task_management_app/service/TaskService.java`](https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/service/TaskService.java) (Task operations), [`src/main/java/com/ben/task_management_app/controller/TaskController.java`](https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/controller/TaskController.java) (Task API), [`src/main/java/com/ben/task_management_app/repository/UserRepository.java`](https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/repository/UserRepository.java) (User repository), [`src/main/java/com/ben/task_management_app/repository/TaskAlertRepository.java`](https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/repository/TaskAlertRepository.java) (Alert repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API layer"]
  node_task_controller["Task API"]
  node_user_controller["User API"]
  node_alert_controller["Alert API"]
end

subgraph group_services["Service layer"]
  node_task_service["Task operations<br/>[TaskService.java]"]
  node_user_service["User operations<br/>[UserService.java]"]
  node_alert_service["Alert operations"]
end

subgraph group_data["Persistence and domain"]
  node_task_repo[("Task repository")]
  node_user_repo[("User repository")]
  node_alert_repo[("Alert repository")]
  node_task_model["Task model<br/>[Task.java]"]
  node_user_model["User model<br/>[User.java]"]
  node_alert_model["Alert model<br/>[TaskAlert.java]"]
  node_task_status["Task status<br/>[TaskStatus.java]"]
end

subgraph group_views["Dashboard views"]
  node_dashboard["Task dashboard<br/>[taskdashboard.jsp]"]
end

node_client(("API client"))

node_client -->|"requests tasks"| node_task_controller
node_client -.->|"manages users"| node_user_controller
node_client -.->|"configures alerts"| node_alert_controller
node_task_controller -->|"delegates tasks"| node_task_service
node_user_controller -->|"delegates users"| node_user_service
node_alert_controller -.->|"delegates alerts"| node_alert_service
node_task_service -->|"reads and writes"| node_task_repo
node_task_service -->|"counts users"| node_user_repo
node_task_service -->|"counts alerts"| node_alert_repo
node_user_service -->|"reads and writes"| node_user_repo
node_alert_service -->|"reads and writes"| node_alert_repo
node_task_repo -->|"persists"| node_task_model
node_user_repo -->|"persists"| node_user_model
node_alert_repo -->|"persists"| node_alert_model
node_user_model -->|"owns tasks"| node_task_model
node_task_service -->|"calculates metrics"| node_task_status
node_task_controller -->|"renders metrics"| node_dashboard

click node_task_controller "https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/controller/TaskController.java"
click node_user_controller "https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/controller/UserController.java"
click node_alert_controller "https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/controller/TaskAlertController.java"
click node_task_service "https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/service/TaskService.java"
click node_user_service "https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/service/UserService.java"
click node_alert_service "https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/service/TaskAlertService.java"
click node_task_repo "https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/repository/TaskRepository.java"
click node_user_repo "https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/repository/UserRepository.java"
click node_alert_repo "https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/repository/TaskAlertRepository.java"
click node_task_model "https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/model/Task.java"
click node_user_model "https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/model/User.java"
click node_alert_model "https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/model/TaskAlert.java"
click node_task_status "https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/model/enums/TaskStatus.java"
click node_dashboard "https://github.com/deadwalker10s/taskmanager/blob/main/src/main/webapp/WEB-INF/jsp/taskdashboard.jsp"

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_task_controller,node_user_controller,node_alert_controller,node_client toneBlue
class node_task_service,node_user_service,node_alert_service toneAmber
class node_task_repo,node_user_repo,node_alert_repo,node_task_model,node_user_model,node_alert_model,node_task_status toneMint
class node_dashboard toneRose
```

## Components

### API layer

- [Task API](https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/controller/TaskController.java): `src/main/java/com/ben/task_management_app/controller/TaskController.java`
- [User API](https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/controller/UserController.java): `src/main/java/com/ben/task_management_app/controller/UserController.java`
- [Alert API](https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/controller/TaskAlertController.java): `src/main/java/com/ben/task_management_app/controller/TaskAlertController.java`

### Service layer

- [Task operations](https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/service/TaskService.java): `src/main/java/com/ben/task_management_app/service/TaskService.java`
- [User operations](https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/service/UserService.java): `src/main/java/com/ben/task_management_app/service/UserService.java`
- [Alert operations](https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/service/TaskAlertService.java): `src/main/java/com/ben/task_management_app/service/TaskAlertService.java`

### Persistence and domain

- [Task repository](https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/repository/TaskRepository.java): `src/main/java/com/ben/task_management_app/repository/TaskRepository.java`
- [User repository](https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/repository/UserRepository.java): `src/main/java/com/ben/task_management_app/repository/UserRepository.java`
- [Alert repository](https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/repository/TaskAlertRepository.java): `src/main/java/com/ben/task_management_app/repository/TaskAlertRepository.java`
- [Task model](https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/model/Task.java): `src/main/java/com/ben/task_management_app/model/Task.java`
- [User model](https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/model/User.java): `src/main/java/com/ben/task_management_app/model/User.java`
- [Alert model](https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/model/TaskAlert.java): `src/main/java/com/ben/task_management_app/model/TaskAlert.java`
- [Task status](https://github.com/deadwalker10s/taskmanager/blob/main/src/main/java/com/ben/task_management_app/model/enums/TaskStatus.java): `src/main/java/com/ben/task_management_app/model/enums/TaskStatus.java`

### Dashboard views

- [Task dashboard](https://github.com/deadwalker10s/taskmanager/blob/main/src/main/webapp/WEB-INF/jsp/taskdashboard.jsp): `src/main/webapp/WEB-INF/jsp/taskdashboard.jsp`

### Other components

- **API client**

## Connections

- API client → Task API: requests tasks (evidence: `README.md`)
- API client → User API: manages users (evidence: `README.md`)
- API client → Alert API: configures alerts (evidence: `README.md`)
- Task API → Task operations: delegates tasks (evidence: `src/main/java/com/ben/task_management_app/controller/TaskController.java`)
- User API → User operations: delegates users (evidence: `src/main/java/com/ben/task_management_app/controller/UserController.java`)
- Alert API → Alert operations: delegates alerts
- Task operations → Task repository: reads and writes (evidence: `src/main/java/com/ben/task_management_app/service/TaskService.java`)
- Task operations → User repository: counts users (evidence: `src/main/java/com/ben/task_management_app/service/TaskService.java`)
- Task operations → Alert repository: counts alerts (evidence: `src/main/java/com/ben/task_management_app/service/TaskService.java`)
- User operations → User repository: reads and writes (evidence: `src/main/java/com/ben/task_management_app/service/UserService.java`)
- Alert operations → Alert repository: reads and writes (evidence: `src/main/java/com/ben/task_management_app/service/TaskAlertService.java`)
- Task repository → Task model: persists (evidence: `src/main/java/com/ben/task_management_app/repository/TaskRepository.java`)
- User repository → User model: persists (evidence: `src/main/java/com/ben/task_management_app/repository/UserRepository.java`)
- Alert repository → Alert model: persists (evidence: `src/main/java/com/ben/task_management_app/repository/TaskAlertRepository.java`)
- User model → Task model: owns tasks (evidence: `src/main/java/com/ben/task_management_app/model/User.java`)
- Task operations → Task status: calculates metrics (evidence: `src/main/java/com/ben/task_management_app/service/TaskService.java`)
- Task API → Task dashboard: renders metrics (evidence: `src/main/java/com/ben/task_management_app/controller/TaskController.java`)
