# barolam/domain-driven-design architecture

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

- Interactive diagram: https://gitdiagram.com/barolam/domain-driven-design
- Repository: https://github.com/barolam/domain-driven-design

## Overview

Task Management System is a Java task-tracking sample organized around Clean Architecture and DDD. Users create tasks and retrieve or change their status through console, Swing GUI, or a mock REST API; the application coordinates domain behavior and persistence, then presents results. The domain includes task status, priority, deadline, validation, and project concepts. The README documents three demo configurations, including Memory and SQLite storage. Some demo wiring and GUI behavior are documented but not shown in sampled source, so those links cite the README; unsampled implementation details are not inferred.

Main entry points: [`dependencies/src/main/java/com/taskmanagement/adapter/application/control/TaskControl.java`](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/application/control/TaskControl.java) (Task control), [`dependencies/src/main/java/com/taskmanagement/domain/task/entity/Task.java`](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/domain/task/entity/Task.java) (Task entity), [`dependencies/src/main/java/com/taskmanagement/adapter/api/TaskApiController.java`](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/api/TaskApiController.java) (REST API), [`dependencies/src/main/java/com/taskmanagement/adapter/persistence/IOSaveToSQLite.java`](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/persistence/IOSaveToSQLite.java) (SQLite storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entrypoints["User interfaces"]
  node_console["Console UI<br/>[IOConsole.java]"]
  node_swing["Swing GUI<br/>[GUISwing.java]"]
  node_webui["Web UI<br/>[WebUI.java]"]
  node_api["REST API"]
  node_apierrors["API errors"]
  node_bootstrap["Demo bootstrap<br/>[Main.java]"]
  node_apiapp["API bootstrap"]
end

subgraph group_application["Application layer"]
  node_control["Task control<br/>[TaskControl.java]"]
  node_taskdto["Task DTOs<br/>[TaskInputDTO.java]"]
  node_boundaries["Task boundaries"]
  node_presenters["Task presenters"]
end

subgraph group_domain["Task domain"]
  node_task["Task entity<br/>[Task.java]"]
  node_tasktypes["Task types"]
  node_taskvalues["Task values"]
  node_taskexceptions["Domain exceptions"]
  node_project["Project model<br/>[Project.java]"]
  node_prioritycalc["Priority calculator"]
end

subgraph group_adapters["Persistence adapters"]
  node_sqlite[("SQLite storage")]
  node_memory[("Memory storage")]
  node_file[("File storage<br/>[IOSaveToFile.java]")]
end

node_user(("User"))

node_user -->|"uses"| node_console
node_user -->|"uses"| node_swing
node_user -->|"uses"| node_webui
node_user -->|"requests"| node_api
node_api -->|"dispatches"| node_control
node_api -->|"maps requests"| node_taskdto
node_apierrors -->|"handles"| node_taskexceptions
node_apierrors -->|"formats errors"| node_api
node_control -->|"maps data"| node_taskdto
node_control -->|"creates and changes"| node_task
node_control -->|"uses contracts"| node_boundaries
node_control -->|"presents results"| node_presenters
node_task -->|"uses"| node_tasktypes
node_task -->|"uses"| node_taskvalues
node_task -->|"raises"| node_taskexceptions
node_project -->|"references"| node_task
node_prioritycalc -->|"calculates priority"| node_task
node_bootstrap -->|"configures"| node_control
node_bootstrap -->|"configures"| node_presenters
node_bootstrap -->|"configures"| node_sqlite
node_apiapp -->|"configures"| node_control
node_apiapp -->|"configures"| node_sqlite
node_console -.->|"uses presenter"| node_presenters
node_swing -.->|"demo uses"| node_sqlite
node_console -.->|"demo uses"| node_memory
node_api -.->|"demo uses"| node_sqlite

click node_console "https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/infrastructure/ui/IOConsole.java"
click node_swing "https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/infrastructure/ui/GUISwing.java"
click node_webui "https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/infrastructure/ui/WebUI.java"
click node_api "https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/api/TaskApiController.java"
click node_apierrors "https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/api/GlobalApiExceptionHandler.java"
click node_control "https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/application/control/TaskControl.java"
click node_taskdto "https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/application/dto/TaskInputDTO.java"
click node_boundaries "https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/application/boundary/TaskRepository.java"
click node_presenters "https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/presenter/TaskConsolePresenter.java"
click node_task "https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/domain/task/entity/Task.java"
click node_tasktypes "https://github.com/barolam/domain-driven-design/tree/main/dependencies/src/main/java/com/taskmanagement/domain/task/enum"
click node_taskvalues "https://github.com/barolam/domain-driven-design/tree/main/dependencies/src/main/java/com/taskmanagement/domain/task/valueobject"
click node_taskexceptions "https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/domain/task/exception/DomainException.java"
click node_project "https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/domain/project/entity/Project.java"
click node_prioritycalc "https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/domain/service/TaskPriorityCalculator.java"
click node_sqlite "https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/persistence/IOSaveToSQLite.java"
click node_memory "https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/persistence/IOSaveToMemory.java"
click node_file "https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/persistence/IOSaveToFile.java"
click node_bootstrap "https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/infrastructure/config/Main.java"
click node_apiapp "https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/infrastructure/api/ApiApplication.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_console,node_swing,node_webui,node_api,node_apierrors,node_bootstrap,node_apiapp,node_user toneBlue
class node_control,node_taskdto,node_boundaries,node_presenters toneAmber
class node_task,node_tasktypes,node_taskvalues,node_taskexceptions,node_project,node_prioritycalc toneMint
class node_sqlite,node_memory,node_file toneRose
```

## Components

### User interfaces

- [Console UI](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/infrastructure/ui/IOConsole.java): `dependencies/src/main/java/com/taskmanagement/infrastructure/ui/IOConsole.java`
- [Swing GUI](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/infrastructure/ui/GUISwing.java): `dependencies/src/main/java/com/taskmanagement/infrastructure/ui/GUISwing.java`
- [Web UI](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/infrastructure/ui/WebUI.java): `dependencies/src/main/java/com/taskmanagement/infrastructure/ui/WebUI.java`
- [REST API](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/api/TaskApiController.java): `dependencies/src/main/java/com/taskmanagement/adapter/api/TaskApiController.java`
- [API errors](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/api/GlobalApiExceptionHandler.java): `dependencies/src/main/java/com/taskmanagement/adapter/api/GlobalApiExceptionHandler.java`
- [Demo bootstrap](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/infrastructure/config/Main.java): `dependencies/src/main/java/com/taskmanagement/infrastructure/config/Main.java`
- [API bootstrap](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/infrastructure/api/ApiApplication.java): `dependencies/src/main/java/com/taskmanagement/infrastructure/api/ApiApplication.java`

### Application layer

- [Task control](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/application/control/TaskControl.java): `dependencies/src/main/java/com/taskmanagement/adapter/application/control/TaskControl.java`
- [Task DTOs](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/application/dto/TaskInputDTO.java): `dependencies/src/main/java/com/taskmanagement/adapter/application/dto/TaskInputDTO.java`
- [Task boundaries](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/application/boundary/TaskRepository.java): `dependencies/src/main/java/com/taskmanagement/adapter/application/boundary/TaskRepository.java`
- [Task presenters](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/presenter/TaskConsolePresenter.java): `dependencies/src/main/java/com/taskmanagement/adapter/presenter/TaskConsolePresenter.java`

### Task domain

- [Task entity](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/domain/task/entity/Task.java): `dependencies/src/main/java/com/taskmanagement/domain/task/entity/Task.java`
- [Task types](https://github.com/barolam/domain-driven-design/tree/main/dependencies/src/main/java/com/taskmanagement/domain/task/enum): `dependencies/src/main/java/com/taskmanagement/domain/task/enum`
- [Task values](https://github.com/barolam/domain-driven-design/tree/main/dependencies/src/main/java/com/taskmanagement/domain/task/valueobject): `dependencies/src/main/java/com/taskmanagement/domain/task/valueobject`
- [Domain exceptions](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/domain/task/exception/DomainException.java): `dependencies/src/main/java/com/taskmanagement/domain/task/exception/DomainException.java`
- [Project model](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/domain/project/entity/Project.java): `dependencies/src/main/java/com/taskmanagement/domain/project/entity/Project.java`
- [Priority calculator](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/domain/service/TaskPriorityCalculator.java): `dependencies/src/main/java/com/taskmanagement/domain/service/TaskPriorityCalculator.java`

### Persistence adapters

- [SQLite storage](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/persistence/IOSaveToSQLite.java): `dependencies/src/main/java/com/taskmanagement/adapter/persistence/IOSaveToSQLite.java`
- [Memory storage](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/persistence/IOSaveToMemory.java): `dependencies/src/main/java/com/taskmanagement/adapter/persistence/IOSaveToMemory.java`
- [File storage](https://github.com/barolam/domain-driven-design/blob/main/dependencies/src/main/java/com/taskmanagement/adapter/persistence/IOSaveToFile.java): `dependencies/src/main/java/com/taskmanagement/adapter/persistence/IOSaveToFile.java`

### Other components

- **User**

## Connections

- User → Console UI: uses (evidence: `README.md`)
- User → Swing GUI: uses (evidence: `README.md`)
- User → Web UI: uses (evidence: `README.md`)
- User → REST API: requests (evidence: `README.md`)
- REST API → Task control: dispatches (evidence: `dependencies/src/main/java/com/taskmanagement/adapter/api/TaskApiController.java`)
- REST API → Task DTOs: maps requests (evidence: `dependencies/src/main/java/com/taskmanagement/adapter/api/TaskApiController.java`)
- API errors → Domain exceptions: handles (evidence: `dependencies/src/main/java/com/taskmanagement/adapter/api/GlobalApiExceptionHandler.java`)
- API errors → REST API: formats errors (evidence: `dependencies/src/main/java/com/taskmanagement/adapter/api/GlobalApiExceptionHandler.java`)
- Task control → Task DTOs: maps data (evidence: `dependencies/src/main/java/com/taskmanagement/adapter/application/control/TaskControl.java`)
- Task control → Task entity: creates and changes (evidence: `dependencies/src/main/java/com/taskmanagement/adapter/application/control/TaskControl.java`)
- Task control → Task boundaries: uses contracts (evidence: `dependencies/src/main/java/com/taskmanagement/adapter/application/control/TaskControl.java`)
- Task control → Task presenters: presents results (evidence: `dependencies/src/main/java/com/taskmanagement/adapter/application/control/TaskControl.java`)
- Task entity → Task types: uses (evidence: `dependencies/src/main/java/com/taskmanagement/domain/task/entity/Task.java`)
- Task entity → Task values: uses (evidence: `dependencies/src/main/java/com/taskmanagement/domain/task/entity/Task.java`)
- Task entity → Domain exceptions: raises (evidence: `dependencies/src/main/java/com/taskmanagement/domain/task/entity/Task.java`)
- Project model → Task entity: references (evidence: `dependencies/src/main/java/com/taskmanagement/domain/project/entity/Project.java`)
- Priority calculator → Task entity: calculates priority (evidence: `dependencies/src/main/java/com/taskmanagement/domain/service/TaskPriorityCalculator.java`)
- Demo bootstrap → Task control: configures (evidence: `dependencies/src/main/java/com/taskmanagement/infrastructure/config/Main.java`)
- Demo bootstrap → Task presenters: configures (evidence: `dependencies/src/main/java/com/taskmanagement/infrastructure/config/Main.java`)
- Demo bootstrap → SQLite storage: configures (evidence: `dependencies/src/main/java/com/taskmanagement/infrastructure/config/Main.java`)
- API bootstrap → Task control: configures (evidence: `dependencies/src/main/java/com/taskmanagement/infrastructure/api/ApiApplication.java`)
- API bootstrap → SQLite storage: configures (evidence: `dependencies/src/main/java/com/taskmanagement/infrastructure/api/ApiApplication.java`)
- Console UI → Task presenters: uses presenter (evidence: `README.md`)
- Swing GUI → SQLite storage: demo uses (evidence: `README.md`)
- Console UI → Memory storage: demo uses (evidence: `README.md`)
- REST API → SQLite storage: demo uses (evidence: `README.md`)
