# zeeelord/phone_book_master architecture

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

- Interactive diagram: https://gitdiagram.com/zeeelord/phone_book_master
- Repository: https://github.com/zeeelord/phone_book_master
- Video tour (about a minute): https://gitdiagram.com/zeeelord/phone_book_master/video

## Overview

This is a small interactive phone-book application. A user enters commands in the console; Main parses and executes them against an in-memory PhoneBook, which stores named PhoneBookEntry records. The main loop supports adding, showing, updating, removing, and listing entries, plus help and exit. Separate AddCommand and ShowCommand implementations also expose command-object behavior, though the sampled Main dispatches its operations directly. The README provides no additional architecture detail; unsampled command implementations are not assumed to be wired into Main.

Main entry points: [`src/bcu/changeme/phonebook/main/Main.java`](https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/main/Main.java) (Main loop and dispatch), [`src/bcu/changeme/phonebook/model/PhoneBook.java`](https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/model/PhoneBook.java) (Phone book), [`src/bcu/changeme/phonebook/main/AddCommand.java`](https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/main/AddCommand.java) (Add command), [`src/bcu/changeme/phonebook/main/ShowCommand.java`](https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/main/ShowCommand.java) (Show command)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["Console interface"]
  node_main["Main loop and dispatch<br/>[Main.java]"]
  node_invalid["Invalid command error"]
end

subgraph group_commands["Command objects"]
  node_command["Command interface<br/>[Command.java]"]
  node_add["Add command<br/>[AddCommand.java]"]
  node_show["Show command<br/>[ShowCommand.java]"]
end

subgraph group_model["Phone-book model"]
  node_book["Phone book<br/>[PhoneBook.java]"]
  node_entry["Phone-book entry"]
  node_duplicate["Duplicate-name error"]
  node_missing["Missing-entry error"]
end

node_user(("Console user"))

node_user -->|"enters commands"| node_main
node_main -->|"prints results"| node_user
node_main -->|"dispatches operations"| node_book
node_main -->|"raises or catches"| node_invalid
node_main -->|"catches"| node_duplicate
node_main -->|"catches"| node_missing
node_add -->|"implements"| node_command
node_add -->|"adds entry"| node_book
node_add -->|"raises"| node_invalid
node_show -->|"implements"| node_command
node_show -->|"gets entry"| node_book
node_book -->|"creates and stores"| node_entry
node_book -->|"throws on duplicate"| node_duplicate
node_book -->|"throws when absent"| node_missing

click node_main "https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/main/Main.java"
click node_invalid "https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/main/InvalidCommandException.java"
click node_command "https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/main/Command.java"
click node_add "https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/main/AddCommand.java"
click node_show "https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/main/ShowCommand.java"
click node_book "https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/model/PhoneBook.java"
click node_entry "https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/model/PhoneBookEntry.java"
click node_duplicate "https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/model/AlreadyPresentException.java"
click node_missing "https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/model/NotPresentException.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_main,node_invalid,node_user toneBlue
class node_command,node_add,node_show toneAmber
class node_book,node_entry,node_duplicate,node_missing toneMint
```

## Components

### Console interface

- [Main loop and dispatch](https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/main/Main.java): `src/bcu/changeme/phonebook/main/Main.java`
- [Invalid command error](https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/main/InvalidCommandException.java): `src/bcu/changeme/phonebook/main/InvalidCommandException.java`

### Command objects

- [Command interface](https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/main/Command.java): `src/bcu/changeme/phonebook/main/Command.java`
- [Add command](https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/main/AddCommand.java): `src/bcu/changeme/phonebook/main/AddCommand.java`
- [Show command](https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/main/ShowCommand.java): `src/bcu/changeme/phonebook/main/ShowCommand.java`

### Phone-book model

- [Phone book](https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/model/PhoneBook.java): `src/bcu/changeme/phonebook/model/PhoneBook.java`
- [Phone-book entry](https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/model/PhoneBookEntry.java): `src/bcu/changeme/phonebook/model/PhoneBookEntry.java`
- [Duplicate-name error](https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/model/AlreadyPresentException.java): `src/bcu/changeme/phonebook/model/AlreadyPresentException.java`
- [Missing-entry error](https://github.com/zeeelord/phone_book_master/blob/main/src/bcu/changeme/phonebook/model/NotPresentException.java): `src/bcu/changeme/phonebook/model/NotPresentException.java`

### Other components

- **Console user**

## Connections

- Console user → Main loop and dispatch: enters commands (evidence: `src/bcu/changeme/phonebook/main/Main.java`)
- Main loop and dispatch → Console user: prints results (evidence: `src/bcu/changeme/phonebook/main/Main.java`)
- Main loop and dispatch → Phone book: dispatches operations (evidence: `src/bcu/changeme/phonebook/main/Main.java`)
- Main loop and dispatch → Invalid command error: raises or catches (evidence: `src/bcu/changeme/phonebook/main/Main.java`)
- Main loop and dispatch → Duplicate-name error: catches (evidence: `src/bcu/changeme/phonebook/main/Main.java`)
- Main loop and dispatch → Missing-entry error: catches (evidence: `src/bcu/changeme/phonebook/main/Main.java`)
- Add command → Command interface: implements (evidence: `src/bcu/changeme/phonebook/main/AddCommand.java`)
- Add command → Phone book: adds entry (evidence: `src/bcu/changeme/phonebook/main/AddCommand.java`)
- Add command → Invalid command error: raises (evidence: `src/bcu/changeme/phonebook/main/AddCommand.java`)
- Show command → Command interface: implements (evidence: `src/bcu/changeme/phonebook/main/ShowCommand.java`)
- Show command → Phone book: gets entry (evidence: `src/bcu/changeme/phonebook/main/ShowCommand.java`)
- Phone book → Phone-book entry: creates and stores (evidence: `src/bcu/changeme/phonebook/model/PhoneBook.java`)
- Phone book → Duplicate-name error: throws on duplicate (evidence: `src/bcu/changeme/phonebook/model/PhoneBook.java`)
- Phone book → Missing-entry error: throws when absent (evidence: `src/bcu/changeme/phonebook/model/PhoneBook.java`)
