# hphehe/ip architecture

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

## Overview

Larp is a personal task-assistant chatbot with both console and JavaFX interfaces. A user submits commands; the application parses task creation, search, completion, and deletion requests, updates an in-memory task list, persists changes in a local text file, and formats responses. Tasks include plain todos, dated deadlines, and timed events. The graph captures the command coordinator and task model as internal layers. Relationships are based on the provided excerpts and README; unsampled wiring is omitted.

Main entry points: [`src/main/java/larp/Larp.java`](https://github.com/hphehe/ip/blob/master/src/main/java/larp/Larp.java) (Command coordinator), [`src/main/java/larp/Storage.java`](https://github.com/hphehe/ip/blob/master/src/main/java/larp/Storage.java) (File storage), [`src/main/java/larp/Parser.java`](https://github.com/hphehe/ip/blob/master/src/main/java/larp/Parser.java) (Command parser), [`src/main/java/larp/MainWindow.java`](https://github.com/hphehe/ip/blob/master/src/main/java/larp/MainWindow.java) (Main window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User interfaces"]
  node_console_ui["Console UI<br/>[Ui.java]"]
  node_javafx_app["JavaFX startup<br/>[Main.java]"]
  node_window["Main window<br/>[MainWindow.java]"]
  node_dialogs["Dialog views<br/>[DialogBox.java]"]
end

subgraph group_application["Command application"]
  node_larp["Command coordinator<br/>[Larp.java]"]
  node_parser["Command parser<br/>[Parser.java]"]
  node_errors["User errors<br/>[LarpException.java]"]
end

subgraph group_tasks["Task domain"]
  node_task_list["Task collection<br/>[TaskList.java]"]
  node_task["Task state<br/>[Task.java]"]
  node_todo["Todo task<br/>[Todo.java]"]
  node_deadline["Deadline task<br/>[Deadline.java]"]
  node_event["Event task<br/>[Event.java]"]
end

subgraph group_persistence["Persistence"]
  node_storage["File storage<br/>[Storage.java]"]
  node_task_file[("Task data file")]
end

node_console_user(("Console user"))
node_gui_user(("GUI user"))

node_console_user -->|"enters commands"| node_console_ui
node_console_ui -->|"supplies input"| node_larp
node_larp -->|"formats output"| node_console_ui
node_gui_user -->|"enters commands"| node_window
node_javafx_app -->|"loads controller"| node_window
node_javafx_app -->|"creates logic"| node_larp
node_window -->|"submits commands"| node_larp
node_window -->|"creates dialogs"| node_dialogs
node_larp -->|"parses commands"| node_parser
node_larp -->|"updates tasks"| node_task_list
node_larp -->|"loads and saves"| node_storage
node_larp -->|"formats responses"| node_console_ui
node_parser -->|"creates tasks"| node_todo
node_parser -->|"creates tasks"| node_deadline
node_parser -->|"creates tasks"| node_event
node_task_list -->|"manages instances"| node_task
node_todo -->|"extends"| node_task
node_deadline -->|"extends"| node_task
node_event -->|"extends"| node_task
node_storage -->|"reads and writes"| node_task_file
node_storage -->|"loads and serializes"| node_task_list
node_storage -->|"reconstructs and formats"| node_todo
node_storage -->|"reconstructs and formats"| node_deadline
node_storage -->|"reconstructs and formats"| node_event
node_parser -->|"raises validation errors"| node_errors

click node_console_ui "https://github.com/hphehe/ip/blob/master/src/main/java/larp/Ui.java"
click node_javafx_app "https://github.com/hphehe/ip/blob/master/src/main/java/larp/Main.java"
click node_window "https://github.com/hphehe/ip/blob/master/src/main/java/larp/MainWindow.java"
click node_dialogs "https://github.com/hphehe/ip/blob/master/src/main/java/larp/DialogBox.java"
click node_larp "https://github.com/hphehe/ip/blob/master/src/main/java/larp/Larp.java"
click node_parser "https://github.com/hphehe/ip/blob/master/src/main/java/larp/Parser.java"
click node_errors "https://github.com/hphehe/ip/blob/master/src/main/java/larp/LarpException.java"
click node_task_list "https://github.com/hphehe/ip/blob/master/src/main/java/larp/TaskList.java"
click node_task "https://github.com/hphehe/ip/blob/master/src/main/java/larp/Task.java"
click node_todo "https://github.com/hphehe/ip/blob/master/src/main/java/larp/Todo.java"
click node_deadline "https://github.com/hphehe/ip/blob/master/src/main/java/larp/Deadline.java"
click node_event "https://github.com/hphehe/ip/blob/master/src/main/java/larp/Event.java"
click node_storage "https://github.com/hphehe/ip/blob/master/src/main/java/larp/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_console_ui,node_javafx_app,node_window,node_dialogs,node_console_user,node_gui_user toneBlue
class node_larp,node_parser,node_errors toneAmber
class node_task_list,node_task,node_todo,node_deadline,node_event toneMint
class node_storage,node_task_file toneRose
```

## Components

### User interfaces

- [Console UI](https://github.com/hphehe/ip/blob/master/src/main/java/larp/Ui.java): `src/main/java/larp/Ui.java`
- [JavaFX startup](https://github.com/hphehe/ip/blob/master/src/main/java/larp/Main.java): `src/main/java/larp/Main.java`
- [Main window](https://github.com/hphehe/ip/blob/master/src/main/java/larp/MainWindow.java): `src/main/java/larp/MainWindow.java`
- [Dialog views](https://github.com/hphehe/ip/blob/master/src/main/java/larp/DialogBox.java): `src/main/java/larp/DialogBox.java`

### Command application

- [Command coordinator](https://github.com/hphehe/ip/blob/master/src/main/java/larp/Larp.java): `src/main/java/larp/Larp.java`
- [Command parser](https://github.com/hphehe/ip/blob/master/src/main/java/larp/Parser.java): `src/main/java/larp/Parser.java`
- [User errors](https://github.com/hphehe/ip/blob/master/src/main/java/larp/LarpException.java): `src/main/java/larp/LarpException.java`

### Task domain

- [Task collection](https://github.com/hphehe/ip/blob/master/src/main/java/larp/TaskList.java): `src/main/java/larp/TaskList.java`
- [Task state](https://github.com/hphehe/ip/blob/master/src/main/java/larp/Task.java): `src/main/java/larp/Task.java`
- [Todo task](https://github.com/hphehe/ip/blob/master/src/main/java/larp/Todo.java): `src/main/java/larp/Todo.java`
- [Deadline task](https://github.com/hphehe/ip/blob/master/src/main/java/larp/Deadline.java): `src/main/java/larp/Deadline.java`
- [Event task](https://github.com/hphehe/ip/blob/master/src/main/java/larp/Event.java): `src/main/java/larp/Event.java`

### Persistence

- [File storage](https://github.com/hphehe/ip/blob/master/src/main/java/larp/Storage.java): `src/main/java/larp/Storage.java`
- **Task data file**

### Other components

- **Console user**
- **GUI user**

## Connections

- Console user → Console UI: enters commands (evidence: `src/main/java/larp/Ui.java`)
- Console UI → Command coordinator: supplies input (evidence: `src/main/java/larp/Larp.java`)
- Command coordinator → Console UI: formats output (evidence: `src/main/java/larp/Larp.java`)
- GUI user → Main window: enters commands (evidence: `src/main/java/larp/MainWindow.java`)
- JavaFX startup → Main window: loads controller (evidence: `src/main/java/larp/Main.java`)
- JavaFX startup → Command coordinator: creates logic (evidence: `src/main/java/larp/Main.java`)
- Main window → Command coordinator: submits commands (evidence: `src/main/java/larp/MainWindow.java`)
- Main window → Dialog views: creates dialogs (evidence: `src/main/java/larp/MainWindow.java`)
- Command coordinator → Command parser: parses commands (evidence: `src/main/java/larp/Larp.java`)
- Command coordinator → Task collection: updates tasks (evidence: `src/main/java/larp/Larp.java`)
- Command coordinator → File storage: loads and saves (evidence: `src/main/java/larp/Larp.java`)
- Command coordinator → Console UI: formats responses (evidence: `src/main/java/larp/Larp.java`)
- Command parser → Todo task: creates tasks (evidence: `src/main/java/larp/Parser.java`)
- Command parser → Deadline task: creates tasks (evidence: `src/main/java/larp/Parser.java`)
- Command parser → Event task: creates tasks (evidence: `src/main/java/larp/Parser.java`)
- Task collection → Task state: manages instances (evidence: `src/main/java/larp/TaskList.java`)
- Todo task → Task state: extends (evidence: `src/main/java/larp/Todo.java`)
- Deadline task → Task state: extends (evidence: `src/main/java/larp/Deadline.java`)
- Event task → Task state: extends (evidence: `src/main/java/larp/Event.java`)
- File storage → Task data file: reads and writes (evidence: `src/main/java/larp/Storage.java`)
- File storage → Task collection: loads and serializes (evidence: `src/main/java/larp/Storage.java`)
- File storage → Todo task: reconstructs and formats (evidence: `src/main/java/larp/Storage.java`)
- File storage → Deadline task: reconstructs and formats (evidence: `src/main/java/larp/Storage.java`)
- File storage → Event task: reconstructs and formats (evidence: `src/main/java/larp/Storage.java`)
- Command parser → User errors: raises validation errors (evidence: `src/main/java/larp/Parser.java`)
