# nadeeshaamod/cit300_project architecture

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

- Interactive diagram: https://gitdiagram.com/nadeeshaamod/cit300_project
- Repository: https://github.com/nadeeshaamod/cit300_project

## Overview

This is a menu-driven university student-record and campus-route management application. A console user enters through Main, which validates input and coordinates student CRUD, service-request queueing, action history, student indexing, and campus-network operations. StudentLinkedList is documented as the master record store; Main also maintains the BST and hash table for sorted display and ID lookup. The graph models campus locations and roads and supports BFS/DFS traversal. Relationships are shown where the Main excerpt, source index, or README supports them; unsampled menu handlers limit detail about their individual operations.

Main entry points: [`src/Main.java`](https://github.com/nadeeshaamod/cit300_project/blob/main/src/Main.java) (Menu coordinator), [`src/Student.java`](https://github.com/nadeeshaamod/cit300_project/blob/main/src/Student.java) (Student record), [`src/StudentLinkedList.java`](https://github.com/nadeeshaamod/cit300_project/blob/main/src/StudentLinkedList.java) (Master record list), [`src/StudentBST.java`](https://github.com/nadeeshaamod/cit300_project/blob/main/src/StudentBST.java) (ID-sorted BST)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_console["Console workflow"]
  node_main["Menu coordinator<br/>[Main.java]"]
end

subgraph group_records["Student records"]
  node_student["Student record<br/>[Student.java]"]
  node_list["Master record list"]
  node_bst["ID-sorted BST<br/>[StudentBST.java]"]
  node_hash["ID hash index"]
end

subgraph group_operations["Requests and history"]
  node_queue["Service request queue"]
  node_stack["Action history stack<br/>[ActionStack.java]"]
end

subgraph group_campus["Campus routes"]
  node_graph["Campus graph<br/>[CampusGraph.java]"]
end

node_user(("Console user"))

node_user -->|"uses menu"| node_main
node_main -->|"creates records"| node_student
node_main -->|"manages records"| node_list
node_main -->|"maintains index"| node_bst
node_main -->|"maintains index"| node_hash
node_main -->|"handles requests"| node_queue
node_main -->|"logs actions"| node_stack
node_main -->|"manages routes"| node_graph
node_list -->|"stores records"| node_student
node_bst -->|"indexes records"| node_student
node_hash -->|"indexes records"| node_student

click node_main "https://github.com/nadeeshaamod/cit300_project/blob/main/src/Main.java"
click node_student "https://github.com/nadeeshaamod/cit300_project/blob/main/src/Student.java"
click node_list "https://github.com/nadeeshaamod/cit300_project/blob/main/src/StudentLinkedList.java"
click node_bst "https://github.com/nadeeshaamod/cit300_project/blob/main/src/StudentBST.java"
click node_hash "https://github.com/nadeeshaamod/cit300_project/blob/main/src/StudentHashTable.java"
click node_queue "https://github.com/nadeeshaamod/cit300_project/blob/main/src/ServiceRequestQueue.java"
click node_stack "https://github.com/nadeeshaamod/cit300_project/blob/main/src/ActionStack.java"
click node_graph "https://github.com/nadeeshaamod/cit300_project/blob/main/src/CampusGraph.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_user toneBlue
class node_student,node_list,node_bst,node_hash toneAmber
class node_queue,node_stack toneMint
class node_graph toneRose
```

## Components

### Console workflow

- [Menu coordinator](https://github.com/nadeeshaamod/cit300_project/blob/main/src/Main.java): `src/Main.java`

### Student records

- [Student record](https://github.com/nadeeshaamod/cit300_project/blob/main/src/Student.java): `src/Student.java`
- [Master record list](https://github.com/nadeeshaamod/cit300_project/blob/main/src/StudentLinkedList.java): `src/StudentLinkedList.java`
- [ID-sorted BST](https://github.com/nadeeshaamod/cit300_project/blob/main/src/StudentBST.java): `src/StudentBST.java`
- [ID hash index](https://github.com/nadeeshaamod/cit300_project/blob/main/src/StudentHashTable.java): `src/StudentHashTable.java`

### Requests and history

- [Service request queue](https://github.com/nadeeshaamod/cit300_project/blob/main/src/ServiceRequestQueue.java): `src/ServiceRequestQueue.java`
- [Action history stack](https://github.com/nadeeshaamod/cit300_project/blob/main/src/ActionStack.java): `src/ActionStack.java`

### Campus routes

- [Campus graph](https://github.com/nadeeshaamod/cit300_project/blob/main/src/CampusGraph.java): `src/CampusGraph.java`

### Other components

- **Console user**

## Connections

- Console user → Menu coordinator: uses menu (evidence: `Readme.MD`)
- Menu coordinator → Student record: creates records (evidence: `src/Main.java`)
- Menu coordinator → Master record list: manages records (evidence: `src/Main.java`)
- Menu coordinator → ID-sorted BST: maintains index (evidence: `src/Main.java`)
- Menu coordinator → ID hash index: maintains index (evidence: `src/Main.java`)
- Menu coordinator → Service request queue: handles requests (evidence: `src/Main.java`)
- Menu coordinator → Action history stack: logs actions (evidence: `src/Main.java`)
- Menu coordinator → Campus graph: manages routes (evidence: `src/Main.java`)
- Master record list → Student record: stores records (evidence: `src/StudentLinkedList.java`)
- ID-sorted BST → Student record: indexes records (evidence: `src/StudentBST.java`)
- ID hash index → Student record: indexes records (evidence: `src/StudentHashTable.java`)
