# duynguyen21007/ip architecture

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

- Interactive diagram: https://gitdiagram.com/duynguyen21007/ip
- Repository: https://github.com/duynguyen21007/ip

## Overview

Milo is a task-management chatbot with both console and JavaFX entry points. The principal workflow accepts a user command, parses it into an executable command, applies it to the task list, optionally persists changes, and presents a response. Its domain supports todo, deadline, and event tasks; listing, search, completion changes, deletion, help, and statistics. Edges reflect relationships shown in excerpts, the SOURCE INDEX, or README; unsampled JavaFX wiring is kept limited to documented/indexed relationships.

Main entry points: [`src/main/java/milo/Milo.java`](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/Milo.java) (Milo coordinator), [`src/main/java/milo/command`](https://github.com/duynguyen21007/ip/tree/master/src/main/java/milo/command) (Command handlers), [`src/main/java/milo/parser/Parser.java`](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/parser/Parser.java) (Command parser), [`src/main/java/milo/task/TaskList.java`](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/task/TaskList.java) (Ordered task list)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User interfaces"]
  node_launcher["Application launcher<br/>[Launcher.java]"]
  node_fxapp["JavaFX app<br/>[Main.java]"]
  node_window["Chat window<br/>[MainWindow.java]"]
  node_dialog["Chat dialog<br/>[DialogBox.java]"]
  node_console["Console UI<br/>[Ui.java]"]
end

subgraph group_workflow["Command workflow"]
  node_milo["Milo coordinator<br/>[Milo.java]"]
  node_parser["Command parser<br/>[Parser.java]"]
  node_commands["Command handlers"]
  node_taskcommand["Task selection<br/>[TaskCommand.java]"]
  node_errors["Recoverable errors<br/>[MiloException.java]"]
end

subgraph group_domain["Task domain"]
  node_tasklist["Ordered task list<br/>[TaskList.java]"]
  node_task["Task state<br/>[Task.java]"]
  node_todo["Todo tasks<br/>[Todo.java]"]
  node_deadline["Deadline tasks<br/>[Deadline.java]"]
  node_event["Event tasks<br/>[Event.java]"]
  node_statistics["Task statistics"]
end

subgraph group_persistence["Persistence"]
  node_storage["File storage<br/>[Storage.java]"]
  node_taskfile[("Saved task file")]
end

node_user(("User"))

node_user -->|"starts"| node_launcher
node_launcher -->|"launches"| node_milo
node_user -->|"enters commands"| node_console
node_console -->|"provides input"| node_milo
node_user -.->|"uses"| node_window
node_fxapp -->|"creates"| node_milo
node_window -->|"uses"| node_milo
node_window -->|"renders"| node_dialog
node_milo -->|"parses input"| node_parser
node_parser -->|"creates command"| node_commands
node_milo -->|"executes"| node_commands
node_commands -->|"extends"| node_taskcommand
node_commands -->|"operates on"| node_tasklist
node_commands -->|"persists changes"| node_storage
node_commands -->|"presents results"| node_console
node_parser -->|"builds"| node_todo
node_parser -->|"builds"| node_deadline
node_parser -->|"builds"| node_event
node_tasklist -->|"stores"| node_task
node_todo -->|"extends"| node_task
node_deadline -->|"extends"| node_task
node_event -->|"extends"| node_task
node_tasklist -->|"summarized by"| node_statistics
node_milo -->|"loads at startup"| node_storage
node_storage -->|"loads tasks"| node_tasklist
node_storage -->|"reads and writes"| node_taskfile
node_milo -->|"handles"| node_errors

click node_launcher "https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/Launcher.java"
click node_fxapp "https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/gui/Main.java"
click node_window "https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/gui/MainWindow.java"
click node_dialog "https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/gui/DialogBox.java"
click node_console "https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/ui/Ui.java"
click node_milo "https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/Milo.java"
click node_parser "https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/parser/Parser.java"
click node_commands "https://github.com/duynguyen21007/ip/tree/master/src/main/java/milo/command"
click node_taskcommand "https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/command/TaskCommand.java"
click node_errors "https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/exception/MiloException.java"
click node_tasklist "https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/task/TaskList.java"
click node_task "https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/task/Task.java"
click node_todo "https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/task/Todo.java"
click node_deadline "https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/task/Deadline.java"
click node_event "https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/task/Event.java"
click node_statistics "https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/task/TaskStatistics.java"
click node_storage "https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/storage/Storage.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_launcher,node_fxapp,node_window,node_dialog,node_console,node_user toneBlue
class node_milo,node_parser,node_commands,node_taskcommand,node_errors toneAmber
class node_tasklist,node_task,node_todo,node_deadline,node_event,node_statistics toneMint
class node_storage,node_taskfile toneRose
```

## Components

### User interfaces

- [Application launcher](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/Launcher.java): `src/main/java/milo/Launcher.java`
- [JavaFX app](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/gui/Main.java): `src/main/java/milo/gui/Main.java`
- [Chat window](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/gui/MainWindow.java): `src/main/java/milo/gui/MainWindow.java`
- [Chat dialog](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/gui/DialogBox.java): `src/main/java/milo/gui/DialogBox.java`
- [Console UI](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/ui/Ui.java): `src/main/java/milo/ui/Ui.java`

### Command workflow

- [Milo coordinator](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/Milo.java): `src/main/java/milo/Milo.java`
- [Command parser](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/parser/Parser.java): `src/main/java/milo/parser/Parser.java`
- [Command handlers](https://github.com/duynguyen21007/ip/tree/master/src/main/java/milo/command): `src/main/java/milo/command`
- [Task selection](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/command/TaskCommand.java): `src/main/java/milo/command/TaskCommand.java`
- [Recoverable errors](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/exception/MiloException.java): `src/main/java/milo/exception/MiloException.java`

### Task domain

- [Ordered task list](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/task/TaskList.java): `src/main/java/milo/task/TaskList.java`
- [Task state](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/task/Task.java): `src/main/java/milo/task/Task.java`
- [Todo tasks](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/task/Todo.java): `src/main/java/milo/task/Todo.java`
- [Deadline tasks](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/task/Deadline.java): `src/main/java/milo/task/Deadline.java`
- [Event tasks](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/task/Event.java): `src/main/java/milo/task/Event.java`
- [Task statistics](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/task/TaskStatistics.java): `src/main/java/milo/task/TaskStatistics.java`

### Persistence

- [File storage](https://github.com/duynguyen21007/ip/blob/master/src/main/java/milo/storage/Storage.java): `src/main/java/milo/storage/Storage.java`
- **Saved task file**

### Other components

- **User**

## Connections

- User → Application launcher: starts (evidence: `src/main/java/milo/Launcher.java`)
- Application launcher → Milo coordinator: launches (evidence: `src/main/java/milo/Launcher.java`)
- User → Console UI: enters commands (evidence: `src/main/java/milo/ui/Ui.java`)
- Console UI → Milo coordinator: provides input (evidence: `src/main/java/milo/Milo.java`)
- User → Chat window: uses
- JavaFX app → Milo coordinator: creates (evidence: `src/main/java/milo/gui/Main.java`)
- Chat window → Milo coordinator: uses (evidence: `src/main/java/milo/gui/MainWindow.java`)
- Chat window → Chat dialog: renders (evidence: `src/main/java/milo/gui/MainWindow.java`)
- Milo coordinator → Command parser: parses input (evidence: `src/main/java/milo/Milo.java`)
- Command parser → Command handlers: creates command (evidence: `src/main/java/milo/parser/Parser.java`)
- Milo coordinator → Command handlers: executes (evidence: `src/main/java/milo/Milo.java`)
- Command handlers → Task selection: extends (evidence: `src/main/java/milo/command/TaskCommand.java`)
- Command handlers → Ordered task list: operates on (evidence: `src/main/java/milo/command/Command.java`)
- Command handlers → File storage: persists changes (evidence: `src/main/java/milo/command/Command.java`)
- Command handlers → Console UI: presents results (evidence: `src/main/java/milo/command/Command.java`)
- Command parser → Todo tasks: builds (evidence: `src/main/java/milo/parser/Parser.java`)
- Command parser → Deadline tasks: builds (evidence: `src/main/java/milo/parser/Parser.java`)
- Command parser → Event tasks: builds (evidence: `src/main/java/milo/parser/Parser.java`)
- Ordered task list → Task state: stores (evidence: `src/main/java/milo/task/TaskList.java`)
- Todo tasks → Task state: extends (evidence: `src/main/java/milo/task/Todo.java`)
- Deadline tasks → Task state: extends (evidence: `src/main/java/milo/task/Deadline.java`)
- Event tasks → Task state: extends (evidence: `src/main/java/milo/task/Event.java`)
- Ordered task list → Task statistics: summarized by (evidence: `src/main/java/milo/task/TaskStatistics.java`)
- Milo coordinator → File storage: loads at startup (evidence: `src/main/java/milo/Milo.java`)
- File storage → Ordered task list: loads tasks (evidence: `src/main/java/milo/storage/Storage.java`)
- File storage → Saved task file: reads and writes (evidence: `src/main/java/milo/storage/Storage.java`)
- Milo coordinator → Recoverable errors: handles (evidence: `src/main/java/milo/Milo.java`)
