# ay2627s1-cs2103t-w13-4/tp architecture

> Architecture diagram of the GitHub repository ay2627s1-cs2103t-w13-4/tp, 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/ay2627s1-cs2103t-w13-4/tp
- Repository: https://github.com/ay2627s1-cs2103t-w13-4/tp

## Overview

PingBook is a desktop client-and-meeting manager for secretaries and sales representatives, designed around short CLI commands with a GUI. The documented client workflow enters through the UI, is parsed and dispatched by the logic layer, changes the in-memory address book, and is persisted through JSON storage. The model also exposes meeting data, and README documents meeting commands, but the provided source excerpts do not show their command implementation or wiring. Relationships are limited to indexed references, excerpts, and README statements; unverified links are dashed.

Main entry points: [`src/main/java/seedu/address/logic/LogicManager.java`](https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/logic/LogicManager.java) (Logic manager), [`src/main/java/seedu/address/model/ModelManager.java`](https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/model/ModelManager.java) (Model manager), [`src/main/java/seedu/address/storage/StorageManager.java`](https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/storage/StorageManager.java) (Storage manager), [`src/main/java/seedu/address/ui`](https://github.com/ay2627s1-cs2103t-w13-4/tp/tree/master/src/main/java/seedu/address/ui) (Desktop UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["User interaction"]
  node_desktop["Desktop UI"]
  node_command_entry["Command entry<br/>[CommandBox.java]"]
end

subgraph group_logic["Command processing"]
  node_logic_manager["Logic manager<br/>[LogicManager.java]"]
  node_command_parser["Command parser"]
  node_commands["Client commands"]
end

subgraph group_domain["Address book model"]
  node_model_manager["Model manager<br/>[ModelManager.java]"]
  node_address_book["Client records<br/>[AddressBook.java]"]
  node_person["Client details<br/>[Person.java]"]
  node_meetings["Meeting records"]
end

subgraph group_persistence["Local persistence"]
  node_storage_manager["Storage manager"]
  node_book_storage["Address book JSON"]
  node_prefs_storage["Preferences JSON"]
  node_json_files[("Local JSON files")]
end

node_user(("Secretary or rep"))

node_user -->|"enters commands"| node_command_entry
node_user -->|"uses GUI"| node_desktop
node_command_entry -.->|"submits commands"| node_logic_manager
node_desktop -->|"uses logic"| node_logic_manager
node_logic_manager -->|"parses input"| node_command_parser
node_command_parser -->|"dispatches commands"| node_commands
node_commands -->|"updates clients"| node_model_manager
node_model_manager -->|"manages records"| node_address_book
node_address_book -.->|"stores clients"| node_person
node_model_manager -->|"manages meetings"| node_meetings
node_user -.->|"requests meeting actions"| node_meetings
node_logic_manager -->|"loads and saves"| node_storage_manager
node_storage_manager -->|"delegates book I/O"| node_book_storage
node_storage_manager -->|"delegates prefs I/O"| node_prefs_storage
node_book_storage -->|"reads and writes"| node_json_files
node_prefs_storage -.->|"reads and writes"| node_json_files

click node_desktop "https://github.com/ay2627s1-cs2103t-w13-4/tp/tree/master/src/main/java/seedu/address/ui"
click node_command_entry "https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/ui/CommandBox.java"
click node_logic_manager "https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/logic/LogicManager.java"
click node_command_parser "https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/logic/parser/AddressBookParser.java"
click node_commands "https://github.com/ay2627s1-cs2103t-w13-4/tp/tree/master/src/main/java/seedu/address/logic/commands"
click node_model_manager "https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/model/ModelManager.java"
click node_address_book "https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/model/AddressBook.java"
click node_person "https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/model/person/Person.java"
click node_meetings "https://github.com/ay2627s1-cs2103t-w13-4/tp/tree/master/src/main/java/seedu/address/model/meeting"
click node_storage_manager "https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/storage/StorageManager.java"
click node_book_storage "https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/storage/JsonAddressBookStorage.java"
click node_prefs_storage "https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/storage/JsonUserPrefsStorage.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_desktop,node_command_entry toneBlue
class node_logic_manager,node_command_parser,node_commands toneAmber
class node_model_manager,node_address_book,node_person,node_meetings toneMint
class node_storage_manager,node_book_storage,node_prefs_storage,node_json_files toneRose
class node_user toneIndigo
```

## Components

### User interaction

- [Desktop UI](https://github.com/ay2627s1-cs2103t-w13-4/tp/tree/master/src/main/java/seedu/address/ui): `src/main/java/seedu/address/ui`
- [Command entry](https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/ui/CommandBox.java): `src/main/java/seedu/address/ui/CommandBox.java`

### Command processing

- [Logic manager](https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/logic/LogicManager.java): `src/main/java/seedu/address/logic/LogicManager.java`
- [Command parser](https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/logic/parser/AddressBookParser.java): `src/main/java/seedu/address/logic/parser/AddressBookParser.java`
- [Client commands](https://github.com/ay2627s1-cs2103t-w13-4/tp/tree/master/src/main/java/seedu/address/logic/commands): `src/main/java/seedu/address/logic/commands`

### Address book model

- [Model manager](https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/model/ModelManager.java): `src/main/java/seedu/address/model/ModelManager.java`
- [Client records](https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/model/AddressBook.java): `src/main/java/seedu/address/model/AddressBook.java`
- [Client details](https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/model/person/Person.java): `src/main/java/seedu/address/model/person/Person.java`
- [Meeting records](https://github.com/ay2627s1-cs2103t-w13-4/tp/tree/master/src/main/java/seedu/address/model/meeting): `src/main/java/seedu/address/model/meeting`

### Local persistence

- [Storage manager](https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/storage/StorageManager.java): `src/main/java/seedu/address/storage/StorageManager.java`
- [Address book JSON](https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/storage/JsonAddressBookStorage.java): `src/main/java/seedu/address/storage/JsonAddressBookStorage.java`
- [Preferences JSON](https://github.com/ay2627s1-cs2103t-w13-4/tp/blob/master/src/main/java/seedu/address/storage/JsonUserPrefsStorage.java): `src/main/java/seedu/address/storage/JsonUserPrefsStorage.java`
- **Local JSON files**

### Other components

- **Secretary or rep**

## Connections

- Secretary or rep → Command entry: enters commands
- Secretary or rep → Desktop UI: uses GUI
- Command entry → Logic manager: submits commands
- Desktop UI → Logic manager: uses logic (evidence: `src/main/java/seedu/address/ui/UiManager.java`)
- Logic manager → Command parser: parses input (evidence: `src/main/java/seedu/address/logic/LogicManager.java`)
- Command parser → Client commands: dispatches commands (evidence: `src/main/java/seedu/address/logic/parser/AddressBookParser.java`)
- Client commands → Model manager: updates clients (evidence: `src/main/java/seedu/address/logic/commands/EditCommand.java`)
- Model manager → Client records: manages records (evidence: `src/main/java/seedu/address/model/ModelManager.java`)
- Client records → Client details: stores clients (evidence: `src/main/java/seedu/address/model/AddressBook.java`)
- Model manager → Meeting records: manages meetings (evidence: `src/main/java/seedu/address/model/ModelManager.java`)
- Secretary or rep → Meeting records: requests meeting actions
- Logic manager → Storage manager: loads and saves (evidence: `src/main/java/seedu/address/logic/LogicManager.java`)
- Storage manager → Address book JSON: delegates book I/O (evidence: `src/main/java/seedu/address/storage/StorageManager.java`)
- Storage manager → Preferences JSON: delegates prefs I/O (evidence: `src/main/java/seedu/address/storage/StorageManager.java`)
- Address book JSON → Local JSON files: reads and writes (evidence: `src/main/java/seedu/address/storage/JsonAddressBookStorage.java`)
- Preferences JSON → Local JSON files: reads and writes
