# liljaydi/console-based-registration-system architecture

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

- Interactive diagram: https://gitdiagram.com/liljaydi/console-based-registration-system
- Repository: https://github.com/liljaydi/console-based-registration-system

## Overview

This is a console-based event registration system. A user enters attendee details, which are validated and queued; processing moves attendees into a registered list and a history stack, with options to view sorted attendees, search by name, and undo the latest registration. The map reflects the shown runtime calls; README content is absent, so no additional documented capabilities are available, and no unsampled behavior is inferred.

Main entry points: [`src/service/RegistrationHandler.java`](https://github.com/liljaydi/console-based-registration-system/blob/main/src/service/RegistrationHandler.java) (Registration handler), [`src/datastructures/Node.java`](https://github.com/liljaydi/console-based-registration-system/blob/main/src/datastructures/Node.java) (Linked node), [`src/datastructures/AttendeeLinkedList.java`](https://github.com/liljaydi/console-based-registration-system/blob/main/src/datastructures/AttendeeLinkedList.java) (Registered list), [`src/main.java`](https://github.com/liljaydi/console-based-registration-system/blob/main/src/main.java) (Menu)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Console workflow"]
  node_menu["Menu<br/>[main.java]"]
  node_validation["Input validation<br/>[Validation.java]"]
  node_handler["Registration handler"]
end

subgraph group_domain["Attendee model"]
  node_attendee["Attendee<br/>[Attendee.java]"]
end

subgraph group_structures["Registration state"]
  node_queue["Pending queue"]
  node_attendee_list["Registered list"]
  node_history["Registration history"]
  node_node["Linked node<br/>[Node.java]"]
end

subgraph group_algorithms["List algorithms"]
  node_search["Name search<br/>[LinearSearch.java]"]
  node_sort["Alphabetical sort<br/>[MergeSort.java]"]
end

node_user(("Operator"))

node_user -->|"chooses actions"| node_menu
node_menu -->|"validates choices"| node_validation
node_menu -->|"dispatches actions"| node_handler
node_handler -->|"validates prompts"| node_validation
node_handler -->|"creates attendee"| node_attendee
node_handler -->|"enqueues and dequeues"| node_queue
node_handler -->|"appends, searches, removes"| node_attendee_list
node_handler -->|"records and undoes"| node_history
node_attendee_list -->|"delegates search"| node_search
node_attendee_list -->|"sorts before display"| node_sort
node_attendee_list -->|"stores nodes"| node_node
node_queue -->|"stores nodes"| node_node
node_history -->|"stores nodes"| node_node
node_search -->|"traverses list"| node_node
node_sort -->|"relinks list"| node_node

click node_menu "https://github.com/liljaydi/console-based-registration-system/blob/main/src/main.java"
click node_validation "https://github.com/liljaydi/console-based-registration-system/blob/main/src/util/Validation.java"
click node_handler "https://github.com/liljaydi/console-based-registration-system/blob/main/src/service/RegistrationHandler.java"
click node_attendee "https://github.com/liljaydi/console-based-registration-system/blob/main/src/model/Attendee.java"
click node_queue "https://github.com/liljaydi/console-based-registration-system/blob/main/src/datastructures/RegistrationQueue.java"
click node_attendee_list "https://github.com/liljaydi/console-based-registration-system/blob/main/src/datastructures/AttendeeLinkedList.java"
click node_history "https://github.com/liljaydi/console-based-registration-system/blob/main/src/datastructures/RegistrationStack.java"
click node_node "https://github.com/liljaydi/console-based-registration-system/blob/main/src/datastructures/Node.java"
click node_search "https://github.com/liljaydi/console-based-registration-system/blob/main/src/algorithms/LinearSearch.java"
click node_sort "https://github.com/liljaydi/console-based-registration-system/blob/main/src/algorithms/MergeSort.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_menu,node_validation,node_handler toneBlue
class node_attendee toneAmber
class node_queue,node_attendee_list,node_history,node_node toneMint
class node_search,node_sort toneRose
class node_user toneIndigo
```

## Components

### Console workflow

- [Menu](https://github.com/liljaydi/console-based-registration-system/blob/main/src/main.java): `src/main.java`
- [Input validation](https://github.com/liljaydi/console-based-registration-system/blob/main/src/util/Validation.java): `src/util/Validation.java`
- [Registration handler](https://github.com/liljaydi/console-based-registration-system/blob/main/src/service/RegistrationHandler.java): `src/service/RegistrationHandler.java`

### Attendee model

- [Attendee](https://github.com/liljaydi/console-based-registration-system/blob/main/src/model/Attendee.java): `src/model/Attendee.java`

### Registration state

- [Pending queue](https://github.com/liljaydi/console-based-registration-system/blob/main/src/datastructures/RegistrationQueue.java): `src/datastructures/RegistrationQueue.java`
- [Registered list](https://github.com/liljaydi/console-based-registration-system/blob/main/src/datastructures/AttendeeLinkedList.java): `src/datastructures/AttendeeLinkedList.java`
- [Registration history](https://github.com/liljaydi/console-based-registration-system/blob/main/src/datastructures/RegistrationStack.java): `src/datastructures/RegistrationStack.java`
- [Linked node](https://github.com/liljaydi/console-based-registration-system/blob/main/src/datastructures/Node.java): `src/datastructures/Node.java`

### List algorithms

- [Name search](https://github.com/liljaydi/console-based-registration-system/blob/main/src/algorithms/LinearSearch.java): `src/algorithms/LinearSearch.java`
- [Alphabetical sort](https://github.com/liljaydi/console-based-registration-system/blob/main/src/algorithms/MergeSort.java): `src/algorithms/MergeSort.java`

### Other components

- **Operator**

## Connections

- Operator → Menu: chooses actions (evidence: `src/main.java`)
- Menu → Input validation: validates choices (evidence: `src/main.java`)
- Menu → Registration handler: dispatches actions (evidence: `src/main.java`)
- Registration handler → Input validation: validates prompts (evidence: `src/service/RegistrationHandler.java`)
- Registration handler → Attendee: creates attendee (evidence: `src/service/RegistrationHandler.java`)
- Registration handler → Pending queue: enqueues and dequeues (evidence: `src/service/RegistrationHandler.java`)
- Registration handler → Registered list: appends, searches, removes (evidence: `src/service/RegistrationHandler.java`)
- Registration handler → Registration history: records and undoes (evidence: `src/service/RegistrationHandler.java`)
- Registered list → Name search: delegates search (evidence: `src/datastructures/AttendeeLinkedList.java`)
- Registered list → Alphabetical sort: sorts before display (evidence: `src/datastructures/AttendeeLinkedList.java`)
- Registered list → Linked node: stores nodes (evidence: `src/datastructures/AttendeeLinkedList.java`)
- Pending queue → Linked node: stores nodes (evidence: `src/datastructures/RegistrationQueue.java`)
- Registration history → Linked node: stores nodes (evidence: `src/datastructures/RegistrationStack.java`)
- Name search → Linked node: traverses list (evidence: `src/algorithms/LinearSearch.java`)
- Alphabetical sort → Linked node: relinks list (evidence: `src/algorithms/MergeSort.java`)
