# sdxky/tasklistorganizer architecture

> Architecture diagram of the GitHub repository sdxky/tasklistorganizer, 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/sdxky/tasklistorganizer
- Repository: https://github.com/sdxky/tasklistorganizer

## Overview

TaskListOrganizer is a Java console task manager. The user enters through the menu loop, supplies validated input, and views or sorts tasks; App coordinates task creation and updates through TaskManager, while Task’s state objects enforce lifecycle rules. TaskManager loads and saves through a storage interface, with PostgreSQL/JDBC and JSON-file implementations. The README also documents CRUD, priority/date/description sorting, overdue display, and input validation. Main’s wiring is supported by the source index and README; implementation details for that file were not excerpted.

Main entry points: [`src/App.java`](https://github.com/sdxky/tasklistorganizer/blob/main/src/App.java) (Menu workflow), [`src/Main.java`](https://github.com/sdxky/tasklistorganizer/blob/main/src/Main.java) (Startup wiring), [`src/storage/TaskJsonStorage.java`](https://github.com/sdxky/tasklistorganizer/blob/main/src/storage/TaskJsonStorage.java) (JSON storage), [`src/service/TaskManager.java`](https://github.com/sdxky/tasklistorganizer/blob/main/src/service/TaskManager.java) (Task management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application and console UI"]
  node_main["Startup wiring<br/>[Main.java]"]
  node_app["Menu workflow<br/>[App.java]"]
  node_input["Validated input<br/>[Input.java]"]
  node_menu["Menu display<br/>[Menu.java]"]
  node_printer["Task formatting<br/>[TaskPrinter.java]"]
end

subgraph group_domain["Task domain"]
  node_task["Task entity<br/>[Task.java]"]
  node_taskstate["State contract<br/>[TaskState.java]"]
  node_newstate["New state<br/>[NewState.java]"]
  node_progressstate["In-progress state"]
  node_donestate["Done state<br/>[DoneState.java]"]
  node_status["Status values<br/>[Status.java]"]
  node_priority["Priority values<br/>[Priority.java]"]
end

subgraph group_service["Task service"]
  node_manager["Task management<br/>[TaskManager.java]"]
end

subgraph group_persistence["Persistence"]
  node_storageapi["Storage contract<br/>[TaskStorage.java]"]
  node_jsonstorage["JSON storage"]
  node_dateadapter["Date adapter"]
  node_postgresstorage["PostgreSQL storage"]
  node_jsonfile["Task data file<br/>[tasks.json]"]
end

node_user(("Console user"))
node_postgres[("PostgreSQL database")]

node_user -->|"uses menu"| node_app
node_main -->|"starts"| node_app
node_main -->|"wires"| node_manager
node_main -.->|"selects backend"| node_jsonstorage
node_main -.->|"selects backend"| node_postgresstorage
node_app -->|"prints"| node_menu
node_app -->|"reads input"| node_input
node_app -->|"formats tasks"| node_printer
node_app -->|"manages tasks"| node_manager
node_app -->|"creates and updates"| node_task
node_app -->|"initializes state"| node_newstate
node_app -->|"reads priority"| node_priority
node_app -->|"sets status"| node_status
node_task -->|"dispatches actions"| node_taskstate
node_newstate -->|"transitions to"| node_progressstate
node_progressstate -->|"transitions to"| node_donestate
node_newstate -->|"removes task"| node_manager
node_manager -->|"loads and saves"| node_storageapi
node_jsonstorage -->|"implements"| node_storageapi
node_postgresstorage -->|"implements"| node_storageapi
node_jsonstorage -->|"registers"| node_dateadapter
node_jsonstorage -->|"reads and writes"| node_jsonfile
node_postgresstorage -->|"queries and updates"| node_postgres

click node_main "https://github.com/sdxky/tasklistorganizer/blob/main/src/Main.java"
click node_app "https://github.com/sdxky/tasklistorganizer/blob/main/src/App.java"
click node_input "https://github.com/sdxky/tasklistorganizer/blob/main/src/ui/Input.java"
click node_menu "https://github.com/sdxky/tasklistorganizer/blob/main/src/ui/Menu.java"
click node_printer "https://github.com/sdxky/tasklistorganizer/blob/main/src/ui/TaskPrinter.java"
click node_task "https://github.com/sdxky/tasklistorganizer/blob/main/src/model/Task.java"
click node_taskstate "https://github.com/sdxky/tasklistorganizer/blob/main/src/model/TaskState.java"
click node_newstate "https://github.com/sdxky/tasklistorganizer/blob/main/src/model/NewState.java"
click node_progressstate "https://github.com/sdxky/tasklistorganizer/blob/main/src/model/InProgressState.java"
click node_donestate "https://github.com/sdxky/tasklistorganizer/blob/main/src/model/DoneState.java"
click node_status "https://github.com/sdxky/tasklistorganizer/blob/main/src/model/Status.java"
click node_priority "https://github.com/sdxky/tasklistorganizer/blob/main/src/model/Priority.java"
click node_manager "https://github.com/sdxky/tasklistorganizer/blob/main/src/service/TaskManager.java"
click node_storageapi "https://github.com/sdxky/tasklistorganizer/blob/main/src/storage/TaskStorage.java"
click node_jsonstorage "https://github.com/sdxky/tasklistorganizer/blob/main/src/storage/TaskJsonStorage.java"
click node_dateadapter "https://github.com/sdxky/tasklistorganizer/blob/main/src/storage/LocalDateAdapter.java"
click node_postgresstorage "https://github.com/sdxky/tasklistorganizer/blob/main/src/storage/TaskPostgresStorage.java"
click node_jsonfile "https://github.com/sdxky/tasklistorganizer/blob/main/data/tasks.json"

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_main,node_app,node_input,node_menu,node_printer,node_user toneBlue
class node_task,node_taskstate,node_newstate,node_progressstate,node_donestate,node_status,node_priority,node_postgres toneAmber
class node_manager toneMint
class node_storageapi,node_jsonstorage,node_dateadapter,node_postgresstorage,node_jsonfile toneRose
```

## Components

### Application and console UI

- [Startup wiring](https://github.com/sdxky/tasklistorganizer/blob/main/src/Main.java): `src/Main.java`
- [Menu workflow](https://github.com/sdxky/tasklistorganizer/blob/main/src/App.java): `src/App.java`
- [Validated input](https://github.com/sdxky/tasklistorganizer/blob/main/src/ui/Input.java): `src/ui/Input.java`
- [Menu display](https://github.com/sdxky/tasklistorganizer/blob/main/src/ui/Menu.java): `src/ui/Menu.java`
- [Task formatting](https://github.com/sdxky/tasklistorganizer/blob/main/src/ui/TaskPrinter.java): `src/ui/TaskPrinter.java`

### Task domain

- [Task entity](https://github.com/sdxky/tasklistorganizer/blob/main/src/model/Task.java): `src/model/Task.java`
- [State contract](https://github.com/sdxky/tasklistorganizer/blob/main/src/model/TaskState.java): `src/model/TaskState.java`
- [New state](https://github.com/sdxky/tasklistorganizer/blob/main/src/model/NewState.java): `src/model/NewState.java`
- [In-progress state](https://github.com/sdxky/tasklistorganizer/blob/main/src/model/InProgressState.java): `src/model/InProgressState.java`
- [Done state](https://github.com/sdxky/tasklistorganizer/blob/main/src/model/DoneState.java): `src/model/DoneState.java`
- [Status values](https://github.com/sdxky/tasklistorganizer/blob/main/src/model/Status.java): `src/model/Status.java`
- [Priority values](https://github.com/sdxky/tasklistorganizer/blob/main/src/model/Priority.java): `src/model/Priority.java`

### Task service

- [Task management](https://github.com/sdxky/tasklistorganizer/blob/main/src/service/TaskManager.java): `src/service/TaskManager.java`

### Persistence

- [Storage contract](https://github.com/sdxky/tasklistorganizer/blob/main/src/storage/TaskStorage.java): `src/storage/TaskStorage.java`
- [JSON storage](https://github.com/sdxky/tasklistorganizer/blob/main/src/storage/TaskJsonStorage.java): `src/storage/TaskJsonStorage.java`
- [Date adapter](https://github.com/sdxky/tasklistorganizer/blob/main/src/storage/LocalDateAdapter.java): `src/storage/LocalDateAdapter.java`
- [PostgreSQL storage](https://github.com/sdxky/tasklistorganizer/blob/main/src/storage/TaskPostgresStorage.java): `src/storage/TaskPostgresStorage.java`
- [Task data file](https://github.com/sdxky/tasklistorganizer/blob/main/data/tasks.json): `data/tasks.json`

### Other components

- **Console user**
- **PostgreSQL database**

## Connections

- Console user → Menu workflow: uses menu (evidence: `README.md`)
- Startup wiring → Menu workflow: starts (evidence: `README.md`)
- Startup wiring → Task management: wires (evidence: `src/Main.java`)
- Startup wiring → JSON storage: selects backend (evidence: `src/Main.java`)
- Startup wiring → PostgreSQL storage: selects backend (evidence: `src/Main.java`)
- Menu workflow → Menu display: prints (evidence: `src/App.java`)
- Menu workflow → Validated input: reads input (evidence: `src/App.java`)
- Menu workflow → Task formatting: formats tasks (evidence: `src/App.java`)
- Menu workflow → Task management: manages tasks (evidence: `src/App.java`)
- Menu workflow → Task entity: creates and updates (evidence: `src/App.java`)
- Menu workflow → New state: initializes state (evidence: `src/App.java`)
- Menu workflow → Priority values: reads priority (evidence: `src/App.java`)
- Menu workflow → Status values: sets status (evidence: `src/App.java`)
- Task entity → State contract: dispatches actions (evidence: `src/model/Task.java`)
- New state → In-progress state: transitions to (evidence: `src/model/NewState.java`)
- In-progress state → Done state: transitions to (evidence: `src/model/InProgressState.java`)
- New state → Task management: removes task (evidence: `src/model/NewState.java`)
- Task management → Storage contract: loads and saves (evidence: `src/service/TaskManager.java`)
- JSON storage → Storage contract: implements (evidence: `src/storage/TaskJsonStorage.java`)
- PostgreSQL storage → Storage contract: implements (evidence: `src/storage/TaskPostgresStorage.java`)
- JSON storage → Date adapter: registers (evidence: `src/storage/TaskJsonStorage.java`)
- JSON storage → Task data file: reads and writes (evidence: `src/storage/TaskJsonStorage.java`)
- PostgreSQL storage → PostgreSQL database: queries and updates (evidence: `src/storage/TaskPostgresStorage.java`)
